@tesouro/embedded-components-react 0.2.260 → 0.2.261

package/README.md

@@ -481,10 +481,11 @@ A self-contained, read-only profile card for the current entity user. It shows a
 
 #### Props
 
-| Prop            | Type                     | Description                                           |
-| --------------- | ------------------------ | ----------------------------------------------------- |
-| `labels`        | `Partial<Labels>`        | Overrides the card's own copy (loading announcement). |
-| `featureLabels` | `Partial<FeatureLabels>` | Overrides tab labels, field labels, and the subtitle. |
+| Prop            | Type                     | Description                                                                                                                                                                                                                                               |
+| --------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `labels`        | `Partial<Labels>`        | Overrides the card's own copy (loading announcement, contact line).                                                                                                                                                                                       |
+| `featureLabels` | `Partial<FeatureLabels>` | Overrides tab labels, field labels, and the subtitle.                                                                                                                                                                                                     |
+| `contactUrl`    | `string`                 | Where the "to change this information, contact your bank" line links (a support page URL or a `mailto:`). Left unset, the card shows the plain unlinked subtitle instead. The bank name in that line comes from widget init, so no other value is needed. |
 
 ### ReceivablesWidget
 
@@ -537,21 +538,25 @@ A composite settings widget that combines Monite document settings, tags, GL cod
 
 #### Props
 
-| Prop                      | Type                     | Default                           | Description                                                                                                                                                                                                                                                                                                            |
-| ------------------------- | ------------------------ | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `acceptInviteRedirectUri` | `string`                 | Same-origin `/accept-invite`      | Forwarded to the Team section's widget — allowlisted URL invite emails link to. Defaults to `${window.location.origin}/accept-invite`; set it when the host app's registered landing route differs from the widget's same-origin default, or the origin is not on the OIDC redirect-URI allowlist (preview/localhost). |
-| `labels`                  | `Partial<Labels>`        | English labels                    | Overrides the settings heading copy.                                                                                                                                                                                                                                                                                   |
-| `featureLabels`           | `Partial<FeatureLabels>` | English labels                    | Overrides section labels.                                                                                                                                                                                                                                                                                              |
-| `profileContent`          | `ReactNode`              | Profile widget                    | Replaces the profile section content.                                                                                                                                                                                                                                                                                  |
-| `teamContent`             | `ReactNode`              | Empty                             | Supplies the team section content.                                                                                                                                                                                                                                                                                     |
-| `invoiceContent`          | `ReactNode`              | Monite template settings          | Replaces invoice settings content.                                                                                                                                                                                                                                                                                     |
-| `billPayContent`          | `ReactNode`              | Monite approval policies          | Replaces bill-pay settings content.                                                                                                                                                                                                                                                                                    |
-| `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.                                                                                                                                                                                                                                                                                 |
+| Prop                      | Type                                         | Default                           | Description                                                                                                                                                                                                                                                                                                            |
+| ------------------------- | -------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `acceptInviteRedirectUri` | `string`                                     | Same-origin `/accept-invite`      | Forwarded to the Team section's widget — allowlisted URL invite emails link to. Defaults to `${window.location.origin}/accept-invite`; set it when the host app's registered landing route differs from the widget's same-origin default, or the origin is not on the OIDC redirect-URI allowlist (preview/localhost). |
+| `labels`                  | `Partial<Labels>`                            | English labels                    | Overrides the settings heading copy.                                                                                                                                                                                                                                                                                   |
+| `featureLabels`           | `Partial<FeatureLabels>`                     | English labels                    | Overrides section labels.                                                                                                                                                                                                                                                                                              |
+| `profileContent`          | `ReactNode`                                  | Profile widget                    | Replaces the profile section content.                                                                                                                                                                                                                                                                                  |
+| `teamContent`             | `ReactNode`                                  | Empty                             | Supplies the team section content.                                                                                                                                                                                                                                                                                     |
+| `invoiceContent`          | `ReactNode`                                  | Monite template settings          | Replaces invoice settings content.                                                                                                                                                                                                                                                                                     |
+| `billPayContent`          | `ReactNode`                                  | Monite approval policies          | Replaces bill-pay settings content.                                                                                                                                                                                                                                                                                    |
+| `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.                                                                                                                                                                                                                                                                                              |
+| `profileContactUrl`       | `string`                                     | `undefined`                       | Forwarded to the Profile section's widget — where its "to change this information, contact your bank" line links. Left unset, the card shows the plain unlinked sentence instead; the bank name comes from widget init.                                                                                                |
+| `selectedSection`         | `SettingsWidgetSectionId`                    | `undefined`                       | The section to show. Leave unset to let the widget own the selection; supply it (with `onSelectedSectionChange`) to drive navigation from a route or search param. A section the user's scopes hide falls back to the first visible one.                                                                               |
+| `onSelectedSectionChange` | `(section: SettingsWidgetSectionId) => void` | `undefined`                       | Called with the id of the section the user selected. Fires whether or not `selectedSection` is supplied, so a host can mirror the selection into its URL without taking ownership of it.                                                                                                                               |
+| `additionalSections`      | `SettingsWidgetAdditionalSection[]`          | `undefined`                       | Host-owned sections rendered alongside the built-in ones. Each is `{ id, label, content }` plus an optional `after` naming the built-in section to place it behind. Unlike the built-ins, these are not scope-gated.                                                                                                   |
+| `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.                                                                                                                                                                                                                                                                                 |
 
 ### TagsWidget
 

package/dist/index.d.ts

@@ -3976,6 +3976,14 @@ declare function ProductsWidget({ baseUrl, widgetToken, organizationId, configCl
 interface Labels$2 {
     loadingLabel: string;
     errorLabel: string;
+    /**
+     * Lead-in for the contact line, rendered as
+     * `{contactPrefix} {bankName} {link}.` when both a bank name and a contact
+     * URL are available.
+     */
+    contactPrefix: string;
+    /** Text of the contact link (wraps the contact URL). */
+    contactLinkText: string;
 }
 
 interface FeatureLabels$3 {
@@ -3995,6 +4003,14 @@ interface FeatureLabels$3 {
 interface ProfileWidgetProps extends WidgetProviderProps {
     labels?: Partial<Labels$2>;
     featureLabels?: Partial<FeatureLabels$3>;
+    /**
+     * Where the "to change this information, contact your bank" line links (a
+     * support page URL or a `mailto:`). Left unset, the card shows the plain
+     * unlinked sentence instead — 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.
+     */
+    contactUrl?: string;
 }
 declare function ProfileWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: ProfileWidgetProps): React.JSX.Element;
 
@@ -4012,6 +4028,12 @@ interface Labels$1 {
     description?: string;
 }
 
+interface SettingsWidgetSection {
+    id: string;
+    label: string;
+    content: ReactNode;
+}
+
 interface FeatureLabels$2 {
     profileSection: string;
     teamSection: string;
@@ -4025,6 +4047,46 @@ interface FeatureLabels$2 {
     expenseRequirementsTab: string;
 }
 
+/**
+ * The sections this widget renders itself. These ids are the public vocabulary
+ * a host uses to deep-link into a section, so they are part of the package's
+ * API surface — renaming one is a breaking change.
+ */
+declare const SettingsSection: {
+    readonly Profile: "profile";
+    readonly Team: "team";
+    readonly Invoice: "invoice";
+    readonly Expense: "expense";
+    readonly BillPay: "bill-pay";
+    readonly Accounting: "accounting";
+    readonly Tags: "tags";
+    readonly Help: "help";
+};
+type SettingsSection = (typeof SettingsSection)[keyof typeof SettingsSection];
+/**
+ * A selectable section id: one of the built-ins, or the id of a host-supplied
+ * {@link SettingsWidgetAdditionalSection}. The `string & {}` arm keeps the
+ * built-in literals visible to editor autocomplete while still accepting a
+ * host's own id.
+ */
+type SettingsWidgetSectionId = SettingsSection | (string & {});
+/**
+ * A section contributed by the host, rendered alongside the built-in ones.
+ *
+ * This exists for surfaces the published package cannot own — the white-label
+ * dashboard's password management, for instance, which is an app-auth concern
+ * rather than an embedded one. Prefer the `*Content` props when replacing the
+ * content of a section that already exists.
+ */
+interface SettingsWidgetAdditionalSection extends SettingsWidgetSection {
+    /**
+     * Place this section immediately after the named built-in one. Sections with
+     * no `after` — and those whose anchor is hidden by scope gating — are
+     * appended to the end of the list.
+     */
+    after?: SettingsSection;
+}
+
 interface SettingsWidgetProps extends MoniteRegionProviderProps {
     labels?: Partial<Labels$1>;
     featureLabels?: Partial<FeatureLabels$2>;
@@ -4040,6 +4102,22 @@ interface SettingsWidgetProps extends MoniteRegionProviderProps {
      * 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;
+    /** Forwarded to the embedded Profile section's {@link ProfileWidget} — where
+     * its "to change this information, contact your bank" line links. The line
+     * falls back to a plain, unlinked sentence when unset, for the same reason
+     * {@link SettingsWidgetProps.helpContactUrl} does. */
+    profileContactUrl?: string;
+    /** The section to show. Leave unset to let the widget own the selection;
+     * supply it (with {@link SettingsWidgetProps.onSelectedSectionChange}) to
+     * drive navigation from a route, a search param, or host state. A section
+     * hidden by the user's scopes falls back to the first visible one. */
+    selectedSection?: SettingsWidgetSectionId;
+    /** Called with the id of the section the user selected. Fires whether or not
+     * {@link SettingsWidgetProps.selectedSection} is supplied, so a host can mirror
+     * the selection into its URL without taking ownership of it. */
+    onSelectedSectionChange?: (section: SettingsWidgetSectionId) => void;
+    /** Host-owned sections rendered alongside the built-in ones. */
+    additionalSections?: SettingsWidgetAdditionalSection[];
     profileContent?: ReactNode;
     teamContent?: ReactNode;
     billPayContent?: ReactNode;
@@ -4555,5 +4633,5 @@ interface GapCoverageAlertProps {
 
 type PendingFeatureStyleSources = GapCoverageAlertProps | NoPolicyBannerProps;
 
-export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ACCOUNT_DELETE_DIALOG_LABELS_EN, ACCOUNT_FORM_SHEET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, AcceptDisclosuresWidget, AccountDeleteDialog, AccountFormSheet, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CHART_OF_ACCOUNTS_LABELS_EN, CHART_OF_ACCOUNTS_MESSAGE_LABELS_EN, CREATE_CARD_FEATURE_LABELS_EN, CardDetailsWidget, CardFormatValue, CardsWidget, ChartOfAccountsTable, ChartOfAccountsWidget, CounterpartsWidget, CreateCardWidget, ExpenseApprovalPoliciesWidget, ExpenseManagementWidget, ExpenseRequirementsWidget, HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, ProfileWidget, RESULT_LABELS_EN, ReceiptMatchWidget, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TagsWidget, TeamWidget, TransfersWidget, UIFramework, UploadReceiptWidget, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, getGlobalWidgetInitState, registerDesignSystemEnsurer, registerUIRenderers, resolveCreateCardFeatureLabels, setGlobalWidgetConfig, subscribeToGlobalWidgetInitState, updateGlobalWidgetConfig, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
-export type { AcceptDisclosuresLinks, AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, AccountDeleteDialogLabels, AccountDeleteDialogProps, Labels$5 as AccountDetailsWidgetLabels, AccountFormErrors, AccountFormMode, AccountFormSheetLabels, AccountFormSheetProps, AccountFormValues, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels as CardsWidgetFeatureLabels, CardsListLabels as CardsWidgetLabels, CardsWidgetPagination, CardsWidgetProps, ChartOfAccountsLabels, ChartOfAccountsMessageLabels, ChartOfAccountsTableProps, ChartOfAccountsWidgetLabelProps, ChartOfAccountsWidgetProps, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, CreateCardFeatureLabels, CreateCardWidgetLabels, CreateCardWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LedgerAccountRow, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchSummary, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, 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, WidgetInitState, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };
+export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ACCOUNT_DELETE_DIALOG_LABELS_EN, ACCOUNT_FORM_SHEET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, AcceptDisclosuresWidget, AccountDeleteDialog, AccountFormSheet, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CHART_OF_ACCOUNTS_LABELS_EN, CHART_OF_ACCOUNTS_MESSAGE_LABELS_EN, CREATE_CARD_FEATURE_LABELS_EN, CardDetailsWidget, CardFormatValue, CardsWidget, ChartOfAccountsTable, ChartOfAccountsWidget, CounterpartsWidget, CreateCardWidget, ExpenseApprovalPoliciesWidget, ExpenseManagementWidget, ExpenseRequirementsWidget, HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, ProfileWidget, RESULT_LABELS_EN, ReceiptMatchWidget, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, SettingsSection, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TagsWidget, TeamWidget, TransfersWidget, UIFramework, UploadReceiptWidget, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, getGlobalWidgetInitState, registerDesignSystemEnsurer, registerUIRenderers, resolveCreateCardFeatureLabels, setGlobalWidgetConfig, subscribeToGlobalWidgetInitState, updateGlobalWidgetConfig, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
+export type { AcceptDisclosuresLinks, AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, AccountDeleteDialogLabels, AccountDeleteDialogProps, Labels$5 as AccountDetailsWidgetLabels, AccountFormErrors, AccountFormMode, AccountFormSheetLabels, AccountFormSheetProps, AccountFormValues, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels as CardsWidgetFeatureLabels, CardsListLabels as CardsWidgetLabels, CardsWidgetPagination, CardsWidgetProps, ChartOfAccountsLabels, ChartOfAccountsMessageLabels, ChartOfAccountsTableProps, ChartOfAccountsWidgetLabelProps, ChartOfAccountsWidgetProps, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, CreateCardFeatureLabels, CreateCardWidgetLabels, CreateCardWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LedgerAccountRow, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchSummary, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, SettingsWidgetAdditionalSection, FeatureLabels$2 as SettingsWidgetFeatureLabels, Labels$1 as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId, SingleInsightLabels, TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps, FeatureLabels$1 as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetInitState, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };

package/dist/index.js

@@ -70,17 +70,18 @@ import "./lib/ProfileWidget.js";
 import "./lib/ReceivablesWidget.js";
 import { ReceiptMatchWidget as se } from "./libs/tesouro-embedded-components-react/expense-receipt-match-widget/feature/dist/lib/ReceiptMatchWidget.js";
 import "./lib/ReceiptMatchWidget.js";
-import { TagsWidget as ce } from "./libs/tesouro-embedded-components-react/tags-widget/feature/dist/index11.js";
-import { TeamWidget as le } from "./libs/tesouro-embedded-components-react/team-widget/feature/dist/index17.js";
-import { SettingsWidget as ue } from "./libs/tesouro-embedded-components-react/settings-widget/feature/dist/index5.js";
+import { SettingsSection as ce } from "./libs/tesouro-embedded-components-react/settings-widget/feature/dist/index4.js";
+import { TagsWidget as le } from "./libs/tesouro-embedded-components-react/tags-widget/feature/dist/index11.js";
+import { TeamWidget as ue } from "./libs/tesouro-embedded-components-react/team-widget/feature/dist/index17.js";
+import { SettingsWidget as de } from "./libs/tesouro-embedded-components-react/settings-widget/feature/dist/index6.js";
 import "./lib/SettingsWidget.js";
 import "./lib/TagsWidget.js";
 import "./lib/TeamWidget.js";
-import { DEFAULT_FEATURE_LABELS as de } from "./libs/tesouro-embedded-components-react/transfers-widget/feature/dist/index3.js";
-import { TRANSFERS_WIDGET_LABELS_EN as fe } from "./libs/tesouro-embedded-components-react/transfers-widget/ui/dist/index9.js";
-import { TransfersWidget as pe } from "./libs/tesouro-embedded-components-react/transfers-widget/feature/dist/index6.js";
+import { DEFAULT_FEATURE_LABELS as fe } from "./libs/tesouro-embedded-components-react/transfers-widget/feature/dist/index3.js";
+import { TRANSFERS_WIDGET_LABELS_EN as pe } from "./libs/tesouro-embedded-components-react/transfers-widget/ui/dist/index9.js";
+import { TransfersWidget as me } from "./libs/tesouro-embedded-components-react/transfers-widget/feature/dist/index6.js";
 import "./lib/TransfersWidget.js";
 import "./lib/UploadReceiptWidget.js";
-import { WidgetProvider as me } from "./lib/WidgetProviderPublic.js";
+import { WidgetProvider as he } from "./lib/WidgetProviderPublic.js";
 import "./lib/WidgetProvider.js";
-export { e as ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, V as ACCOUNT_DELETE_DIALOG_LABELS_EN, H as ACCOUNT_FORM_SHEET_LABELS_EN, ee as ADDITIONAL_OWNERS_LABELS_EN, b as AcceptDisclosuresWidget, K as AccountDeleteDialog, G as AccountFormSheet, P as BALANCES_WIDGET_LABELS_EN, te as BUSINESS_DETAILS_LABELS_EN, F as BalancesWidget, ie as BankAccountOnboardingWidget, x as BankAccountsWidget, C as BillPayWidget, U as CHART_OF_ACCOUNTS_LABELS_EN, B as CHART_OF_ACCOUNTS_MESSAGE_LABELS_EN, E as CREATE_CARD_FEATURE_LABELS_EN, w as CardDetailsWidget, T as CardFormatValue, k as CardsWidget, W as ChartOfAccountsTable, q as ChartOfAccountsWidget, S as CounterpartsWidget, O as CreateCardWidget, A as ExpenseApprovalPoliciesWidget, N as ExpenseManagementWidget, j as ExpenseRequirementsWidget, Y as HELP_FAQ_EN, J as HELP_WIDGET_LABELS_EN, X as HelpWidget, I as INSIGHTS_FEATURE_LABELS_EN, L as INSIGHTS_WIDGET_LABELS_EN, n as Implementation, z as InsightsWidget, Z as InvoicingWidget, $ as LinkedAccountsWidget, ne as PERSONAL_DETAILS_LABELS_EN, ae as ProductsWidget, oe as ProfileWidget, re as RESULT_LABELS_EN, se as ReceiptMatchWidget, Q as ReceivablesWidget, m as RefreshingRootWidgetProvider, d as RootWidgetProvider, R as SINGLE_INSIGHT_LABELS_EN, ue as SettingsWidget, de as TRANSFERS_FEATURE_LABELS_EN, fe as TRANSFERS_WIDGET_LABELS_EN, ce as TagsWidget, le as TeamWidget, pe as TransfersWidget, c as UIFramework, M as UploadReceiptWidget, me as WidgetProvider, f as WidgetTokenRefreshProvider, t as cloneEmbeddedClient, r as getGlobalWidgetConfig, o as getGlobalWidgetInitState, l as registerDesignSystemEnsurer, u as registerUIRenderers, D as resolveCreateCardFeatureLabels, i as setGlobalWidgetConfig, s as subscribeToGlobalWidgetInitState, a as updateGlobalWidgetConfig, h as useOwnWidgetConfig, g as useRefetchWidget, _ as useWidgetConfig, v as useWidgetError, y as useWidgetLoading, p as useWidgetToken };
+export { e as ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, V as ACCOUNT_DELETE_DIALOG_LABELS_EN, H as ACCOUNT_FORM_SHEET_LABELS_EN, ee as ADDITIONAL_OWNERS_LABELS_EN, b as AcceptDisclosuresWidget, K as AccountDeleteDialog, G as AccountFormSheet, P as BALANCES_WIDGET_LABELS_EN, te as BUSINESS_DETAILS_LABELS_EN, F as BalancesWidget, ie as BankAccountOnboardingWidget, x as BankAccountsWidget, C as BillPayWidget, U as CHART_OF_ACCOUNTS_LABELS_EN, B as CHART_OF_ACCOUNTS_MESSAGE_LABELS_EN, E as CREATE_CARD_FEATURE_LABELS_EN, w as CardDetailsWidget, T as CardFormatValue, k as CardsWidget, W as ChartOfAccountsTable, q as ChartOfAccountsWidget, S as CounterpartsWidget, O as CreateCardWidget, A as ExpenseApprovalPoliciesWidget, N as ExpenseManagementWidget, j as ExpenseRequirementsWidget, Y as HELP_FAQ_EN, J as HELP_WIDGET_LABELS_EN, X as HelpWidget, I as INSIGHTS_FEATURE_LABELS_EN, L as INSIGHTS_WIDGET_LABELS_EN, n as Implementation, z as InsightsWidget, Z as InvoicingWidget, $ as LinkedAccountsWidget, ne as PERSONAL_DETAILS_LABELS_EN, ae as ProductsWidget, oe as ProfileWidget, re as RESULT_LABELS_EN, se as ReceiptMatchWidget, Q as ReceivablesWidget, m as RefreshingRootWidgetProvider, d as RootWidgetProvider, R as SINGLE_INSIGHT_LABELS_EN, ce as SettingsSection, de as SettingsWidget, fe as TRANSFERS_FEATURE_LABELS_EN, pe as TRANSFERS_WIDGET_LABELS_EN, le as TagsWidget, ue as TeamWidget, me as TransfersWidget, c as UIFramework, M as UploadReceiptWidget, he as WidgetProvider, f as WidgetTokenRefreshProvider, t as cloneEmbeddedClient, r as getGlobalWidgetConfig, o as getGlobalWidgetInitState, l as registerDesignSystemEnsurer, u as registerUIRenderers, D as resolveCreateCardFeatureLabels, i as setGlobalWidgetConfig, s as subscribeToGlobalWidgetInitState, a as updateGlobalWidgetConfig, h as useOwnWidgetConfig, g as useRefetchWidget, _ as useWidgetConfig, v as useWidgetError, y as useWidgetLoading, p as useWidgetToken };

package/dist/lib/ProfileWidget.d.ts

@@ -5,6 +5,14 @@ import { FallbackProps } from 'react-error-boundary';
 interface Labels {
     loadingLabel: string;
     errorLabel: string;
+    /**
+     * Lead-in for the contact line, rendered as
+     * `{contactPrefix} {bankName} {link}.` when both a bank name and a contact
+     * URL are available.
+     */
+    contactPrefix: string;
+    /** Text of the contact link (wraps the contact URL). */
+    contactLinkText: string;
 }
 
 type AuthToken = string | undefined;
@@ -588,6 +596,14 @@ interface FeatureLabels {
 interface ProfileWidgetProps extends WidgetProviderProps {
     labels?: Partial<Labels>;
     featureLabels?: Partial<FeatureLabels>;
+    /**
+     * Where the "to change this information, contact your bank" line links (a
+     * support page URL or a `mailto:`). Left unset, the card shows the plain
+     * unlinked sentence instead — 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.
+     */
+    contactUrl?: string;
 }
 declare function ProfileWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: ProfileWidgetProps): React.JSX.Element;
 

package/dist/lib/SettingsWidget.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { ComponentType, AnchorHTMLAttributes, ReactNode, ErrorInfo } from 'react';
+import { ReactNode, ComponentType, AnchorHTMLAttributes, ErrorInfo } from 'react';
 import { FallbackProps } from 'react-error-boundary';
 
 interface Labels {
@@ -7,6 +7,12 @@ interface Labels {
     description?: string;
 }
 
+interface SettingsWidgetSection {
+    id: string;
+    label: string;
+    content: ReactNode;
+}
+
 interface FinopsThemeColors {
     primary?: string;
     primaryForeground?: string;
@@ -594,6 +600,46 @@ interface FeatureLabels {
     expenseRequirementsTab: string;
 }
 
+/**
+ * The sections this widget renders itself. These ids are the public vocabulary
+ * a host uses to deep-link into a section, so they are part of the package's
+ * API surface — renaming one is a breaking change.
+ */
+declare const SettingsSection: {
+    readonly Profile: "profile";
+    readonly Team: "team";
+    readonly Invoice: "invoice";
+    readonly Expense: "expense";
+    readonly BillPay: "bill-pay";
+    readonly Accounting: "accounting";
+    readonly Tags: "tags";
+    readonly Help: "help";
+};
+type SettingsSection = (typeof SettingsSection)[keyof typeof SettingsSection];
+/**
+ * A selectable section id: one of the built-ins, or the id of a host-supplied
+ * {@link SettingsWidgetAdditionalSection}. The `string & {}` arm keeps the
+ * built-in literals visible to editor autocomplete while still accepting a
+ * host's own id.
+ */
+type SettingsWidgetSectionId = SettingsSection | (string & {});
+/**
+ * A section contributed by the host, rendered alongside the built-in ones.
+ *
+ * This exists for surfaces the published package cannot own — the white-label
+ * dashboard's password management, for instance, which is an app-auth concern
+ * rather than an embedded one. Prefer the `*Content` props when replacing the
+ * content of a section that already exists.
+ */
+interface SettingsWidgetAdditionalSection extends SettingsWidgetSection {
+    /**
+     * Place this section immediately after the named built-in one. Sections with
+     * no `after` — and those whose anchor is hidden by scope gating — are
+     * appended to the end of the list.
+     */
+    after?: SettingsSection;
+}
+
 interface SettingsWidgetProps extends MoniteRegionProviderProps {
     labels?: Partial<Labels>;
     featureLabels?: Partial<FeatureLabels>;
@@ -609,6 +655,22 @@ interface SettingsWidgetProps extends MoniteRegionProviderProps {
      * 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;
+    /** Forwarded to the embedded Profile section's {@link ProfileWidget} — where
+     * its "to change this information, contact your bank" line links. The line
+     * falls back to a plain, unlinked sentence when unset, for the same reason
+     * {@link SettingsWidgetProps.helpContactUrl} does. */
+    profileContactUrl?: string;
+    /** The section to show. Leave unset to let the widget own the selection;
+     * supply it (with {@link SettingsWidgetProps.onSelectedSectionChange}) to
+     * drive navigation from a route, a search param, or host state. A section
+     * hidden by the user's scopes falls back to the first visible one. */
+    selectedSection?: SettingsWidgetSectionId;
+    /** Called with the id of the section the user selected. Fires whether or not
+     * {@link SettingsWidgetProps.selectedSection} is supplied, so a host can mirror
+     * the selection into its URL without taking ownership of it. */
+    onSelectedSectionChange?: (section: SettingsWidgetSectionId) => void;
+    /** Host-owned sections rendered alongside the built-in ones. */
+    additionalSections?: SettingsWidgetAdditionalSection[];
     profileContent?: ReactNode;
     teamContent?: ReactNode;
     billPayContent?: ReactNode;
@@ -620,5 +682,5 @@ interface SettingsWidgetProps extends MoniteRegionProviderProps {
 }
 declare function SettingsWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, finopsThemeColors, analytics, ...innerProps }: SettingsWidgetProps): React.JSX.Element;
 
-export { SettingsWidget };
-export type { FeatureLabels as SettingsWidgetFeatureLabels, Labels as SettingsWidgetLabels, SettingsWidgetProps };
+export { SettingsSection, SettingsWidget };
+export type { SettingsWidgetAdditionalSection, FeatureLabels as SettingsWidgetFeatureLabels, Labels as SettingsWidgetLabels, SettingsWidgetProps, SettingsWidgetSection, SettingsWidgetSectionId };

package/dist/lib/SettingsWidget.js

@@ -1,3 +1,4 @@
-import { SettingsWidget as e } from "../libs/tesouro-embedded-components-react/settings-widget/feature/dist/index5.js";
+import { SettingsSection as e } from "../libs/tesouro-embedded-components-react/settings-widget/feature/dist/index4.js";
+import { SettingsWidget as t } from "../libs/tesouro-embedded-components-react/settings-widget/feature/dist/index6.js";
 import "../libs/tesouro-embedded-components-react/settings-widget/feature/dist/index.js";
-export { e as SettingsWidget };
+export { e as SettingsSection, t as SettingsWidget };