@terreno/ui 57.18.0 → 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 (361) hide show
  1. package/.ai/guidelines/core.md +1 -1
  2. package/CHANGELOG.md +2074 -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/AreaChart.d.ts.map +1 -1
  7. package/dist/AreaChart.js +2 -2
  8. package/dist/AreaChart.js.map +1 -1
  9. package/dist/Avatar.d.ts.map +1 -1
  10. package/dist/Avatar.js +3 -1
  11. package/dist/Avatar.js.map +1 -1
  12. package/dist/BarChart.d.ts.map +1 -1
  13. package/dist/BarChart.js +2 -2
  14. package/dist/BarChart.js.map +1 -1
  15. package/dist/Box.d.ts.map +1 -1
  16. package/dist/Box.js +66 -8
  17. package/dist/Box.js.map +1 -1
  18. package/dist/Card.d.ts.map +1 -1
  19. package/dist/Card.js +5 -4
  20. package/dist/Card.js.map +1 -1
  21. package/dist/ChartCard.d.ts.map +1 -1
  22. package/dist/ChartCard.js +4 -2
  23. package/dist/ChartCard.js.map +1 -1
  24. package/dist/Common.d.ts +240 -14
  25. package/dist/Common.d.ts.map +1 -1
  26. package/dist/Common.js.map +1 -1
  27. package/dist/ConsentFormScreen.d.ts +1 -1
  28. package/dist/ConsentFormScreen.d.ts.map +1 -1
  29. package/dist/ConsentFormScreen.js +13 -4
  30. package/dist/ConsentFormScreen.js.map +1 -1
  31. package/dist/DateTimeField.d.ts.map +1 -1
  32. package/dist/DateTimeField.js +5 -3
  33. package/dist/DateTimeField.js.map +1 -1
  34. package/dist/DonutChart.d.ts.map +1 -1
  35. package/dist/DonutChart.js +2 -2
  36. package/dist/DonutChart.js.map +1 -1
  37. package/dist/Field.d.ts.map +1 -1
  38. package/dist/Field.js +2 -0
  39. package/dist/Field.js.map +1 -1
  40. package/dist/FormContainer.d.ts +68 -0
  41. package/dist/FormContainer.d.ts.map +1 -0
  42. package/dist/FormContainer.js +79 -0
  43. package/dist/FormContainer.js.map +1 -0
  44. package/dist/GPTChat.d.ts.map +1 -1
  45. package/dist/GPTChat.js +2 -1
  46. package/dist/GPTChat.js.map +1 -1
  47. package/dist/Heading.d.ts +1 -1
  48. package/dist/Heading.d.ts.map +1 -1
  49. package/dist/Heading.js +5 -2
  50. package/dist/Heading.js.map +1 -1
  51. package/dist/Icon.d.ts +4 -0
  52. package/dist/Icon.d.ts.map +1 -1
  53. package/dist/Icon.js +43 -2
  54. package/dist/Icon.js.map +1 -1
  55. package/dist/LabeledCheckBox.d.ts +22 -0
  56. package/dist/LabeledCheckBox.d.ts.map +1 -0
  57. package/dist/LabeledCheckBox.js +30 -0
  58. package/dist/LabeledCheckBox.js.map +1 -0
  59. package/dist/LineChart.d.ts.map +1 -1
  60. package/dist/LineChart.js +2 -2
  61. package/dist/LineChart.js.map +1 -1
  62. package/dist/ListDetailLayout.d.ts +36 -0
  63. package/dist/ListDetailLayout.d.ts.map +1 -0
  64. package/dist/ListDetailLayout.js +153 -0
  65. package/dist/ListDetailLayout.js.map +1 -0
  66. package/dist/MarkdownEditor.d.ts.map +1 -1
  67. package/dist/MarkdownEditor.js +2 -1
  68. package/dist/MarkdownEditor.js.map +1 -1
  69. package/dist/MediaQuery.d.ts +1 -1
  70. package/dist/MediaQuery.d.ts.map +1 -1
  71. package/dist/MediaQuery.js +1 -1
  72. package/dist/MediaQuery.js.map +1 -1
  73. package/dist/OtpField.d.ts +60 -0
  74. package/dist/OtpField.d.ts.map +1 -0
  75. package/dist/OtpField.js +154 -0
  76. package/dist/OtpField.js.map +1 -0
  77. package/dist/Page.d.ts +1 -0
  78. package/dist/Page.d.ts.map +1 -1
  79. package/dist/Page.js +10 -1
  80. package/dist/Page.js.map +1 -1
  81. package/dist/ProvisionalConsentSigner.d.ts +21 -0
  82. package/dist/ProvisionalConsentSigner.d.ts.map +1 -0
  83. package/dist/ProvisionalConsentSigner.js +199 -0
  84. package/dist/ProvisionalConsentSigner.js.map +1 -0
  85. package/dist/ResponsiveBreakpoint.d.ts +5 -0
  86. package/dist/ResponsiveBreakpoint.d.ts.map +1 -1
  87. package/dist/ResponsiveBreakpoint.js +7 -0
  88. package/dist/ResponsiveBreakpoint.js.map +1 -1
  89. package/dist/Scorecard.d.ts.map +1 -1
  90. package/dist/Scorecard.js +5 -2
  91. package/dist/Scorecard.js.map +1 -1
  92. package/dist/Skeleton.d.ts +39 -0
  93. package/dist/Skeleton.d.ts.map +1 -0
  94. package/dist/Skeleton.js +195 -0
  95. package/dist/Skeleton.js.map +1 -0
  96. package/dist/SocialLoginButton.d.ts +10 -0
  97. package/dist/SocialLoginButton.d.ts.map +1 -1
  98. package/dist/SocialLoginButton.js +26 -8
  99. package/dist/SocialLoginButton.js.map +1 -1
  100. package/dist/SplitPage.d.ts +12 -1
  101. package/dist/SplitPage.d.ts.map +1 -1
  102. package/dist/SplitPage.js +14 -7
  103. package/dist/SplitPage.js.map +1 -1
  104. package/dist/SplitPage.native.d.ts +1 -1
  105. package/dist/SplitPage.native.d.ts.map +1 -1
  106. package/dist/SplitPage.native.js +6 -3
  107. package/dist/SplitPage.native.js.map +1 -1
  108. package/dist/SplitPageLoading.d.ts +14 -0
  109. package/dist/SplitPageLoading.d.ts.map +1 -0
  110. package/dist/SplitPageLoading.js +19 -0
  111. package/dist/SplitPageLoading.js.map +1 -0
  112. package/dist/SyncStatusBanner.d.ts +7 -1
  113. package/dist/SyncStatusBanner.d.ts.map +1 -1
  114. package/dist/SyncStatusBanner.js +20 -4
  115. package/dist/SyncStatusBanner.js.map +1 -1
  116. package/dist/Text.d.ts +3 -1
  117. package/dist/Text.d.ts.map +1 -1
  118. package/dist/Text.js +2 -0
  119. package/dist/Text.js.map +1 -1
  120. package/dist/TextField.d.ts.map +1 -1
  121. package/dist/TextField.js +44 -10
  122. package/dist/TextField.js.map +1 -1
  123. package/dist/charts/ChartFrame.d.ts +2 -2
  124. package/dist/charts/ChartFrame.d.ts.map +1 -1
  125. package/dist/charts/ChartFrame.js +9 -2
  126. package/dist/charts/ChartFrame.js.map +1 -1
  127. package/dist/fieldElements/FieldError.d.ts.map +1 -1
  128. package/dist/fieldElements/FieldError.js +1 -1
  129. package/dist/fieldElements/FieldError.js.map +1 -1
  130. package/dist/index.d.ts +21 -3
  131. package/dist/index.d.ts.map +1 -1
  132. package/dist/index.js +16 -1
  133. package/dist/index.js.map +1 -1
  134. package/dist/lazyBoundaries/heavyOptionalExports.d.ts +3 -0
  135. package/dist/lazyBoundaries/heavyOptionalExports.d.ts.map +1 -1
  136. package/dist/lazyBoundaries/heavyOptionalExports.js +2 -0
  137. package/dist/lazyBoundaries/heavyOptionalExports.js.map +1 -1
  138. package/dist/login/LastUsedBadge.d.ts +14 -0
  139. package/dist/login/LastUsedBadge.d.ts.map +1 -0
  140. package/dist/login/LastUsedBadge.js +23 -0
  141. package/dist/login/LastUsedBadge.js.map +1 -0
  142. package/dist/login/LoginAccountCard.d.ts +38 -0
  143. package/dist/login/LoginAccountCard.d.ts.map +1 -0
  144. package/dist/login/LoginAccountCard.js +72 -0
  145. package/dist/login/LoginAccountCard.js.map +1 -0
  146. package/dist/login/LoginAccountList.d.ts +33 -0
  147. package/dist/login/LoginAccountList.d.ts.map +1 -0
  148. package/dist/login/LoginAccountList.js +30 -0
  149. package/dist/login/LoginAccountList.js.map +1 -0
  150. package/dist/login/LoginScreen.d.ts +4 -4
  151. package/dist/login/LoginScreen.d.ts.map +1 -1
  152. package/dist/login/LoginScreen.js +294 -13
  153. package/dist/login/LoginScreen.js.map +1 -1
  154. package/dist/login/OutlinePill.d.ts +28 -0
  155. package/dist/login/OutlinePill.d.ts.map +1 -0
  156. package/dist/login/OutlinePill.js +48 -0
  157. package/dist/login/OutlinePill.js.map +1 -0
  158. package/dist/login/TwoFactorChallengeScreen.d.ts +26 -0
  159. package/dist/login/TwoFactorChallengeScreen.d.ts.map +1 -0
  160. package/dist/login/TwoFactorChallengeScreen.js +139 -0
  161. package/dist/login/TwoFactorChallengeScreen.js.map +1 -0
  162. package/dist/login/loginMethods.d.ts +27 -0
  163. package/dist/login/loginMethods.d.ts.map +1 -0
  164. package/dist/login/loginMethods.js +37 -0
  165. package/dist/login/loginMethods.js.map +1 -0
  166. package/dist/login/loginTypes.d.ts +202 -5
  167. package/dist/login/loginTypes.d.ts.map +1 -1
  168. package/dist/pdfHtmlTemplate.d.ts +17 -0
  169. package/dist/pdfHtmlTemplate.d.ts.map +1 -1
  170. package/dist/pdfHtmlTemplate.js +78 -0
  171. package/dist/pdfHtmlTemplate.js.map +1 -1
  172. package/dist/security/AccountSecurityScreen.d.ts +10 -0
  173. package/dist/security/AccountSecurityScreen.d.ts.map +1 -0
  174. package/dist/security/AccountSecurityScreen.js +50 -0
  175. package/dist/security/AccountSecurityScreen.js.map +1 -0
  176. package/dist/security/LinkedAccountsCard.d.ts +32 -0
  177. package/dist/security/LinkedAccountsCard.d.ts.map +1 -0
  178. package/dist/security/LinkedAccountsCard.js +145 -0
  179. package/dist/security/LinkedAccountsCard.js.map +1 -0
  180. package/dist/security/PasskeysCard.d.ts +39 -0
  181. package/dist/security/PasskeysCard.d.ts.map +1 -0
  182. package/dist/security/PasskeysCard.js +168 -0
  183. package/dist/security/PasskeysCard.js.map +1 -0
  184. package/dist/security/PasswordCard.d.ts +32 -0
  185. package/dist/security/PasswordCard.d.ts.map +1 -0
  186. package/dist/security/PasswordCard.js +198 -0
  187. package/dist/security/PasswordCard.js.map +1 -0
  188. package/dist/security/SessionsCard.d.ts +39 -0
  189. package/dist/security/SessionsCard.d.ts.map +1 -0
  190. package/dist/security/SessionsCard.js +168 -0
  191. package/dist/security/SessionsCard.js.map +1 -0
  192. package/dist/security/TwoFactorSettingsCard.d.ts +55 -0
  193. package/dist/security/TwoFactorSettingsCard.d.ts.map +1 -0
  194. package/dist/security/TwoFactorSettingsCard.js +458 -0
  195. package/dist/security/TwoFactorSettingsCard.js.map +1 -0
  196. package/dist/security/securityMethods.d.ts +40 -0
  197. package/dist/security/securityMethods.d.ts.map +1 -0
  198. package/dist/security/securityMethods.js +66 -0
  199. package/dist/security/securityMethods.js.map +1 -0
  200. package/dist/security/securityTypes.d.ts +467 -0
  201. package/dist/security/securityTypes.d.ts.map +1 -0
  202. package/dist/security/securityTypes.js +2 -0
  203. package/dist/security/securityTypes.js.map +1 -0
  204. package/dist/security/userAgent.d.ts +26 -0
  205. package/dist/security/userAgent.d.ts.map +1 -0
  206. package/dist/security/userAgent.js +80 -0
  207. package/dist/security/userAgent.js.map +1 -0
  208. package/dist/signUp/OAuthButtons.d.ts +28 -5
  209. package/dist/signUp/OAuthButtons.d.ts.map +1 -1
  210. package/dist/signUp/OAuthButtons.js +44 -5
  211. package/dist/signUp/OAuthButtons.js.map +1 -1
  212. package/dist/signUp/SignUpScreen.d.ts.map +1 -1
  213. package/dist/signUp/SignUpScreen.js +50 -5
  214. package/dist/signUp/SignUpScreen.js.map +1 -1
  215. package/dist/signUp/signUpTypes.d.ts +21 -1
  216. package/dist/signUp/signUpTypes.d.ts.map +1 -1
  217. package/dist/useConsentForms.d.ts +9 -0
  218. package/dist/useConsentForms.d.ts.map +1 -1
  219. package/dist/useConsentForms.js +18 -0
  220. package/dist/useConsentForms.js.map +1 -1
  221. package/dist/useProvisionalConsent.d.ts +124 -0
  222. package/dist/useProvisionalConsent.d.ts.map +1 -0
  223. package/dist/useProvisionalConsent.js +79 -0
  224. package/dist/useProvisionalConsent.js.map +1 -0
  225. package/dist/withLoading.d.ts +20 -0
  226. package/dist/withLoading.d.ts.map +1 -0
  227. package/dist/withLoading.js +24 -0
  228. package/dist/withLoading.js.map +1 -0
  229. package/package.json +4 -2
  230. package/src/Accordion.test.tsx +5 -0
  231. package/src/Accordion.tsx +3 -8
  232. package/src/AreaChart.test.tsx +15 -0
  233. package/src/AreaChart.tsx +6 -0
  234. package/src/Avatar.test.tsx +8 -0
  235. package/src/Avatar.tsx +2 -0
  236. package/src/BarChart.test.tsx +15 -0
  237. package/src/BarChart.tsx +6 -0
  238. package/src/Box.test.tsx +131 -1
  239. package/src/Box.tsx +77 -8
  240. package/src/Card.test.tsx +48 -0
  241. package/src/Card.tsx +13 -2
  242. package/src/ChartCard.test.tsx +30 -0
  243. package/src/ChartCard.tsx +18 -1
  244. package/src/Common.ts +263 -14
  245. package/src/ConsentFormScreen.test.tsx +84 -0
  246. package/src/ConsentFormScreen.tsx +28 -4
  247. package/src/DateTimeField.tsx +5 -3
  248. package/src/DonutChart.test.tsx +15 -0
  249. package/src/DonutChart.tsx +6 -0
  250. package/src/Field.tsx +2 -0
  251. package/src/FilePickerButton.test.tsx +35 -0
  252. package/src/FormContainer.test.tsx +242 -0
  253. package/src/FormContainer.tsx +177 -0
  254. package/src/GPTChat.test.tsx +16 -0
  255. package/src/GPTChat.tsx +8 -2
  256. package/src/Heading.test.tsx +14 -0
  257. package/src/Heading.tsx +6 -1
  258. package/src/Icon.test.tsx +52 -1
  259. package/src/Icon.tsx +92 -3
  260. package/src/IconButton.test.tsx +85 -0
  261. package/src/LabeledCheckBox.test.tsx +45 -0
  262. package/src/LabeledCheckBox.tsx +89 -0
  263. package/src/LineChart.test.tsx +18 -0
  264. package/src/LineChart.tsx +6 -0
  265. package/src/ListDetailLayout.tsx +247 -0
  266. package/src/MarkdownEditor.tsx +2 -1
  267. package/src/MediaQuery.ts +1 -0
  268. package/src/OtpField.test.tsx +280 -0
  269. package/src/OtpField.tsx +307 -0
  270. package/src/Page.test.tsx +38 -0
  271. package/src/Page.tsx +38 -19
  272. package/src/ProvisionalConsentSigner.test.tsx +625 -0
  273. package/src/ProvisionalConsentSigner.tsx +423 -0
  274. package/src/ResponsiveBreakpoint.test.tsx +7 -0
  275. package/src/ResponsiveBreakpoint.tsx +14 -0
  276. package/src/RootImportRegression.test.tsx +3 -0
  277. package/src/Scorecard.test.tsx +11 -0
  278. package/src/Scorecard.tsx +21 -0
  279. package/src/Skeleton.test.tsx +262 -0
  280. package/src/Skeleton.tsx +430 -0
  281. package/src/SocialLoginButton.test.tsx +14 -0
  282. package/src/SocialLoginButton.tsx +51 -7
  283. package/src/SplitPage.native.tsx +16 -3
  284. package/src/SplitPage.tsx +29 -12
  285. package/src/SplitPageLoading.test.tsx +51 -0
  286. package/src/SplitPageLoading.tsx +53 -0
  287. package/src/SyncStatusBanner.test.tsx +61 -4
  288. package/src/SyncStatusBanner.tsx +29 -3
  289. package/src/Text.tsx +4 -1
  290. package/src/TextField.test.tsx +150 -0
  291. package/src/TextField.tsx +66 -8
  292. package/src/__snapshots__/AddressField.test.tsx.snap +12 -0
  293. package/src/__snapshots__/AiSuggestionBox.test.tsx.snap +15 -0
  294. package/src/__snapshots__/Avatar.test.tsx.snap +1 -0
  295. package/src/__snapshots__/CustomSelectField.test.tsx.snap +3 -0
  296. package/src/__snapshots__/EmailField.test.tsx.snap +6 -0
  297. package/src/__snapshots__/Field.test.tsx.snap +37 -0
  298. package/src/__snapshots__/HeightField.test.tsx.snap +2 -0
  299. package/src/__snapshots__/MobileAddressAutoComplete.test.tsx.snap +3 -0
  300. package/src/__snapshots__/NumberField.test.tsx.snap +3 -0
  301. package/src/__snapshots__/Page.test.tsx.snap +28 -5
  302. package/src/__snapshots__/PhoneNumberField.test.tsx.snap +12 -0
  303. package/src/__snapshots__/Slider.test.tsx.snap +1 -0
  304. package/src/__snapshots__/SocialLoginButton.test.tsx.snap +43 -22
  305. package/src/__snapshots__/SplitPage.test.tsx.snap +16 -0
  306. package/src/__snapshots__/TapToEdit.test.tsx.snap +3 -0
  307. package/src/__snapshots__/TextArea.test.tsx.snap +17 -1
  308. package/src/__snapshots__/TextField.test.tsx.snap +19 -2
  309. package/src/__snapshots__/TypedSignatureField.test.tsx.snap +3 -0
  310. package/src/__snapshots__/UnifiedAddressAutoComplete.test.tsx.snap +18 -0
  311. package/src/__snapshots__/WebAddressAutocomplete.test.tsx.snap +12 -0
  312. package/src/bunSetup.ts +13 -1
  313. package/src/charts/ChartFrame.tsx +19 -8
  314. package/src/fieldElements/FieldError.tsx +1 -0
  315. package/src/fieldElements/__snapshots__/FieldError.test.tsx.snap +2 -0
  316. package/src/index.tsx +44 -1
  317. package/src/isolated/ListDetailLayout.isolated.tsx +634 -0
  318. package/src/lazyBoundaries/heavyOptionalExports.tsx +7 -0
  319. package/src/login/LastUsedBadge.tsx +40 -0
  320. package/src/login/LoginAccountCard.tsx +205 -0
  321. package/src/login/LoginAccountList.tsx +115 -0
  322. package/src/login/LoginScreen.test.tsx +837 -1
  323. package/src/login/LoginScreen.tsx +674 -91
  324. package/src/login/OutlinePill.tsx +110 -0
  325. package/src/login/TwoFactorChallengeScreen.test.tsx +376 -0
  326. package/src/login/TwoFactorChallengeScreen.tsx +307 -0
  327. package/src/login/__snapshots__/LoginScreen.test.tsx.snap +1454 -334
  328. package/src/login/loginMethods.test.ts +53 -0
  329. package/src/login/loginMethods.ts +60 -0
  330. package/src/login/loginTypes.ts +208 -5
  331. package/src/pdfHtmlTemplate.test.ts +243 -4
  332. package/src/pdfHtmlTemplate.ts +93 -0
  333. package/src/security/AccountSecurityScreen.test.tsx +262 -0
  334. package/src/security/AccountSecurityScreen.tsx +156 -0
  335. package/src/security/LinkedAccountsCard.test.tsx +371 -0
  336. package/src/security/LinkedAccountsCard.tsx +297 -0
  337. package/src/security/PasskeysCard.test.tsx +378 -0
  338. package/src/security/PasskeysCard.tsx +371 -0
  339. package/src/security/PasswordCard.test.tsx +445 -0
  340. package/src/security/PasswordCard.tsx +342 -0
  341. package/src/security/SessionsCard.test.tsx +349 -0
  342. package/src/security/SessionsCard.tsx +362 -0
  343. package/src/security/TwoFactorSettingsCard.test.tsx +700 -0
  344. package/src/security/TwoFactorSettingsCard.tsx +872 -0
  345. package/src/security/securityMethods.test.ts +101 -0
  346. package/src/security/securityMethods.ts +104 -0
  347. package/src/security/securityTypes.ts +480 -0
  348. package/src/security/userAgent.test.ts +119 -0
  349. package/src/security/userAgent.ts +102 -0
  350. package/src/signUp/OAuthButtons.test.tsx +27 -0
  351. package/src/signUp/OAuthButtons.tsx +153 -19
  352. package/src/signUp/SignUpScreen.test.tsx +170 -1
  353. package/src/signUp/SignUpScreen.tsx +87 -25
  354. package/src/signUp/__snapshots__/SignUpScreen.test.tsx.snap +22 -11
  355. package/src/signUp/signUpTypes.ts +23 -1
  356. package/src/useConsentForms.test.ts +37 -1
  357. package/src/useConsentForms.ts +25 -0
  358. package/src/useProvisionalConsent.test.ts +256 -0
  359. package/src/useProvisionalConsent.ts +218 -0
  360. package/src/withLoading.test.tsx +61 -0
  361. package/src/withLoading.tsx +50 -0
package/dist/Common.d.ts CHANGED
@@ -1,7 +1,8 @@
1
1
  import type { Block, BlockAction, BlocksDocument, InlineDataset } from "@terreno/blocks";
2
+ import type { Href, Stack } from "expo-router";
2
3
  import type { CountryCode } from "libphonenumber-js";
3
4
  import type React from "react";
4
- import type { FC, ReactElement, ReactNode } from "react";
5
+ import type { ComponentProps, FC, ReactElement, ReactNode } from "react";
5
6
  import type { ImageStyle, ListRenderItemInfo, Text as NativeText, ScrollView, StyleProp, TextInput, TextStyle, ViewStyle } from "react-native";
6
7
  import type { DimensionValue } from "react-native/Libraries/StyleSheet/StyleSheetTypes";
7
8
  import type { Styles } from "react-native-google-places-autocomplete";
@@ -44,7 +45,7 @@ export interface AccordionProps extends InfoModalIconProps {
44
45
  includeInfoModal?: boolean;
45
46
  /**
46
47
  * If true, the accordion will be collapsed.
47
- * @default true
48
+ * @default false
48
49
  */
49
50
  isCollapsed?: boolean;
50
51
  subtitle?: string;
@@ -529,15 +530,123 @@ export interface AccessibilityProps {
529
530
  */
530
531
  accessibilityRole?: string;
531
532
  }
532
- /** Checked and disabled state a `Box` reports to screen readers. */
533
+ /** Checked, disabled, and selected state a `Box` reports to screen readers. */
533
534
  export interface BoxAccessibilityState {
535
+ /** Set automatically while `loading` is true; sent as `aria-busy` on web. */
536
+ busy?: boolean;
534
537
  checked?: boolean;
535
538
  disabled?: boolean;
539
+ selected?: boolean;
540
+ }
541
+ /** How skeleton placeholders animate. `none` renders a static block. */
542
+ export type SkeletonAnimation = "pulse" | "shimmer" | "none";
543
+ /**
544
+ * Shared loading contract. Box, Card, ChartCard, Scorecard, Page, SplitPage, and the charts
545
+ * accept it, and custom components can extend it and hand it to a `Box` or `withLoading`.
546
+ */
547
+ export interface LoadingProps {
548
+ /** When true, renders `loadingComponent` in place of the children. */
549
+ loading?: boolean;
550
+ /**
551
+ * Placeholder rendered while `loading` is true, usually built from `Skeleton`, `SkeletonText`,
552
+ * `SkeletonCircle`, `SkeletonCard`, or `SkeletonList`. Each component documents its default.
553
+ */
554
+ loadingComponent?: ReactNode;
555
+ /**
556
+ * Animation for skeletons inside `loadingComponent` that do not set their own `animation`.
557
+ * Falls back to `none` when the OS reduce-motion setting is on.
558
+ * @default "pulse"
559
+ */
560
+ loadingAnimation?: SkeletonAnimation;
561
+ /**
562
+ * Screen reader label announced while loading.
563
+ * @default "Loading"
564
+ */
565
+ loadingLabel?: string;
566
+ }
567
+ export interface SkeletonProps extends WithTestID {
568
+ /**
569
+ * Overrides the nearest `SkeletonGroup` (or loading container) animation.
570
+ * @default "pulse"
571
+ */
572
+ animation?: SkeletonAnimation;
573
+ /**
574
+ * Placeholder fill.
575
+ * @default "neutralExtraLight"
576
+ */
577
+ color?: SurfaceColor;
578
+ /** @default 16 */
579
+ height?: NumberOrPercentage;
580
+ /** @default "sm" */
581
+ rounding?: Rounding | "circle";
582
+ /** @default "100%" */
583
+ width?: NumberOrPercentage;
584
+ }
585
+ export interface SkeletonTextProps extends WithTestID {
586
+ animation?: SkeletonAnimation;
587
+ /**
588
+ * Width of the final line, so a paragraph does not end flush.
589
+ * @default "60%"
590
+ */
591
+ lastLineWidth?: NumberOrPercentage;
592
+ /** @default 3 */
593
+ lines?: number;
594
+ /**
595
+ * Matches the line height of `Text` at this size.
596
+ * @default "md"
597
+ */
598
+ size?: TextSize;
536
599
  }
537
- export interface BoxPropsBase extends WithTestID {
600
+ export interface SkeletonCircleProps extends WithTestID {
601
+ animation?: SkeletonAnimation;
538
602
  /**
539
- * Checked and disabled state for screen readers, sent as `accessibilityState` and as
540
- * `aria-checked` / `aria-disabled`. On a clickable Box, `disabled: true` also stops presses.
603
+ * Diameter in pixels.
604
+ * @default 40
605
+ */
606
+ size?: number;
607
+ }
608
+ export interface SkeletonCardProps extends WithTestID {
609
+ animation?: SkeletonAnimation;
610
+ /** @default 2 */
611
+ lines?: number;
612
+ /**
613
+ * Height of the media block when `showMedia` is true.
614
+ * @default 160
615
+ */
616
+ mediaHeight?: number;
617
+ /** @default true */
618
+ showAvatar?: boolean;
619
+ /** Adds a full-width media block above the text, like a display `Card` with an image. */
620
+ showMedia?: boolean;
621
+ }
622
+ export interface SkeletonListProps extends WithTestID {
623
+ animation?: SkeletonAnimation;
624
+ /**
625
+ * Text lines per row.
626
+ * @default 2
627
+ */
628
+ lines?: number;
629
+ /** @default 3 */
630
+ rows?: number;
631
+ /** @default true */
632
+ showAvatar?: boolean;
633
+ }
634
+ export interface SkeletonGroupProps {
635
+ /**
636
+ * Animation inherited by every skeleton inside the group. Skeletons in one group pulse in sync.
637
+ * @default "pulse"
638
+ */
639
+ animation?: SkeletonAnimation;
640
+ children?: ReactNode;
641
+ }
642
+ export interface BoxPropsBase extends WithTestID, LoadingProps {
643
+ /**
644
+ * Checked, disabled, and selected state for screen readers, sent as `accessibilityState` and as
645
+ * `aria-checked` / `aria-disabled`. `selected` is sent as `aria-selected` on a selectable
646
+ * `accessibilityRole` (`tab`, `option`, `row`, ...) and as `aria-current="true"` on any other Box,
647
+ * such as a clickable list row. On web that row does not also keep `selected` in
648
+ * `accessibilityState`, because react-native-web would emit `aria-selected` on the button.
649
+ * On a clickable Box, `disabled: true` also stops presses.
541
650
  */
542
651
  accessibilityState?: BoxAccessibilityState;
543
652
  /**
@@ -792,6 +901,11 @@ export interface HelperTextProps {
792
901
  }
793
902
  export interface ErrorTextProps {
794
903
  errorText?: string;
904
+ /**
905
+ * Where `errorText` sits relative to the control.
906
+ * @default "above"
907
+ */
908
+ errorPosition?: "above" | "below";
795
909
  }
796
910
  export interface AiSuggestionProps {
797
911
  /**
@@ -820,7 +934,16 @@ export interface TextFieldProps extends BaseFieldProps, HelperTextProps, ErrorTe
820
934
  * @default true
821
935
  */
822
936
  showVisibilityToggle?: boolean;
823
- autoComplete?: "current-password" | "on" | "off" | "username";
937
+ /**
938
+ * Autofill hint. On web it is set as the input's `autocomplete` attribute; `"username webauthn"`
939
+ * asks the browser to offer saved passkeys in the field's autofill. On native it is sent as
940
+ * React Native's `autoComplete` (Android's autofill hint) and as the matching iOS
941
+ * `textContentType`: `username` → `username`, `email` → `emailAddress`, `current-password` →
942
+ * `password`, `new-password` → `newPassword` (iOS offers a strong password), `one-time-code` →
943
+ * `oneTimeCode`, `off` → `none`. Without it (or with `"on"`) the field's `type` picks the iOS
944
+ * hint.
945
+ */
946
+ autoComplete?: "current-password" | "email" | "new-password" | "on" | "off" | "one-time-code" | "username" | "username webauthn";
824
947
  returnKeyType?: "done" | "go" | "next" | "search" | "send";
825
948
  grow?: boolean;
826
949
  /**
@@ -832,7 +955,13 @@ export interface TextFieldProps extends BaseFieldProps, HelperTextProps, ErrorTe
832
955
  rows?: number;
833
956
  inputRef?: (ref: TextInput | null) => void;
834
957
  trimOnBlur?: boolean;
958
+ /** Renders the value in a monospace face with tracking, for codes such as backup codes. */
959
+ mono?: boolean;
835
960
  aiSuggestion?: AiSuggestionProps;
961
+ /**
962
+ * Accessible name for the input. Screen readers otherwise announce "Text input field".
963
+ */
964
+ accessibilityLabel?: string;
836
965
  }
837
966
  export interface TextAreaProps extends Omit<TextFieldProps, "multiline" | "type"> {
838
967
  }
@@ -903,6 +1032,12 @@ export interface HeadingProps extends WithTestID {
903
1032
  align?: "left" | "right" | "center" | "justify";
904
1033
  children?: React.ReactNode;
905
1034
  color?: TextColor;
1035
+ /**
1036
+ * Outline level, 1 for the page title. When set, the heading is exposed to assistive
1037
+ * technology as a heading: `role="heading"` with `aria-level` (an `<h1>`–`<h6>` on web, the
1038
+ * header accessibility role on native). When omitted, the heading is plain text.
1039
+ */
1040
+ level?: 1 | 2 | 3 | 4 | 5 | 6;
906
1041
  overflow?: "normal" | "breakWord";
907
1042
  size?: "sm" | "md" | "lg" | "xl" | "2xl";
908
1043
  truncate?: boolean;
@@ -982,7 +1117,7 @@ export interface LayoutChangeEvent {
982
1117
  export interface SplitPageListItem {
983
1118
  id: string;
984
1119
  }
985
- export interface SplitPageProps<TItem extends SplitPageListItem = SplitPageListItem> {
1120
+ export interface SplitPageProps<TItem extends SplitPageListItem = SplitPageListItem> extends LoadingProps {
986
1121
  /**
987
1122
  * can accept either one React Child or any array of ReactChild. If this is not provided,
988
1123
  * renderContent must return one or many ReactChild.
@@ -1060,6 +1195,77 @@ export interface SplitPageProps<TItem extends SplitPageListItem = SplitPageListI
1060
1195
  */
1061
1196
  childColumnRounding?: Rounding;
1062
1197
  }
1198
+ /**
1199
+ * Props for ListDetailLayout, the route-driven list/detail layout used as a route group's
1200
+ * `_layout.tsx`. The group's `index.tsx` renders `ListDetailIndex`, and a dynamic child route
1201
+ * (default `[id].tsx`) renders the detail.
1202
+ */
1203
+ export interface ListDetailLayoutProps {
1204
+ /**
1205
+ * The list. Rendered in the left pane when split, and by `ListDetailIndex` when not split.
1206
+ */
1207
+ list: ReactElement;
1208
+ /**
1209
+ * Where selecting an item navigates, e.g. `(id) => \`/mail/${id}\``.
1210
+ */
1211
+ detailHref: (id: string) => Href;
1212
+ /**
1213
+ * The group's own path, e.g. `/mail`. `clear()` returns here, and `selectedId` is only read
1214
+ * from routes directly below it.
1215
+ */
1216
+ indexHref: string;
1217
+ /**
1218
+ * Shown in the detail pane when split and no item is open.
1219
+ */
1220
+ emptyDetail?: ReactElement;
1221
+ /**
1222
+ * Split into list and detail panes when the layout's measured width is at least this many
1223
+ * pixels. Defaults to 768.
1224
+ */
1225
+ splitAtWidth?: number;
1226
+ /**
1227
+ * Width in pixels of the list pane when split. Defaults to 360.
1228
+ */
1229
+ listWidth?: number;
1230
+ /**
1231
+ * The child route name that holds the detail. Defaults to `"[id]"`.
1232
+ */
1233
+ detailRoute?: string;
1234
+ /**
1235
+ * The route param that holds the item id. Defaults to `"id"`.
1236
+ */
1237
+ paramName?: string;
1238
+ /**
1239
+ * Screen options passed through to the underlying expo-router Stack.
1240
+ */
1241
+ screenOptions?: ComponentProps<typeof Stack>["screenOptions"];
1242
+ /**
1243
+ * Optional `Stack.Screen` definitions passed through to the underlying expo-router Stack.
1244
+ */
1245
+ children?: React.ReactNode;
1246
+ }
1247
+ /**
1248
+ * The value returned by `useListDetail()` inside a ListDetailLayout.
1249
+ */
1250
+ export interface ListDetailState {
1251
+ /**
1252
+ * True when the list and detail panes are shown side by side.
1253
+ */
1254
+ isSplit: boolean;
1255
+ /**
1256
+ * The id of the open item, read from the detail route. Undefined on the index route.
1257
+ */
1258
+ selectedId?: string;
1259
+ /**
1260
+ * Open an item. Pushes the detail route, or replaces the open detail when split, so back
1261
+ * always returns to the list.
1262
+ */
1263
+ select: (id: string) => void;
1264
+ /**
1265
+ * Close the open item and return to the group's index route.
1266
+ */
1267
+ clear: () => void;
1268
+ }
1063
1269
  export type PermissionKind = "location" | "locationAlways" | "camera" | "microphone" | "photo" | "contacts" | "event" | "reminder" | "bluetooth" | "notification" | "backgroundRefresh" | "speechRecognition" | "mediaLibrary" | "motion";
1064
1270
  export type PermissionStatus = "authorized" | "denied" | "softDenied" | "restricted" | "undetermined";
1065
1271
  export interface AddressInterface {
@@ -1851,6 +2057,10 @@ export interface ButtonProps extends WithTestID {
1851
2057
  * Used for OAuth social login buttons (Google, GitHub, Apple).
1852
2058
  */
1853
2059
  export interface SocialLoginButtonProps extends WithTestID {
2060
+ /**
2061
+ * Accessible name. Defaults to the button text.
2062
+ */
2063
+ accessibilityLabel?: string;
1854
2064
  /**
1855
2065
  * The OAuth provider for the social login.
1856
2066
  */
@@ -1867,10 +2077,16 @@ export interface SocialLoginButtonProps extends WithTestID {
1867
2077
  /**
1868
2078
  * The visual variant of the button.
1869
2079
  * - "primary": Uses the provider's brand colors
1870
- * - "outline": Uses an outline style with neutral colors
2080
+ * - "outline": Neutral outline pill, matching the other sign-in methods
1871
2081
  * @default "primary"
1872
2082
  */
1873
2083
  variant?: "primary" | "outline";
2084
+ /**
2085
+ * When set on the outline variant, highlights the pill and shows this label inside it.
2086
+ */
2087
+ lastUsedLabel?: string;
2088
+ /** Test ID of the last-used label. Requires `lastUsedLabel`. */
2089
+ lastUsedTestID?: string;
1874
2090
  /**
1875
2091
  * If true, the button will be disabled.
1876
2092
  * @default false
@@ -2187,7 +2403,7 @@ export interface NumberPickerActionSheetProps {
2187
2403
  onChange: OnChangeCallback;
2188
2404
  actionSheetRef: React.RefObject<any>;
2189
2405
  }
2190
- export interface PageProps extends WithTestID {
2406
+ export interface PageProps extends WithTestID, LoadingProps {
2191
2407
  navigation?: any;
2192
2408
  scroll?: boolean;
2193
2409
  loading?: boolean;
@@ -2408,7 +2624,7 @@ export interface PaginationProps extends WithTestID {
2408
2624
  setPage: (page: number) => void;
2409
2625
  totalPages: number;
2410
2626
  }
2411
- export interface LineChartProps extends WithTestID {
2627
+ export interface LineChartProps extends WithTestID, LoadingProps {
2412
2628
  /** Summary announced for the whole chart. */
2413
2629
  accessibilityLabel?: string;
2414
2630
  /** Optional previous-period values drawn as a dotted overlay. */
@@ -2423,7 +2639,9 @@ export interface LineChartProps extends WithTestID {
2423
2639
  height?: number;
2424
2640
  /** Series name shown under the plot. */
2425
2641
  legendLabel?: string;
2426
- /** When true, shows a spinner instead of the plot. */
2642
+ /**
2643
+ * When true, shows `loadingComponent` (default: a spinner) instead of the plot.
2644
+ */
2427
2645
  loading?: boolean;
2428
2646
  /** Makes `periodLabel` pressable when provided. */
2429
2647
  onPeriodPress?: () => void;
@@ -2452,7 +2670,11 @@ export interface SparklineChartProps extends WithTestID {
2452
2670
  /** Whole sparkline height in pixels. */
2453
2671
  height?: number;
2454
2672
  }
2455
- export interface ChartCardProps extends WithTestID {
2673
+ /**
2674
+ * While `loading`, the title row stays visible and the body shows `loadingComponent`
2675
+ * (default: a 160px `Skeleton`).
2676
+ */
2677
+ export interface ChartCardProps extends WithTestID, LoadingProps {
2456
2678
  children: React.ReactNode;
2457
2679
  /** Optional context shown below the title row. */
2458
2680
  filterSummary?: string;
@@ -2463,7 +2685,11 @@ export interface ChartCardProps extends WithTestID {
2463
2685
  /** Card heading. */
2464
2686
  title: string;
2465
2687
  }
2466
- export interface ScorecardProps extends WithTestID {
2688
+ /**
2689
+ * While `loading`, the title row stays visible and the value shows `loadingComponent`
2690
+ * (default: a heading-sized `Skeleton`).
2691
+ */
2692
+ export interface ScorecardProps extends WithTestID, LoadingProps {
2467
2693
  /** Optional previous-period sparkline values. */
2468
2694
  comparisonData?: Array<{
2469
2695
  label: string;