@tesouro/embedded-components-react 0.3.25 → 0.3.27

package/dist/lib/HelpWidget.d.ts

@@ -650,6 +650,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}.
  *
@@ -662,8 +682,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);
     /**
@@ -680,6 +700,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>;
 }
 
 /**
@@ -704,7 +733,7 @@ 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;
 
 export { HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget };
 export type { HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps };

package/dist/lib/InsightsWidget.d.ts

@@ -602,6 +602,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}.
  *
@@ -614,8 +634,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);
     /**
@@ -632,6 +652,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 InsightsFeatureLabels {

package/dist/lib/InvoicingWidget.d.ts

@@ -596,6 +596,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}.
  *
@@ -608,8 +628,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);
     /**
@@ -626,6 +646,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 MoniteRegionProviderProps = WidgetProviderProps & MoniteWrapperProps;
@@ -633,7 +662,7 @@ type MoniteRegionProviderProps = WidgetProviderProps & MoniteWrapperProps;
 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;
 
 export { ReceivablesWidgetMonite as InvoicingWidget };
 export type { ReceivablesWidgetMoniteProps as InvoicingWidgetProps };

package/dist/lib/LinkedAccountsWidget.d.ts

@@ -634,6 +634,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}.
  *
@@ -646,8 +666,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);
     /**
@@ -664,6 +684,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 FeatureLabels {
@@ -678,7 +707,7 @@ interface LinkedAccountsWidgetProps extends WidgetProviderProps {
     labels?: Partial<Labels>;
     featureLabels?: Partial<FeatureLabels>;
 }
-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;
 
 export { LinkedAccountsWidget };
 export type { FeatureLabels as LinkedAccountsWidgetFeatureLabels, Labels as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps };

package/dist/lib/ProductsWidget.d.ts

@@ -566,6 +566,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}.
  *
@@ -578,8 +598,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);
     /**
@@ -596,6 +616,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 ProductFormSheetLabels {
@@ -780,7 +809,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;
 
 export { ProductsWidget };
 export type { MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps };

package/dist/lib/ProfileWidget.d.ts

@@ -579,6 +579,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}.
  *
@@ -591,8 +611,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);
     /**
@@ -609,6 +629,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 FeatureLabels {
@@ -637,7 +666,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;
 
 export { ProfileWidget };
 export type { FeatureLabels as ProfileWidgetFeatureLabels, Labels as ProfileWidgetLabels, ProfileWidgetProps };

package/dist/lib/ReceiptMatchWidget.d.ts

@@ -566,6 +566,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}.
  *
@@ -578,8 +598,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);
     /**
@@ -596,6 +616,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 ReceiptMatchWidgetProps = WidgetProviderProps & {
@@ -605,7 +634,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;
 
 export { ReceiptMatchWidget };
 export type { ReceiptMatchWidgetProps };

package/dist/lib/ReceivablesWidget.d.ts

@@ -573,6 +573,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}.
  *
@@ -585,8 +605,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);
     /**
@@ -603,6 +623,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 AddressFieldGroupLabels {
@@ -1028,7 +1057,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;
 
 export { ReceivablesWidget };
 export type { CounterpartFormSheetLabels, CounterpartMessageLabels, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, ProductFormSheetLabels, ProductMessageLabels, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab };

package/dist/lib/SettingsWidget.d.ts

@@ -584,6 +584,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}.
  *
@@ -596,8 +616,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);
     /**
@@ -614,6 +634,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 MoniteRegionProviderProps = WidgetProviderProps & MoniteWrapperProps;
@@ -718,7 +747,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;
 
 export { SettingsSection, SettingsWidget };
 export type { SettingsWidgetAdditionalSection, FeatureLabels as SettingsWidgetFeatureLabels, Labels as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId };

package/dist/lib/TagsWidget.d.ts

@@ -566,6 +566,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}.
  *
@@ -578,8 +598,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);
     /**
@@ -596,6 +616,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>;
 }
 
 /**
@@ -684,7 +713,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;
 
 export { TagsWidget };
 export type { TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps };