@tesouro/embedded-components-react 0.5.233 → 0.5.236

package/README.md

@@ -452,20 +452,22 @@ Walks an applicant through bank-account onboarding: business details, personal d
 
 #### Props
 
-| Prop                                        | Type                                           | Default        | Description                                                                                                                        |
-| ------------------------------------------- | ---------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `onEmbeddedOnboardingCompletedSuccessfully` | `() => void`                                   | **Required**   | Called when the application is approved and the account is open.                                                                   |
-| `onNavigateToDashboard`                     | `() => void`                                   | **Required**   | Called when the user clicks the dashboard CTA on the result screen.                                                                |
-| `initialBusinessDetails`                    | `Partial<HostSupplied<BusinessDetailsValues>>` | `undefined`    | Prefills step 1 (business details); the user can still edit.                                                                       |
-| `initialPersonalDetails`                    | `Partial<HostSupplied<PersonalDetailsValues>>` | `undefined`    | Prefills step 2 (personal details); the user can still edit.                                                                       |
-| `initialAdditionalOwners`                   | `HostSuppliedOwner[]`                          | `[]`           | Prefills step 3 (additional owners).                                                                                               |
-| `open`                                      | `boolean`                                      | `undefined`    | Controlled open state for the modal; update it from `onOpenChange`. Omit for uncontrolled mode.                                    |
-| `defaultOpen`                               | `boolean`                                      | `false`        | Initial open state when uncontrolled. Ignored when `open` is set.                                                                  |
-| `onOpenChange`                              | `(open: boolean) => void`                      | `undefined`    | Fires whenever the modal opens or closes (overlay click, Escape, close button, Cancel, save or delete).                            |
-| `labels`                                    | `BankAccountOnboardingWidgetLabels`            | English labels | Per-step and shell copy overrides, merged with the English defaults.                                                               |
-| `bankLogoSrc`                               | `string`                                       | `undefined`    | Bank logo URL for the result screen; falls back to the bank name as text.                                                          |
-| `disclosureLinks`                           | `DisclosureLinks`                              | `undefined`    | URLs for Terms of Use, Privacy Policy, Electronic Communication and Patriot Act on step 1. You resolve these; omit to leave unset. |
-| `isFullScreenInline`                        | `boolean`                                      | `false`        | Renders inline, filling its container, instead of in a modal. `open` / `defaultOpen` are ignored.                                  |
+| Prop                                        | Type                                           | Default        | Description                                                                                                                                                                                                                            |
+| ------------------------------------------- | ---------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `onEmbeddedOnboardingCompletedSuccessfully` | `() => void`                                   | **Required**   | Called when the application is approved and the account is open.                                                                                                                                                                       |
+| `onNavigateToDashboard`                     | `() => void`                                   | **Required**   | Called when the user clicks the dashboard CTA on the result screen.                                                                                                                                                                    |
+| `initialBusinessDetails`                    | `Partial<HostSupplied<BusinessDetailsValues>>` | `undefined`    | Prefills step 1 (business details); the user can still edit.                                                                                                                                                                           |
+| `initialPersonalDetails`                    | `Partial<HostSupplied<PersonalDetailsValues>>` | `undefined`    | Prefills step 2 (personal details); the user can still edit.                                                                                                                                                                           |
+| `initialAdditionalOwners`                   | `HostSuppliedOwner[]`                          | `[]`           | Prefills step 3 (additional owners).                                                                                                                                                                                                   |
+| `open`                                      | `boolean`                                      | `undefined`    | Controlled open state for the modal; update it from `onOpenChange`. Omit for uncontrolled mode.                                                                                                                                        |
+| `defaultOpen`                               | `boolean`                                      | `false`        | Initial open state when uncontrolled. Ignored when `open` is set.                                                                                                                                                                      |
+| `onOpenChange`                              | `(open: boolean) => void`                      | `undefined`    | Fires whenever the modal opens or closes (overlay click, Escape, close button, Cancel, save or delete).                                                                                                                                |
+| `labels`                                    | `BankAccountOnboardingWidgetLabels`            | English labels | Per-step and shell copy overrides, merged with the English defaults.                                                                                                                                                                   |
+| `bankLogoSrc`                               | `string`                                       | `undefined`    | Bank logo URL for the result screen; falls back to the bank name as text.                                                                                                                                                              |
+| `disclosureLinks`                           | `DisclosureLinks`                              | `undefined`    | URLs for Terms of Use, Privacy Policy, Electronic Communication and Patriot Act on step 1. You resolve these; omit to leave unset.                                                                                                     |
+| `isFullScreenInline`                        | `boolean`                                      | `false`        | Renders inline, filling its container, instead of in a modal. `open` / `defaultOpen` are ignored.                                                                                                                                      |
+| `showApplicationStatusRefresh`              | `boolean`                                      | `false`        | Adds a **Check again** button to the application status card that re-reads the organization's application. Never shown over the form or result screens.                                                                                |
+| `onResultPhaseChange`                       | `(isInResultPhase: boolean) => void`           | `undefined`    | Called with `true` once the widget starts processing a submitted application, and with `false` if it unmounts after that. While `true` it keeps its processing or result screen up whatever the status read says, so leave it mounted. |
 
 ### MarketingWidget
 
@@ -507,12 +509,15 @@ Lists, creates, edits and acts on an organization's invoices, quotes and credit
 | -------------------------- | ---------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `defaultTab`               | `ReceivablesWidgetTab`                               | `'invoices'`                             | Initial tab; if omitted or disabled, the widget starts on the first enabled tab.                                                                             |
 | `enabledTabs`              | `ReceivablesWidgetTab[]`                             | `['invoices', 'quotes', 'credit_notes']` | Tabs visible to the user. Duplicate or unknown values are ignored.                                                                                           |
+| `initialCounterpartId`     | `string`                                             | `undefined`                              | Opens the invoice list filtered to this customer, with a chip naming them. Clear all removes it.                                                             |
 | `pageSizeOptions`          | `number[]`                                           | `[10, 25, 50, 100]`                      | Rows-per-page choices. The first page loads with a page size of `10`.                                                                                        |
 | `onReceivableCreated`      | `(id: string, type: ReceivableDocumentType) => void` | `undefined`                              | Called after a create or clone succeeds.                                                                                                                     |
 | `onReceivableOpened`       | `(id: string, type: ReceivableDocumentType) => void` | `undefined`                              | Called when the user opens a row's details panel.                                                                                                            |
 | `onTemplateSettingsClick`  | `() => void`                                         | `undefined`                              | Shows a template settings action in the header and calls this handler when clicked.                                                                          |
 | `embeddedBankName`         | `string`                                             | `undefined`                              | Sponsor bank name shown as "Powered by {embeddedBankName}" next to embedded accounts in the invoice payment-account picker. Omitted when unset.              |
 | `screenLabels`             | `ReceivablesScreenLabelOverrides`                    | English labels                           | Table, tab, filter, empty, error, action and status badge copy.                                                                                              |
+| `filterBarLabels`          | `InvoicesFilterBarLabelOverrides`                    | English labels                           | Invoice filter bar copy: field names, search, amount bounds, the customer panel and Clear all.                                                               |
+| `filterLabels`             | `InvoicesFilterLabelOverrides`                       | English labels                           | Invoice filter copy built from state: date presets, status descriptions and chip wording.                                                                    |
 | `formLabels`               | `Partial<ReceivableFormSheetLabels>`                 | English labels                           | Create/edit form copy; the save and issue buttons are in `messageLabels`.                                                                                    |
 | `detailsLabels`            | `ReceivableDetailsPanelLabelOverrides`               | English labels                           | Details panel copy. Status badge copy comes from `screenLabels.statusBadge`.                                                                                 |
 | `auditHistoryLabels`       | `Partial<ReceivableAuditHistoryLabels>`              | English labels                           | Audit history row copy. Document and status names follow `messageLabels` and `screenLabels.statusBadge` unless overridden here.                              |

package/dist/index.d.ts

@@ -521,6 +521,50 @@ interface RequiredFieldsLegendLabels {
     marker: string;
 }
 
+interface FilterMenuButtonLabels {
+    /** Button text, followed by "(N)" when `activeCount` is set. */
+    filters: string;
+}
+
+interface FilterTagLabels {
+    /**
+     * Accessible name for the editable tag body. `{label}` is substituted with
+     * the tag's own text; keep the placeholder when overriding.
+     */
+    edit: string;
+    /** Accessible name for the × dismiss button. `{label}` is substituted. */
+    remove: string;
+}
+
+interface DateRangePickerLabels {
+    /**
+     * Name of the preset field, rendered before the select (a `:` is appended by
+     * the component). Owners showing more than one date field pass the one that
+     * names theirs, e.g. "Due date range".
+     */
+    fieldLabel: string;
+    /** Select placeholder shown while the range matches no preset. */
+    presetPlaceholder: string;
+}
+
+interface AmountFilterLabels {
+    /**
+     * Rendered next to the min input. Owners pass the wording that matches their
+     * bound semantics — "No less than" for inclusive, "Greater than" for not.
+     */
+    min: string;
+    /** Rendered next to the max input. See {@link min}. */
+    max: string;
+    /** Amount-mode radio options. */
+    modeAny: string;
+    modeExact: string;
+    modeRange: string;
+    /** Flow-direction radio options, shown only when `showFlowDirection`. */
+    flowAny: string;
+    flowIn: string;
+    flowOut: string;
+}
+
 type LinkComponentProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     children?: ReactNode;
 };
@@ -1869,6 +1913,11 @@ interface ApplicationStatusLabels {
     bankDisclosure: string;
     /** Screen-reader name of the dialog's close control, in modal mode. */
     close: string;
+    /**
+     * The re-check control under the card, shown only when the host opts in with
+     * `showApplicationStatusRefresh`.
+     */
+    checkAgain: string;
     /**
      * Formats an application date (an ISO date-time from the status read). A
      * label, not a hardcoded formatter, so a host can localize it with the copy.
@@ -1879,6 +1928,12 @@ interface ApplicationStatusLabels {
     submittedByOther: ApplicationStatusNoticeLabels;
     deniedByYou: ApplicationStatusNoticeLabels;
     deniedByOther: ApplicationStatusNoticeLabels;
+    /**
+     * Shown when a re-check moves a card to a status this widget has nothing to
+     * say about (one added after it shipped, say), so the
+     * re-check control still has somewhere to live.
+     */
+    unavailable: ApplicationStatusNoticeLabels;
 }
 declare const APPLICATION_STATUS_LABELS_EN: ApplicationStatusLabels;
 interface BankAccountOnboardingWidgetLabels {
@@ -1976,6 +2031,12 @@ interface BankAccountOnboardingWidgetInnerProps {
      * scope can start a fresh one. Set by the session scope, not by hosts.
      */
     onApplicationDeleted?: () => void;
+    /**
+     * Called when a re-read of the status replaces a status card with the
+     * form, so the session scope can re-take the resume decision it froze while
+     * the card was showing. Set by the session scope, not by hosts.
+     */
+    onNoticeReplacedByForm?: () => void;
     bankLogoSrc?: string;
     /**
      * Host-resolved disclosure URLs for the business-details agreement step.
@@ -2009,8 +2070,29 @@ interface BankAccountOnboardingWidgetInnerProps {
      * to them (e.g. by unmounting the widget).
      */
     isFullScreenInline?: boolean;
+    /**
+     * Puts a "Check again" control under the application status card, which
+     * re-reads the organization's application.
+     *
+     * The widget providers disable `refetchOnWindowFocus`, so without it a
+     * session looking at a colleague's application has no way to see that
+     * colleague finish short of a reload. Opt-in because a host with its own
+     * refresh affordance (or one that remounts the widget) would get two. The
+     * control renders only with the card, never over the form or the widget's
+     * own processing and result screens.
+     */
+    showApplicationStatusRefresh?: boolean;
+    /**
+     * Called with `true` when the widget starts processing a submitted
+     * application, and with `false` if it unmounts after that. In between, the
+     * widget keeps its processing or result screen up whatever the status read
+     * says, so a host that would otherwise replace the widget on a status change
+     * (as `WidgetSuite` does when the widget would render nothing) should leave
+     * it mounted while this is `true`.
+     */
+    onResultPhaseChange?: (isInResultPhase: boolean) => void;
 }
-type BankAccountOnboardingWidgetProps = WidgetProviderProps & Omit<BankAccountOnboardingWidgetInnerProps, 'initialApplicationId' | 'initialBoundAuthEpoch' | 'initialBusinessDetails' | 'initialPersonalDetails' | 'initialAdditionalOwners' | 'onEditableDraftChange' | 'onApplicationDeleted'> & {
+type BankAccountOnboardingWidgetProps = WidgetProviderProps & Omit<BankAccountOnboardingWidgetInnerProps, 'initialApplicationId' | 'initialBoundAuthEpoch' | 'initialBusinessDetails' | 'initialPersonalDetails' | 'initialAdditionalOwners' | 'onEditableDraftChange' | 'onApplicationDeleted' | 'onNoticeReplacedByForm'> & {
     initialBusinessDetails?: Partial<HostSupplied<BusinessDetailsValues>>;
     initialPersonalDetails?: Partial<HostSupplied<PersonalDetailsValues>>;
     initialAdditionalOwners?: HostSuppliedOwner[];
@@ -3790,30 +3872,41 @@ interface WidgetSuiteDisclosureLabels {
     };
 }
 /**
- * Copy for the suite's entry-point gate — which of onboarding, the "ask your
- * admin" message, or the normal suite a fresh (non-invited) session sees
+ * Copy for the suite's entry-point gate — which of onboarding, the
+ * unavailable state, or the normal suite a fresh (non-invited) session sees
  * before the menu ever renders. Sibling to `disclosure`, which covers the
- * acceptance half of that same gate; only the admin-message state needs copy
- * here, since the onboarding widget and the normal shell carry their own.
+ * acceptance half of that same gate; only the unavailable state needs copy
+ * here, since the onboarding widget (form and status card alike) and the
+ * normal shell carry their own.
  */
 interface WidgetSuiteOnboardingGateLabels {
     /**
      * Shown instead of the onboarding widget when the organization's
-     * bank-account application is already in progress under a different
-     * member. The backend allows one application per organization, so this
-     * session can neither start nor resume one — only that colleague, or an
-     * org admin, can move it forward.
+     * bank-account application is one the widget renders nothing for: denied
+     * more than 30 days ago, or in a status it has no copy for. Without it the
+     * page would be blank.
      */
-    applicationInFlightState: {
+    applicationUnavailableState: {
         title: string;
         body: string;
         /**
          * The widget providers disable `refetchOnWindowFocus`, so nothing else
-         * re-checks whether that colleague has since finished — this button is
-         * the only way forward short of a reload.
+         * re-reads the status — this button is the only way forward short of a
+         * reload.
          */
         retryButton: string;
     };
+    /**
+     * @deprecated Ignored since EMBD-6416. A colleague's application now shows
+     * the onboarding widget's status card, whose copy is under
+     * `onboarding.labels.applicationStatus`. Kept so an existing override still
+     * compiles; it will be removed in a future major version.
+     */
+    applicationInFlightState: {
+        title: string;
+        body: string;
+        retryButton: string;
+    };
 }
 /**
  * A widget's whole copy surface: every label prop it accepts, spread onto it so
@@ -4020,9 +4113,10 @@ interface WidgetSuiteProps extends WidgetProviderProps {
  * before the shell renders: placeholders while either has not settled, a
  * closed retry state when init fails before answering the disclosure flags,
  * the acceptance surface alone when the session owes the bank's disclosures,
- * full-screen onboarding for a session whose organization has no application
- * yet, an "ask your admin" message when a teammate's is already in flight, or
- * the nav over its sections. An invited session, or one this init already
+ * full-screen onboarding for a prospect session (the form, or the widget's
+ * status card for an application already under way), a closed "check again"
+ * state for an application the widget has nothing to show for, or the nav
+ * over its sections. An invited session, or one this init already
  * reports ACTIVE/INACTIVE, skips the application question entirely and goes
  * straight to the disclosure gate — which also means neither a failed
  * status read nor a teammate's in-flight application can blank the suite for
@@ -4850,6 +4944,34 @@ interface ProductMessageLabels {
     updateMeasureUnitError: string;
 }
 
+declare const InvoicesFilterField: {
+    readonly DueDate: "dueDate";
+    readonly CreatedAt: "createdAt";
+    readonly IssueDate: "issueDate";
+    readonly Status: "status";
+    readonly Amount: "amount";
+    readonly Customer: "customer";
+};
+type InvoicesFilterField = (typeof InvoicesFilterField)[keyof typeof InvoicesFilterField];
+type InvoicesDateFilterField = typeof InvoicesFilterField.DueDate | typeof InvoicesFilterField.CreatedAt | typeof InvoicesFilterField.IssueDate;
+
+interface InvoicesFilterBarLabels {
+    fields: Record<InvoicesFilterField, string>;
+    searchPlaceholder: string;
+    searchLabel: string;
+    amountMin: string;
+    amountMax: string;
+    customerNameHeading: string;
+    customerSearchPlaceholder: string;
+    customerSearchHint: string;
+    clearAll: string;
+    filterMenuButton: FilterMenuButtonLabels;
+    filterTag: FilterTagLabels;
+    amountFilter: Omit<AmountFilterLabels, 'min' | 'max'>;
+    dateRangePicker: Omit<DateRangePickerLabels, 'fieldLabel'>;
+}
+type InvoicesFilterBarLabelOverrides = PartialDeep<InvoicesFilterBarLabels>;
+
 interface ReceivableActionsModalLabels {
     issueDescription: string;
     toLabel: string;
@@ -5149,6 +5271,39 @@ interface ReceivableActionDialogLabels {
 type ReceivableDocumentType = ReceivableDocumentKind;
 type ReceivablesWidgetTab = 'invoices' | 'quotes' | 'credit_notes';
 
+declare const InvoicesDatePreset: {
+    readonly Today: "today";
+    readonly ThisWeek: "this_week";
+    readonly ThisMonth: "this_month";
+    readonly ThisQuarter: "this_quarter";
+    readonly ThisYear: "this_year";
+    readonly Yesterday: "yesterday";
+    readonly LastWeek: "last_week";
+    readonly LastMonth: "last_month";
+    readonly Last30Days: "last_30_days";
+    readonly Last90Days: "last_90_days";
+    readonly LastQuarter: "last_quarter";
+    readonly LastYear: "last_year";
+};
+type InvoicesDatePreset = (typeof InvoicesDatePreset)[keyof typeof InvoicesDatePreset];
+
+interface InvoicesFilterLabels {
+    presets: Record<InvoicesDatePreset, string>;
+    presetGroupCurrent: string;
+    presetGroupPast: string;
+    dateFieldNames: Record<InvoicesDateFilterField, string>;
+    customRange: string;
+    /** Shown under a status option; a status with no entry shows none. */
+    statusDescriptions: Partial<Record<string, string>>;
+    dateChip: (fieldLabel: string, range: string) => string;
+    statusChip: (value: string) => string;
+    moreSelected: (first: string, count: number) => string;
+    customerChip: (name: string) => string;
+    amountChip: string;
+    searchChip: (value: string) => string;
+}
+type InvoicesFilterLabelOverrides = PartialDeep<InvoicesFilterLabels>;
+
 interface ReceivableMessageLabels {
     customerRequired: string;
     customerAddressRequired: string;
@@ -5457,11 +5612,15 @@ interface ReceivablesWidgetOwnProps {
     /** Sponsor bank shown as "Powered by {bank}" beside embedded accounts. */
     embeddedBankName?: string;
     enabledTabs?: ReceivablesWidgetTab[];
+    /** Opens the invoice list filtered to this customer. */
+    initialCounterpartId?: string;
     pageSizeOptions?: number[];
     onReceivableCreated?: (id: string, type: ReceivableDocumentType) => void;
     onReceivableOpened?: (id: string, type: ReceivableDocumentType) => void;
     onTemplateSettingsClick?: () => void;
     screenLabels?: ReceivablesScreenLabelOverrides;
+    filterBarLabels?: InvoicesFilterBarLabelOverrides;
+    filterLabels?: InvoicesFilterLabelOverrides;
     formLabels?: Partial<ReceivableFormSheetLabels>;
     detailsLabels?: ReceivableDetailsPanelLabelOverrides;
     auditHistoryLabels?: Partial<ReceivableAuditHistoryLabels>;
@@ -5908,4 +6067,4 @@ interface GapCoverageAlertProps {
 type PendingFeatureStyleSources = CheckAmountAndDetailScreenProps | GapCoverageAlertProps | NoPolicyBannerProps;
 
 export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, APPLICATION_STATUS_LABELS_EN, AcceptDisclosuresWidget, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CardDetailsWidget, CounterpartsWidget, CreditCardsWidget, CustomersWidget, DebitCardsWidget, ERROR_STATE_ID, ExpenseManagementWidget, HELP_FAQ_EN, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, MARKETING_WIDGET_LABELS_EN, MARKETING_WIDGET_STATUS_LABELS_EN, MarketingBenefitIcon, MarketingWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, RESULT_LABELS_EN, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, Scope, SettingsSection, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TransfersWidget, UIFramework, UploadReceiptWidget, WIDGET_SUITE_DEFAULT_SECTIONS, WIDGET_SUITE_LABELS_EN, WidgetProvider, WidgetSuite, WidgetSuiteSectionId, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, getGlobalWidgetInitState, isScope, registerDesignSystemEnsurer, registerUIRenderers, setGlobalWidgetConfig, subscribeToGlobalWidgetInitState, updateGlobalWidgetConfig, useDisclosuresAcceptanceSurface, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetInitStaleForToken, useWidgetLoading, useWidgetToken };
-export type { AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, AccordionItemCardLabels, Labels$3 as AccountDetailsWidgetLabels, ActivateCardPanelLabels, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, ApplicationStatusLabelValues, ApplicationStatusLabels, ApplicationStatusNoticeLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$3 as BankAccountsWidgetFeatureLabels, Labels$4 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels, CardsListLabels as CardsLabels, CardsPagination, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartActionTarget, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, CreditCardsWidgetProps, CustomersWidgetOwnProps, CustomersWidgetProps, DebitCardsWidgetProps, DisclosureLinks, EmbeddedClient, Labels$2 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseStatusBadgeLabels, FileViewerLabels, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LinkComponent, LinkComponentProps, FeatureLabels$2 as LinkedAccountsWidgetFeatureLabels, Labels$1 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingStatusLabelValues, MarketingStatusNoticeLabels, MarketingWidgetAppearance, MarketingWidgetBenefit, MarketingWidgetContent, MarketingWidgetHowItWorksStep, MarketingWidgetImage, MarketingWidgetLabels, MarketingWidgetProps, MarketingWidgetStatusLabels, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, ReceiptMatchSummary, ReceivableActionDialogLabels, ReceivableActionsModalLabels, ReceivableAuditHistoryLabels, ReceivableDetailsPanelLabelOverrides, ReceivableDetailsPanelLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, SettingsWidgetAdditionalSection, FeatureLabels$1 as SettingsWidgetFeatureLabels, Labels as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId, SingleInsightLabels, TransactionDetailsActionsLabels, TransactionDetailsLabels, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderLabels, WidgetProviderProps, WidgetSuiteCardsLabels, WidgetSuiteDashboardLabels, WidgetSuiteDisclosureLabels, WidgetSuiteExpensesLabels, WidgetSuiteLabelOverrides, WidgetSuiteLabels, WidgetSuiteMenuLabels, WidgetSuiteOnboardingGateLabels, WidgetSuiteOnboardingLabels, WidgetSuiteProps, WidgetSuiteSectionContentLabels, WidgetSuiteSectionTitleLabels, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };
+export type { AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, AccordionItemCardLabels, Labels$3 as AccountDetailsWidgetLabels, ActivateCardPanelLabels, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, ApplicationStatusLabelValues, ApplicationStatusLabels, ApplicationStatusNoticeLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$3 as BankAccountsWidgetFeatureLabels, Labels$4 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels, CardsListLabels as CardsLabels, CardsPagination, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartActionTarget, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, CreditCardsWidgetProps, CustomersWidgetOwnProps, CustomersWidgetProps, DebitCardsWidgetProps, DisclosureLinks, EmbeddedClient, Labels$2 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseStatusBadgeLabels, FileViewerLabels, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, InvoicesFilterBarLabelOverrides, InvoicesFilterBarLabels, InvoicesFilterLabelOverrides, InvoicesFilterLabels, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LinkComponent, LinkComponentProps, FeatureLabels$2 as LinkedAccountsWidgetFeatureLabels, Labels$1 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingStatusLabelValues, MarketingStatusNoticeLabels, MarketingWidgetAppearance, MarketingWidgetBenefit, MarketingWidgetContent, MarketingWidgetHowItWorksStep, MarketingWidgetImage, MarketingWidgetLabels, MarketingWidgetProps, MarketingWidgetStatusLabels, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, ReceiptMatchSummary, ReceivableActionDialogLabels, ReceivableActionsModalLabels, ReceivableAuditHistoryLabels, ReceivableDetailsPanelLabelOverrides, ReceivableDetailsPanelLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, SettingsWidgetAdditionalSection, FeatureLabels$1 as SettingsWidgetFeatureLabels, Labels as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId, SingleInsightLabels, TransactionDetailsActionsLabels, TransactionDetailsLabels, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderLabels, WidgetProviderProps, WidgetSuiteCardsLabels, WidgetSuiteDashboardLabels, WidgetSuiteDisclosureLabels, WidgetSuiteExpensesLabels, WidgetSuiteLabelOverrides, WidgetSuiteLabels, WidgetSuiteMenuLabels, WidgetSuiteOnboardingGateLabels, WidgetSuiteOnboardingLabels, WidgetSuiteProps, WidgetSuiteSectionContentLabels, WidgetSuiteSectionTitleLabels, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };

package/dist/index.js

@@ -27,7 +27,7 @@ import { InsightsWidget as L } from "./libs/tesouro-embedded-components-react/in
 import { UploadReceiptWidget as R } from "./libs/tesouro-embedded-components-react/upload-receipt-widget/feature/dist/index2.js";
 import { ExpenseManagementWidget as z } from "./libs/tesouro-embedded-components-react/expense-management-widget/feature/dist/index19.js";
 import { InvoicingWidget as B } from "./libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index3.js";
-import { ReceivablesWidget as V } from "./libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index36.js";
+import { ReceivablesWidget as V } from "./libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index40.js";
 import { SettingsSection as H } from "./libs/tesouro-embedded-components-react/settings-widget/feature/dist/index4.js";
 import { HELP_FAQ_EN as U } from "./libs/tesouro-embedded-components-react/settings-widget/help/ui/contract/dist/index3.js";
 import { SettingsWidget as W } from "./libs/tesouro-embedded-components-react/settings-widget/feature/dist/index6.js";

package/dist/lib/BankAccountOnboardingWidget.d.ts

@@ -981,6 +981,11 @@ interface ApplicationStatusLabels {
     bankDisclosure: string;
     /** Screen-reader name of the dialog's close control, in modal mode. */
     close: string;
+    /**
+     * The re-check control under the card, shown only when the host opts in with
+     * `showApplicationStatusRefresh`.
+     */
+    checkAgain: string;
     /**
      * Formats an application date (an ISO date-time from the status read). A
      * label, not a hardcoded formatter, so a host can localize it with the copy.
@@ -991,6 +996,12 @@ interface ApplicationStatusLabels {
     submittedByOther: ApplicationStatusNoticeLabels;
     deniedByYou: ApplicationStatusNoticeLabels;
     deniedByOther: ApplicationStatusNoticeLabels;
+    /**
+     * Shown when a re-check moves a card to a status this widget has nothing to
+     * say about (one added after it shipped, say), so the
+     * re-check control still has somewhere to live.
+     */
+    unavailable: ApplicationStatusNoticeLabels;
 }
 declare const APPLICATION_STATUS_LABELS_EN: ApplicationStatusLabels;
 interface BankAccountOnboardingWidgetLabels {
@@ -1088,6 +1099,12 @@ interface BankAccountOnboardingWidgetInnerProps {
      * scope can start a fresh one. Set by the session scope, not by hosts.
      */
     onApplicationDeleted?: () => void;
+    /**
+     * Called when a re-read of the status replaces a status card with the
+     * form, so the session scope can re-take the resume decision it froze while
+     * the card was showing. Set by the session scope, not by hosts.
+     */
+    onNoticeReplacedByForm?: () => void;
     bankLogoSrc?: string;
     /**
      * Host-resolved disclosure URLs for the business-details agreement step.
@@ -1121,8 +1138,29 @@ interface BankAccountOnboardingWidgetInnerProps {
      * to them (e.g. by unmounting the widget).
      */
     isFullScreenInline?: boolean;
+    /**
+     * Puts a "Check again" control under the application status card, which
+     * re-reads the organization's application.
+     *
+     * The widget providers disable `refetchOnWindowFocus`, so without it a
+     * session looking at a colleague's application has no way to see that
+     * colleague finish short of a reload. Opt-in because a host with its own
+     * refresh affordance (or one that remounts the widget) would get two. The
+     * control renders only with the card, never over the form or the widget's
+     * own processing and result screens.
+     */
+    showApplicationStatusRefresh?: boolean;
+    /**
+     * Called with `true` when the widget starts processing a submitted
+     * application, and with `false` if it unmounts after that. In between, the
+     * widget keeps its processing or result screen up whatever the status read
+     * says, so a host that would otherwise replace the widget on a status change
+     * (as `WidgetSuite` does when the widget would render nothing) should leave
+     * it mounted while this is `true`.
+     */
+    onResultPhaseChange?: (isInResultPhase: boolean) => void;
 }
-type BankAccountOnboardingWidgetProps = WidgetProviderProps & Omit<BankAccountOnboardingWidgetInnerProps, 'initialApplicationId' | 'initialBoundAuthEpoch' | 'initialBusinessDetails' | 'initialPersonalDetails' | 'initialAdditionalOwners' | 'onEditableDraftChange' | 'onApplicationDeleted'> & {
+type BankAccountOnboardingWidgetProps = WidgetProviderProps & Omit<BankAccountOnboardingWidgetInnerProps, 'initialApplicationId' | 'initialBoundAuthEpoch' | 'initialBusinessDetails' | 'initialPersonalDetails' | 'initialAdditionalOwners' | 'onEditableDraftChange' | 'onApplicationDeleted' | 'onNoticeReplacedByForm'> & {
     initialBusinessDetails?: Partial<HostSupplied<BusinessDetailsValues>>;
     initialPersonalDetails?: Partial<HostSupplied<PersonalDetailsValues>>;
     initialAdditionalOwners?: HostSuppliedOwner[];

package/dist/lib/ReceivablesWidget.d.ts

@@ -369,6 +369,50 @@ interface RequiredFieldsLegendLabels {
     marker: string;
 }
 
+interface FilterMenuButtonLabels {
+    /** Button text, followed by "(N)" when `activeCount` is set. */
+    filters: string;
+}
+
+interface FilterTagLabels {
+    /**
+     * Accessible name for the editable tag body. `{label}` is substituted with
+     * the tag's own text; keep the placeholder when overriding.
+     */
+    edit: string;
+    /** Accessible name for the × dismiss button. `{label}` is substituted. */
+    remove: string;
+}
+
+interface DateRangePickerLabels {
+    /**
+     * Name of the preset field, rendered before the select (a `:` is appended by
+     * the component). Owners showing more than one date field pass the one that
+     * names theirs, e.g. "Due date range".
+     */
+    fieldLabel: string;
+    /** Select placeholder shown while the range matches no preset. */
+    presetPlaceholder: string;
+}
+
+interface AmountFilterLabels {
+    /**
+     * Rendered next to the min input. Owners pass the wording that matches their
+     * bound semantics — "No less than" for inclusive, "Greater than" for not.
+     */
+    min: string;
+    /** Rendered next to the max input. See {@link min}. */
+    max: string;
+    /** Amount-mode radio options. */
+    modeAny: string;
+    modeExact: string;
+    modeRange: string;
+    /** Flow-direction radio options, shown only when `showFlowDirection`. */
+    flowAny: string;
+    flowIn: string;
+    flowOut: string;
+}
+
 type LinkComponentProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     children?: ReactNode;
 };
@@ -909,6 +953,34 @@ interface ProductMessageLabels {
     updateMeasureUnitError: string;
 }
 
+declare const InvoicesFilterField: {
+    readonly DueDate: "dueDate";
+    readonly CreatedAt: "createdAt";
+    readonly IssueDate: "issueDate";
+    readonly Status: "status";
+    readonly Amount: "amount";
+    readonly Customer: "customer";
+};
+type InvoicesFilterField = (typeof InvoicesFilterField)[keyof typeof InvoicesFilterField];
+type InvoicesDateFilterField = typeof InvoicesFilterField.DueDate | typeof InvoicesFilterField.CreatedAt | typeof InvoicesFilterField.IssueDate;
+
+interface InvoicesFilterBarLabels {
+    fields: Record<InvoicesFilterField, string>;
+    searchPlaceholder: string;
+    searchLabel: string;
+    amountMin: string;
+    amountMax: string;
+    customerNameHeading: string;
+    customerSearchPlaceholder: string;
+    customerSearchHint: string;
+    clearAll: string;
+    filterMenuButton: FilterMenuButtonLabels;
+    filterTag: FilterTagLabels;
+    amountFilter: Omit<AmountFilterLabels, 'min' | 'max'>;
+    dateRangePicker: Omit<DateRangePickerLabels, 'fieldLabel'>;
+}
+type InvoicesFilterBarLabelOverrides = PartialDeep<InvoicesFilterBarLabels>;
+
 interface ReceivableActionsModalLabels {
     issueDescription: string;
     toLabel: string;
@@ -1208,6 +1280,39 @@ interface ReceivableActionDialogLabels {
 type ReceivableDocumentType = ReceivableDocumentKind;
 type ReceivablesWidgetTab = 'invoices' | 'quotes' | 'credit_notes';
 
+declare const InvoicesDatePreset: {
+    readonly Today: "today";
+    readonly ThisWeek: "this_week";
+    readonly ThisMonth: "this_month";
+    readonly ThisQuarter: "this_quarter";
+    readonly ThisYear: "this_year";
+    readonly Yesterday: "yesterday";
+    readonly LastWeek: "last_week";
+    readonly LastMonth: "last_month";
+    readonly Last30Days: "last_30_days";
+    readonly Last90Days: "last_90_days";
+    readonly LastQuarter: "last_quarter";
+    readonly LastYear: "last_year";
+};
+type InvoicesDatePreset = (typeof InvoicesDatePreset)[keyof typeof InvoicesDatePreset];
+
+interface InvoicesFilterLabels {
+    presets: Record<InvoicesDatePreset, string>;
+    presetGroupCurrent: string;
+    presetGroupPast: string;
+    dateFieldNames: Record<InvoicesDateFilterField, string>;
+    customRange: string;
+    /** Shown under a status option; a status with no entry shows none. */
+    statusDescriptions: Partial<Record<string, string>>;
+    dateChip: (fieldLabel: string, range: string) => string;
+    statusChip: (value: string) => string;
+    moreSelected: (first: string, count: number) => string;
+    customerChip: (name: string) => string;
+    amountChip: string;
+    searchChip: (value: string) => string;
+}
+type InvoicesFilterLabelOverrides = PartialDeep<InvoicesFilterLabels>;
+
 interface ReceivableMessageLabels {
     customerRequired: string;
     customerAddressRequired: string;
@@ -1516,11 +1621,15 @@ interface ReceivablesWidgetOwnProps {
     /** Sponsor bank shown as "Powered by {bank}" beside embedded accounts. */
     embeddedBankName?: string;
     enabledTabs?: ReceivablesWidgetTab[];
+    /** Opens the invoice list filtered to this customer. */
+    initialCounterpartId?: string;
     pageSizeOptions?: number[];
     onReceivableCreated?: (id: string, type: ReceivableDocumentType) => void;
     onReceivableOpened?: (id: string, type: ReceivableDocumentType) => void;
     onTemplateSettingsClick?: () => void;
     screenLabels?: ReceivablesScreenLabelOverrides;
+    filterBarLabels?: InvoicesFilterBarLabelOverrides;
+    filterLabels?: InvoicesFilterLabelOverrides;
     formLabels?: Partial<ReceivableFormSheetLabels>;
     detailsLabels?: ReceivableDetailsPanelLabelOverrides;
     auditHistoryLabels?: Partial<ReceivableAuditHistoryLabels>;
@@ -1541,4 +1650,4 @@ type ReceivablesWidgetProps = WidgetProviderProps & ReceivablesWidgetOwnProps;
 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, ReceivableActionsModalLabels, ReceivableAuditHistoryLabels, ReceivableDetailsPanelLabelOverrides, ReceivableDetailsPanelLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab };
+export type { CounterpartFormSheetLabels, CounterpartMessageLabels, InvoicesFilterBarLabelOverrides, InvoicesFilterBarLabels, InvoicesFilterLabelOverrides, InvoicesFilterLabels, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, ProductFormSheetLabels, ProductMessageLabels, ReceivableActionDialogLabels, ReceivableActionsModalLabels, ReceivableAuditHistoryLabels, ReceivableDetailsPanelLabelOverrides, ReceivableDetailsPanelLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab };

package/dist/lib/ReceivablesWidget.js

@@ -1,3 +1,3 @@
-import { ReceivablesWidget as e } from "../libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index36.js";
+import { ReceivablesWidget as e } from "../libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index40.js";
 import "../libs/tesouro-embedded-components-react/invoicing-widget/feature/dist/index.js";
 export { e as ReceivablesWidget };