@tesouro/embedded-components-react 0.2.205 → 0.2.208

package/dist/index.d.ts

@@ -3,8 +3,8 @@ import { ReactNode, ComponentType, AnchorHTMLAttributes, PropsWithChildren, Erro
 import { FallbackProps } from 'react-error-boundary';
 import { SortingState, OnChangeFn } from '@tanstack/react-table';
 
-type PartialDeep$3<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$3<T[K]> : T[K];
+type PartialDeep$4<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$4<T[K]> : T[K];
 };
 interface AcceptDisclosuresWidgetLabels {
     title: string;
@@ -41,7 +41,7 @@ interface AcceptDisclosuresWidgetProps$1 {
     isAgreed: boolean;
     onAgreedChange: (checked: boolean) => void;
     onAccept: () => void;
-    labels?: PartialDeep$3<AcceptDisclosuresWidgetLabels>;
+    labels?: PartialDeep$4<AcceptDisclosuresWidgetLabels>;
 }
 
 type AuthToken = string | undefined;
@@ -368,6 +368,8 @@ type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean
 type ClientOptions = {
     baseUrl: 'https://api.stage.tesouro.com' | 'https://api.sandbox.stage.tesouro.com' | 'https://api.stage.business-banking.app' | 'https://api.tesouro.com' | 'https://api.sandbox.tesouro.com' | 'https://api.business-banking.app' | (string & {});
 };
+type CreditCardStatus = 'PENDING_ACTIVATION' | 'ACTIVE' | 'LOCKED' | 'CLOSED';
+type CreditCardType = 'DIGITAL' | 'PHYSICAL';
 type DisclosureRequirement = 'NOT_REQUIRED' | 'REQUIRED';
 type OrganizationType = 'BANK' | 'EMBEDDED' | 'PLATFORM' | 'TRANSACTOR' | 'VERTICAL_SOFTWARE_PROVIDER';
 type WidgetInitResponse = {
@@ -1153,6 +1155,47 @@ interface UseWidgetTokenResult {
 }
 declare function useWidgetToken(): UseWidgetTokenResult;
 
+/**
+ * Which issuing product a card belongs to. A card list shows exactly one
+ * program at a time, and the value selects the endpoint the data-access layer
+ * calls: `credit` → `/embedded-banking/v1/credit-cards`, `debit` →
+ * `/embedded-banking/v1/debit-cards`.
+ *
+ * Defined here rather than in either widget because `CardsWidget` and
+ * `CardDetailsWidget` both publish it as a required public prop. Declared
+ * inline in each, the literal would become public API twice with no single
+ * definition — and `cards-widget/ui` ↔ `card-details-widget/ui` imports are
+ * lint-banned while the reverse feature import would be an Nx cycle, so
+ * `shared/feature` is the only home that serves both without duplication.
+ *
+ * Deliberately **not** the generated `CardTypeEnum` (`credit | debit | prepaid
+ * | unknown`), which greps as an exact match for this concept but belongs to
+ * the unrelated snake_case third-party schema family (its sibling fields are
+ * `card_type`, `last4`, `background_color`) and carries two members neither
+ * widget supports. In this codebase "card type" is the DIGITAL/PHYSICAL form
+ * factor instead — see `CardType` in `./cardPresentation`.
+ *
+ * Const-object-plus-type rather than a bare union, mirroring `UIFramework` in
+ * `shared/ui` — the other two-member literal that ships as a public prop type.
+ */
+declare const CardProgram: {
+    readonly Credit: "credit";
+    readonly Debit: "debit";
+};
+type CardProgram = (typeof CardProgram)[keyof typeof CardProgram];
+
+/**
+ * A card's lifecycle status, program-agnostic. Aliases the credit union because
+ * one of the two has to be the base; the parity assertions below are what keep
+ * that choice arbitrary.
+ */
+type CardStatus = CreditCardStatus;
+/**
+ * A card's physical form factor — the codebase's meaning of "card type". The
+ * credit/debit axis is `CardProgram`, not this.
+ */
+type CardType = CreditCardType;
+
 /**
  * The four disclosure documents a host supplies. Keyed rather than a free-form
  * array because `agreementTextTemplate` names exactly these four instruments —
@@ -1529,6 +1572,408 @@ type BillPayWidgetProps = BillPayWidgetMoniteProps;
  */
 declare function BillPayWidget({ implementation, ...props }: BillPayWidgetProps): React.JSX.Element;
 
+/**
+ * Every key of `T` optional, recursively, so a consumer can override one nested
+ * label without restating its siblings. Defined locally because the repo has no
+ * shared deep-partial type and does not depend on `type-fest`.
+ */
+type PartialDeep$3<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$3<T[K]> : T[K];
+};
+interface CardsListColumnHeaderLabels {
+    cardName: string;
+    fundingAccount: string;
+    cardholder: string;
+    status: string;
+    limit: string;
+}
+/**
+ * Screen-reader-only copy naming the details sheet a row click opens.
+ *
+ * Both strings are invisible by design: the sheet's visible header belongs to
+ * whatever the owner slots into it (`CardDetailsPanel`, via `CardsWidget`), and a
+ * second visible title would duplicate it. They exist because the sheet is a
+ * dialog, and a dialog without an accessible name is announced as nothing.
+ */
+interface CardsListDetailsSheetLabels {
+    /** Accessible name for the sheet. */
+    title: string;
+    /** Accessible description, announced after the name. */
+    description: string;
+}
+/**
+ * Every user-facing string the cards list renders, including screen-reader-only
+ * copy and the decorative separators.
+ *
+ * There is intentionally **no** card-type or card-status map here: the row
+ * arrives with `typeLabel` and `statusLabel` already resolved, so the
+ * `DIGITAL`/`PHYSICAL` and `PENDING_ACTIVATION`/`ACTIVE`/`LOCKED`/`CLOSED` maps
+ * live in `shared/feature` keyed on the generated types (EMBD-4404 amendment;
+ * see `statusBadge.ts`). That is also where the "label keys carry the code term,
+ * values carry the copy" rule applies — `digital`, never `virtual`, so a later
+ * wording change is not a breaking rename.
+ */
+interface CardsListLabels {
+    title: string;
+    /** Accessible name for the list region. */
+    regionLabel: string;
+    columnHeaders: CardsListColumnHeaderLabels;
+    /** Screen-reader name for the unheaded trailing row-actions column. */
+    rowActionsColumn: string;
+    showMyCardsToggle: string;
+    createCardButton: string;
+    activateButton: string;
+    /** Accessible name for a row's Activate button; the card name is appended. */
+    activateButtonForCard: string;
+    /** Accessible name for a row's open-details control; card name appended. */
+    selectCardButton: string;
+    /** Separator between a card's nickname and its last four digits. */
+    cardNameSeparator: string;
+    /** Stands in for the limit when a card has none set. */
+    noLimit: string;
+    /** Announced while a page of cards is loading. */
+    loadingLabel: string;
+    emptyTitle: string;
+    emptyDescription: string;
+    errorTitle: string;
+    errorDescription: string;
+    retryButton: string;
+    pagination: PaginationFooterLabels;
+    /**
+     * Copy for the details sheet a row click opens. Rendered by
+     * `CardsListDetailsSheet` rather than by the table, but part of this surface
+     * because it is one screen and one `labels` prop — the same reason `pagination`
+     * sits here for a footer that lives in `shared/ui`.
+     */
+    detailsSheet: CardsListDetailsSheetLabels;
+}
+
+/** Accessible copy for the panel header's controls. */
+interface CardDetailsHeaderLabels {
+    /** Fallback title when the card has no nickname. */
+    untitledCard: string;
+    /** Accessible name for the kebab that opens the card actions menu. */
+    menuTriggerAriaLabel: string;
+    /** Accessible name for the close (X) control. */
+    closeAriaLabel: string;
+}
+/** Accessible copy for the simplified card face. */
+interface CardDetailsCardFaceLabels {
+    /** Alt text for the bank logo when the caller supplies no `bankLogoAlt`. */
+    bankLogoAlt: string;
+}
+/** Row headings and per-row copy affordance names for the details table. */
+interface CardDetailsFieldLabels {
+    cardholder: string;
+    nickname: string;
+    billingAddress: string;
+    allowedCategories: string;
+    /** Stands in for a row whose value the card does not carry. */
+    emptyValue: string;
+    copyCardholderAriaLabel: string;
+    copyNicknameAriaLabel: string;
+    copyBillingAddressAriaLabel: string;
+}
+/** Copy for the three non-loaded screens. */
+interface CardDetailsStatusScreenLabels {
+    /** Accessible name announced while the panel is loading. */
+    loadingAriaLabel: string;
+    errorTitle: string;
+    errorDescription: string;
+    errorRetry: string;
+    notFoundTitle: string;
+    notFoundDescription: string;
+}
+interface CardDetailsPanelLabels {
+    header: CardDetailsHeaderLabels;
+    cardFace: CardDetailsCardFaceLabels;
+    fields: CardDetailsFieldLabels;
+    status: CardDetailsStatusScreenLabels;
+}
+
+/**
+ * Deep partial for label overrides.
+ *
+ * Both label surfaces this widget exposes have nested groups, and a shallow
+ * `Partial` would let a consumer who overrides one nested string drop the rest
+ * of that group. The repo has no shared `PartialDeep` and does not depend on
+ * `type-fest`, so each labels module defines its own — `card-details-widget/ui`
+ * has an identical one for the panel's labels, and this declaration also types
+ * that prop here so the widget carries one such helper rather than two.
+ */
+type PartialDeep$2<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$2<T[K]> : T[K];
+};
+/**
+ * Copy the **feature** layer owns, as opposed to the panel's own
+ * `CardDetailsPanelLabels`.
+ *
+ * The split follows where the string is resolved, not where it is painted. A
+ * status badge word is chosen by mapping a generated `cardStatus` enum member,
+ * which is a data-access-typed decision the presentational layer is not allowed
+ * to make — so it is overridable here even though the panel renders it. The
+ * panel's own labels stay with the panel.
+ */
+interface CardDetailsFeatureLabels {
+    /** Confirmation toast after a copy affordance writes to the clipboard. */
+    copySuccessToast: string;
+    /** Program wording on the card face, keyed on the widget's `cardProgram`. */
+    programLabels: Record<CardProgram, string>;
+    /** Status badge wording, keyed on the generated card status. */
+    statusLabels: Record<CardStatus, string>;
+    /** Form-factor subtitle wording, keyed on the generated card type. */
+    formFactorLabels: Record<CardType, string>;
+}
+
+interface CardDetailsWidgetProps extends WidgetProviderProps {
+    /** Id of the card to show. */
+    cardId: string;
+    /**
+     * Which issuing product `cardId` belongs to. **Required, with no default** —
+     * it selects the endpoint the card is fetched from, and a wrong guess would
+     * 404 a card that exists. `CardsWidget` publishes the same required prop, so
+     * one value configures a list and its detail panel together.
+     *
+     * A JavaScript consumer, or a host passing a route param straight through, can
+     * still get a value past the type. **There is no catch-all and no default:**
+     * anything that is not explicitly one of the two programs fetches nothing and
+     * renders the panel's error state with no retry, and the reason is named on the
+     * console. That covers an absent prop (`undefined` / `null`) as well as an
+     * unrecognised one (`'prepaid'`, a case-wrong `'Credit'`), because the widget
+     * cannot know which product to ask about in either case.
+     *
+     * A host that resolves the program asynchronously should gate its own render on
+     * it rather than mounting this widget without it — an absent program is not
+     * read as "still loading".
+     */
+    cardProgram: CardProgram;
+    /**
+     * Called when the header's close control is pressed. Omitting it renders no
+     * close control at all: a standalone card page has nothing to close back to,
+     * while a host rendering the panel in a drawer supplies this and suppresses
+     * its own chrome's close button so the two do not sit side by side.
+     */
+    onClose?: () => void;
+    /** Overrides for the panel's own copy. */
+    labels?: PartialDeep$2<CardDetailsPanelLabels>;
+    /** Overrides for the copy this layer resolves — see `CardDetailsFeatureLabels`. */
+    featureLabels?: PartialDeep$2<CardDetailsFeatureLabels>;
+    /**
+     * Bank logo for the card face. The widget ships no bank artwork of its own and
+     * resolves none from the init response: an embeddable library must not depend
+     * on a Tesouro-hosted asset a host page's content-security policy can block,
+     * and a bundled bank-name→URL table would put internal CDN links in the
+     * published package (PLAT-1179, embedded ADR 0005). Omit it and the card face
+     * renders without a logo rather than with a placeholder.
+     */
+    bankLogoSrc?: string;
+    bankLogoAlt?: string;
+}
+/**
+ * Read-only details for one card, standalone-capable.
+ *
+ * Provides its own `WidgetProvider`, so it renders with nothing above it — a
+ * partner can mount it on a real `/cards/[id]` page. Nested inside another
+ * widget's provider with no auth props of its own, it inherits that init
+ * response and `QueryClient` instead, costing no second `/init` call and sharing
+ * one cache with the list that opened it. Do not forward `baseUrl` or
+ * `widgetToken` into it from a parent widget: either one flips this provider into
+ * fetch mode and buys a redundant init request per open.
+ *
+ * Both placements are covered by specs, because they take different code paths
+ * through the provider and this export exists for the standalone one.
+ */
+declare function CardDetailsWidget({ baseUrl, widgetToken, organizationId, configClient, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, ...innerProps }: CardDetailsWidgetProps): React.JSX.Element;
+
+/**
+ * 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$1<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep$1<T[K]> : T[K];
+};
+/**
+ * Strings this layer produces rather than passes through.
+ *
+ * They are separate from `CardsListLabels` (the `ui` lib's) because the cells
+ * reaching that library are already formatted: the em-dash, the nickname
+ * fallback and the "Viewing" prefix are all written *here*, so the UI lib has
+ * no key to override them with. `bank-accounts-widget`'s `featureLabels` is the
+ * precedent for the split.
+ *
+ * The status and form-factor maps live here for the same reason. EMBD-4503's
+ * amendment put them in `shared/feature` keyed on the generated unions, and the
+ * row arrives with `statusLabel` / `typeLabel` resolved — so this is the only
+ * layer a consumer could reach them through.
+ */
+interface CardsFeatureLabels {
+    /**
+     * Stands in for a cell the card program carries no value for — credit has no
+     * funding account, and a debit card's funding account is unresolvable without
+     * the bank-account read scope.
+     */
+    emptyValue: string;
+    /** Name shown for a card with no nickname set. */
+    untitledCard: string;
+    /**
+     * Last-resort name for a funding account with neither a nickname nor an
+     * account number to mask. An account with no nickname shows `••••1234`
+     * instead, so that two unnamed accounts stay distinguishable — this is only
+     * for the case where there is nothing at all to show.
+     */
+    untitledFundingAccount: string;
+    /** Display copy per card lifecycle status; keys are the generated code terms. */
+    cardStatus: Record<CardStatus, string>;
+    /** Display copy per card form factor; keys are the generated code terms. */
+    cardType: Record<CardType, string>;
+}
+
+interface CardsWidgetPagination {
+    /** Cursor for the page on screen. Omit for the first page. */
+    paginationToken?: string;
+    /** Number of rows requested per page. */
+    pageSize: number;
+}
+interface CardsWidgetPaginationInput {
+    paginationToken?: string;
+    pageSize?: number;
+}
+
+interface CardsWidgetProps extends WidgetProviderProps {
+    /**
+     * Which issuing program the list shows — `'credit'` or `'debit'`.
+     *
+     * **Required, with no default.** A cards list shows exactly one program, and
+     * the value selects the endpoint that is read as well as which scopes gate the
+     * affordances. Defaulting it would make the choice invisible at the call site
+     * and would silently pick a program for a host that meant the other one.
+     */
+    cardProgram: CardProgram;
+    /**
+     * Controlled cursor/page-size metadata. Supply with `onPaginationChange` when
+     * a host owns the list position, e.g. URL-backed pagination.
+     */
+    pagination?: CardsWidgetPaginationInput;
+    /**
+     * Initial cursor/page-size metadata for uncontrolled usage. Omit for first
+     * page with the default page size. Ignored when `pagination` is supplied.
+     */
+    defaultPagination?: CardsWidgetPaginationInput;
+    /**
+     * Called whenever the widget changes its cursor/page-size pair through pagination
+     * controls or a cursor-invalidating reset such as page-size changes. Hosts that
+     * persist list position should store this whole object, not the token alone.
+     */
+    onPaginationChange?: (pagination: CardsWidgetPagination) => void;
+    /**
+     * Overrides for the list's own copy, merged per nested group. Typed with the
+     * `ui` lib's own deep-partial helper (each labels module declares one — the
+     * repo has no shared version) so this prop follows that library's contract.
+     */
+    labels?: PartialDeep$3<CardsListLabels>;
+    /**
+     * Overrides for the copy this layer produces rather than passes through — the
+     * status and form-factor vocabulary, the empty-cell placeholder, the nickname
+     * fallbacks, and the pagination range prefix. Separate from `labels` because
+     * the list library receives those values already formatted and so has no key
+     * for them; `BankAccountsWidget.featureLabels` is the same split.
+     */
+    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`
+     * closes the panel; omit the prop for uncontrolled behaviour.
+     *
+     * Pinning it to `null` and navigating from `onSelectedCardIdChange` is how a
+     * host suppresses the built-in panel entirely and owns navigation itself: the
+     * click is still reported, and because the value never comes back non-null,
+     * nothing ever opens.
+     */
+    selectedCardId?: string | null;
+    /** Initial selection when uncontrolled. Ignored when `selectedCardId` is supplied. */
+    defaultSelectedCardId?: string | null;
+    /**
+     * Called whenever the open card changes, including on close (`null`).
+     *
+     * Supplying it does **not** change what renders — a host can observe row clicks
+     * for analytics, or mirror the selection into a query param, and still get the
+     * built-in panel. (The removed `onCardSelect` could not: its presence
+     * suppressed the panel, so those two intents were unexpressible together.)
+     */
+    onSelectedCardIdChange?: (cardId: string | null) => void;
+    /**
+     * Label overrides forwarded into the nested card details panel, mirroring
+     * `BankAccountsWidgetProps.accountDetailsLabels`.
+     *
+     * Derived from the receiving prop rather than restated, so the forwarded and
+     * received types cannot drift. Naming the panel's labels type directly is not
+     * an option anyway: a cross-widget `type:ui` import is banned by
+     * `EMBEDDED_DEP_CONSTRAINTS`, and this indexed access reaches it through the
+     * sanctioned feature → feature edge without re-exporting anything. It already
+     * carries `card-details-widget`'s own deep partial, so no wrapper here.
+     */
+    cardDetailsLabels?: CardDetailsWidgetProps['labels'];
+    /**
+     * Overrides for the copy the panel's *feature* layer resolves — its status
+     * vocabulary, form-factor wording, program label and copy-success toast.
+     *
+     * Distinct from `featureLabels`, which covers the list's own vocabulary.
+     * Without this prop the panel is unreachable for that copy, so a host that
+     * renames a status in the list would still read the default inside the panel.
+     */
+    cardDetailsFeatureLabels?: CardDetailsWidgetProps['featureLabels'];
+    /**
+     * Bank logo for the details panel's card face. Forwarded verbatim; the panel
+     * renders no logo without it, so omitting these leaves the built-in sheet
+     * showing a logo-less card rather than a placeholder.
+     *
+     * These stay props because the package ships no bank artwork and resolves none
+     * from the init response (PLAT-1179, embedded ADR 0005).
+     */
+    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 creation flow: `POST /credit-cards`
+     * exists but has no designed flow in EMBD-4398, and debit has no create
+     * endpoint at all despite `debit_card:issue:org` being a real scope. So the
+     * gesture is handed to the host, and omitting the callback hides the button
+     * rather than offering a control that does nothing.
+     */
+    onCreateCard?: () => void;
+    /**
+     * Called with the card's id when a row's Activate button is clicked. The button
+     * renders only on cards in `PENDING_ACTIVATION`, and only when the widget token
+     * also holds the program's activate scope.
+     *
+     * Host-owned for the same reason as `onCreateCard`: EMBD-4398 designs no
+     * activation flow, and `POST /debit-cards/{id}/activate` does not exist even
+     * though `debit_card:activate:org` does — so a built-in flow could serve only
+     * one of the two programs.
+     */
+    onActivateCard?: (cardId: string) => void;
+}
+/**
+ * The cards list widget: one page of an organization's credit or debit cards,
+ * with scope-gated Show my cards, Create card and per-row Activate affordances.
+ *
+ * Selecting a row opens that card's read-only details in a sheet, composed from
+ * `CardDetailsWidget` over the sanctioned feature → feature edge. Which card is
+ * open is a controllable value (`selectedCardId` / `defaultSelectedCardId` /
+ * `onSelectedCardIdChange`) so a host can deep-link into it, mirror it into a
+ * query param, or take navigation over entirely — the widget itself reads no
+ * router and no search params.
+ *
+ * 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;
+
 interface AddressFieldGroupLabels {
     line1: string;
     line2: string;
@@ -2803,8 +3248,8 @@ interface DisclosureLinks {
 }
 
 /** Nested keys are individually optional — see AGENTS.md labels guidance. */
-type PartialDeep$2<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$2<T[K]> : T[K];
+type PartialDeep<T> = {
+    [K in keyof T]?: T[K] extends object ? PartialDeep<T[K]> : T[K];
 };
 interface BankAccountOnboardingWidgetLabels {
     stepIndicator: {
@@ -2813,7 +3258,7 @@ interface BankAccountOnboardingWidgetLabels {
         ownership: string;
         done: string;
     };
-    businessDetails: PartialDeep$2<BusinessDetailsLabels>;
+    businessDetails: PartialDeep<BusinessDetailsLabels>;
     personalDetails: Partial<PersonalDetailsLabels>;
     additionalOwners: Partial<AdditionalOwnersLabels>;
     result: ResultLabels;
@@ -2843,7 +3288,7 @@ interface BankAccountOnboardingWidgetLabels {
 interface BankAccountOnboardingWidgetInnerProps {
     onEmbeddedOnboardingCompletedSuccessfully: () => void;
     onNavigateToDashboard: () => void;
-    labels?: PartialDeep$2<BankAccountOnboardingWidgetLabels>;
+    labels?: PartialDeep<BankAccountOnboardingWidgetLabels>;
     initialBusinessDetails?: Partial<BusinessDetailsValues>;
     initialPersonalDetails?: Partial<PersonalDetailsValues>;
     initialAdditionalOwners?: AdditionalOwner[];
@@ -3558,307 +4003,7 @@ interface GapCoverageAlertProps {
     labels?: Partial<GapCoverageAlertLabels>;
 }
 
-/**
- * Deep partial for label overrides. `Labels` here has nested groups, and a
- * shallow `Partial` would let a consumer who overrides one nested string drop
- * the rest of that group. The repo has no shared `PartialDeep` and does not
- * depend on `type-fest`, so each labels module defines its own.
- */
-type PartialDeep$1<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep$1<T[K]> : T[K];
-};
-/** Accessible copy for the panel header's controls. */
-interface CardDetailsHeaderLabels {
-    /** Fallback title when the card has no nickname. */
-    untitledCard: string;
-    /** Accessible name for the kebab that opens the card actions menu. */
-    menuTriggerAriaLabel: string;
-    /** Accessible name for the close (X) control. */
-    closeAriaLabel: string;
-}
-/** Accessible copy for the simplified card face. */
-interface CardDetailsCardFaceLabels {
-    /** Alt text for the bank logo when the caller supplies no `bankLogoAlt`. */
-    bankLogoAlt: string;
-}
-/** Row headings and per-row copy affordance names for the details table. */
-interface CardDetailsFieldLabels {
-    cardholder: string;
-    nickname: string;
-    billingAddress: string;
-    allowedCategories: string;
-    /** Stands in for a row whose value the card does not carry. */
-    emptyValue: string;
-    copyCardholderAriaLabel: string;
-    copyNicknameAriaLabel: string;
-    copyBillingAddressAriaLabel: string;
-}
-/** Copy for the three non-loaded screens. */
-interface CardDetailsStatusScreenLabels {
-    /** Accessible name announced while the panel is loading. */
-    loadingAriaLabel: string;
-    errorTitle: string;
-    errorDescription: string;
-    errorRetry: string;
-    notFoundTitle: string;
-    notFoundDescription: string;
-}
-interface CardDetailsPanelLabels {
-    header: CardDetailsHeaderLabels;
-    cardFace: CardDetailsCardFaceLabels;
-    fields: CardDetailsFieldLabels;
-    status: CardDetailsStatusScreenLabels;
-}
-
-/**
- * Presentational tone for the card status badge. The feature layer decides which
- * tone a domain status maps to; this UI helper only turns a tone into colors —
- * so the component never encodes card-status semantics.
- *
- * Deliberately NOT a `Record<CardStatus, string>` inside this lib (the shape
- * `bill-pay-widget` uses). `cards-widget/ui` ↔ `card-details-widget/ui` imports
- * are lint-banned, so a status map here would have to be duplicated in the list
- * widget and could drift between the list badge and the panel badge on the same
- * screen. `CARD_STATUS_TONE` and `CARD_STATUS_LABELS_EN` live in
- * `shared/feature` instead (EMBD-4503), and both widgets read from there.
- */
-type CardStatusTone$1 = 'success' | 'info' | 'warning' | 'neutral';
-
-/** Which of the four screens the panel renders. */
-type CardDetailsPanelState = 'loading' | 'error' | 'notFound' | 'loaded';
-interface CardDetailsPanelProps {
-    labels?: PartialDeep$1<CardDetailsPanelLabels>;
-    state: CardDetailsPanelState;
-    /** Card nickname. Absent falls back to `labels.header.untitledCard`. */
-    nickname?: string;
-    /** Already-resolved status wording, e.g. "Active". */
-    statusLabel?: string;
-    /** Already-resolved presentational tone for the status badge. */
-    statusTone?: CardStatusTone$1;
-    /** Form-factor subtitle, e.g. "Virtual". */
-    formFactorLabel?: string;
-    /** Items for the kebab menu. Absent renders no kebab. */
-    cardMenu?: ReactNode;
-    /** Absent renders no X — see `CardDetailsHeader`. */
-    onClose?: () => void;
-    bankLogoSrc?: string;
-    bankLogoAlt?: string;
-    cardholderName?: string;
-    /** Already-masked account number, e.g. `•••• •••• •••• 1234`. */
-    maskedCardNumber?: string;
-    /** Resolved program wording, e.g. "Business credit". */
-    programLabel?: string;
-    /**
-     * Unpopulated today: credit has no billing address and EMBD-4406 promises one
-     * for debit. Committing the prop now keeps that follow-up feature-layer-only.
-     * Renders nothing when absent.
-     */
-    billingAddress?: string;
-    /** Same as `billingAddress` — committed for EMBD-4406, renders nothing when absent. */
-    allowedCategories?: string[];
-    /** Emits the gesture only; the clipboard write and toast are the feature layer's. */
-    onCopy?: (value: string) => void;
-    /** Absent renders the error screen without a retry button. */
-    onRetry?: () => void;
-    className?: string;
-}
-
-/**
- * Every key of `T` optional, recursively, so a consumer can override one nested
- * label without restating its siblings. Defined locally because the repo has no
- * shared deep-partial type and does not depend on `type-fest`.
- */
-type PartialDeep<T> = {
-    [K in keyof T]?: T[K] extends object ? PartialDeep<T[K]> : T[K];
-};
-interface CardsListColumnHeaderLabels {
-    cardName: string;
-    fundingAccount: string;
-    cardholder: string;
-    status: string;
-    limit: string;
-}
-/**
- * Screen-reader-only copy naming the details sheet a row click opens.
- *
- * Both strings are invisible by design: the sheet's visible header belongs to
- * whatever the owner slots into it (`CardDetailsPanel`, via `CardsWidget`), and a
- * second visible title would duplicate it. They exist because the sheet is a
- * dialog, and a dialog without an accessible name is announced as nothing.
- */
-interface CardsListDetailsSheetLabels {
-    /** Accessible name for the sheet. */
-    title: string;
-    /** Accessible description, announced after the name. */
-    description: string;
-}
-/**
- * Every user-facing string the cards list renders, including screen-reader-only
- * copy and the decorative separators.
- *
- * There is intentionally **no** card-type or card-status map here: the row
- * arrives with `typeLabel` and `statusLabel` already resolved, so the
- * `DIGITAL`/`PHYSICAL` and `PENDING_ACTIVATION`/`ACTIVE`/`LOCKED`/`CLOSED` maps
- * live in `shared/feature` keyed on the generated types (EMBD-4404 amendment;
- * see `statusBadge.ts`). That is also where the "label keys carry the code term,
- * values carry the copy" rule applies — `digital`, never `virtual`, so a later
- * wording change is not a breaking rename.
- */
-interface CardsListLabels {
-    title: string;
-    /** Accessible name for the list region. */
-    regionLabel: string;
-    columnHeaders: CardsListColumnHeaderLabels;
-    /** Screen-reader name for the unheaded trailing row-actions column. */
-    rowActionsColumn: string;
-    showMyCardsToggle: string;
-    createCardButton: string;
-    activateButton: string;
-    /** Accessible name for a row's Activate button; the card name is appended. */
-    activateButtonForCard: string;
-    /** Accessible name for a row's open-details control; card name appended. */
-    selectCardButton: string;
-    /** Separator between a card's nickname and its last four digits. */
-    cardNameSeparator: string;
-    /** Stands in for the limit when a card has none set. */
-    noLimit: string;
-    /** Announced while a page of cards is loading. */
-    loadingLabel: string;
-    emptyTitle: string;
-    emptyDescription: string;
-    errorTitle: string;
-    errorDescription: string;
-    retryButton: string;
-    pagination: PaginationFooterLabels;
-    /**
-     * Copy for the details sheet a row click opens. Rendered by
-     * `CardsListDetailsSheet` rather than by the table, but part of this surface
-     * because it is one screen and one `labels` prop — the same reason `pagination`
-     * sits here for a footer that lives in `shared/ui`.
-     */
-    detailsSheet: CardsListDetailsSheetLabels;
-}
-
-/**
- * Presentational tone for a card's status chip. The feature layer decides which
- * tone a domain status maps to; this UI helper only turns a tone into colors, so
- * the library never encodes card-status semantics.
- *
- * This follows `team-widget/ui/src/lib/TeamMembersTable/statusBadge.ts` rather
- * than `bill-pay-widget`'s `Record<PayableBadgeStatus, string>`: the two in-repo
- * precedents disagree, and EMBD-4404 settled it in favour of `team-widget`.
- * `CARD_STATUS_TONE` / `CARD_STATUS_LABELS_EN` / `CARD_TYPE_LABELS_EN` live in
- * `shared/feature` (keyed on the generated types) so the list badge and the
- * EMBD-4404 details panel cannot drift apart — a `cards-widget/ui` ↔
- * `card-details-widget/ui` import is lint-banned and the reverse feature import
- * would be an Nx cycle, leaving `shared/feature` the only home serving both.
- */
-type CardStatusTone = 'success' | 'info' | 'warning' | 'neutral';
-
-/**
- * The cards list's columns, in the canonical Figma order (node 612-140748, with
- * the Funding account column EMBD-4398 has pending).
- *
- * Keys name the **column on screen**, not a row field: `cardName` is one column
- * that renders a card's nickname, last four digits and card type together, so
- * column keys and `CardRow` fields are deliberately not 1:1. Pass a subset (in
- * any order) as `CardsListProps.columns` — this constant is the full set, handy
- * for the owner to filter.
- */
-declare const CARD_COLUMN_KEYS: readonly ["cardName", "fundingAccount", "cardholder", "status", "limit"];
-type CardColumnKey = (typeof CARD_COLUMN_KEYS)[number];
-/**
- * A display-ready cards-list row — every field is an already-formatted string
- * the owner produced.
- *
- * This is the **superset** of what any card program shows, so the library does
- * not know that credit and debit exist. A program with no value for a field
- * passes an em-dash rather than omitting it, and a program that does not show a
- * column at all simply leaves that column out of `columns`.
- */
-interface CardRow {
-    /** Stable render identity for React keys and test anchors. */
-    key: string;
-    nickname: string;
-    /** Last four digits, already trimmed by the owner, e.g. `"4783"`. */
-    lastFour: string;
-    /** Card type copy, e.g. `"Digital"` / `"Physical"`, resolved by the owner. */
-    typeLabel: string;
-    fundingAccount: string;
-    cardholder: string;
-    statusLabel: string;
-    statusTone: CardStatusTone;
-    /**
-     * The card's spending limit amount, formatted, e.g. `"$10,000"`. Omit when the
-     * card has no limit, and the cell falls back to the `noLimit` label.
-     *
-     * Deliberately **not** paired with a balance — the column shows the limit on
-     * the card regardless of what has been spent or what the funding account holds
-     * (Dan's decision with the backend engineers, 2026-07-28).
-     */
-    limit?: string;
-    /**
-     * The muted qualifier rendered after `limit`, e.g. `"/mo"`, `"/day"`,
-     * `"one-time"`. Split from the amount because the mockup gives the two
-     * different weights — amount in foreground, qualifier muted — so one
-     * pre-joined string could not render it.
-     *
-     * **No caller sets this today, on either program.** `CreditCardResponse` and
-     * `DebitCardResponse` each expose a single bare limit scalar — `cardLimit` and
-     * `spendingLimit` — with no period beside it. TSYS models debit limits per
-     * cycle (`perCycle` / `daily` / `monthly`, plus a separate
-     * `singlePurchaseLimit`), but none of that is in `openapi.json`, so
-     * `toCardRows` leaves this unset for every card and `rows.spec.ts` pins that.
-     *
-     * Kept rather than deleted because the field is a plausible API addition and
-     * the renderer for it is already correct: a period would otherwise have to
-     * arrive pre-joined into `limit`, which cannot carry the two weights the design
-     * gives them. When the API grows one, populate it in `toCardRows` and restore
-     * the periods to the debit fixtures — nothing here changes.
-     *
-     * Ignored when `limit` is omitted.
-     */
-    limitPeriod?: string;
-    /** Optional open-details gesture for the card-name cell. */
-    onSelect?: () => void;
-    /** Optional Activate gesture; when omitted, the action cell stays empty. */
-    onActivate?: () => void;
-}
-
-interface CardsListProps {
-    rows: CardRow[];
-    /**
-     * The visible columns, in render order. Required: which columns a program
-     * shows is the owner's call, and a default would silently decide it.
-     * `CARD_COLUMN_KEYS` is the full set to filter from.
-     */
-    columns: readonly CardColumnKey[];
-    isLoading?: boolean;
-    isError?: boolean;
-    /** Renders the "Show my cards" toggle. A boolean — never a role or a scope. */
-    canToggleShowMyCards?: boolean;
-    isShowingMyCards?: boolean;
-    onShowMyCardsChange?: (isShowingMyCards: boolean) => void;
-    /** Renders "Create card", in the header and as the empty-state action. */
-    canCreateCard?: boolean;
-    onCreateCardClick?: () => void;
-    /** Renders a retry action on the error state. */
-    onRetry?: () => void;
-    isPaginationVisible?: boolean;
-    pageSize?: number;
-    pageSizeOptions?: number[];
-    /** Pre-formatted range, e.g. "Viewing 1-10". The owner computes it. */
-    rangeLabel?: string;
-    isPreviousPageDisabled?: boolean;
-    isNextPageDisabled?: boolean;
-    onPageSizeChange?: (pageSize: number) => void;
-    onPreviousPageClick?: () => void;
-    onNextPageClick?: () => void;
-    /** Merged over `CARDS_LIST_LABELS_EN`; nested groups merge per group. */
-    labels?: PartialDeep<CardsListLabels>;
-}
-
-type PendingFeatureStyleSources = GapCoverageAlertProps | NoPolicyBannerProps | CardDetailsPanelProps | CardsListProps;
+type PendingFeatureStyleSources = GapCoverageAlertProps | NoPolicyBannerProps;
 
-export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, AcceptDisclosuresWidget, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CounterpartsWidget, ExpenseApprovalPoliciesWidget, ExpenseManagementWidget, ExpenseRequirementsWidget, GLCodeTableWidget, GL_CODE_TABLE_LABELS_EN, GlCodeTable, HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, ProfileWidget, RESULT_LABELS_EN, ReceiptMatchWidget, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TagsWidget, TeamWidget, TransfersWidget, UIFramework, UploadReceiptWidget, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, registerDesignSystemEnsurer, registerUIRenderers, setGlobalWidgetConfig, updateGlobalWidgetConfig, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
-export type { AcceptDisclosuresLinks, AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, Labels$5 as AccountDetailsWidgetLabels, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, GLCodeTableWidgetProps, GlCode, GlCodeTableLabels, GlCodeTableProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, FeatureLabels$2 as SettingsWidgetFeatureLabels, Labels$1 as SettingsWidgetLabels, SettingsWidgetProps, SingleInsightLabels, TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps, FeatureLabels$1 as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };
+export { ACCEPT_DISCLOSURES_WIDGET_LABELS_EN, ADDITIONAL_OWNERS_LABELS_EN, AcceptDisclosuresWidget, BALANCES_WIDGET_LABELS_EN, BUSINESS_DETAILS_LABELS_EN, BalancesWidget, BankAccountOnboardingWidget, BankAccountsWidget, BillPayWidget, CardDetailsWidget, CardsWidget, CounterpartsWidget, ExpenseApprovalPoliciesWidget, ExpenseManagementWidget, ExpenseRequirementsWidget, GLCodeTableWidget, GL_CODE_TABLE_LABELS_EN, GlCodeTable, HELP_FAQ_EN, HELP_WIDGET_LABELS_EN, HelpWidget, INSIGHTS_FEATURE_LABELS_EN, INSIGHTS_WIDGET_LABELS_EN, Implementation, InsightsWidget, ReceivablesWidgetMonite as InvoicingWidget, LinkedAccountsWidget, PERSONAL_DETAILS_LABELS_EN, ProductsWidget, ProfileWidget, RESULT_LABELS_EN, ReceiptMatchWidget, ReceivablesWidget, RefreshingRootWidgetProvider, RootWidgetProvider, SINGLE_INSIGHT_LABELS_EN, SettingsWidget, DEFAULT_FEATURE_LABELS as TRANSFERS_FEATURE_LABELS_EN, TRANSFERS_WIDGET_LABELS_EN, TagsWidget, TeamWidget, TransfersWidget, UIFramework, UploadReceiptWidget, WidgetProvider, WidgetTokenRefreshProvider, cloneEmbeddedClient, getGlobalWidgetConfig, registerDesignSystemEnsurer, registerUIRenderers, setGlobalWidgetConfig, updateGlobalWidgetConfig, useOwnWidgetConfig, useRefetchWidget, useWidgetConfig, useWidgetError, useWidgetLoading, useWidgetToken };
+export type { AcceptDisclosuresLinks, AcceptDisclosuresWidgetLabels, AcceptDisclosuresWidgetProps, Labels$5 as AccountDetailsWidgetLabels, AdditionalOwner, AdditionalOwnersLabels, AddressFormSheetLabels, BalancesWidgetLabels, BalancesWidgetProps, BankAccountFormSheetLabels, BankAccountOnboardingWidgetLabels, BankAccountOnboardingWidgetProps, FeatureLabels$5 as BankAccountsWidgetFeatureLabels, Labels$6 as BankAccountsWidgetLabels, BankAccountsWidgetProps, BillPayWidgetProps, BusinessDetailsLabels, BusinessDetailsValues, CardDetailsFeatureLabels, CardDetailsPanelLabels as CardDetailsWidgetLabels, CardDetailsWidgetProps, CardsFeatureLabels as CardsWidgetFeatureLabels, CardsListLabels as CardsWidgetLabels, CardsWidgetPagination, CardsWidgetProps, CompanyStructureValue, ConfirmDeleteDialogLabels, CounterpartDetailsSheetLabels, CounterpartFormSheetLabels, CounterpartMessageLabels, CounterpartMode, CounterpartsScreenLabels, CounterpartsWidgetProps, DisclosureLinks, EmbeddedClient, ExpenseApprovalPoliciesWidgetProps, Labels$4 as ExpenseManagementWidgetLabels, ExpenseManagementWidgetProps, ExpenseRequirementsWidgetProps, GLCodeTableWidgetProps, GlCode, GlCodeTableLabels, GlCodeTableProps, HelpFaqAnswer, HelpFaqBullet, HelpFaqBulletType, HelpFaqItem, HelpFaqSection, HelpWidgetLabels, HelpWidgetProps, InsightsFeatureLabels, InsightsWidgetLabels, InsightsWidgetProps, ReceivablesWidgetMoniteProps as InvoicingWidgetProps, LinkComponent, LinkComponentProps, FeatureLabels$4 as LinkedAccountsWidgetFeatureLabels, Labels$3 as LinkedAccountsWidgetLabels, LinkedAccountsWidgetProps, MarketingWidgetContent, MeasureUnitDeleteDialogLabels, MeasureUnitsManagerLabels, PendingFeatureStyleSources, PersonalDetailsLabels, PersonalDetailsValues, ProductDeleteDialogLabels, ProductDetailsSheetLabels, ProductFormSheetLabels, ProductMessageLabels, ProductsScreenLabels, ProductsWidgetProps, FeatureLabels$3 as ProfileWidgetFeatureLabels, Labels$2 as ProfileWidgetLabels, ProfileWidgetProps, ReceiptMatchWidgetProps, ReceivableActionDialogLabels, ReceivableDetailsSheetLabelOverrides, ReceivableDetailsSheetLabels, ReceivableDocumentType, ReceivableFormSheetLabels, ReceivableMessageLabels, ReceivablePaymentDialogLabels, ReceivableSendDialogLabels, ReceivableStatusBadgeLabels, ReceivablesScreenLabelOverrides, ReceivablesScreenLabels, ReceivablesWidgetProps, ReceivablesWidgetTab, RefreshingRootWidgetProviderProps, ResultLabels, RootWidgetProviderProps, FeatureLabels$2 as SettingsWidgetFeatureLabels, Labels$1 as SettingsWidgetLabels, SettingsWidgetProps, SingleInsightLabels, TagDeleteDialogLabels, TagFormSheetLabels, TagMessageLabels, TagsScreenLabels, TagsWidgetProps, FeatureLabels$1 as TeamWidgetFeatureLabels, Labels as TeamWidgetLabels, TeamWidgetProps, FeatureLabels as TransfersWidgetFeatureLabels, TransfersWidgetLabels, TransfersWidgetProps, UploadReceiptWidgetProps, WidgetConfig, WidgetConfigInput, WidgetInitResponse, WidgetProviderProps, WidgetTokenFetcher, WidgetTokenManager, WidgetTokenRefreshProviderProps, WidgetTokenState };