@tesouro/embedded-components-react 0.2.177 → 0.2.181

package/README.md

@@ -308,12 +308,12 @@ A self-contained Help widget: a static FAQ accordion with an optional "Contact U
 
 #### Props
 
-| Prop         | Type                        | Default                 | Description                                                                         |
-| ------------ | --------------------------- | ----------------------- | ----------------------------------------------------------------------------------- |
-| `faq`        | `HelpFaqSection[]`          | `HELP_FAQ_EN`           | FAQ content to render, grouped into titled sections.                                |
-| `bankName`   | `string`                    | `undefined`             | Bank/provider name interpolated into the contact line.                              |
-| `contactUrl` | `string`                    | `undefined`             | When set, renders a "Contact Us" card linking here. Omit to hide it.                |
-| `labels`     | `Partial<HelpWidgetLabels>` | `HELP_WIDGET_LABELS_EN` | Display-string overrides, merged over `HELP_WIDGET_LABELS_EN` (FAQ + contact copy). |
+| Prop         | Type                        | Default                 | Description                                                                                                                                    |
+| ------------ | --------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `faq`        | `HelpFaqSection[]`          | `HELP_FAQ_EN`           | FAQ content to render, grouped into titled sections.                                                                                           |
+| `bankName`   | `string`                    | `initResponse.bankName` | Bank/provider name interpolated into the contact line. Defaults to the bank resolved by widget init; pass this only to override it.            |
+| `contactUrl` | `string`                    | `undefined`             | When set, renders a "Contact Us" card linking here. Omit to hide it. The card also needs a bank name, so it appears once widget init resolves. |
+| `labels`     | `Partial<HelpWidgetLabels>` | `HELP_WIDGET_LABELS_EN` | Display-string overrides, merged over `HELP_WIDGET_LABELS_EN` (FAQ + contact copy).                                                            |
 
 ### InvoicingWidget
 
@@ -450,6 +450,7 @@ A composite settings widget that combines Monite document settings, tags, GL cod
 | `accountingContent`       | `ReactNode`              | GL code table widget              | Replaces accounting content.                                                                                                                                                                                                                                                                                           |
 | `tagsContent`             | `ReactNode`              | Monite tags                       | Replaces tags content.                                                                                                                                                                                                                                                                                                 |
 | `expenseContent`          | `ReactNode`              | Expense policies and requirements | Replaces expense content.                                                                                                                                                                                                                                                                                              |
+| `helpContactUrl`          | `string`                 | `undefined`                       | Forwarded to the Help section's widget — where its "Contact Us" line links (a support page URL or a `mailto:`). The line is hidden while unset, since the package has no tenant-agnostic support address to fall back on; the bank name in that line comes from widget init.                                           |
 | `helpContent`             | `ReactNode`              | Help widget                       | Replaces the help section content.                                                                                                                                                                                                                                                                                     |
 | `finopsThemeColors`       | `FinopsThemeColors`      | `undefined`                       | Optional Monite theme color overrides.                                                                                                                                                                                                                                                                                 |
 

package/dist/index.css

@@ -657,6 +657,9 @@
   .ttw\:h-0\.5 {
     height: calc(var(--ttw-spacing) * 0.5);
   }
+  .ttw\:h-1 {
+    height: var(--ttw-spacing);
+  }
   .ttw\:h-1\.5 {
     height: calc(var(--ttw-spacing) * 1.5);
   }
@@ -714,6 +717,9 @@
   .ttw\:h-16\.5 {
     height: calc(var(--ttw-spacing) * 16.5);
   }
+  .ttw\:h-18 {
+    height: calc(var(--ttw-spacing) * 18);
+  }
   .ttw\:h-21 {
     height: calc(var(--ttw-spacing) * 21);
   }
@@ -744,9 +750,6 @@
   .ttw\:h-\[92px\] {
     height: 92px;
   }
-  .ttw\:h-\[168px\] {
-    height: 168px;
-  }
   .ttw\:h-\[190px\] {
     height: 190px;
   }
@@ -1128,6 +1131,9 @@
   .ttw\:w-\[35\%\] {
     width: 35%;
   }
+  .ttw\:w-\[42px\] {
+    width: 42px;
+  }
   .ttw\:w-\[55\%\] {
     width: 55%;
   }
@@ -1143,6 +1149,9 @@
   .ttw\:w-\[90\%\] {
     width: 90%;
   }
+  .ttw\:w-\[90px\] {
+    width: 90px;
+  }
   .ttw\:w-\[300px\] {
     width: 300px;
   }
@@ -1838,9 +1847,15 @@
   .ttw\:rounded-3xl {
     border-radius: calc(var(--ttw-radius) + 12px);
   }
+  .ttw\:rounded-\[1px\] {
+    border-radius: 1px;
+  }
   .ttw\:rounded-\[2px\] {
     border-radius: 2px;
   }
+  .ttw\:rounded-\[3\.5px\] {
+    border-radius: 3.5px;
+  }
   .ttw\:rounded-\[4px\] {
     border-radius: 4px;
   }
@@ -2323,6 +2338,9 @@
   .ttw\:bg-muted {
     background-color: var(--ttw-muted);
   }
+  .ttw\:bg-muted-foreground {
+    background-color: var(--ttw-muted-foreground);
+  }
   .ttw\:bg-muted\/30 {
     background-color: var(--ttw-muted);
     @supports (color: color-mix(in lab, red, red)) {

package/dist/index.d.ts

@@ -3,8 +3,8 @@ import { ReactNode, ComponentType, AnchorHTMLAttributes, PropsWithChildren, Erro
 import { FallbackProps } from 'react-error-boundary';
 import { SortingState, OnChangeFn } from '@tanstack/react-table';
 
-type PartialDeep$2<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$2<T[K]> : T[K];
+type PartialDeep$3<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$3<T[K]> : T[K];
 };
 interface AcceptDisclosuresWidgetLabels {
     title: string;
@@ -41,7 +41,7 @@ interface AcceptDisclosuresWidgetProps$1 {
     isAgreed: boolean;
     onAgreedChange: (checked: boolean) => void;
     onAccept: () => void;
-    labels?: PartialDeep$2<AcceptDisclosuresWidgetLabels>;
+    labels?: PartialDeep$3<AcceptDisclosuresWidgetLabels>;
 }
 
 type AuthToken = string | undefined;
@@ -467,6 +467,12 @@ declare function registerUIRenderers(framework: UIFramework, map: RendererMap):
  */
 declare function registerDesignSystemEnsurer(framework: UIFramework, ensurer: DesignSystemEnsurer): void;
 
+interface PaginationFooterLabels {
+    rowsPerPageLabel: string;
+    previousPageButton: string;
+    nextPageButton: string;
+}
+
 /**
  * The implementation a widget renders with.
  *
@@ -2093,7 +2099,8 @@ declare const HELP_WIDGET_LABELS_EN: HelpWidgetLabels;
 interface HelpWidgetProps$1 {
     /** FAQ content to render, grouped into titled sections. */
     faq: HelpFaqSection[];
-    /** Bank/provider name interpolated into the contact line. */
+    /** Bank/provider name interpolated into the contact line. Defaulted from the
+     * widget-init response by {@link HelpWidget}, so hosts rarely pass it. */
     bankName?: string;
     /** When set, renders a "Contact Us" card linking here. Omit to hide it. */
     contactUrl?: string;
@@ -2764,8 +2771,8 @@ interface DisclosureLinks {
 }
 
 /** Nested keys are individually optional — see AGENTS.md labels guidance. */
-type PartialDeep$1<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$1<T[K]> : T[K];
+type PartialDeep$2<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$2<T[K]> : T[K];
 };
 interface BankAccountOnboardingWidgetLabels {
     stepIndicator: {
@@ -2774,7 +2781,7 @@ interface BankAccountOnboardingWidgetLabels {
         ownership: string;
         done: string;
     };
-    businessDetails: PartialDeep$1<BusinessDetailsLabels>;
+    businessDetails: PartialDeep$2<BusinessDetailsLabels>;
     personalDetails: Partial<PersonalDetailsLabels>;
     additionalOwners: Partial<AdditionalOwnersLabels>;
     result: ResultLabels;
@@ -2804,7 +2811,7 @@ interface BankAccountOnboardingWidgetLabels {
 interface BankAccountOnboardingWidgetInnerProps {
     onEmbeddedOnboardingCompletedSuccessfully: () => void;
     onNavigateToDashboard: () => void;
-    labels?: PartialDeep$1<BankAccountOnboardingWidgetLabels>;
+    labels?: PartialDeep$2<BankAccountOnboardingWidgetLabels>;
     initialBusinessDetails?: Partial<BusinessDetailsValues>;
     initialPersonalDetails?: Partial<PersonalDetailsValues>;
     initialAdditionalOwners?: AdditionalOwner[];
@@ -3000,6 +3007,12 @@ interface SettingsWidgetProps extends MoniteRegionProviderProps {
      * registered landing route differs from that default, or the origin is
      * not on the OIDC redirect-URI allowlist (preview/localhost). */
     acceptInviteRedirectUri?: string;
+    /** Forwarded to the embedded Help section's {@link HelpWidget} — where its
+     * "Contact Us" line links (a support page URL or a `mailto:`). The line is
+     * hidden entirely when unset, since the package has no tenant-agnostic
+     * support address to fall back on. The bank name in that line comes from
+     * widget init, so this is the only value a host needs to supply. */
+    helpContactUrl?: string;
     profileContent?: ReactNode;
     teamContent?: ReactNode;
     billPayContent?: ReactNode;
@@ -3519,8 +3532,8 @@ interface GapCoverageAlertProps {
  * the rest of that group. The repo has no shared `PartialDeep` and does not
  * depend on `type-fest`, so each labels module defines its own.
  */
-type PartialDeep<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep<T[K]> : T[K];
+type PartialDeep$1<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$1<T[K]> : T[K];
 };
 /** Accessible copy for the panel header's controls. */
 interface CardDetailsHeaderLabels {
@@ -3577,19 +3590,19 @@ interface CardDetailsPanelLabels {
  * screen. `CARD_STATUS_TONE` and `CARD_STATUS_LABELS_EN` live in
  * `shared/feature` instead (EMBD-4503), and both widgets read from there.
  */
-type CardStatusTone = 'success' | 'info' | 'warning' | 'neutral';
+type CardStatusTone$1 = 'success' | 'info' | 'warning' | 'neutral';
 
 /** Which of the four screens the panel renders. */
 type CardDetailsPanelState = 'loading' | 'error' | 'notFound' | 'loaded';
 interface CardDetailsPanelProps {
-    labels?: PartialDeep<CardDetailsPanelLabels>;
+    labels?: PartialDeep$1<CardDetailsPanelLabels>;
     state: CardDetailsPanelState;
     /** Card nickname. Absent falls back to `labels.header.untitledCard`. */
     nickname?: string;
     /** Already-resolved status wording, e.g. "Active". */
     statusLabel?: string;
     /** Already-resolved presentational tone for the status badge. */
-    statusTone?: CardStatusTone;
+    statusTone?: CardStatusTone$1;
     /** Form-factor subtitle, e.g. "Virtual". */
     formFactorLabel?: string;
     /** Items for the kebab menu. Absent renders no kebab. */
@@ -3618,16 +3631,170 @@ interface CardDetailsPanelProps {
     className?: string;
 }
 
-interface CardsStyleProbeLabels {
+/**
+ * Every key of `T` optional, recursively, so a consumer can override one nested
+ * label without restating its siblings. Defined locally because the repo has no
+ * shared deep-partial type and does not depend on `type-fest`.
+ */
+type PartialDeep<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep<T[K]> : T[K];
+};
+interface CardsListColumnHeaderLabels {
+    cardName: string;
+    fundingAccount: string;
+    cardholder: string;
+    status: string;
+    limit: string;
+}
+/**
+ * Every user-facing string the cards list renders, including screen-reader-only
+ * copy and the decorative separators.
+ *
+ * There is intentionally **no** card-type or card-status map here: the row
+ * arrives with `typeLabel` and `statusLabel` already resolved, so the
+ * `DIGITAL`/`PHYSICAL` and `PENDING_ACTIVATION`/`ACTIVE`/`LOCKED`/`CLOSED` maps
+ * live in `shared/feature` keyed on the generated types (EMBD-4404 amendment;
+ * see `statusBadge.ts`). That is also where the "label keys carry the code term,
+ * values carry the copy" rule applies — `digital`, never `virtual`, so a later
+ * wording change is not a breaking rename.
+ */
+interface CardsListLabels {
     title: string;
-    body: string;
+    /** Accessible name for the list region. */
+    regionLabel: string;
+    columnHeaders: CardsListColumnHeaderLabels;
+    /** Screen-reader name for the unheaded trailing row-actions column. */
+    rowActionsColumn: string;
+    showMyCardsToggle: string;
+    createCardButton: string;
+    activateButton: string;
+    /** Accessible name for a row's Activate button; the card name is appended. */
+    activateButtonForCard: string;
+    /** Accessible name for a row's open-details control; card name appended. */
+    selectCardButton: string;
+    /** Separator between a card's nickname and its last four digits. */
+    cardNameSeparator: string;
+    /** Stands in for the limit when a card has none set. */
+    noLimit: string;
+    /** Announced while a page of cards is loading. */
+    loadingLabel: string;
+    emptyTitle: string;
+    emptyDescription: string;
+    errorTitle: string;
+    errorDescription: string;
+    retryButton: string;
+    pagination: PaginationFooterLabels;
 }
 
-interface CardsStyleProbeProps {
-    labels?: Partial<CardsStyleProbeLabels>;
+/**
+ * Presentational tone for a card's status chip. The feature layer decides which
+ * tone a domain status maps to; this UI helper only turns a tone into colors, so
+ * the library never encodes card-status semantics.
+ *
+ * This follows `team-widget/ui/src/lib/TeamMembersTable/statusBadge.ts` rather
+ * than `bill-pay-widget`'s `Record<PayableBadgeStatus, string>`: the two in-repo
+ * precedents disagree, and EMBD-4404 settled it in favour of `team-widget`.
+ * `CARD_STATUS_TONE` / `CARD_STATUS_LABELS_EN` / `CARD_TYPE_LABELS_EN` live in
+ * `shared/feature` (keyed on the generated types) so the list badge and the
+ * EMBD-4404 details panel cannot drift apart — a `cards-widget/ui` ↔
+ * `card-details-widget/ui` import is lint-banned and the reverse feature import
+ * would be an Nx cycle, leaving `shared/feature` the only home serving both.
+ */
+type CardStatusTone = 'success' | 'info' | 'neutral';
+
+/**
+ * The cards list's columns, in the canonical Figma order (node 612-140748, with
+ * the Funding account column EMBD-4398 has pending).
+ *
+ * Keys name the **column on screen**, not a row field: `cardName` is one column
+ * that renders a card's nickname, last four digits and card type together, so
+ * column keys and `CardRow` fields are deliberately not 1:1. Pass a subset (in
+ * any order) as `CardsListProps.columns` — this constant is the full set, handy
+ * for the owner to filter.
+ */
+declare const CARD_COLUMN_KEYS: readonly ["cardName", "fundingAccount", "cardholder", "status", "limit"];
+type CardColumnKey = (typeof CARD_COLUMN_KEYS)[number];
+/**
+ * A display-ready cards-list row — every field is an already-formatted string
+ * the owner produced.
+ *
+ * This is the **superset** of what any card program shows, so the library does
+ * not know that credit and debit exist. A program with no value for a field
+ * passes an em-dash rather than omitting it, and a program that does not show a
+ * column at all simply leaves that column out of `columns`.
+ */
+interface CardRow {
+    /** Stable render identity for React keys and test anchors. */
+    key: string;
+    nickname: string;
+    /** Last four digits, already trimmed by the owner, e.g. `"4783"`. */
+    lastFour: string;
+    /** Card type copy, e.g. `"Digital"` / `"Physical"`, resolved by the owner. */
+    typeLabel: string;
+    fundingAccount: string;
+    cardholder: string;
+    statusLabel: string;
+    statusTone: CardStatusTone;
+    /**
+     * The card's spending limit amount, formatted, e.g. `"$10,000"`. Omit when the
+     * card has no limit, and the cell falls back to the `noLimit` label.
+     *
+     * Deliberately **not** paired with a balance — the column shows the limit on
+     * the card regardless of what has been spent or what the funding account holds
+     * (Dan's decision with the backend engineers, 2026-07-28).
+     */
+    limit?: string;
+    /**
+     * The muted qualifier rendered after `limit`, e.g. `"/mo"`, `"/day"`,
+     * `"one-time"`. Split from the amount because the mockup gives the two
+     * different weights — amount in foreground, qualifier muted — so one
+     * pre-joined string could not render it.
+     *
+     * Omit for a limit with no qualifier: credit's `cardLimit` is a bare amount,
+     * while debit's varies (TSYS exposes `perCycle` / `daily` / `monthly` and a
+     * separate `singlePurchaseLimit`). Ignored when `limit` is omitted.
+     */
+    limitPeriod?: string;
+    /** Optional open-details gesture for the card-name cell. */
+    onSelect?: () => void;
+    /** Optional Activate gesture; when omitted, the action cell stays empty. */
+    onActivate?: () => void;
 }
 
-type PendingFeatureStyleSources = GapCoverageAlertProps | NoPolicyBannerProps | CardDetailsPanelProps | CardsStyleProbeProps;
+interface CardsListProps {
+    rows: CardRow[];
+    /**
+     * The visible columns, in render order. Required: which columns a program
+     * shows is the owner's call, and a default would silently decide it.
+     * `CARD_COLUMN_KEYS` is the full set to filter from.
+     */
+    columns: readonly CardColumnKey[];
+    isLoading?: boolean;
+    isError?: boolean;
+    /** Renders the "Show my cards" toggle. A boolean — never a role or a scope. */
+    canToggleShowMyCards?: boolean;
+    isShowingMyCards?: boolean;
+    onShowMyCardsChange?: (isShowingMyCards: boolean) => void;
+    /** Renders "Create card", in the header and as the empty-state action. */
+    canCreateCard?: boolean;
+    onCreateCardClick?: () => void;
+    /** Renders a retry action on the error state. */
+    onRetry?: () => void;
+    isPaginationVisible?: boolean;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    /** Pre-formatted range, e.g. "Viewing 1-10". The owner computes it. */
+    rangeLabel?: string;
+    isPreviousPageDisabled?: boolean;
+    isNextPageDisabled?: boolean;
+    onPageSizeChange?: (pageSize: number) => void;
+    onPreviousPageClick?: () => void;
+    onNextPageClick?: () => void;
+    /** Merged over `CARDS_LIST_LABELS_EN`; nested groups merge per group. */
+    labels?: PartialDeep<CardsListLabels>;
+}
+
+type PendingFeatureStyleSources = GapCoverageAlertProps | NoPolicyBannerProps | CardDetailsPanelProps | CardsListProps;
 
 export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, AcceptDisclosuresWidget, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CounterpartsWidget, ExpenseApprovalPoliciesWidget, ExpenseManagementWidget, ExpenseRequirementsWidget, GLCodeTableWidget, GL_CODE_TABLE_LABELS_EN, GlCodeTable, HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, ProfileWidget, RESULT_LABELS_EN, ReceiptMatchWidget, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TagsWidget, TeamWidget, TransfersWidget, UIFramework, UploadReceiptWidget, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, registerDesignSystemEnsurer, registerUIRenderers, setGlobalWidgetConfig, updateGlobalWidgetConfig, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
 export type { AcceptDisclosuresLinks, AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, Labels$5 as AccountDetailsWidgetLabels, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, GLCodeTableWidgetProps, GlCode, GlCodeTableLabels, GlCodeTableProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, FeatureLabels$2 as SettingsWidgetFeatureLabels, Labels$1 as SettingsWidgetLabels, SettingsWidgetProps, SingleInsightLabels, TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps, FeatureLabels$1 as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };

package/dist/lib/HelpWidget.d.ts

@@ -77,7 +77,8 @@ declare const HELP_WIDGET_LABELS_EN: HelpWidgetLabels;
 interface HelpWidgetProps$1 {
     /** FAQ content to render, grouped into titled sections. */
     faq: HelpFaqSection[];
-    /** Bank/provider name interpolated into the contact line. */
+    /** Bank/provider name interpolated into the contact line. Defaulted from the
+     * widget-init response by {@link HelpWidget}, so hosts rarely pass it. */
     bankName?: string;
     /** When set, renders a "Contact Us" card linking here. Omit to hide it. */
     contactUrl?: string;

package/dist/lib/ReceivablesWidget.js

@@ -14,12 +14,12 @@ import "react-hot-toast";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index85.js";
 import "radix-ui";
 import "react-hook-form";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index159.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index154.js";
 import "@radix-ui/react-label";
 import "@radix-ui/react-radio-group";
 import "@hookform/resolvers/zod";
 import "zod";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index326.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index304.js";
 import "@radix-ui/react-checkbox";
 import "@radix-ui/react-select";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index90.js";
@@ -31,7 +31,7 @@ import "../libs/tesouro-embedded-components-react/shared/data-access/dist/lib/re
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index92.js";
 import "react-dom";
 import "@mui/x-data-grid";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index151.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index145.js";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index83.js";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index55.js";
 import "@mui/material";
@@ -41,9 +41,9 @@ import "@mui/icons-material/Close";
 import "@mui/material/IconButton";
 import "@mui/material/Tooltip";
 import "@tanstack/react-table";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index158.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index153.js";
 import "@radix-ui/react-avatar";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index233.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index221.js";
 import "@mui/icons-material/AddCircleOutline";
 import "@mui/icons-material/Delete";
 import "@mui/icons-material/Cancel";
@@ -51,15 +51,15 @@ import "@mui/icons-material/HourglassEmpty";
 import "@mui/icons-material/PaidOutlined";
 import "@emotion/react";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index101.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index450.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index451.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index377.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index280.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index463.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index464.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index406.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index317.js";
 import "../packages/shared-ui-shadcn/dist/index.js";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index86.js";
 import "@mui/icons-material/DangerousOutlined";
 import "@mui/x-date-pickers";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index217.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index288.js";
 import "@mui/icons-material/CheckCircleOutlineRounded";
 import "@mui/icons-material/HighlightOffRounded";
 import "@mui/icons-material/Add";
@@ -68,16 +68,16 @@ import "@mui/icons-material/AttachFile";
 import "@mui/icons-material/CloudUploadOutlined";
 import "@mui/icons-material/MoreVert";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index475.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index322.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index324.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index371.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index175.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index339.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index341.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index399.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index164.js";
 import "@mui/icons-material/Sync";
 import "@mui/icons-material/Search";
 import "@mui/icons-material/CalendarToday";
 import "react-day-picker";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index412.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index415.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index377.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index380.js";
 import "@mui/icons-material/BlockOutlined";
 import "@mui/icons-material/CheckOutlined";
 import "@mui/icons-material/ErrorOutlineOutlined";
@@ -86,25 +86,25 @@ import "@mui/icons-material/InsertDriveFileOutlined";
 import "@mui/icons-material/ReplayOutlined";
 import "@mui/icons-material/SendOutlined";
 import "@mui/icons-material/StarHalfOutlined";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index421.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index423.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index391.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index393.js";
 import "@radix-ui/react-accordion";
 import "@radix-ui/react-tooltip";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index253.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index359.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index433.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index241.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index357.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index437.js";
 import "@mui/icons-material/DriveFileRenameOutline";
 import "deep-eql";
 import "react-use";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index192.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index314.js";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index315.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index187.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index343.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index344.js";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index56.js";
 import "react-script-hook";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index54.js";
 import "@mui/icons-material/Money";
 import "@mui/icons-material/MonetizationOnOutlined";
-import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index166.js";
+import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index178.js";
 import "@mui/material/styles";
 import "@emotion/cache";
 import "../libs/tesouro-embedded-components-react/monite-sdk/dist/index106.js";

package/dist/lib/SettingsWidget.d.ts

@@ -603,6 +603,12 @@ interface SettingsWidgetProps extends MoniteRegionProviderProps {
      * registered landing route differs from that default, or the origin is
      * not on the OIDC redirect-URI allowlist (preview/localhost). */
     acceptInviteRedirectUri?: string;
+    /** Forwarded to the embedded Help section's {@link HelpWidget} — where its
+     * "Contact Us" line links (a support page URL or a `mailto:`). The line is
+     * hidden entirely when unset, since the package has no tenant-agnostic
+     * support address to fall back on. The bank name in that line comes from
+     * widget init, so this is the only value a host needs to supply. */
+    helpContactUrl?: string;
     profileContent?: ReactNode;
     teamContent?: ReactNode;
     billPayContent?: ReactNode;