@tesouro/embedded-components-react 0.2.133 → 0.2.148

package/README.md

@@ -162,13 +162,14 @@ listed here.
 
 ### AcceptDisclosuresWidget
 
-A self-contained widget for reviewing and accepting required disclosures. This is a scaffold export; disclosures UI and data hooks will land in follow-up work.
+A self-contained widget for reviewing and accepting required banking disclosures. Renders an inline bordered card with disclosure links, an agreement checkbox, and an Accept action. White-label copy and link URLs come from the widget init tenant identity (or an optional `whiteLabelKey`); acceptance is local-only until network wiring lands.
 
 #### Props
 
-| Prop     | Type                                     | Default | Description                                     |
-| -------- | ---------------------------------------- | ------- | ----------------------------------------------- |
-| `labels` | `Partial<AcceptDisclosuresWidgetLabels>` | —       | Override shell copy (currently the stub title). |
+| Prop            | Type                                     | Default | Description                                                                                                                                                                      |
+| --------------- | ---------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `whiteLabelKey` | `'nail-it' \| 'zenith' \| 'suds'`        | —       | Forces a white-label instance. When omitted, resolves from `initResponse` `vspName`/`bankName`. If neither resolves, the widget renders nothing (no demo-tenant legal fallback). |
+| `labels`        | `Partial<AcceptDisclosuresWidgetLabels>` | —       | Override shell copy (title, Accept, link labels, attribution/agreement templates).                                                                                               |
 
 ### BankAccountsWidget
 
@@ -332,25 +333,26 @@ A self-contained widget that lists and manages external bank accounts, including
 | `labels`        | `Partial<LinkedAccountsWidgetLabels>`        | English labels | Overrides visible UI copy such as button, dialog, empty-state, loading, and error labels. Unspecified labels fall back to defaults.                                                         |
 | `featureLabels` | `Partial<LinkedAccountsWidgetFeatureLabels>` | English labels | Overrides strings produced by the feature layer, such as row title fallback, account-number subtitle fragments, and the success toast messages shown after editing or unlinking an account. |
 
-### OnboardingWidget
+### BankAccountOnboardingWidget
 
 A self-contained widget that walks an applicant through the embedded bank-account onboarding flow: business details, personal details, optional additional owners, and a result screen. It owns all REST mutations (`createApplication`, `updateApplication`, `submitApplication`), step navigation, validation, and polling for provisioning to complete — the host application only supplies auth credentials and two callbacks.
 
 #### Props
 
-| Prop                                        | Type                      | Required | Description                                                                                                                                                                                              |
-| ------------------------------------------- | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `onEmbeddedOnboardingCompletedSuccessfully` | `() => void`              | Yes      | Called when the application is submitted and approved.                                                                                                                                                   |
-| `onNavigateToDashboard`                     | `() => void`              | Yes      | Called when the user clicks the dashboard CTA on the result screen.                                                                                                                                      |
-| `open`                                      | `boolean`                 | No       | Controlled open state for the modal. When provided the host owns open/close and must update it via `onOpenChange`. Omit for uncontrolled mode.                                                           |
-| `defaultOpen`                               | `boolean`                 | No       | Initial open state when uncontrolled. Defaults to `true` so the modal renders on mount. Ignored when `open` is set.                                                                                      |
-| `onOpenChange`                              | `(open: boolean) => void` | No       | Notified whenever the modal opens or closes — fires on overlay click, escape key, the close button, and any controlled state update. Used both as the change handler in controlled mode and a side hook. |
-| `labels`                                    | `OnboardingWidgetLabels`  | No       | Per-step label overrides — see Labels section. Accepts a `modalTitle` override for the modal's accessible title (default: `Bank account onboarding`).                                                    |
-| `bankLogoSrc`                               | `string`                  | No       | URL for the bank logo rendered on the result screen; falls back to bank name text.                                                                                                                       |
-| `termsHref`                                 | `string`                  | No       | URL for the Terms of Use document linked in step 1.                                                                                                                                                      |
-| `privacyHref`                               | `string`                  | No       | URL for the Privacy Policy document linked in step 1.                                                                                                                                                    |
-| `electronicCommunicationHref`               | `string`                  | No       | URL for the Electronic Communication document linked in step 1.                                                                                                                                          |
-| `patriotActHref`                            | `string`                  | No       | URL for the Patriot Act document linked in step 1.                                                                                                                                                       |
+| Prop                                        | Type                                | Required | Description                                                                                                                                                                                              |
+| ------------------------------------------- | ----------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `onEmbeddedOnboardingCompletedSuccessfully` | `() => void`                        | Yes      | Called when the application is submitted and approved.                                                                                                                                                   |
+| `onNavigateToDashboard`                     | `() => void`                        | Yes      | Called when the user clicks the dashboard CTA on the result screen.                                                                                                                                      |
+| `initialBusinessDetails`                    | `Partial<BusinessDetailsValues>`    | No       | Prefills step 1 (business details). Unset fields start empty; the user can still edit before continuing.                                                                                                 |
+| `initialPersonalDetails`                    | `Partial<PersonalDetailsValues>`    | No       | Prefills step 2 (personal / about-you details). Unset fields start empty; the user can still edit before continuing.                                                                                     |
+| `initialAdditionalOwners`                   | `AdditionalOwner[]`                 | No       | Prefills step 3 (additional owners). Defaults to an empty list when omitted.                                                                                                                             |
+| `open`                                      | `boolean`                           | No       | Controlled open state for the modal. When provided the host owns open/close and must update it via `onOpenChange`. Omit for uncontrolled mode.                                                           |
+| `defaultOpen`                               | `boolean`                           | No       | Initial open state when uncontrolled. Defaults to `false` so the modal stays closed until the host or marketing CTA opens it. Ignored when `open` is set.                                                |
+| `onOpenChange`                              | `(open: boolean) => void`           | No       | Notified whenever the modal opens or closes — fires on overlay click, escape key, the close button, and any controlled state update. Used both as the change handler in controlled mode and a side hook. |
+| `labels`                                    | `BankAccountOnboardingWidgetLabels` | No       | Per-step label overrides — see Labels section. Accepts a `modalTitle` override for the modal's accessible title (default: `Bank account onboarding`).                                                    |
+| `bankLogoSrc`                               | `string`                            | No       | URL for the bank logo rendered on the result screen; falls back to bank name text.                                                                                                                       |
+| `disclosureLinks`                           | `DisclosureLinks`                   | No       | Host-resolved URLs for Terms of Use, Privacy Policy, Electronic Communication, and Patriot Act on the business-details agreement step. Omit to leave those links unset.                                  |
+| `marketingContent`                          | `MarketingWidgetContent \| null`    | No       | Host-resolved marketing card/modal content. When omitted or `null`, the marketing surface is not rendered.                                                                                               |
 
 ### ProductsWidget