@velion-la/onboarding-sdk-react-native 1.4.0-beta.2 → 1.4.0-beta.4

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 (230) hide show
  1. package/CHANGELOG.md +6 -1
  2. package/README.md +22 -1
  3. package/lib/commonjs/camera/AddressSearchBar.js +9 -7
  4. package/lib/commonjs/camera/AddressSearchBar.js.map +1 -1
  5. package/lib/commonjs/camera/DocumentCapture.js +7 -6
  6. package/lib/commonjs/camera/DocumentCapture.js.map +1 -1
  7. package/lib/commonjs/camera/LivenessCamera.js +6 -5
  8. package/lib/commonjs/camera/LivenessCamera.js.map +1 -1
  9. package/lib/commonjs/camera/MapAddressPicker.js +2 -1
  10. package/lib/commonjs/camera/MapAddressPicker.js.map +1 -1
  11. package/lib/commonjs/index.js +6 -0
  12. package/lib/commonjs/index.js.map +1 -1
  13. package/lib/commonjs/steps/AddressInfoStep.js +4 -3
  14. package/lib/commonjs/steps/AddressInfoStep.js.map +1 -1
  15. package/lib/commonjs/steps/DocumentsOcrStep.js +4 -3
  16. package/lib/commonjs/steps/DocumentsOcrStep.js.map +1 -1
  17. package/lib/commonjs/steps/EconomicActivityStep.js +3 -2
  18. package/lib/commonjs/steps/EconomicActivityStep.js.map +1 -1
  19. package/lib/commonjs/steps/EmailOtpStep.js +2 -1
  20. package/lib/commonjs/steps/EmailOtpStep.js.map +1 -1
  21. package/lib/commonjs/steps/FaceMatchStep.js +3 -2
  22. package/lib/commonjs/steps/FaceMatchStep.js.map +1 -1
  23. package/lib/commonjs/steps/LivenessMatchStep.js +3 -2
  24. package/lib/commonjs/steps/LivenessMatchStep.js.map +1 -1
  25. package/lib/commonjs/steps/PhoneOtpStep.js +2 -1
  26. package/lib/commonjs/steps/PhoneOtpStep.js.map +1 -1
  27. package/lib/commonjs/steps/TermsAndConditionsStep.js +3 -2
  28. package/lib/commonjs/steps/TermsAndConditionsStep.js.map +1 -1
  29. package/lib/commonjs/transport/api.js +1 -0
  30. package/lib/commonjs/transport/api.js.map +1 -1
  31. package/lib/commonjs/types/index.js +7 -6
  32. package/lib/commonjs/types/index.js.map +1 -1
  33. package/lib/commonjs/ui/StepShell.js +3 -2
  34. package/lib/commonjs/ui/StepShell.js.map +1 -1
  35. package/lib/commonjs/ui/VelionOnboardingScreen.js +5 -4
  36. package/lib/commonjs/ui/VelionOnboardingScreen.js.map +1 -1
  37. package/lib/commonjs/ui/icons/StepIcon.js +2 -2
  38. package/lib/commonjs/ui/icons/StepIcon.js.map +1 -1
  39. package/lib/commonjs/ui/overlays/AnalyzingOverlay.js +3 -2
  40. package/lib/commonjs/ui/overlays/AnalyzingOverlay.js.map +1 -1
  41. package/lib/commonjs/ui/overlays/LoadingOverlay.js +2 -1
  42. package/lib/commonjs/ui/overlays/LoadingOverlay.js.map +1 -1
  43. package/lib/commonjs/ui/overlays/RetryDialog.js +4 -3
  44. package/lib/commonjs/ui/overlays/RetryDialog.js.map +1 -1
  45. package/lib/commonjs/ui/primitives/BackButton.js +2 -1
  46. package/lib/commonjs/ui/primitives/BackButton.js.map +1 -1
  47. package/lib/commonjs/ui/primitives/Banner.js +3 -2
  48. package/lib/commonjs/ui/primitives/Banner.js.map +1 -1
  49. package/lib/commonjs/ui/primitives/Button.js +8 -5
  50. package/lib/commonjs/ui/primitives/Button.js.map +1 -1
  51. package/lib/commonjs/ui/primitives/Checkbox.js +5 -4
  52. package/lib/commonjs/ui/primitives/Checkbox.js.map +1 -1
  53. package/lib/commonjs/ui/primitives/CountrySelect.js +16 -13
  54. package/lib/commonjs/ui/primitives/CountrySelect.js.map +1 -1
  55. package/lib/commonjs/ui/primitives/DatePicker.js +4 -3
  56. package/lib/commonjs/ui/primitives/DatePicker.js.map +1 -1
  57. package/lib/commonjs/ui/primitives/Input.js +9 -7
  58. package/lib/commonjs/ui/primitives/Input.js.map +1 -1
  59. package/lib/commonjs/ui/primitives/SearchableSingleSelectList.js +8 -6
  60. package/lib/commonjs/ui/primitives/SearchableSingleSelectList.js.map +1 -1
  61. package/lib/commonjs/ui/primitives/Select.js +11 -9
  62. package/lib/commonjs/ui/primitives/Select.js.map +1 -1
  63. package/lib/commonjs/ui/primitives/Text.js +67 -0
  64. package/lib/commonjs/ui/primitives/Text.js.map +1 -0
  65. package/lib/commonjs/ui/primitives/index.js +13 -0
  66. package/lib/commonjs/ui/primitives/index.js.map +1 -1
  67. package/lib/commonjs/ui/theme/ThemeProvider.js +14 -1
  68. package/lib/commonjs/ui/theme/ThemeProvider.js.map +1 -1
  69. package/lib/commonjs/ui/theme/fontLoader.js +77 -0
  70. package/lib/commonjs/ui/theme/fontLoader.js.map +1 -0
  71. package/lib/commonjs/ui/theme/fonts.js +200 -0
  72. package/lib/commonjs/ui/theme/fonts.js.map +1 -0
  73. package/lib/commonjs/ui/theme/index.js +31 -0
  74. package/lib/commonjs/ui/theme/index.js.map +1 -1
  75. package/lib/commonjs/ui/theme/tokens.js +32 -9
  76. package/lib/commonjs/ui/theme/tokens.js.map +1 -1
  77. package/lib/module/camera/AddressSearchBar.js +5 -3
  78. package/lib/module/camera/AddressSearchBar.js.map +1 -1
  79. package/lib/module/camera/DocumentCapture.js +2 -1
  80. package/lib/module/camera/DocumentCapture.js.map +1 -1
  81. package/lib/module/camera/LivenessCamera.js +2 -1
  82. package/lib/module/camera/LivenessCamera.js.map +1 -1
  83. package/lib/module/camera/MapAddressPicker.js +2 -1
  84. package/lib/module/camera/MapAddressPicker.js.map +1 -1
  85. package/lib/module/index.js +1 -1
  86. package/lib/module/index.js.map +1 -1
  87. package/lib/module/steps/AddressInfoStep.js +2 -1
  88. package/lib/module/steps/AddressInfoStep.js.map +1 -1
  89. package/lib/module/steps/DocumentsOcrStep.js +2 -1
  90. package/lib/module/steps/DocumentsOcrStep.js.map +1 -1
  91. package/lib/module/steps/EconomicActivityStep.js +2 -1
  92. package/lib/module/steps/EconomicActivityStep.js.map +1 -1
  93. package/lib/module/steps/EmailOtpStep.js +2 -1
  94. package/lib/module/steps/EmailOtpStep.js.map +1 -1
  95. package/lib/module/steps/FaceMatchStep.js +2 -1
  96. package/lib/module/steps/FaceMatchStep.js.map +1 -1
  97. package/lib/module/steps/LivenessMatchStep.js +2 -1
  98. package/lib/module/steps/LivenessMatchStep.js.map +1 -1
  99. package/lib/module/steps/PhoneOtpStep.js +2 -1
  100. package/lib/module/steps/PhoneOtpStep.js.map +1 -1
  101. package/lib/module/steps/TermsAndConditionsStep.js +2 -1
  102. package/lib/module/steps/TermsAndConditionsStep.js.map +1 -1
  103. package/lib/module/transport/api.js +1 -0
  104. package/lib/module/transport/api.js.map +1 -1
  105. package/lib/module/types/index.js +7 -6
  106. package/lib/module/types/index.js.map +1 -1
  107. package/lib/module/ui/StepShell.js +2 -1
  108. package/lib/module/ui/StepShell.js.map +1 -1
  109. package/lib/module/ui/VelionOnboardingScreen.js +2 -1
  110. package/lib/module/ui/VelionOnboardingScreen.js.map +1 -1
  111. package/lib/module/ui/icons/StepIcon.js +1 -1
  112. package/lib/module/ui/icons/StepIcon.js.map +1 -1
  113. package/lib/module/ui/overlays/AnalyzingOverlay.js +2 -1
  114. package/lib/module/ui/overlays/AnalyzingOverlay.js.map +1 -1
  115. package/lib/module/ui/overlays/LoadingOverlay.js +2 -1
  116. package/lib/module/ui/overlays/LoadingOverlay.js.map +1 -1
  117. package/lib/module/ui/overlays/RetryDialog.js +2 -1
  118. package/lib/module/ui/overlays/RetryDialog.js.map +1 -1
  119. package/lib/module/ui/primitives/BackButton.js +2 -1
  120. package/lib/module/ui/primitives/BackButton.js.map +1 -1
  121. package/lib/module/ui/primitives/Banner.js +2 -1
  122. package/lib/module/ui/primitives/Banner.js.map +1 -1
  123. package/lib/module/ui/primitives/Button.js +7 -4
  124. package/lib/module/ui/primitives/Button.js.map +1 -1
  125. package/lib/module/ui/primitives/Checkbox.js +2 -1
  126. package/lib/module/ui/primitives/Checkbox.js.map +1 -1
  127. package/lib/module/ui/primitives/CountrySelect.js +8 -5
  128. package/lib/module/ui/primitives/CountrySelect.js.map +1 -1
  129. package/lib/module/ui/primitives/DatePicker.js +2 -1
  130. package/lib/module/ui/primitives/DatePicker.js.map +1 -1
  131. package/lib/module/ui/primitives/Input.js +6 -4
  132. package/lib/module/ui/primitives/Input.js.map +1 -1
  133. package/lib/module/ui/primitives/SearchableSingleSelectList.js +5 -3
  134. package/lib/module/ui/primitives/SearchableSingleSelectList.js.map +1 -1
  135. package/lib/module/ui/primitives/Select.js +5 -3
  136. package/lib/module/ui/primitives/Select.js.map +1 -1
  137. package/lib/module/ui/primitives/Text.js +65 -0
  138. package/lib/module/ui/primitives/Text.js.map +1 -0
  139. package/lib/module/ui/primitives/index.js +1 -0
  140. package/lib/module/ui/primitives/index.js.map +1 -1
  141. package/lib/module/ui/theme/ThemeProvider.js +13 -1
  142. package/lib/module/ui/theme/ThemeProvider.js.map +1 -1
  143. package/lib/module/ui/theme/fontLoader.js +70 -0
  144. package/lib/module/ui/theme/fontLoader.js.map +1 -0
  145. package/lib/module/ui/theme/fonts.js +191 -0
  146. package/lib/module/ui/theme/fonts.js.map +1 -0
  147. package/lib/module/ui/theme/index.js +3 -2
  148. package/lib/module/ui/theme/index.js.map +1 -1
  149. package/lib/module/ui/theme/tokens.js +31 -9
  150. package/lib/module/ui/theme/tokens.js.map +1 -1
  151. package/lib/typescript/camera/AddressSearchBar.d.ts.map +1 -1
  152. package/lib/typescript/index.d.ts +1 -1
  153. package/lib/typescript/index.d.ts.map +1 -1
  154. package/lib/typescript/steps/AddressInfoStep.d.ts.map +1 -1
  155. package/lib/typescript/steps/EconomicActivityStep.d.ts.map +1 -1
  156. package/lib/typescript/steps/EmailOtpStep.d.ts.map +1 -1
  157. package/lib/typescript/steps/FaceMatchStep.d.ts.map +1 -1
  158. package/lib/typescript/steps/LivenessMatchStep.d.ts.map +1 -1
  159. package/lib/typescript/steps/PhoneOtpStep.d.ts.map +1 -1
  160. package/lib/typescript/steps/TermsAndConditionsStep.d.ts.map +1 -1
  161. package/lib/typescript/transport/api.d.ts.map +1 -1
  162. package/lib/typescript/types/index.d.ts +35 -7
  163. package/lib/typescript/types/index.d.ts.map +1 -1
  164. package/lib/typescript/ui/StepShell.d.ts.map +1 -1
  165. package/lib/typescript/ui/VelionOnboardingScreen.d.ts.map +1 -1
  166. package/lib/typescript/ui/overlays/LoadingOverlay.d.ts.map +1 -1
  167. package/lib/typescript/ui/overlays/RetryDialog.d.ts.map +1 -1
  168. package/lib/typescript/ui/primitives/BackButton.d.ts.map +1 -1
  169. package/lib/typescript/ui/primitives/Banner.d.ts.map +1 -1
  170. package/lib/typescript/ui/primitives/Button.d.ts +2 -1
  171. package/lib/typescript/ui/primitives/Button.d.ts.map +1 -1
  172. package/lib/typescript/ui/primitives/Checkbox.d.ts.map +1 -1
  173. package/lib/typescript/ui/primitives/CountrySelect.d.ts.map +1 -1
  174. package/lib/typescript/ui/primitives/DatePicker.d.ts.map +1 -1
  175. package/lib/typescript/ui/primitives/Input.d.ts +3 -3
  176. package/lib/typescript/ui/primitives/Input.d.ts.map +1 -1
  177. package/lib/typescript/ui/primitives/SearchableSingleSelectList.d.ts.map +1 -1
  178. package/lib/typescript/ui/primitives/Select.d.ts.map +1 -1
  179. package/lib/typescript/ui/primitives/Text.d.ts +19 -0
  180. package/lib/typescript/ui/primitives/Text.d.ts.map +1 -0
  181. package/lib/typescript/ui/primitives/index.d.ts +1 -0
  182. package/lib/typescript/ui/primitives/index.d.ts.map +1 -1
  183. package/lib/typescript/ui/theme/ThemeProvider.d.ts +7 -0
  184. package/lib/typescript/ui/theme/ThemeProvider.d.ts.map +1 -1
  185. package/lib/typescript/ui/theme/fontLoader.d.ts +28 -0
  186. package/lib/typescript/ui/theme/fontLoader.d.ts.map +1 -0
  187. package/lib/typescript/ui/theme/fonts.d.ts +157 -0
  188. package/lib/typescript/ui/theme/fonts.d.ts.map +1 -0
  189. package/lib/typescript/ui/theme/index.d.ts +3 -2
  190. package/lib/typescript/ui/theme/index.d.ts.map +1 -1
  191. package/lib/typescript/ui/theme/tokens.d.ts +25 -2
  192. package/lib/typescript/ui/theme/tokens.d.ts.map +1 -1
  193. package/package.json +2 -1
  194. package/src/camera/AddressSearchBar.tsx +3 -4
  195. package/src/camera/DocumentCapture.tsx +1 -1
  196. package/src/camera/LivenessCamera.tsx +1 -1
  197. package/src/camera/MapAddressPicker.tsx +1 -1
  198. package/src/index.ts +2 -0
  199. package/src/steps/AddressInfoStep.tsx +6 -1
  200. package/src/steps/DocumentsOcrStep.tsx +1 -1
  201. package/src/steps/EconomicActivityStep.tsx +6 -1
  202. package/src/steps/EmailOtpStep.tsx +6 -1
  203. package/src/steps/FaceMatchStep.tsx +6 -1
  204. package/src/steps/LivenessMatchStep.tsx +7 -1
  205. package/src/steps/PhoneOtpStep.tsx +6 -1
  206. package/src/steps/TermsAndConditionsStep.tsx +7 -1
  207. package/src/transport/api.ts +1 -0
  208. package/src/types/index.ts +35 -7
  209. package/src/ui/StepShell.tsx +6 -1
  210. package/src/ui/VelionOnboardingScreen.tsx +5 -1
  211. package/src/ui/icons/StepIcon.tsx +1 -1
  212. package/src/ui/overlays/AnalyzingOverlay.tsx +1 -1
  213. package/src/ui/overlays/LoadingOverlay.tsx +7 -1
  214. package/src/ui/overlays/RetryDialog.tsx +5 -1
  215. package/src/ui/primitives/BackButton.tsx +5 -1
  216. package/src/ui/primitives/Banner.tsx +5 -1
  217. package/src/ui/primitives/Button.tsx +5 -4
  218. package/src/ui/primitives/Checkbox.tsx +5 -1
  219. package/src/ui/primitives/CountrySelect.tsx +5 -6
  220. package/src/ui/primitives/DatePicker.tsx +7 -1
  221. package/src/ui/primitives/Input.tsx +6 -6
  222. package/src/ui/primitives/SearchableSingleSelectList.tsx +3 -4
  223. package/src/ui/primitives/Select.tsx +3 -3
  224. package/src/ui/primitives/Text.tsx +66 -0
  225. package/src/ui/primitives/index.ts +1 -0
  226. package/src/ui/theme/ThemeProvider.tsx +15 -2
  227. package/src/ui/theme/fontLoader.ts +92 -0
  228. package/src/ui/theme/fonts.ts +220 -0
  229. package/src/ui/theme/index.ts +9 -0
  230. package/src/ui/theme/tokens.ts +44 -6
@@ -10,7 +10,13 @@
10
10
  */
11
11
 
12
12
  import { useCallback, useEffect, useMemo, useState } from 'react';
13
- import { Linking, Pressable, StyleSheet, Text, View } from 'react-native';
13
+ import {
14
+ Linking,
15
+ Pressable,
16
+ StyleSheet,
17
+ View,
18
+ } from 'react-native';
19
+ import { Text } from '../ui/primitives/Text';
14
20
  import {
15
21
  SdkErrorCode,
16
22
  type SdkError,
@@ -127,6 +127,7 @@ export function createApiCaller(
127
127
  ...extra,
128
128
  Authorization: `Bearer ${currentToken}`,
129
129
  'X-Velion-SDK-Version': SDK_VERSION,
130
+ 'X-Velion-Client': `sdk-react-native/${SDK_VERSION}`,
130
131
  ...(appId !== null && { 'X-App-Id': appId }),
131
132
  };
132
133
  }
@@ -421,16 +421,17 @@ export interface SdkError {
421
421
  // ─────────────────────────────────────────────────────────────────────────────
422
422
 
423
423
  /**
424
- * White-labeling theme configuration.
425
- * Each property maps to a CSS custom property injected on the SDK container,
426
- * making all SDK UI elements styleable via `--vl-*` variables.
424
+ * White-labeling theme configuration. Same keys as the web SDK's
425
+ * `VelionTheme`, so one workflow appearance renders alike on web and mobile.
427
426
  *
428
427
  * @example
429
428
  * ```typescript
430
429
  * const theme: VelionTheme = {
431
- * primaryColor: '#0052CC', // → --vl-primary-color
432
- * borderRadius: '12px', // → --vl-border-radius
433
- * fontFamily: 'Inter, sans-serif'// → --vl-font-family
430
+ * primaryColor: '#0052CC',
431
+ * borderRadius: '12px',
432
+ * fontFamily: 'inter',
433
+ * inputHeight: '48px',
434
+ * buttonHeight: '52px',
434
435
  * };
435
436
  * ```
436
437
  */
@@ -447,7 +448,20 @@ export interface VelionTheme {
447
448
  textSecondaryColor?: string;
448
449
  /** Border radius for cards, buttons, and inputs. */
449
450
  borderRadius?: string;
450
- /** Font family string. Must be available in the host page's CSS context. */
451
+ /**
452
+ * Font every SDK text renders with, by id from the closed catalog:
453
+ * `'system'` (default), `'inter'`, `'roboto'`, `'open-sans'`, `'montserrat'`,
454
+ * `'poppins'`, `'nunito'`, `'source-sans-3'`, `'work-sans'`,
455
+ * `'ibm-plex-sans'`, `'dm-sans'` (see `VELION_FONT_IDS`).
456
+ *
457
+ * The SDK downloads the font with `expo-font`; texts use the system font
458
+ * until it is loaded, and keep it if the download fails. The Google Fonts
459
+ * name works too (`'Open Sans'`), and only the first family of a CSS stack
460
+ * counts. Any other value renders with the system font: the SDK never loads
461
+ * a font from a URL in the configuration.
462
+ *
463
+ * @default 'system'
464
+ */
451
465
  fontFamily?: string;
452
466
  /** Color used for error states and destructive actions. */
453
467
  errorColor?: string;
@@ -459,6 +473,20 @@ export interface VelionTheme {
459
473
  borderColor?: string;
460
474
  /** Box shadow definition for elevated elements (cards, modals). */
461
475
  cardShadow?: string;
476
+ /**
477
+ * Minimum height of text inputs, selects and search fields, as a pixel
478
+ * length (`'48px'`). Taller content (a wrapped value) still grows the field.
479
+ *
480
+ * @default '44px'
481
+ */
482
+ inputHeight?: string;
483
+ /**
484
+ * Minimum height of the SDK's buttons (primary, secondary and ghost), as a
485
+ * pixel length (`'48px'`). A label that wraps still grows the button.
486
+ *
487
+ * @default '44px'
488
+ */
489
+ buttonHeight?: string;
462
490
  /**
463
491
  * When true, the SDK omits the round colored icon next to each step's
464
492
  * title — only the title + subtitle are rendered. Useful for hosts that
@@ -8,7 +8,12 @@
8
8
 
9
9
  import type { ReactNode } from 'react';
10
10
  import { useRef } from 'react';
11
- import { Animated, StyleSheet, Text, View } from 'react-native';
11
+ import {
12
+ Animated,
13
+ StyleSheet,
14
+ View,
15
+ } from 'react-native';
16
+ import { Text } from './primitives/Text';
12
17
  import Svg, {
13
18
  Defs,
14
19
  LinearGradient as SvgLinearGradient,
@@ -15,7 +15,11 @@ import React, {
15
15
  useState,
16
16
  type ReactNode,
17
17
  } from 'react';
18
- import { StyleSheet, Text, View } from 'react-native';
18
+ import {
19
+ StyleSheet,
20
+ View,
21
+ } from 'react-native';
22
+ import { Text } from './primitives/Text';
19
23
  import { VelionOnboarding, type VelionConfig } from '../core/VelionOnboarding';
20
24
  import type {
21
25
  OnboardingExit,
@@ -16,7 +16,7 @@
16
16
  */
17
17
 
18
18
  import type { ReactElement } from 'react';
19
- import { Text } from 'react-native';
19
+ import { Text } from '../primitives/Text';
20
20
  import { log } from '../../utils/log';
21
21
 
22
22
  export type MaterialIconName =
@@ -17,10 +17,10 @@ import {
17
17
  Animated,
18
18
  Easing,
19
19
  StyleSheet,
20
- Text,
21
20
  useWindowDimensions,
22
21
  View,
23
22
  } from 'react-native';
23
+ import { Text } from '../primitives/Text';
24
24
  import Svg, { Circle, Path } from 'react-native-svg';
25
25
 
26
26
  import { useTheme, withAlpha } from '../theme';
@@ -14,7 +14,13 @@
14
14
  */
15
15
 
16
16
  import { useEffect, useRef } from 'react';
17
- import { Animated, Easing, StyleSheet, Text, View } from 'react-native';
17
+ import {
18
+ Animated,
19
+ Easing,
20
+ StyleSheet,
21
+ View,
22
+ } from 'react-native';
23
+ import { Text } from '../primitives/Text';
18
24
  import { useReducedMotion, useTheme } from '../theme';
19
25
 
20
26
  export interface LoadingOverlayProps {
@@ -6,7 +6,11 @@
6
6
  * recover without losing their inputs.
7
7
  */
8
8
 
9
- import { StyleSheet, Text, View } from 'react-native';
9
+ import {
10
+ StyleSheet,
11
+ View,
12
+ } from 'react-native';
13
+ import { Text } from '../primitives/Text';
10
14
  import { Button } from '../primitives/Button';
11
15
  import { mixHex, useTheme, withAlpha } from '../theme';
12
16
 
@@ -11,7 +11,11 @@
11
11
  * is unavailable the icon falls back gracefully and only the label shows.
12
12
  */
13
13
 
14
- import { Pressable, StyleSheet, Text } from 'react-native';
14
+ import {
15
+ Pressable,
16
+ StyleSheet,
17
+ } from 'react-native';
18
+ import { Text } from './Text';
15
19
  import { useTheme, withAlpha } from '../theme';
16
20
  import { StepIcon } from '../icons/StepIcon';
17
21
 
@@ -3,7 +3,11 @@
3
3
  * inline warning icon (single "!" character to keep zero asset dependencies).
4
4
  */
5
5
 
6
- import { StyleSheet, Text, View } from 'react-native';
6
+ import {
7
+ StyleSheet,
8
+ View,
9
+ } from 'react-native';
10
+ import { Text } from './Text';
7
11
  import { mixHex, useTheme } from '../theme';
8
12
 
9
13
  export interface BannerProps {
@@ -6,7 +6,8 @@
6
6
  * - Secondary: filled with `secondaryColor`.
7
7
  * - Ghost: transparent with border + text in `textColor`.
8
8
  *
9
- * 44 px min tap target (Apple HIG / WCAG 2.5.5). Disabled state dims at 0.45
9
+ * Min height from `theme.buttonHeight` (44 px by default, the Apple HIG /
10
+ * WCAG 2.5.5 tap target). Disabled state dims at 0.45
10
11
  * opacity (matches `.vl-btn:disabled`).
11
12
  */
12
13
 
@@ -15,12 +16,12 @@ import {
15
16
  ActivityIndicator,
16
17
  Pressable,
17
18
  StyleSheet,
18
- Text,
19
19
  View,
20
20
  type GestureResponderEvent,
21
21
  type StyleProp,
22
22
  type ViewStyle,
23
23
  } from 'react-native';
24
+ import { Text } from './Text';
24
25
  import { useTheme, withAlpha } from '../theme';
25
26
 
26
27
  export type ButtonVariant = 'primary' | 'secondary' | 'ghost';
@@ -66,6 +67,7 @@ export function Button({
66
67
  testID={testID}
67
68
  style={({ pressed }) => [
68
69
  styles.base,
70
+ { minHeight: theme.buttonHeightPx },
69
71
  { borderRadius: theme.borderRadiusPx },
70
72
  variantStyles.container,
71
73
  fullWidth && styles.fullWidth,
@@ -136,9 +138,8 @@ function buildVariantStyles(
136
138
 
137
139
  const styles = StyleSheet.create({
138
140
  base: {
139
- minHeight: 44,
140
141
  paddingHorizontal: 16,
141
- paddingVertical: 10,
142
+ paddingVertical: 8,
142
143
  borderWidth: 1,
143
144
  alignItems: 'center',
144
145
  justifyContent: 'center',
@@ -9,7 +9,11 @@
9
9
  * No external icon dependency: the check is a tinted square with a "✓" glyph.
10
10
  */
11
11
 
12
- import { StyleSheet, Text, View } from 'react-native';
12
+ import {
13
+ StyleSheet,
14
+ View,
15
+ } from 'react-native';
16
+ import { Text } from './Text';
13
17
  import { Pressable } from 'react-native';
14
18
  import { mixHex, useTheme } from '../theme';
15
19
 
@@ -18,12 +18,11 @@ import {
18
18
  Modal,
19
19
  Pressable,
20
20
  StyleSheet,
21
- Text,
22
- TextInput,
23
21
  View,
24
22
  type StyleProp,
25
23
  type ViewStyle,
26
24
  } from 'react-native';
25
+ import { Text, TextInput } from './Text';
27
26
  import { useTheme, withAlpha } from '../theme';
28
27
  import {
29
28
  filterIso3166Countries,
@@ -116,6 +115,7 @@ export function CountrySelect({
116
115
  onPress={() => setOpen(true)}
117
116
  style={[
118
117
  styles.trigger,
118
+ { minHeight: theme.inputHeightPx },
119
119
  {
120
120
  backgroundColor: theme.backgroundColor,
121
121
  borderColor: hasError ? theme.errorColor : theme.borderColor,
@@ -179,6 +179,7 @@ export function CountrySelect({
179
179
  onChangeText={setQuery}
180
180
  style={[
181
181
  styles.search,
182
+ { minHeight: theme.inputHeightPx },
182
183
  {
183
184
  color: theme.textColor,
184
185
  backgroundColor: theme.backgroundColor,
@@ -270,9 +271,8 @@ const styles = StyleSheet.create({
270
271
  fontWeight: '400',
271
272
  },
272
273
  trigger: {
273
- minHeight: 44,
274
274
  paddingHorizontal: 12,
275
- paddingVertical: 10,
275
+ paddingVertical: 8,
276
276
  borderWidth: 1,
277
277
  flexDirection: 'row',
278
278
  alignItems: 'center',
@@ -316,9 +316,8 @@ const styles = StyleSheet.create({
316
316
  marginBottom: 8,
317
317
  },
318
318
  search: {
319
- minHeight: 44,
320
319
  paddingHorizontal: 12,
321
- paddingVertical: 10,
320
+ paddingVertical: 8,
322
321
  fontSize: 15,
323
322
  borderWidth: 1,
324
323
  marginBottom: 8,
@@ -22,7 +22,13 @@
22
22
  */
23
23
 
24
24
  import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
25
- import { StyleSheet, Text, View, type StyleProp, type ViewStyle } from 'react-native';
25
+ import {
26
+ StyleSheet,
27
+ View,
28
+ type StyleProp,
29
+ type ViewStyle,
30
+ } from 'react-native';
31
+ import { Text } from './Text';
26
32
  import { useTheme } from '../theme';
27
33
  import { Select, type SelectOption } from './Select';
28
34
 
@@ -2,7 +2,7 @@
2
2
  * Themed text input with optional inline error message.
3
3
  *
4
4
  * Matches `.vl-hbi__input` semantics:
5
- * - 44 px min height tap target.
5
+ * - Min height from `theme.inputHeight` (44 px by default, the tap target).
6
6
  * - Border switches to `errorColor` and a subtle ring when `errorMessage` is set.
7
7
  * - Pairs an externally controlled label rendered above (see `<Field>` helper).
8
8
  */
@@ -10,13 +10,13 @@
10
10
  import { forwardRef, useId } from 'react';
11
11
  import {
12
12
  StyleSheet,
13
- Text,
14
- TextInput,
15
13
  View,
16
14
  type StyleProp,
15
+ type TextInput as RNTextInput,
17
16
  type TextInputProps,
18
17
  type ViewStyle,
19
18
  } from 'react-native';
19
+ import { Text, TextInput } from './Text';
20
20
  import { useTheme } from '../theme';
21
21
 
22
22
  export interface InputProps extends Omit<TextInputProps, 'style'> {
@@ -26,7 +26,7 @@ export interface InputProps extends Omit<TextInputProps, 'style'> {
26
26
  containerStyle?: StyleProp<ViewStyle>;
27
27
  }
28
28
 
29
- export const Input = forwardRef<TextInput, InputProps>(function Input(
29
+ export const Input = forwardRef<RNTextInput, InputProps>(function Input(
30
30
  { label, errorMessage, required, containerStyle, ...rest },
31
31
  ref,
32
32
  ) {
@@ -55,6 +55,7 @@ export const Input = forwardRef<TextInput, InputProps>(function Input(
55
55
  {...rest}
56
56
  style={[
57
57
  styles.input,
58
+ { minHeight: theme.inputHeightPx },
58
59
  {
59
60
  color: theme.textColor,
60
61
  backgroundColor: theme.backgroundColor,
@@ -96,9 +97,8 @@ const styles = StyleSheet.create({
96
97
  fontWeight: '400',
97
98
  },
98
99
  input: {
99
- minHeight: 44,
100
100
  paddingHorizontal: 12,
101
- paddingVertical: 10,
101
+ paddingVertical: 8,
102
102
  fontSize: 15,
103
103
  borderWidth: 1,
104
104
  },
@@ -21,12 +21,11 @@ import {
21
21
  FlatList,
22
22
  Pressable,
23
23
  StyleSheet,
24
- Text,
25
- TextInput,
26
24
  View,
27
25
  type StyleProp,
28
26
  type ViewStyle,
29
27
  } from 'react-native';
28
+ import { Text, TextInput } from './Text';
30
29
  import { useTheme, withAlpha } from '../theme';
31
30
  import {
32
31
  filterSearchableOptions,
@@ -79,6 +78,7 @@ export function SearchableSingleSelectList({
79
78
  onChangeText={setQuery}
80
79
  style={[
81
80
  styles.search,
81
+ { minHeight: theme.inputHeightPx },
82
82
  {
83
83
  color: theme.textColor,
84
84
  backgroundColor: theme.backgroundColor,
@@ -155,9 +155,8 @@ const styles = StyleSheet.create({
155
155
  width: '100%',
156
156
  },
157
157
  search: {
158
- minHeight: 44,
159
158
  paddingHorizontal: 12,
160
- paddingVertical: 10,
159
+ paddingVertical: 8,
161
160
  fontSize: 15,
162
161
  borderWidth: 1,
163
162
  marginBottom: 8,
@@ -13,11 +13,11 @@ import {
13
13
  Pressable,
14
14
  ScrollView,
15
15
  StyleSheet,
16
- Text,
17
16
  View,
18
17
  type StyleProp,
19
18
  type ViewStyle,
20
19
  } from 'react-native';
20
+ import { Text } from './Text';
21
21
  import { useTheme, withAlpha } from '../theme';
22
22
 
23
23
  export interface SelectOption {
@@ -78,6 +78,7 @@ export function Select({
78
78
  onPress={() => setOpen(true)}
79
79
  style={[
80
80
  styles.trigger,
81
+ { minHeight: theme.inputHeightPx },
81
82
  {
82
83
  backgroundColor: theme.backgroundColor,
83
84
  borderColor: hasError ? theme.errorColor : theme.borderColor,
@@ -199,9 +200,8 @@ const styles = StyleSheet.create({
199
200
  fontWeight: '400',
200
201
  },
201
202
  trigger: {
202
- minHeight: 44,
203
203
  paddingHorizontal: 12,
204
- paddingVertical: 10,
204
+ paddingVertical: 8,
205
205
  borderWidth: 1,
206
206
  flexDirection: 'row',
207
207
  alignItems: 'center',
@@ -0,0 +1,66 @@
1
+ /**
2
+ * @fileoverview Themed `Text` and `TextInput` (OSDKR-45).
3
+ *
4
+ * Drop-in replacements for the React Native components that render with the
5
+ * theme's catalog font. Every SDK text goes through them — a test fails if a
6
+ * file imports `Text` or `TextInput` from `react-native` directly — so the
7
+ * font configured in `VelionTheme.fontFamily` reaches all of them.
8
+ *
9
+ * The face is picked from the text's own `fontWeight`, or from the enclosing
10
+ * `Text`'s when a nested one sets none (React Native inherits the weight, but
11
+ * a nested text names its own face, so the weight has to travel with it).
12
+ * With no catalog font
13
+ * loaded (or outside a `ThemeProvider`) they behave exactly like the React
14
+ * Native components.
15
+ */
16
+
17
+ import { createContext, forwardRef, useContext } from 'react';
18
+ import {
19
+ StyleSheet,
20
+ Text as RNText,
21
+ TextInput as RNTextInput,
22
+ type TextInputProps,
23
+ type TextProps,
24
+ } from 'react-native';
25
+ import { fontStyleFor } from '../theme/fonts';
26
+ import { useOptionalTheme } from '../theme/ThemeProvider';
27
+
28
+ /** `fontWeight` of the enclosing `Text`, for nested texts that set none. */
29
+ const InheritedWeight = createContext<unknown>(undefined);
30
+
31
+ export const Text = forwardRef<RNText, TextProps>(function Text(
32
+ { style, children, ...rest },
33
+ ref,
34
+ ) {
35
+ const fontId = useOptionalTheme()?.fontId ?? null;
36
+ const inheritedWeight = useContext(InheritedWeight);
37
+ if (!fontId) {
38
+ return (
39
+ <RNText ref={ref} {...rest} style={style}>
40
+ {children}
41
+ </RNText>
42
+ );
43
+ }
44
+ const weight = StyleSheet.flatten(style)?.fontWeight ?? inheritedWeight;
45
+ return (
46
+ <RNText ref={ref} {...rest} style={[style, fontStyleFor(fontId, weight)]}>
47
+ <InheritedWeight.Provider value={weight}>{children}</InheritedWeight.Provider>
48
+ </RNText>
49
+ );
50
+ });
51
+
52
+ export const TextInput = forwardRef<RNTextInput, TextInputProps>(
53
+ function TextInput({ style, ...rest }, ref) {
54
+ const fontId = useOptionalTheme()?.fontId ?? null;
55
+ const fontStyle = fontId
56
+ ? fontStyleFor(fontId, StyleSheet.flatten(style)?.fontWeight)
57
+ : undefined;
58
+ return (
59
+ <RNTextInput
60
+ ref={ref}
61
+ {...rest}
62
+ style={fontStyle ? [style, fontStyle] : style}
63
+ />
64
+ );
65
+ },
66
+ );
@@ -1,3 +1,4 @@
1
+ export { Text, TextInput } from './Text';
1
2
  export { Button, type ButtonProps, type ButtonVariant } from './Button';
2
3
  export { BackButton, type BackButtonProps } from './BackButton';
3
4
  export { Input, type InputProps } from './Input';
@@ -4,6 +4,8 @@
4
4
  * - `ThemeProvider` resolves tokens from `VelionConfig.theme` + colorMode and
5
5
  * exposes them to descendants.
6
6
  * - `useTheme()` returns the active `ResolvedTheme`.
7
+ * - The catalog font named by `fontFamily` is loaded here (`useCatalogFont`)
8
+ * and exposed as `theme.fontId` once it is usable.
7
9
  * - `useReducedMotion()` honours the OS-level `prefers-reduced-motion` flag —
8
10
  * components disable animations when true.
9
11
  */
@@ -19,6 +21,7 @@ import React, {
19
21
  import { AccessibilityInfo, useColorScheme } from 'react-native';
20
22
  import type { VelionTheme } from '../../types';
21
23
  import { resolveTheme, type ResolvedTheme } from './tokens';
24
+ import { useCatalogFont } from './fontLoader';
22
25
 
23
26
  interface ThemeContextValue {
24
27
  theme: ResolvedTheme;
@@ -48,9 +51,11 @@ export function ThemeProvider({
48
51
  return systemScheme === 'dark' ? 'dark' : 'light';
49
52
  }, [colorMode, systemScheme]);
50
53
 
54
+ const loadedFontId = useCatalogFont(themeOverrides?.fontFamily);
55
+
51
56
  const theme = useMemo(
52
- () => resolveTheme(themeOverrides, resolvedMode),
53
- [themeOverrides, resolvedMode],
57
+ () => resolveTheme(themeOverrides, resolvedMode, loadedFontId),
58
+ [themeOverrides, resolvedMode, loadedFontId],
54
59
  );
55
60
 
56
61
  const value = useMemo<ThemeContextValue>(
@@ -73,6 +78,14 @@ export function useTheme(): ResolvedTheme {
73
78
  return ctx.theme;
74
79
  }
75
80
 
81
+ /**
82
+ * Like `useTheme`, but `null` outside a `ThemeProvider` instead of throwing.
83
+ * For primitives that must also render where no provider is mounted.
84
+ */
85
+ export function useOptionalTheme(): ResolvedTheme | null {
86
+ return useContext(ThemeContext)?.theme ?? null;
87
+ }
88
+
76
89
  export function useReducedMotion(): boolean {
77
90
  const ctx = useContext(ThemeContext);
78
91
  return ctx?.reduceMotion ?? false;
@@ -0,0 +1,92 @@
1
+ /**
2
+ * @fileoverview Loads the theme's catalog font with `expo-font` (OSDKR-45).
3
+ *
4
+ * `useCatalogFont` returns the catalog id only once every face is registered,
5
+ * so `ThemeProvider` never hands texts a family the platform does not have.
6
+ * Until then — and for good if the download fails — texts use the system font.
7
+ */
8
+
9
+ import { useEffect, useState } from 'react';
10
+ import * as ExpoFont from 'expo-font';
11
+ import { log } from '../../utils/log';
12
+ import {
13
+ fontSources,
14
+ resolveFontId,
15
+ type VelionCatalogFontId,
16
+ } from './fonts';
17
+
18
+ /** The slice of `expo-font` the loader uses; injectable for tests. */
19
+ export interface FontApi {
20
+ isLoaded(fontFamily: string): boolean;
21
+ loadAsync(fontMap: Record<string, string>): Promise<void>;
22
+ }
23
+
24
+ const expoFontApi: FontApi = {
25
+ isLoaded: (fontFamily) => ExpoFont.isLoaded(fontFamily),
26
+ loadAsync: (fontMap) => ExpoFont.loadAsync(fontMap),
27
+ };
28
+
29
+ /** True when every face of the font is already registered. */
30
+ export function isCatalogFontLoaded(
31
+ fontId: VelionCatalogFontId,
32
+ api: FontApi = expoFontApi,
33
+ ): boolean {
34
+ return Object.keys(fontSources(fontId)).every((face) => api.isLoaded(face));
35
+ }
36
+
37
+ /**
38
+ * Registers every face of the font. Resolves `true` when they are all usable
39
+ * and `false` when the download failed; it never rejects, because a missing
40
+ * font must not break the flow.
41
+ */
42
+ export async function loadCatalogFont(
43
+ fontId: VelionCatalogFontId,
44
+ api: FontApi = expoFontApi,
45
+ ): Promise<boolean> {
46
+ if (isCatalogFontLoaded(fontId, api)) return true;
47
+ try {
48
+ await api.loadAsync(fontSources(fontId));
49
+ return true;
50
+ } catch (error) {
51
+ log.warn(
52
+ `Could not load font "${fontId}"; using the system font.`,
53
+ error,
54
+ );
55
+ return false;
56
+ }
57
+ }
58
+
59
+ /**
60
+ * Resolves `fontFamily` against the catalog and loads it. Returns the id once
61
+ * the font is usable, `null` while it loads, when it failed, or when the value
62
+ * is not a catalog font.
63
+ */
64
+ export function useCatalogFont(
65
+ fontFamily: string | undefined,
66
+ ): VelionCatalogFontId | null {
67
+ const fontId = resolveFontId(fontFamily);
68
+ const [loadedFontId, setLoadedFontId] = useState<VelionCatalogFontId | null>(
69
+ () => (fontId && isCatalogFontLoaded(fontId) ? fontId : null),
70
+ );
71
+
72
+ useEffect(() => {
73
+ if (!fontId) {
74
+ if (fontFamily && fontFamily.trim().toLowerCase() !== 'system') {
75
+ log.warn(
76
+ `Font "${fontFamily}" is not in the SDK font catalog; using the system font.`,
77
+ );
78
+ }
79
+ setLoadedFontId(null);
80
+ return undefined;
81
+ }
82
+ let active = true;
83
+ loadCatalogFont(fontId).then((loaded) => {
84
+ if (active) setLoadedFontId(loaded ? fontId : null);
85
+ });
86
+ return () => {
87
+ active = false;
88
+ };
89
+ }, [fontId, fontFamily]);
90
+
91
+ return loadedFontId === fontId ? loadedFontId : null;
92
+ }