@tesouro/embedded-components-react 0.3.26 → 0.3.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/README.md +3 -0
  2. package/dist/experimental/WidgetSuite.d.ts +32 -3
  3. package/dist/experimental/index.d.ts +32 -3
  4. package/dist/index.d.ts +60 -25
  5. package/dist/lib/AcceptDisclosuresWidget.d.ts +32 -3
  6. package/dist/lib/BalancesWidget.d.ts +31 -2
  7. package/dist/lib/BankAccountOnboardingWidget.d.ts +32 -3
  8. package/dist/lib/BankAccountsWidget.d.ts +32 -3
  9. package/dist/lib/BillPayWidget.d.ts +31 -2
  10. package/dist/lib/CardDetailsWidget.d.ts +32 -3
  11. package/dist/lib/CardsWidget.d.ts +32 -3
  12. package/dist/lib/ChartOfAccountsWidget.d.ts +32 -3
  13. package/dist/lib/CounterpartsWidget.d.ts +32 -3
  14. package/dist/lib/CreateCardWidget.d.ts +32 -3
  15. package/dist/lib/ExpenseApprovalPoliciesWidget.d.ts +32 -3
  16. package/dist/lib/ExpenseManagementWidget.d.ts +32 -3
  17. package/dist/lib/ExpenseRequirementsWidget.d.ts +32 -3
  18. package/dist/lib/HelpWidget.d.ts +32 -3
  19. package/dist/lib/InsightsWidget.d.ts +31 -2
  20. package/dist/lib/InvoicingWidget.d.ts +32 -3
  21. package/dist/lib/LinkedAccountsWidget.d.ts +32 -3
  22. package/dist/lib/ProductsWidget.d.ts +32 -3
  23. package/dist/lib/ProfileWidget.d.ts +32 -3
  24. package/dist/lib/ReceiptMatchWidget.d.ts +32 -3
  25. package/dist/lib/ReceivablesWidget.d.ts +32 -3
  26. package/dist/lib/SettingsWidget.d.ts +32 -3
  27. package/dist/lib/TagsWidget.d.ts +32 -3
  28. package/dist/lib/TeamWidget.d.ts +32 -3
  29. package/dist/lib/TransfersWidget.d.ts +31 -2
  30. package/dist/lib/WidgetProvider.d.ts +39 -4
  31. package/dist/lib/WidgetProviderPublic.d.ts +31 -2
  32. package/dist/libs/tesouro-embedded-components-react/accept-disclosures-widget/feature/dist/index5.js +3 -2
  33. package/dist/libs/tesouro-embedded-components-react/bank-account-onboarding-widget/feature/dist/index18.js +131 -130
  34. package/dist/libs/tesouro-embedded-components-react/bank-accounts-widget/feature/dist/index8.js +3 -2
  35. package/dist/libs/tesouro-embedded-components-react/bill-pay-widget/feature/dist/index51.js +4 -3
  36. package/dist/libs/tesouro-embedded-components-react/bill-pay-widget/feature/dist/index73.js +3 -2
  37. package/dist/libs/tesouro-embedded-components-react/card-details-widget/feature/dist/index6.js +3 -2
  38. package/dist/libs/tesouro-embedded-components-react/cards-widget/feature/dist/index9.js +3 -2
  39. package/dist/libs/tesouro-embedded-components-react/counterparts-widget/feature/dist/index8.js +3 -2
  40. package/dist/libs/tesouro-embedded-components-react/create-card-widget/feature/dist/index7.js +88 -87
  41. package/dist/libs/tesouro-embedded-components-react/expense-management-widget/feature/dist/index13.js +7 -6
  42. package/dist/libs/tesouro-embedded-components-react/expense-management-widget/feature/dist/index6.js +2 -1
  43. package/dist/libs/tesouro-embedded-components-react/expense-management-widget/feature/dist/index9.js +3 -2
  44. package/dist/libs/tesouro-embedded-components-react/expense-requirements-widget/feature/dist/lib/ExpenseRequirementsWidget.js +2 -1
  45. package/dist/libs/tesouro-embedded-components-react/gl-code-table-widget/feature/dist/index8.js +5 -4
  46. package/dist/libs/tesouro-embedded-components-react/help-widget/feature/dist/index3.js +3 -2
  47. package/dist/libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index12.js +3 -2
  48. package/dist/libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index3.js +5 -4
  49. package/dist/libs/tesouro-embedded-components-react/linked-accounts-widget/feature/dist/index9.js +3 -2
  50. package/dist/libs/tesouro-embedded-components-react/products-widget/feature/dist/index8.js +3 -2
  51. package/dist/libs/tesouro-embedded-components-react/profile-widget/feature/dist/index4.js +3 -2
  52. package/dist/libs/tesouro-embedded-components-react/settings-widget/feature/dist/index6.js +3 -2
  53. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/WidgetProvider/RootWidgetProvider.js +50 -48
  54. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/WidgetProvider/WidgetErrorBoundary.js +13 -13
  55. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/WidgetProvider/WidgetProvider.js +174 -163
  56. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/WidgetProvider/isDisclosuresAcceptanceRequired.js +12 -1
  57. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/WidgetProvider/labels.js +7 -1
  58. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/analytics/build-info.js +1 -1
  59. package/dist/libs/tesouro-embedded-components-react/shared/feature/dist/lib/analytics/events.js +1 -0
  60. package/dist/libs/tesouro-embedded-components-react/tags-widget/feature/dist/index11.js +3 -2
  61. package/dist/libs/tesouro-embedded-components-react/team-widget/feature/dist/index17.js +3 -2
  62. package/dist/libs/tesouro-embedded-components-react/widget-suite/feature/dist/index8.js +3 -2
  63. package/package.json +1 -1
@@ -566,6 +566,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
566
566
  analytics?: boolean;
567
567
  }
568
568
 
569
+ /**
570
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
571
+ * the error-boundary fallback and the disclosures gate. A host overrides any
572
+ * subset through the `providerLabels` prop, which cascades like
573
+ * `disclosuresAcceptance`.
574
+ *
575
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
576
+ * different thing, and these two travel together on every widget's props type.
577
+ */
578
+ interface WidgetProviderLabels {
579
+ /** Default copy for the built-in error boundary fallback. */
580
+ errorBoundaryFallback: string;
581
+ /** Heading when init reports disclosures are required and not yet accepted. */
582
+ disclosuresRequiredTitle: string;
583
+ /** Heading while a token-only refresh leaves init stale for the live token. */
584
+ disclosuresRefreshingTitle: string;
585
+ /** Supporting copy while the accept action is withheld for a stale init. */
586
+ disclosuresRefreshingDescription: string;
587
+ }
588
+
569
589
  /**
570
590
  * Props for {@link WidgetProvider}.
571
591
  *
@@ -578,8 +598,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
578
598
  * Fallback rendered when a render-time exception is caught inside this
579
599
  * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
580
600
  * render-prop receiving `{ error, resetErrorBoundary }` from
581
- * `react-error-boundary`. Default is a plain `role="alert"` div with
582
- * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
601
+ * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
602
+ * comes from `providerLabels.errorBoundaryFallback`.
583
603
  */
584
604
  errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
585
605
  /**
@@ -596,6 +616,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
596
616
  * WidgetProvider cannot import the widget itself (cycle).
597
617
  */
598
618
  disclosuresAcceptance?: ReactNode;
619
+ /**
620
+ * Overrides for the copy this provider renders in place of the widget: the
621
+ * built-in error-boundary fallback and the disclosures gate. Any subset;
622
+ * unlisted keys keep their defaults. Cascades like `linkComponent`.
623
+ *
624
+ * Named `providerLabels` rather than `labels` because a widget's own
625
+ * `labels` prop sits alongside this one on the same props type.
626
+ */
627
+ providerLabels?: Partial<WidgetProviderLabels>;
599
628
  }
600
629
 
601
630
  interface Labels {
@@ -843,7 +872,7 @@ interface TeamWidgetProps extends WidgetProviderProps {
843
872
  */
844
873
  acceptInviteRedirectUri?: string;
845
874
  }
846
- declare function TeamWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: TeamWidgetProps): React.JSX.Element;
875
+ declare function TeamWidget({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, providerLabels, ...innerProps }: TeamWidgetProps): React.JSX.Element;
847
876
 
848
877
  export { TeamWidget };
849
878
  export type { FeatureLabels as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps };
@@ -566,6 +566,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
566
566
  analytics?: boolean;
567
567
  }
568
568
 
569
+ /**
570
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
571
+ * the error-boundary fallback and the disclosures gate. A host overrides any
572
+ * subset through the `providerLabels` prop, which cascades like
573
+ * `disclosuresAcceptance`.
574
+ *
575
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
576
+ * different thing, and these two travel together on every widget's props type.
577
+ */
578
+ interface WidgetProviderLabels {
579
+ /** Default copy for the built-in error boundary fallback. */
580
+ errorBoundaryFallback: string;
581
+ /** Heading when init reports disclosures are required and not yet accepted. */
582
+ disclosuresRequiredTitle: string;
583
+ /** Heading while a token-only refresh leaves init stale for the live token. */
584
+ disclosuresRefreshingTitle: string;
585
+ /** Supporting copy while the accept action is withheld for a stale init. */
586
+ disclosuresRefreshingDescription: string;
587
+ }
588
+
569
589
  /**
570
590
  * Props for {@link WidgetProvider}.
571
591
  *
@@ -578,8 +598,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
578
598
  * Fallback rendered when a render-time exception is caught inside this
579
599
  * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
580
600
  * render-prop receiving `{ error, resetErrorBoundary }` from
581
- * `react-error-boundary`. Default is a plain `role="alert"` div with
582
- * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
601
+ * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
602
+ * comes from `providerLabels.errorBoundaryFallback`.
583
603
  */
584
604
  errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
585
605
  /**
@@ -596,6 +616,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
596
616
  * WidgetProvider cannot import the widget itself (cycle).
597
617
  */
598
618
  disclosuresAcceptance?: ReactNode;
619
+ /**
620
+ * Overrides for the copy this provider renders in place of the widget: the
621
+ * built-in error-boundary fallback and the disclosures gate. Any subset;
622
+ * unlisted keys keep their defaults. Cascades like `linkComponent`.
623
+ *
624
+ * Named `providerLabels` rather than `labels` because a widget's own
625
+ * `labels` prop sits alongside this one on the same props type.
626
+ */
627
+ providerLabels?: Partial<WidgetProviderLabels>;
599
628
  }
600
629
 
601
630
  interface TransfersWidgetLabels {
@@ -680,6 +680,26 @@ interface WidgetConfig extends WidgetConfigInput {
680
680
  initResponse?: WidgetInitResponse;
681
681
  }
682
682
 
683
+ /**
684
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
685
+ * the error-boundary fallback and the disclosures gate. A host overrides any
686
+ * subset through the `providerLabels` prop, which cascades like
687
+ * `disclosuresAcceptance`.
688
+ *
689
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
690
+ * different thing, and these two travel together on every widget's props type.
691
+ */
692
+ interface WidgetProviderLabels {
693
+ /** Default copy for the built-in error boundary fallback. */
694
+ errorBoundaryFallback: string;
695
+ /** Heading when init reports disclosures are required and not yet accepted. */
696
+ disclosuresRequiredTitle: string;
697
+ /** Heading while a token-only refresh leaves init stale for the live token. */
698
+ disclosuresRefreshingTitle: string;
699
+ /** Supporting copy while the accept action is withheld for a stale init. */
700
+ disclosuresRefreshingDescription: string;
701
+ }
702
+
683
703
  /**
684
704
  * Replaces the global widget config and notifies all reactive subscribers.
685
705
  *
@@ -894,6 +914,12 @@ interface RootWidgetProviderProps extends WidgetProviderBaseProps {
894
914
  * WidgetProviders.
895
915
  */
896
916
  disclosuresAcceptance?: ReactNode;
917
+ /**
918
+ * Overrides for the copy a descendant `WidgetProvider` renders in place of
919
+ * its widget: the built-in error-boundary fallback and the disclosures gate.
920
+ * Any subset; unlisted keys keep their defaults. Cascades to the whole tree.
921
+ */
922
+ providerLabels?: Partial<WidgetProviderLabels>;
897
923
  }
898
924
  /**
899
925
  * Top-level provider for the widget config cascade.
@@ -947,7 +973,7 @@ interface RootWidgetProviderProps extends WidgetProviderBaseProps {
947
973
  * @see {@link useWidgetConfig} to read the resolved config in descendants
948
974
  * @see {@link setGlobalWidgetConfig} to push config imperatively from outside React
949
975
  */
950
- declare function RootWidgetProvider({ children, baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, uiFramework, implementation, analytics, unstable_initResponseOverride, disclosuresAcceptance, }: PropsWithChildren<RootWidgetProviderProps>): React.JSX.Element;
976
+ declare function RootWidgetProvider({ children, baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, uiFramework, implementation, analytics, unstable_initResponseOverride, disclosuresAcceptance, providerLabels, }: PropsWithChildren<RootWidgetProviderProps>): React.JSX.Element;
951
977
 
952
978
  /**
953
979
  * Props for {@link WidgetProvider}.
@@ -961,8 +987,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
961
987
  * Fallback rendered when a render-time exception is caught inside this
962
988
  * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
963
989
  * render-prop receiving `{ error, resetErrorBoundary }` from
964
- * `react-error-boundary`. Default is a plain `role="alert"` div with
965
- * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
990
+ * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
991
+ * comes from `providerLabels.errorBoundaryFallback`.
966
992
  */
967
993
  errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
968
994
  /**
@@ -979,6 +1005,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
979
1005
  * WidgetProvider cannot import the widget itself (cycle).
980
1006
  */
981
1007
  disclosuresAcceptance?: ReactNode;
1008
+ /**
1009
+ * Overrides for the copy this provider renders in place of the widget: the
1010
+ * built-in error-boundary fallback and the disclosures gate. Any subset;
1011
+ * unlisted keys keep their defaults. Cascades like `linkComponent`.
1012
+ *
1013
+ * Named `providerLabels` rather than `labels` because a widget's own
1014
+ * `labels` prop sits alongside this one on the same props type.
1015
+ */
1016
+ providerLabels?: Partial<WidgetProviderLabels>;
982
1017
  }
983
1018
 
984
1019
  type WidgetTokenFetcher = () => Promise<{
@@ -1248,4 +1283,4 @@ declare function useWidgetToken(): UseWidgetTokenResult;
1248
1283
  declare function WidgetProvider(props: PropsWithChildren<WidgetProviderProps>): ReactNode;
1249
1284
 
1250
1285
  export { ERROR_STATE_ID, Implementation, RefreshingRootWidgetProvider, RootWidgetProvider, UIFramework, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, getGlobalWidgetInitState, registerDesignSystemEnsurer, registerUIRenderers, setGlobalWidgetConfig, subscribeToGlobalWidgetInitState, updateGlobalWidgetConfig, useDisclosuresAcceptanceSurface, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
1251
- export type { EmbeddedClient, LinkComponent, LinkComponentProps, RefreshingRootWidgetProviderProps, RootWidgetProviderProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };
1286
+ export type { EmbeddedClient, LinkComponent, LinkComponentProps, RefreshingRootWidgetProviderProps, RootWidgetProviderProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderLabels, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };
@@ -565,6 +565,26 @@ interface WidgetProviderBaseProps extends WidgetConfigInput {
565
565
  analytics?: boolean;
566
566
  }
567
567
 
568
+ /**
569
+ * Copy for the states `WidgetProvider` renders *itself*, in place of the widget:
570
+ * the error-boundary fallback and the disclosures gate. A host overrides any
571
+ * subset through the `providerLabels` prop, which cascades like
572
+ * `disclosuresAcceptance`.
573
+ *
574
+ * Not named `Labels` on the public surface: a widget's own `labels` prop is a
575
+ * different thing, and these two travel together on every widget's props type.
576
+ */
577
+ interface WidgetProviderLabels {
578
+ /** Default copy for the built-in error boundary fallback. */
579
+ errorBoundaryFallback: string;
580
+ /** Heading when init reports disclosures are required and not yet accepted. */
581
+ disclosuresRequiredTitle: string;
582
+ /** Heading while a token-only refresh leaves init stale for the live token. */
583
+ disclosuresRefreshingTitle: string;
584
+ /** Supporting copy while the accept action is withheld for a stale init. */
585
+ disclosuresRefreshingDescription: string;
586
+ }
587
+
568
588
  /**
569
589
  * Props for {@link WidgetProvider}.
570
590
  *
@@ -577,8 +597,8 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
577
597
  * Fallback rendered when a render-time exception is caught inside this
578
598
  * provider's subtree. Pass either a `ReactNode` (rendered directly) or a
579
599
  * render-prop receiving `{ error, resetErrorBoundary }` from
580
- * `react-error-boundary`. Default is a plain `role="alert"` div with
581
- * generic copy from `DEFAULT_LABELS.errorBoundaryFallback`.
600
+ * `react-error-boundary`. Default is a plain `role="alert"` div whose copy
601
+ * comes from `providerLabels.errorBoundaryFallback`.
582
602
  */
583
603
  errorFallback?: ReactNode | ((props: FallbackProps) => ReactNode);
584
604
  /**
@@ -595,6 +615,15 @@ interface WidgetProviderProps extends WidgetProviderBaseProps {
595
615
  * WidgetProvider cannot import the widget itself (cycle).
596
616
  */
597
617
  disclosuresAcceptance?: ReactNode;
618
+ /**
619
+ * Overrides for the copy this provider renders in place of the widget: the
620
+ * built-in error-boundary fallback and the disclosures gate. Any subset;
621
+ * unlisted keys keep their defaults. Cascades like `linkComponent`.
622
+ *
623
+ * Named `providerLabels` rather than `labels` because a widget's own
624
+ * `labels` prop sits alongside this one on the same props type.
625
+ */
626
+ providerLabels?: Partial<WidgetProviderLabels>;
598
627
  }
599
628
 
600
629
  /**
@@ -130,7 +130,7 @@ function w({ displayedVersion: e, labelOverrides: t, content: n, labels: i, onAc
130
130
  }
131
131
  });
132
132
  }
133
- function T({ baseUrl: e, widgetToken: n, organizationId: r, configClient: i, gatewayRouting: a, linkComponent: o, implementation: s, uiFramework: c, errorFallback: l, onError: d, analytics: f, disclosuresAcceptance: p, ...m }) {
133
+ function T({ baseUrl: e, widgetToken: n, organizationId: r, configClient: i, gatewayRouting: a, linkComponent: o, implementation: s, uiFramework: c, errorFallback: l, onError: d, analytics: f, disclosuresAcceptance: p, providerLabels: m, ...h }) {
134
134
  return /* @__PURE__ */ b(u, {
135
135
  widgetName: t,
136
136
  baseUrl: e,
@@ -145,7 +145,8 @@ function T({ baseUrl: e, widgetToken: n, organizationId: r, configClient: i, gat
145
145
  onError: d,
146
146
  analytics: f,
147
147
  disclosuresAcceptance: p,
148
- children: /* @__PURE__ */ b(C, { ...m })
148
+ providerLabels: m,
149
+ children: /* @__PURE__ */ b(C, { ...h })
149
150
  });
150
151
  }
151
152
  //#endregion