@tesouro/embedded-components-react 0.2.259 → 0.2.261

package/README.md

@@ -239,27 +239,30 @@ A Monite-backed bill pay widget wrapped in Tesouro widget auth and theming.
 
 ### CardsWidget
 
-One page of an organization's credit **or** debit cards, with a scope-gated "Show my cards" toggle, Create card and per-row Activate affordances. Selecting a row opens that card's read-only details in a side sheet.
+One page of an organization's credit **or** debit cards, with a scope-gated "Show my cards" toggle, Create card and per-row Activate affordances. Selecting a row opens that card's read-only details in a side sheet. On a debit list with `cardArtSrc`, Create card opens the same sheet with the built-in debit issuance flow.
 
 #### Props
 
-| Prop                       | Type                                    | Default        | Description                                                                                                                                                        |
-| -------------------------- | --------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `cardProgram`              | `'credit' \| 'debit'`                   | **Required**   | Which issuing program the list shows. Also selects the scopes that gate each affordance.                                                                           |
-| `pagination`               | `{ paginationToken?, pageSize? }`       | `undefined`    | Controlled cursor and page size. Supply with `onPaginationChange` when your app owns the list position.                                                            |
-| `defaultPagination`        | `{ paginationToken?, pageSize? }`       | First page, 10 | Initial cursor and page size when uncontrolled. Ignored when `pagination` is supplied.                                                                             |
-| `onPaginationChange`       | `(pagination) => void`                  | `undefined`    | Called whenever the widget moves page or changes page size. Persist the whole object, not the token alone.                                                         |
-| `labels`                   | `PartialDeep<CardsWidgetLabels>`        | English labels | Overrides the copy of the list screen, including the details sheet's screen-reader name under `detailsSheet`. Nested groups merge per group.                       |
-| `featureLabels`            | `PartialDeep<CardsWidgetFeatureLabels>` | English labels | Overrides the copy this widget resolves rather than passes through — status and form-factor vocabulary, the empty-cell placeholder, and name fallbacks.            |
-| `selectedCardId`           | `string \| null`                        | `undefined`    | Controlled selection of the card whose details panel is open. `null` closes it; omit for uncontrolled. See **Selection** below.                                    |
-| `defaultSelectedCardId`    | `string \| null`                        | `undefined`    | Initial selection when uncontrolled. Ignored when `selectedCardId` is supplied.                                                                                    |
-| `onSelectedCardIdChange`   | `(cardId: string \| null) => void`      | `undefined`    | Fires whenever the open card changes, including on close (`null`). Supplying it does **not** change what renders.                                                  |
-| `cardDetailsLabels`        | `PartialDeep<CardDetailsWidgetLabels>`  | English labels | Label overrides forwarded into the details panel.                                                                                                                  |
-| `cardDetailsFeatureLabels` | `PartialDeep<CardDetailsFeatureLabels>` | English labels | Overrides for the copy the panel's feature layer resolves — status vocabulary, form-factor copy, program label, copy-success toast. Distinct from `featureLabels`. |
-| `bankLogoSrc`              | `string`                                | `undefined`    | Bank logo for the details panel's card face. Omit and the face renders without a logo rather than with a placeholder.                                              |
-| `bankLogoAlt`              | `string`                                | `undefined`    | Alt text for `bankLogoSrc`.                                                                                                                                        |
-| `onCreateCard`             | `() => void`                            | `undefined`    | Called when Create card is clicked. Omit it and the button is not rendered.                                                                                        |
-| `onActivateCard`           | `(cardId: string) => void`              | `undefined`    | Called when a row's Activate button is clicked. Omit it and the button is not rendered.                                                                            |
+| Prop                       | Type                                    | Default        | Description                                                                                                                                                                             |
+| -------------------------- | --------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `cardProgram`              | `'credit' \| 'debit'`                   | **Required**   | Which issuing program the list shows. Also selects the scopes that gate each affordance.                                                                                                |
+| `pagination`               | `{ paginationToken?, pageSize? }`       | `undefined`    | Controlled cursor and page size. Supply with `onPaginationChange` when your app owns the list position.                                                                                 |
+| `defaultPagination`        | `{ paginationToken?, pageSize? }`       | First page, 10 | Initial cursor and page size when uncontrolled. Ignored when `pagination` is supplied.                                                                                                  |
+| `onPaginationChange`       | `(pagination) => void`                  | `undefined`    | Called whenever the widget moves page or changes page size. Persist the whole object, not the token alone.                                                                              |
+| `labels`                   | `PartialDeep<CardsWidgetLabels>`        | English labels | Overrides the copy of the list screen, including the details sheet's screen-reader name under `detailsSheet` and the create sheet's under `createSheet`. Nested groups merge per group. |
+| `featureLabels`            | `PartialDeep<CardsWidgetFeatureLabels>` | English labels | Overrides the copy this widget resolves rather than passes through — status and form-factor vocabulary, the empty-cell placeholder, and name fallbacks.                                 |
+| `selectedCardId`           | `string \| null`                        | `undefined`    | Controlled selection of the card whose details panel is open. `null` closes it; omit for uncontrolled. See **Selection** below.                                                         |
+| `defaultSelectedCardId`    | `string \| null`                        | `undefined`    | Initial selection when uncontrolled. Ignored when `selectedCardId` is supplied.                                                                                                         |
+| `onSelectedCardIdChange`   | `(cardId: string \| null) => void`      | `undefined`    | Fires whenever the open card changes, including on close (`null`). Supplying it does **not** change what renders.                                                                       |
+| `cardDetailsLabels`        | `PartialDeep<CardDetailsWidgetLabels>`  | English labels | Label overrides forwarded into the details panel.                                                                                                                                       |
+| `cardDetailsFeatureLabels` | `PartialDeep<CardDetailsFeatureLabels>` | English labels | Overrides for the copy the panel's feature layer resolves — status vocabulary, form-factor copy, program label, copy-success toast. Distinct from `featureLabels`.                      |
+| `bankLogoSrc`              | `string`                                | `undefined`    | Bank logo for the details panel's card face. Omit and the face renders without a logo rather than with a placeholder.                                                                   |
+| `bankLogoAlt`              | `string`                                | `undefined`    | Alt text for `bankLogoSrc`.                                                                                                                                                             |
+| `cardArtSrc`               | `string`                                | `undefined`    | Plastic art for the built-in debit create sheet. Required for that sheet: omit it (with no `onCreateCard`) and Create card is hidden. See **Create card** below.                        |
+| `createCardLabels`         | `PartialDeep<CreateCardWidgetLabels>`   | English labels | Label overrides forwarded into the nested create-card panel.                                                                                                                            |
+| `createCardFeatureLabels`  | toast / untitled-funding overrides      | English labels | Overrides for the copy the create panel's feature layer resolves — mutation toasts, untitled funding-account fallback, pending-activation success copy.                                 |
+| `onCreateCard`             | `() => void`                            | `undefined`    | Host-owned Create card handler. When supplied, the built-in debit sheet does not open. Credit Create card still requires this callback.                                                 |
+| `onActivateCard`           | `(cardId: string) => void`              | `undefined`    | Called when a row's Activate button is clicked. Omit it and the button is not rendered.                                                                                                 |
 
 ### CardDetailsWidget
 
@@ -478,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
 
@@ -534,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

@@ -1792,6 +1792,11 @@ interface CardsListLabels {
      * sits here for a footer that lives in `shared/ui`.
      */
     detailsSheet: CardsListDetailsSheetLabels;
+    /**
+     * Screen-reader copy for the same sheet when Create card is slotted in, rather
+     * than a selected card's details. Same chrome, different accessible name.
+     */
+    createSheet: CardsListDetailsSheetLabels;
 }
 
 /** Accessible copy for the panel header's controls. */
@@ -1931,14 +1936,130 @@ interface CardDetailsWidgetProps extends WidgetProviderProps {
  */
 declare function CardDetailsWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: CardDetailsWidgetProps): React.JSX.Element;
 
+type PartialDeep$2<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$2<T[K]> : T[K];
+};
+interface CreateCardWidgetLabels {
+    header: {
+        title: string;
+        closeAriaLabel: string;
+    };
+    cardArtAlt: string;
+    setup: {
+        sectionTitle: string;
+        sectionDescription: string;
+        cardholderLabel: string;
+        cardholderPlaceholder: string;
+        cardFormatLabel: string;
+        cardFormatPlaceholder: string;
+        cardFormatVirtual: string;
+        cardFormatPhysical: string;
+        fundingAccountLabel: string;
+        fundingAccountPlaceholder: string;
+    };
+    mailing: {
+        sectionTitle: string;
+        sectionDescription: string;
+        businessTitle: string;
+        businessDescription: string;
+        customTitle: string;
+        customDescription: string;
+    };
+    manualAddress: {
+        streetLabel: string;
+        cityLabel: string;
+        stateLabel: string;
+        statePlaceholder: string;
+        zipLabel: string;
+    };
+    preparing: {
+        title: string;
+        description: string;
+    };
+    success: {
+        title: string;
+        description: string;
+        createAnother: string;
+        viewCard: string;
+    };
+    footer: {
+        cancel: string;
+        createCard: string;
+    };
+    cardholderError: {
+        title: string;
+        description: string;
+        retry: string;
+    };
+    fundingAccountError: {
+        title: string;
+        description: string;
+        retry: string;
+    };
+}
+
+interface CreateCardFeatureLabels {
+    toast: {
+        creating: string;
+        success: string;
+        error: string;
+    };
+    untitledFundingAccount: string;
+    /**
+     * Success-screen copy chosen from the create response's `cardStatus`.
+     * Active/ready wording lives on the UI defaults; these cover statuses that
+     * must not claim the card is already usable.
+     */
+    success: {
+        pendingActivationTitle: string;
+        pendingActivationDescription: string;
+        createdTitle: string;
+        createdDescription: string;
+    };
+}
+declare const CREATE_CARD_FEATURE_LABELS_EN: CreateCardFeatureLabels;
+declare function resolveCreateCardFeatureLabels(overrides?: Partial<{
+    toast: Partial<CreateCardFeatureLabels['toast']>;
+    untitledFundingAccount: string;
+    success: Partial<CreateCardFeatureLabels['success']>;
+}>): CreateCardFeatureLabels;
+
+type CreateCardWidgetProps = WidgetProviderProps & {
+    /** Static card plastic image URL (no overlays). Host / white-label supplied. */
+    cardArtSrc: string;
+    labels?: PartialDeep$2<CreateCardWidgetLabels>;
+    featureLabels?: Partial<{
+        toast: Partial<CreateCardFeatureLabels['toast']>;
+        untitledFundingAccount: string;
+        success: Partial<CreateCardFeatureLabels['success']>;
+    }>;
+    className?: string;
+    onClose?: () => void;
+    onCancel?: () => void;
+    /** Fired with the new debit card id after a successful create. */
+    onViewCard?: (cardId: string) => void;
+};
+/**
+ * Self-contained Create Card widget. Issues a debit card via the Embed API and
+ * drives setup → preparing → success with sonner toasts for the mutation.
+ */
+declare function CreateCardWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: CreateCardWidgetProps): React.JSX.Element;
+
+/** Opaque UI format values — mapped to API `DebitCardType` in the feature. */
+declare const CardFormatValue: {
+    readonly Virtual: "virtual";
+    readonly Physical: "physical";
+};
+type CardFormatValue = (typeof CardFormatValue)[keyof typeof CardFormatValue];
+
 /**
  * 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` — same helper the
  * two card `ui` libs declare.
  */
-type PartialDeep$2<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$2<T[K]> : T[K];
+type PartialDeep$1<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$1<T[K]> : T[K];
 };
 /**
  * Strings this layer produces rather than passes through.
@@ -2026,7 +2147,7 @@ interface CardsWidgetProps extends WidgetProviderProps {
      * the list library receives those values already formatted and so has no key
      * for them; `BankAccountsWidget.featureLabels` is the same split.
      */
-    featureLabels?: PartialDeep$2<CardsFeatureLabels>;
+    featureLabels?: PartialDeep$1<CardsFeatureLabels>;
     /**
      * The card whose details panel is open. Supply with `onSelectedCardIdChange`
      * when the host owns that state — a deep-linked `/cards/[id]`, say. `null`
@@ -2081,13 +2202,32 @@ interface CardsWidgetProps extends WidgetProviderProps {
     bankLogoSrc?: string;
     bankLogoAlt?: string;
     /**
-     * Called when Create card is clicked. The button renders only when the widget
-     * token also holds the program's issue scope.
-     *
-     * The widget deliberately implements no in-list creation flow: compose
-     * `CreateCardWidget` (debit) — or your own credit flow — and open it from
-     * this callback (for example in the details sheet). Omitting the callback
-     * hides the button rather than offering a control that does nothing.
+     * Plastic art for the built-in debit create sheet. Forwarded verbatim into
+     * nested `CreateCardWidget`. Required for that sheet: omitting it (with no
+     * host `onCreateCard`) hides Create card rather than opening a panel that
+     * cannot render. Same PLAT-1179 / ADR 0005 rule as `bankLogoSrc` — the package
+     * ships no card artwork.
+     */
+    cardArtSrc?: string;
+    /**
+     * Label overrides forwarded into the nested create-card panel. Indexed off
+     * `CreateCardWidgetProps` so the forwarded and received types cannot drift,
+     * the same feature → feature edge as `cardDetailsLabels`.
+     */
+    createCardLabels?: CreateCardWidgetProps['labels'];
+    /**
+     * Overrides for the copy the create panel's *feature* layer resolves — mutation
+     * toasts, the untitled funding-account fallback, and pending-activation success
+     * copy.
+     */
+    createCardFeatureLabels?: CreateCardWidgetProps['featureLabels'];
+    /**
+     * Called when Create card is clicked. When supplied, the host owns the
+     * gesture: the built-in debit sheet does **not** open. Omit it on a debit list
+     * with `cardArtSrc` to use the built-in `CreateCardWidget` sheet. Credit has
+     * no in-package issuance widget, so credit Create card still requires this
+     * callback — omitting it hides the button rather than offering a control that
+     * does nothing.
      */
     onCreateCard?: () => void;
     /**
@@ -2113,128 +2253,18 @@ interface CardsWidgetProps extends WidgetProviderProps {
  * query param, or take navigation over entirely — the widget itself reads no
  * router and no search params.
  *
+ * On a debit list with `cardArtSrc`, Create card opens the same sheet with
+ * nested `CreateCardWidget`. A host `onCreateCard` still takes over that
+ * gesture (credit, or a custom debit flow). The two panels are mutually
+ * exclusive: opening one closes the other. Success **View card** selects the
+ * new debit card so its details open.
+ *
  * A pure provider wrapper — every hook lives in `CardsWidgetInner` so it runs
  * inside `WidgetProvider`'s subtree, which is what the data-access hooks read
  * their client, org and token from.
  */
 declare function CardsWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: CardsWidgetProps): React.JSX.Element;
 
-type PartialDeep$1<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$1<T[K]> : T[K];
-};
-interface CreateCardWidgetLabels {
-    header: {
-        title: string;
-        closeAriaLabel: string;
-    };
-    cardArtAlt: string;
-    setup: {
-        sectionTitle: string;
-        sectionDescription: string;
-        cardholderLabel: string;
-        cardholderPlaceholder: string;
-        cardFormatLabel: string;
-        cardFormatPlaceholder: string;
-        cardFormatVirtual: string;
-        cardFormatPhysical: string;
-        fundingAccountLabel: string;
-        fundingAccountPlaceholder: string;
-    };
-    mailing: {
-        sectionTitle: string;
-        sectionDescription: string;
-        businessTitle: string;
-        businessDescription: string;
-        customTitle: string;
-        customDescription: string;
-    };
-    manualAddress: {
-        streetLabel: string;
-        cityLabel: string;
-        stateLabel: string;
-        statePlaceholder: string;
-        zipLabel: string;
-    };
-    preparing: {
-        title: string;
-        description: string;
-    };
-    success: {
-        title: string;
-        description: string;
-        createAnother: string;
-        viewCard: string;
-    };
-    footer: {
-        cancel: string;
-        createCard: string;
-    };
-    cardholderError: {
-        title: string;
-        description: string;
-        retry: string;
-    };
-    fundingAccountError: {
-        title: string;
-        description: string;
-        retry: string;
-    };
-}
-
-interface CreateCardFeatureLabels {
-    toast: {
-        creating: string;
-        success: string;
-        error: string;
-    };
-    untitledFundingAccount: string;
-    /**
-     * Success-screen copy chosen from the create response's `cardStatus`.
-     * Active/ready wording lives on the UI defaults; these cover statuses that
-     * must not claim the card is already usable.
-     */
-    success: {
-        pendingActivationTitle: string;
-        pendingActivationDescription: string;
-        createdTitle: string;
-        createdDescription: string;
-    };
-}
-declare const CREATE_CARD_FEATURE_LABELS_EN: CreateCardFeatureLabels;
-declare function resolveCreateCardFeatureLabels(overrides?: Partial<{
-    toast: Partial<CreateCardFeatureLabels['toast']>;
-    untitledFundingAccount: string;
-    success: Partial<CreateCardFeatureLabels['success']>;
-}>): CreateCardFeatureLabels;
-
-type CreateCardWidgetProps = WidgetProviderProps & {
-    /** Static card plastic image URL (no overlays). Host / white-label supplied. */
-    cardArtSrc: string;
-    labels?: PartialDeep$1<CreateCardWidgetLabels>;
-    featureLabels?: Partial<{
-        toast: Partial<CreateCardFeatureLabels['toast']>;
-        untitledFundingAccount: string;
-        success: Partial<CreateCardFeatureLabels['success']>;
-    }>;
-    className?: string;
-    onClose?: () => void;
-    onCancel?: () => void;
-    /** Fired with the new debit card id after a successful create. */
-    onViewCard?: (cardId: string) => void;
-};
-/**
- * Self-contained Create Card widget. Issues a debit card via the Embed API and
- * drives setup → preparing → success with sonner toasts for the mutation.
- */
-declare function CreateCardWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: CreateCardWidgetProps): React.JSX.Element;
-
-/** Opaque UI format values — mapped to API `DebitCardType` in the feature. */
-declare const CardFormatValue: {
-    readonly Virtual: "virtual";
-    readonly Physical: "physical";
-};
-type CardFormatValue = (typeof CardFormatValue)[keyof typeof CardFormatValue];
-
 interface AddressFieldGroupLabels {
     line1: string;
     line2: string;
@@ -3946,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 {
@@ -3965,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;
 
@@ -3982,6 +4028,12 @@ interface Labels$1 {
     description?: string;
 }
 
+interface SettingsWidgetSection {
+    id: string;
+    label: string;
+    content: ReactNode;
+}
+
 interface FeatureLabels$2 {
     profileSection: string;
     teamSection: string;
@@ -3995,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>;
@@ -4010,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;
@@ -4525,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 };