@tesouro/embedded-components-react 0.3.25 → 0.3.27

package/README.md

@@ -120,6 +120,7 @@ App-level provider. Resolves `baseUrl` / `widgetToken` / `organizationId` (falli
 | `analytics`                     | `boolean`                                    | Enables anonymous analytics for this provider tree (default `true`). `RootWidgetProvider` is the analytics owner; set `false` to disable capture and skip loading PostHog.                                                                                                                                                                                                       |
 | `unstable_initResponseOverride` | `WidgetInitResponse`                         | First-party hosts only. Skips the `GET /api/widget-gateway/init` fetch and exposes this host-authored object as `initResponse` to the subtree. Use when the host authenticates users directly against the Tesouro issuer and passes the user's bearer access token as `widgetToken`. Embed integrations minting widget JWEs must leave this unset.                               |
 | `disclosuresAcceptance`         | `ReactNode`                                  | Accept surface shown when the caller owes disclosures (`INVITED`, or `REQUIRED` with `disclosuresAccepted: false`). Pass `<AcceptDisclosuresWidget />`. Cascades to nested providers.                                                                                                                                                                                            |
+| `providerLabels`                | `Partial<WidgetProviderLabels>`              | Overrides the copy a provider renders in place of a widget: the error-boundary fallback and the disclosures gate. Any subset; unlisted keys keep their defaults. Cascades to nested providers. See Provider copy.                                                                                                                                              |
 | `children`                      | `ReactNode`                                  | The React subtree that consumes the widget context.                                                                                                                                                                                                                                                                                                                              |
 
 ### `WidgetProvider`
@@ -142,6 +143,7 @@ Mid-tree or standalone provider. With no props it is a transparent pass-through
 | `onError`               | `(error: unknown, info: ErrorInfo) => void`        | Optional telemetry hook. Runs once per caught error before the fallback renders.                                                                                                                                                                                                                                            |
 | `analytics`             | `boolean`                                          | Enables anonymous analytics (default `true`). Honored only when this is a standalone analytics owner (no `RootWidgetProvider` ancestor); on a nested provider it is a no-op.                                                                                                                                                |
 | `disclosuresAcceptance` | `ReactNode`                                        | Accept surface shown when the caller owes disclosures (`INVITED`, or `REQUIRED` with `disclosuresAccepted: false`). Pass `<AcceptDisclosuresWidget />`. When omitted, inherits from the nearest ancestor.                                                                                                                   |
+| `providerLabels`        | `Partial<WidgetProviderLabels>`                    | Overrides the copy this provider renders in place of the widget: the error-boundary fallback and the disclosures gate. Any subset; unlisted keys keep their defaults. When omitted, inherits from the nearest ancestor. See Provider copy.                                                                |
 | `children`              | `ReactNode`                                        | The React subtree that consumes the overridden context.                                                                                                                                                                                                                                                                     |
 
 ### `WidgetTokenRefreshProvider`
@@ -175,6 +177,7 @@ Bundles `WidgetTokenRefreshProvider` + `RootWidgetProvider` and wires the live t
 | `analytics`                     | `RootWidgetProvider`         | Enables anonymous analytics (default `true`); set `false` to disable capture.                                                                     |
 | `unstable_initResponseOverride` | `RootWidgetProvider`         | First-party hosts only. Skips the gateway init fetch and supplies host-authored identity for the subtree.                                         |
 | `disclosuresAcceptance`         | `RootWidgetProvider`         | Accept surface shown when the caller owes disclosures (`INVITED`, or `REQUIRED` with `disclosuresAccepted: false`). Cascades to nested providers. |
+| `providerLabels`                | `RootWidgetProvider`         | Overrides the copy a provider renders in place of a widget (error-boundary fallback, disclosures gate). Any subset. Cascades to nested providers. |
 | `fetcher`                       | `WidgetTokenRefreshProvider` | Required.                                                                                                                                         |
 | `leadSeconds`                   | `WidgetTokenRefreshProvider` | Default `60`.                                                                                                                                     |
 | `onToken`                       | `WidgetTokenRefreshProvider` | Fires once per distinct token; useful for telemetry, persistence, or — for non-React hosts — mirroring the token via `updateGlobalWidgetConfig`.  |

package/dist/experimental/WidgetSuite.d.ts

@@ -595,6 +595,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
     analytics?: boolean;
 }
 
+/**
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
+ * the error-boundary fallback and the disclosures gate. A host overrides any
+ * subset through the `providerLabels` prop, which cascades like
+ * `disclosuresAcceptance`.
+ *
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
+ * different thing, and these two travel together on every widget's props type.
+ */
+interface WidgetProviderLabels {
+    /** Default copy for the built-in error boundary fallback. */
+    errorBoundaryFallback: string;
+    /** Heading when init reports disclosures are required and not yet accepted. */
+    disclosuresRequiredTitle: string;
+    /** Heading while a token-only refresh leaves init stale for the live token. */
+    disclosuresRefreshingTitle: string;
+    /** Supporting copy while the accept action is withheld for a stale init. */
+    disclosuresRefreshingDescription: string;
+}
+
 /**
  * Props for {@link WidgetProvider}.
  *
@@ -607,8 +627,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * Fallback rendered when a render-time exception is caught inside this
      * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
      * render-prop receiving `{ error, resetErrorBoundary }` from
-     * `react-error-boundary`. Default is a plain `role="alert"` div with
-     * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
+     * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
+     * comes from `providerLabels.errorBoundaryFallback`.
      */
     errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
     /**
@@ -625,6 +645,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProvider cannot import the widget itself (cycle).
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy this provider renders in place of the widget: the
+     * built-in error-boundary fallback and the disclosures gate. Any subset;
+     * unlisted keys keep their defaults. Cascades like `linkComponent`.
+     *
+     * Named `providerLabels` rather than `labels` because a widget's own
+     * `labels` prop sits alongside this one on the same props type.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 
 /**
@@ -941,7 +970,7 @@ interface WidgetSuiteProps extends WidgetProviderProps {
  * card list its cursor. That split is the widgets' current shape rather than a
  * decision — see `WidgetSuiteSelection` for the ticket behind each gap.
  */
-declare function WidgetSuite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: WidgetSuiteProps): React.JSX.Element;
+declare function WidgetSuite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: WidgetSuiteProps): React.JSX.Element;
 
 export { WIDGET_SUITE_CONTENT_LABELS_EN, WIDGET_SUITE_DEFAULT_SECTIONS, WIDGET_SUITE_DISCLOSURE_LABELS_EN, WIDGET_SUITE_SECTION_LABELS_EN, WIDGET_SUITE_SECTION_TITLE_LABELS_EN, WIDGET_SUITE_SHELL_LABELS_EN, WidgetSuite, WidgetSuiteSectionId };
 export type { PartialDeep, WidgetSuiteAccountsSelection, WidgetSuiteCardsSelection, WidgetSuiteCardsSelectionSnapshot, WidgetSuiteContentLabels, WidgetSuiteDefaultSelection, WidgetSuiteDisclosureLabels, WidgetSuiteProps, WidgetSuiteSectionLabels, WidgetSuiteSectionTitleLabels, WidgetSuiteSelection, WidgetSuiteSelectionSnapshot, WidgetSuiteSettingsSelection, WidgetSuiteShellLabels };

package/dist/experimental/index.d.ts

@@ -595,6 +595,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
     analytics?: boolean;
 }
 
+/**
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
+ * the error-boundary fallback and the disclosures gate. A host overrides any
+ * subset through the `providerLabels` prop, which cascades like
+ * `disclosuresAcceptance`.
+ *
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
+ * different thing, and these two travel together on every widget's props type.
+ */
+interface WidgetProviderLabels {
+    /** Default copy for the built-in error boundary fallback. */
+    errorBoundaryFallback: string;
+    /** Heading when init reports disclosures are required and not yet accepted. */
+    disclosuresRequiredTitle: string;
+    /** Heading while a token-only refresh leaves init stale for the live token. */
+    disclosuresRefreshingTitle: string;
+    /** Supporting copy while the accept action is withheld for a stale init. */
+    disclosuresRefreshingDescription: string;
+}
+
 /**
  * Props for {@link WidgetProvider}.
  *
@@ -607,8 +627,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * Fallback rendered when a render-time exception is caught inside this
      * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
      * render-prop receiving `{ error, resetErrorBoundary }` from
-     * `react-error-boundary`. Default is a plain `role="alert"` div with
-     * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
+     * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
+     * comes from `providerLabels.errorBoundaryFallback`.
      */
     errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
     /**
@@ -625,6 +645,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProvider cannot import the widget itself (cycle).
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy this provider renders in place of the widget: the
+     * built-in error-boundary fallback and the disclosures gate. Any subset;
+     * unlisted keys keep their defaults. Cascades like `linkComponent`.
+     *
+     * Named `providerLabels` rather than `labels` because a widget's own
+     * `labels` prop sits alongside this one on the same props type.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 
 /**
@@ -941,7 +970,7 @@ interface WidgetSuiteProps extends WidgetProviderProps {
  * card list its cursor. That split is the widgets' current shape rather than a
  * decision — see `WidgetSuiteSelection` for the ticket behind each gap.
  */
-declare function WidgetSuite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: WidgetSuiteProps): React.JSX.Element;
+declare function WidgetSuite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: WidgetSuiteProps): React.JSX.Element;
 
 export { WIDGET_SUITE_CONTENT_LABELS_EN, WIDGET_SUITE_DEFAULT_SECTIONS, WIDGET_SUITE_DISCLOSURE_LABELS_EN, WIDGET_SUITE_SECTION_LABELS_EN, WIDGET_SUITE_SECTION_TITLE_LABELS_EN, WIDGET_SUITE_SHELL_LABELS_EN, WidgetSuite, WidgetSuiteSectionId };
 export type { PartialDeep, WidgetSuiteAccountsSelection, WidgetSuiteCardsSelection, WidgetSuiteCardsSelectionSnapshot, WidgetSuiteContentLabels, WidgetSuiteDefaultSelection, WidgetSuiteDisclosureLabels, WidgetSuiteProps, WidgetSuiteSectionLabels, WidgetSuiteSectionTitleLabels, WidgetSuiteSelection, WidgetSuiteSelectionSnapshot, WidgetSuiteSettingsSelection, WidgetSuiteShellLabels };

package/dist/index.d.ts

@@ -814,6 +814,26 @@ interface WidgetConfig extends WidgetConfigInput {
     initResponse?: WidgetInitResponse;
 }
 
+/**
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
+ * the error-boundary fallback and the disclosures gate. A host overrides any
+ * subset through the `providerLabels` prop, which cascades like
+ * `disclosuresAcceptance`.
+ *
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
+ * different thing, and these two travel together on every widget's props type.
+ */
+interface WidgetProviderLabels {
+    /** Default copy for the built-in error boundary fallback. */
+    errorBoundaryFallback: string;
+    /** Heading when init reports disclosures are required and not yet accepted. */
+    disclosuresRequiredTitle: string;
+    /** Heading while a token-only refresh leaves init stale for the live token. */
+    disclosuresRefreshingTitle: string;
+    /** Supporting copy while the accept action is withheld for a stale init. */
+    disclosuresRefreshingDescription: string;
+}
+
 /**
  * Replaces the global widget config and notifies all reactive subscribers.
  *
@@ -1028,6 +1048,12 @@ interface RootWidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProviders.
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy a descendant `WidgetProvider` renders in place of
+     * its widget: the built-in error-boundary fallback and the disclosures gate.
+     * Any subset; unlisted keys keep their defaults. Cascades to the whole tree.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 /**
  * Top-level provider for the widget config cascade.
@@ -1081,7 +1107,7 @@ interface RootWidgetProviderProps extends WidgetProviderBaseProps {
  * @see {@link useWidgetConfig} to read the resolved config in descendants
  * @see {@link setGlobalWidgetConfig} to push config imperatively from outside React
  */
-declare function RootWidgetProvider({ children, baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, uiFramework, implementation, analytics, unstable_initResponseOverride, disclosuresAcceptance, }: PropsWithChildren<RootWidgetProviderProps>): React.JSX.Element;
+declare function RootWidgetProvider({ children, baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, uiFramework, implementation, analytics, unstable_initResponseOverride, disclosuresAcceptance, providerLabels, }: PropsWithChildren<RootWidgetProviderProps>): React.JSX.Element;
 
 /**
  * Props for {@link WidgetProvider}.
@@ -1095,8 +1121,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * Fallback rendered when a render-time exception is caught inside this
      * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
      * render-prop receiving `{ error, resetErrorBoundary }` from
-     * `react-error-boundary`. Default is a plain `role="alert"` div with
-     * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
+     * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
+     * comes from `providerLabels.errorBoundaryFallback`.
      */
     errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
     /**
@@ -1113,6 +1139,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProvider cannot import the widget itself (cycle).
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy this provider renders in place of the widget: the
+     * built-in error-boundary fallback and the disclosures gate. Any subset;
+     * unlisted keys keep their defaults. Cascades like `linkComponent`.
+     *
+     * Named `providerLabels` rather than `labels` because a widget's own
+     * `labels` prop sits alongside this one on the same props type.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 
 declare const USStateAbbreviation: {
@@ -1490,7 +1525,7 @@ type AcceptDisclosuresWidgetProps = WidgetProviderProps & InnerProps;
  *
  * See `WidgetSuite`, which mounts it as its acceptance state.
  */
-declare function AcceptDisclosuresWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: AcceptDisclosuresWidgetProps): React.JSX.Element;
+declare function AcceptDisclosuresWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: AcceptDisclosuresWidgetProps): React.JSX.Element;
 
 interface Labels$6 {
     bankingTaglinePrefix: string;
@@ -1626,7 +1661,7 @@ interface BankAccountsWidgetProps extends WidgetProviderProps {
     /** Called when the user opens account details or goes back to the list. */
     onSelectedAccountIdChange?: (accountId: string | null) => void;
 }
-declare function BankAccountsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: BankAccountsWidgetProps): React.JSX.Element;
+declare function BankAccountsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: BankAccountsWidgetProps): React.JSX.Element;
 
 interface AddressFieldGroupLabels {
     line1: string;
@@ -2266,7 +2301,7 @@ interface CardDetailsWidgetProps extends WidgetProviderProps {
  * Both placements are covered by specs, because they take different code paths
  * through the provider and this export exists for the standalone one.
  */
-declare function CardDetailsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: CardDetailsWidgetProps): React.JSX.Element;
+declare function CardDetailsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: CardDetailsWidgetProps): React.JSX.Element;
 
 /**
  * Reset-period tab labels and notice copy are deliberately absent: the owner
@@ -2413,7 +2448,7 @@ type CreateCardWidgetProps = WidgetProviderProps & {
  * Self-contained Create Card widget. Issues a debit card via the Embed API and
  * drives setup → preparing → success with sonner toasts for the mutation.
  */
-declare function CreateCardWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: CreateCardWidgetProps): React.JSX.Element;
+declare function CreateCardWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: CreateCardWidgetProps): React.JSX.Element;
 
 /** Opaque UI format values — mapped to API `DebitCardType` in the feature. */
 declare const CardFormatValue: {
@@ -2633,7 +2668,7 @@ interface CardsWidgetProps extends WidgetProviderProps {
  * inside `WidgetProvider`'s subtree, which is what the data-access hooks read
  * their client, org and token from.
  */
-declare function CardsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: CardsWidgetProps): React.JSX.Element;
+declare function CardsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: CardsWidgetProps): React.JSX.Element;
 
 /**
  * Co-located user-facing strings for the counterparts widget UI. Each component
@@ -2783,7 +2818,7 @@ type CounterpartsWidgetProps = WidgetProviderProps & CounterpartsWidgetOwnProps;
  * />
  * ```
  */
-declare function CounterpartsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: CounterpartsWidgetProps): React.JSX.Element;
+declare function CounterpartsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: CounterpartsWidgetProps): React.JSX.Element;
 
 interface Labels$4 {
     description: string;
@@ -2826,7 +2861,7 @@ interface ExpenseManagementWidgetProps extends WidgetProviderProps {
     policiesContent?: ReactNode;
     requirementsContent?: ReactNode;
 }
-declare function ExpenseManagementWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: ExpenseManagementWidgetProps): React.JSX.Element;
+declare function ExpenseManagementWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: ExpenseManagementWidgetProps): React.JSX.Element;
 
 type ReceiptMatchWidgetProps = WidgetProviderProps & {
     isOpen?: boolean;
@@ -2835,7 +2870,7 @@ type ReceiptMatchWidgetProps = WidgetProviderProps & {
     targetTransactionId?: string;
     onSingleTransactionUpdate?: () => void;
 };
-declare function ReceiptMatchWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, disclosuresAcceptance, isOpen, preSelectedReceiptIds, onClose, targetTransactionId, onSingleTransactionUpdate, }: ReceiptMatchWidgetProps): React.JSX.Element;
+declare function ReceiptMatchWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, disclosuresAcceptance, providerLabels, isOpen, preSelectedReceiptIds, onClose, targetTransactionId, onSingleTransactionUpdate, }: ReceiptMatchWidgetProps): React.JSX.Element;
 
 type ExpenseApprovalPoliciesWidgetProps = WidgetProviderProps & {
     /** @deprecated Use `widgetToken` instead */
@@ -2843,7 +2878,7 @@ type ExpenseApprovalPoliciesWidgetProps = WidgetProviderProps & {
     /** @deprecated Use `organizationId` instead */
     orgId?: string | null;
 };
-declare function ExpenseApprovalPoliciesWidget({ token, orgId, widgetToken, organizationId, baseUrl, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, disclosuresAcceptance, }?: ExpenseApprovalPoliciesWidgetProps): React.JSX.Element;
+declare function ExpenseApprovalPoliciesWidget({ token, orgId, widgetToken, organizationId, baseUrl, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, disclosuresAcceptance, providerLabels, }?: ExpenseApprovalPoliciesWidgetProps): React.JSX.Element;
 
 type ExpenseRequirementsWidgetProps = WidgetProviderProps & {
     /** @deprecated Use `widgetToken` instead */
@@ -2851,7 +2886,7 @@ type ExpenseRequirementsWidgetProps = WidgetProviderProps & {
     /** @deprecated Use `organizationId` instead */
     orgId?: string | null;
 };
-declare function ExpenseRequirementsWidget({ token, orgId, widgetToken, organizationId, baseUrl, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, disclosuresAcceptance, }?: ExpenseRequirementsWidgetProps): React.JSX.Element;
+declare function ExpenseRequirementsWidget({ token, orgId, widgetToken, organizationId, baseUrl, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, disclosuresAcceptance, providerLabels, }?: ExpenseRequirementsWidgetProps): React.JSX.Element;
 
 interface BalancesWidgetLabels {
     /** Card header title (e.g. next to the building icon) */
@@ -3302,7 +3337,7 @@ type ChartOfAccountsWidgetProps = WidgetProviderProps & TableProps & ChartOfAcco
  * />
  * ```
  */
-declare function ChartOfAccountsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, analytics, disclosuresAcceptance, errorFallback, onError, ...tableProps }: ChartOfAccountsWidgetProps): React.JSX.Element;
+declare function ChartOfAccountsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, analytics, disclosuresAcceptance, providerLabels, errorFallback, onError, ...tableProps }: ChartOfAccountsWidgetProps): React.JSX.Element;
 
 /**
  * Static FAQ content for the Help widget.
@@ -3410,12 +3445,12 @@ type HelpWidgetProps = WidgetProviderProps & HelpContentProps;
  * <HelpWidget bankName="Acme Bank" contactUrl="https://acme.example/support" />
  * ```
  */
-declare function HelpWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...contentProps }: HelpWidgetProps): React.JSX.Element;
+declare function HelpWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...contentProps }: HelpWidgetProps): React.JSX.Element;
 
 type ReceivablesWidgetMoniteProps = MoniteRegionProviderProps & Omit<ReceivablesProps, 'pageTitleComponent' | 'initialView' | 'initialCounterpartId'> & {
     pageTitleComponent?: ReceivablesProps['pageTitleComponent'];
 };
-declare function ReceivablesWidgetMonite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, errorFallback, onError, finopsThemeColors, analytics, disclosuresAcceptance, pageTitleComponent, uiFramework, ...receivablesProps }: ReceivablesWidgetMoniteProps): React.JSX.Element;
+declare function ReceivablesWidgetMonite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, errorFallback, onError, finopsThemeColors, analytics, disclosuresAcceptance, providerLabels, pageTitleComponent, uiFramework, ...receivablesProps }: ReceivablesWidgetMoniteProps): React.JSX.Element;
 
 interface ProductFormSheetLabels {
     createTitle: string;
@@ -3740,7 +3775,7 @@ interface ReceivablesWidgetOwnProps {
 }
 type ReceivablesWidgetProps = WidgetProviderProps & ReceivablesWidgetOwnProps;
 
-declare function ReceivablesWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: ReceivablesWidgetProps): React.JSX.Element;
+declare function ReceivablesWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: ReceivablesWidgetProps): React.JSX.Element;
 
 interface Labels$3 {
     title: string;
@@ -3822,7 +3857,7 @@ interface LinkedAccountsWidgetProps extends WidgetProviderProps {
     labels?: Partial<Labels$3>;
     featureLabels?: Partial<FeatureLabels$4>;
 }
-declare function LinkedAccountsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: LinkedAccountsWidgetProps): React.JSX.Element;
+declare function LinkedAccountsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: LinkedAccountsWidgetProps): React.JSX.Element;
 
 interface AdditionalOwnersLabels {
     heading: string;
@@ -4126,7 +4161,7 @@ interface BankAccountOnboardingWidgetInnerProps {
     onOpenChange?: (open: boolean) => void;
 }
 type BankAccountOnboardingWidgetProps = WidgetProviderProps & BankAccountOnboardingWidgetInnerProps;
-declare function BankAccountOnboardingWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: BankAccountOnboardingWidgetProps): React.JSX.Element;
+declare function BankAccountOnboardingWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: BankAccountOnboardingWidgetProps): React.JSX.Element;
 
 /**
  * Co-located user-facing strings for the products widget UI. Each component
@@ -4223,7 +4258,7 @@ type ProductsWidgetProps = WidgetProviderProps & ProductsWidgetOwnProps;
  * <ProductsWidget baseUrl="https://api.tesouro.com" widgetToken="wt_..." organizationId="org_..." />
  * ```
  */
-declare function ProductsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: ProductsWidgetProps): React.JSX.Element;
+declare function ProductsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: ProductsWidgetProps): React.JSX.Element;
 
 interface Labels$2 {
     loadingLabel: string;
@@ -4264,7 +4299,7 @@ interface ProfileWidgetProps extends WidgetProviderProps {
      */
     contactUrl?: string;
 }
-declare function ProfileWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: ProfileWidgetProps): React.JSX.Element;
+declare function ProfileWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: ProfileWidgetProps): React.JSX.Element;
 
 interface Labels$1 {
     description?: string;
@@ -4376,7 +4411,7 @@ interface SettingsWidgetProps extends MoniteRegionProviderProps {
     tagsContent?: ReactNode;
     invoiceContent?: ReactNode;
 }
-declare function SettingsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, finopsThemeColors, analytics, disclosuresAcceptance, ...innerProps }: SettingsWidgetProps): React.JSX.Element;
+declare function SettingsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, finopsThemeColors, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: SettingsWidgetProps): React.JSX.Element;
 
 /**
  * Co-located user-facing strings for the tags widget UI. Each component takes a
@@ -4464,7 +4499,7 @@ type TagsWidgetProps = WidgetProviderProps & TagsWidgetOwnProps;
  * <TagsWidget baseUrl="https://api.tesouro.com" widgetToken="wt_..." organizationId="org_..." />
  * ```
  */
-declare function TagsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: TagsWidgetProps): React.JSX.Element;
+declare function TagsWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: TagsWidgetProps): React.JSX.Element;
 
 interface Labels {
     title: string;
@@ -4711,7 +4746,7 @@ interface TeamWidgetProps extends WidgetProviderProps {
      */
     acceptInviteRedirectUri?: string;
 }
-declare function TeamWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: TeamWidgetProps): React.JSX.Element;
+declare function TeamWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: TeamWidgetProps): React.JSX.Element;
 
 interface TransfersWidgetLabels {
     widgetTitle: string;
@@ -4876,4 +4911,4 @@ interface CheckAmountAndDetailScreenProps {
 type PendingFeatureStyleSources = CheckAmountAndDetailScreenProps | GapCoverageAlertProps | NoPolicyBannerProps;
 
 export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ACCOUNT_DELETE_DIALOG_LABELS_EN, ACCOUNT_FORM_SHEET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, AcceptDisclosuresWidget, AccountDeleteDialog, AccountFormSheet, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CHART_OF_ACCOUNTS_LABELS_EN, CHART_OF_ACCOUNTS_MESSAGE_LABELS_EN, CREATE_CARD_FEATURE_LABELS_EN, CardDetailsWidget, CardFormatValue, CardsWidget, ChartOfAccountsTable, ChartOfAccountsWidget, CounterpartsWidget, CreateCardWidget, ERROR_STATE_ID, ExpenseApprovalPoliciesWidget, ExpenseManagementWidget, ExpenseRequirementsWidget, HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, ProfileWidget, RESULT_LABELS_EN, ReceiptMatchWidget, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, SettingsSection, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TagsWidget, TeamWidget, TransfersWidget, UIFramework, UploadReceiptWidget, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, getGlobalWidgetInitState, registerDesignSystemEnsurer, registerUIRenderers, resolveCreateCardFeatureLabels, setGlobalWidgetConfig, subscribeToGlobalWidgetInitState, updateGlobalWidgetConfig, useDisclosuresAcceptanceSurface, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
-export type { AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, AccountDeleteDialogLabels, AccountDeleteDialogProps, Labels$5 as AccountDetailsWidgetLabels, AccountFormErrors, AccountFormMode, AccountFormSheetLabels, AccountFormSheetProps, AccountFormValues, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels as CardsWidgetFeatureLabels, CardsListLabels as CardsWidgetLabels, CardsWidgetPagination, CardsWidgetProps, ChartOfAccountsLabels, ChartOfAccountsMessageLabels, ChartOfAccountsTableProps, ChartOfAccountsWidgetLabelProps, ChartOfAccountsWidgetProps, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, CreateCardFeatureLabels, CreateCardWidgetLabels, CreateCardWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LedgerAccountRow, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchSummary, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, SettingsWidgetAdditionalSection, FeatureLabels$2 as SettingsWidgetFeatureLabels, Labels$1 as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId, SingleInsightLabels, TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps, FeatureLabels$1 as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };
+export type { AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, AccountDeleteDialogLabels, AccountDeleteDialogProps, Labels$5 as AccountDetailsWidgetLabels, AccountFormErrors, AccountFormMode, AccountFormSheetLabels, AccountFormSheetProps, AccountFormValues, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels as CardsWidgetFeatureLabels, CardsListLabels as CardsWidgetLabels, CardsWidgetPagination, CardsWidgetProps, ChartOfAccountsLabels, ChartOfAccountsMessageLabels, ChartOfAccountsTableProps, ChartOfAccountsWidgetLabelProps, ChartOfAccountsWidgetProps, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, CreateCardFeatureLabels, CreateCardWidgetLabels, CreateCardWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LedgerAccountRow, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchSummary, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, SettingsWidgetAdditionalSection, FeatureLabels$2 as SettingsWidgetFeatureLabels, Labels$1 as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId, SingleInsightLabels, TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps, FeatureLabels$1 as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderLabels, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };

package/dist/lib/AcceptDisclosuresWidget.d.ts

@@ -691,6 +691,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
     analytics?: boolean;
 }
 
+/**
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
+ * the error-boundary fallback and the disclosures gate. A host overrides any
+ * subset through the `providerLabels` prop, which cascades like
+ * `disclosuresAcceptance`.
+ *
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
+ * different thing, and these two travel together on every widget's props type.
+ */
+interface WidgetProviderLabels {
+    /** Default copy for the built-in error boundary fallback. */
+    errorBoundaryFallback: string;
+    /** Heading when init reports disclosures are required and not yet accepted. */
+    disclosuresRequiredTitle: string;
+    /** Heading while a token-only refresh leaves init stale for the live token. */
+    disclosuresRefreshingTitle: string;
+    /** Supporting copy while the accept action is withheld for a stale init. */
+    disclosuresRefreshingDescription: string;
+}
+
 /**
  * Props for {@link WidgetProvider}.
  *
@@ -703,8 +723,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * Fallback rendered when a render-time exception is caught inside this
      * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
      * render-prop receiving `{ error, resetErrorBoundary }` from
-     * `react-error-boundary`. Default is a plain `role="alert"` div with
-     * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
+     * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
+     * comes from `providerLabels.errorBoundaryFallback`.
      */
     errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
     /**
@@ -721,6 +741,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProvider cannot import the widget itself (cycle).
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy this provider renders in place of the widget: the
+     * built-in error-boundary fallback and the disclosures gate. Any subset;
+     * unlisted keys keep their defaults. Cascades like `linkComponent`.
+     *
+     * Named `providerLabels` rather than `labels` because a widget's own
+     * `labels` prop sits alongside this one on the same props type.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 
 type UiOwnedProps = 'providerAttribution' | 'agreementText' | 'disclosureLinks' | 'isAgreed' | 'onAgreedChange' | 'onAccept' | 'isSubmitting' | 'isAccepted' | 'errorMessage' | 'testIds';
@@ -753,7 +782,7 @@ type AcceptDisclosuresWidgetProps = WidgetProviderProps & InnerProps;
  *
  * See `WidgetSuite`, which mounts it as its acceptance state.
  */
-declare function AcceptDisclosuresWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: AcceptDisclosuresWidgetProps): React.JSX.Element;
+declare function AcceptDisclosuresWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: AcceptDisclosuresWidgetProps): React.JSX.Element;
 
 export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, AcceptDisclosuresWidget };
 export type { AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps };

package/dist/lib/BalancesWidget.d.ts

@@ -587,6 +587,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
     analytics?: boolean;
 }
 
+/**
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
+ * the error-boundary fallback and the disclosures gate. A host overrides any
+ * subset through the `providerLabels` prop, which cascades like
+ * `disclosuresAcceptance`.
+ *
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
+ * different thing, and these two travel together on every widget's props type.
+ */
+interface WidgetProviderLabels {
+    /** Default copy for the built-in error boundary fallback. */
+    errorBoundaryFallback: string;
+    /** Heading when init reports disclosures are required and not yet accepted. */
+    disclosuresRequiredTitle: string;
+    /** Heading while a token-only refresh leaves init stale for the live token. */
+    disclosuresRefreshingTitle: string;
+    /** Supporting copy while the accept action is withheld for a stale init. */
+    disclosuresRefreshingDescription: string;
+}
+
 /**
  * Props for {@link WidgetProvider}.
  *
@@ -599,8 +619,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * Fallback rendered when a render-time exception is caught inside this
      * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
      * render-prop receiving `{ error, resetErrorBoundary }` from
-     * `react-error-boundary`. Default is a plain `role="alert"` div with
-     * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
+     * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
+     * comes from `providerLabels.errorBoundaryFallback`.
      */
     errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
     /**
@@ -617,6 +637,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProvider cannot import the widget itself (cycle).
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy this provider renders in place of the widget: the
+     * built-in error-boundary fallback and the disclosures gate. Any subset;
+     * unlisted keys keep their defaults. Cascades like `linkComponent`.
+     *
+     * Named `providerLabels` rather than `labels` because a widget's own
+     * `labels` prop sits alongside this one on the same props type.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 
 interface BalancesWidgetWithContextProps {

package/dist/lib/BankAccountOnboardingWidget.d.ts

@@ -833,6 +833,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
     analytics?: boolean;
 }
 
+/**
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
+ * the error-boundary fallback and the disclosures gate. A host overrides any
+ * subset through the `providerLabels` prop, which cascades like
+ * `disclosuresAcceptance`.
+ *
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
+ * different thing, and these two travel together on every widget's props type.
+ */
+interface WidgetProviderLabels {
+    /** Default copy for the built-in error boundary fallback. */
+    errorBoundaryFallback: string;
+    /** Heading when init reports disclosures are required and not yet accepted. */
+    disclosuresRequiredTitle: string;
+    /** Heading while a token-only refresh leaves init stale for the live token. */
+    disclosuresRefreshingTitle: string;
+    /** Supporting copy while the accept action is withheld for a stale init. */
+    disclosuresRefreshingDescription: string;
+}
+
 /**
  * Props for {@link WidgetProvider}.
  *
@@ -845,8 +865,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * Fallback rendered when a render-time exception is caught inside this
      * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
      * render-prop receiving `{ error, resetErrorBoundary }` from
-     * `react-error-boundary`. Default is a plain `role="alert"` div with
-     * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
+     * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
+     * comes from `providerLabels.errorBoundaryFallback`.
      */
     errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
     /**
@@ -863,6 +883,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
      * WidgetProvider cannot import the widget itself (cycle).
      */
     disclosuresAcceptance?: ReactNode;
+    /**
+     * Overrides for the copy this provider renders in place of the widget: the
+     * built-in error-boundary fallback and the disclosures gate. Any subset;
+     * unlisted keys keep their defaults. Cascades like `linkComponent`.
+     *
+     * Named `providerLabels` rather than `labels` because a widget's own
+     * `labels` prop sits alongside this one on the same props type.
+     */
+    providerLabels?: Partial<WidgetProviderLabels>;
 }
 
 /**
@@ -955,7 +984,7 @@ interface BankAccountOnboardingWidgetInnerProps {
     onOpenChange?: (open: boolean) => void;
 }
 type BankAccountOnboardingWidgetProps = WidgetProviderProps & BankAccountOnboardingWidgetInnerProps;
-declare function BankAccountOnboardingWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: BankAccountOnboardingWidgetProps): React.JSX.Element;
+declare function BankAccountOnboardingWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: BankAccountOnboardingWidgetProps): React.JSX.Element;
 
 export { ADDITIONAL_OWNERS_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BankAccountOnboardingWidget, PERSONAL_DETAILS_LABELS_EN, RESULT_LABELS_EN };
 export type { AdditionalOwner, AdditionalOwnersLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CompanyStructureValue, DisclosureLinks, MarketingWidgetContent, PersonalDetailsLabels, PersonalDetailsValues, ResultLabels };