@gearbox-protocol/ui-kit 4.0.0-next.2 → 4.0.0-next.21

package/dist/types/components/base/time-to-liquidation-block/time-to-liquidation-block.d.ts

@@ -5,12 +5,12 @@ import { TimeToLiquidationBlockTest } from './constants';
 export { TimeToLiquidationBlockTest };
 export interface TimeToLiquidationBlockProps {
     /**
-     * Time to liquidation in seconds; `null` renders "N/A", omit to render "—"
-     * (value not available).
+     * SDK `timeToLiquidation` in milliseconds; `null` renders "N/A", omit to
+     * render "—" (value not available).
      */
-    readonly seconds?: number | null;
+    readonly data?: bigint | null;
     /** Time after the operation; renders a from → to transition. */
-    readonly secondsTo?: number | null;
+    readonly dataTo?: bigint | null;
     /** Pre-computed zone; if not set, derived from the value. */
     readonly zone?: TTLZones;
     readonly isLoading?: boolean;
@@ -23,6 +23,5 @@ export interface TimeToLiquidationBlockProps {
 /**
  * "Time to liquidation" row of a preview: label + help tip, the remaining
  * time as `Nmo` / `Nd` / `<1d` with a zone dot, optionally from → to.
- * Design only — the reference `TimeToLiquidationBlock` markup on value props.
  */
-export declare function TimeToLiquidationBlock({ seconds, secondsTo, zone, isLoading, title, tip, testId, }: TimeToLiquidationBlockProps): React.ReactElement;
+export declare function TimeToLiquidationBlock({ data, dataTo, zone, isLoading, title, tip, testId, }: TimeToLiquidationBlockProps): React.ReactElement;

package/dist/types/components/base/title-meta/constants.d.ts

@@ -2,4 +2,5 @@ export declare class TitleMetaTest {
     static root: string;
     static network: string;
     static curator: string;
+    static link: string;
 }

package/dist/types/components/base/title-meta/title-meta.d.ts

@@ -1,15 +1,23 @@
+import { Token } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
 import { NetworkIcons } from '../../../utils/network-icons';
 import { TitleMetaTest } from './constants';
 export { TitleMetaTest };
+export interface TitleMetaLink {
+    readonly href: string;
+    readonly token?: Token;
+    readonly label?: string;
+    readonly onClick?: () => void;
+}
 export interface TitleMetaProps {
     readonly network: NetworkIcons;
     readonly curatorName: string | undefined;
     readonly curatorLink: string | undefined;
     readonly onCuratorLinkClick?: () => void;
+    readonly links?: ReadonlyArray<TitleMetaLink>;
     readonly testId?: string;
     readonly networkTestId?: string;
     readonly curatorTestId?: string;
 }
 /** Network + curator row under a detail-page title. */
-export declare function TitleMeta({ network, curatorName, curatorLink, onCuratorLinkClick, testId, networkTestId, curatorTestId, }: TitleMetaProps): React.ReactElement;
+export declare function TitleMeta({ network, curatorName, curatorLink, onCuratorLinkClick, links, testId, networkTestId, curatorTestId, }: TitleMetaProps): React.ReactElement;

package/dist/types/components/base/token-amount/token-amount.d.ts

@@ -1,7 +1,9 @@
 import { Amount, Token, TokenAmount as TokenAmountModel } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
+import { StackAlign } from '../stack';
 import { TokenAmountTest } from './constants';
 export { TokenAmountTest };
+export type TokenAmountAlign = Extract<StackAlign, "start" | "end">;
 /**
  * An amount of a token, with its USD value underneath.
  *
@@ -10,7 +12,7 @@ export { TokenAmountTest };
  * `totalSupply` / `totalBorrow`, implicitly in the market underlying) name their
  * token alongside.
  */
-export type TokenAmountProps = {
+type TokenAmountDataProps = {
     /** `null` means unavailable and renders an em-dash. */
     readonly data: TokenAmountModel | null;
     readonly token?: undefined;
@@ -18,4 +20,8 @@ export type TokenAmountProps = {
     readonly data: Amount | null;
     readonly token: Token;
 };
-export declare function TokenAmount({ data, token, }: TokenAmountProps): React.ReactElement;
+export type TokenAmountProps = TokenAmountDataProps & {
+    /** Cross-axis alignment of the token line and the USD caption. */
+    readonly align?: TokenAmountAlign;
+};
+export declare function TokenAmount({ data, token, align, }: TokenAmountProps): React.ReactElement;

package/dist/types/components/base/values/constants.d.ts

@@ -6,6 +6,7 @@ export declare class ValueTest {
     static healthFactor: string;
     static pnl: string;
     static tokenBigint: string;
+    static points: string;
     static placeholder: string;
 }
 export declare class PositionShortLabelTest {

package/dist/types/components/base/values/index.d.ts

@@ -1,5 +1,7 @@
 export { ValueTest } from './constants';
 export { PnlValue } from './pnl-value';
+export { PointsValue, type PointsValueProps } from './points-value';
 export { PositionShortLabel, PositionShortLabelTest, } from './position-short-label';
+export { type PositionStatus, PositionStatusBadge, type PositionStatusBadgeProps, } from './position-status-badge';
 export { PositionTypeBadge, type PositionTypeBadgeProps, } from './position-type-badge';
-export { ApyValue, type ApyValueProps, HealthFactorValue, LeverageValue, TokenBigint, UsdValue, UtilizationValue, } from './scalars';
+export { ApyValue, type ApyValueProps, bps, HealthFactorValue, LeverageValue, TokenBigint, UsdValue, UtilizationValue, } from './scalars';

package/dist/types/components/base/values/points-value.d.ts

@@ -0,0 +1,11 @@
+import { ApyBreakdown } from '@gearbox-protocol/sdk/model';
+import { default as React } from 'react';
+export interface PointsValueProps {
+    /** SDK APY breakdown; `undefined` or no point programs render nothing. */
+    readonly data: ApyBreakdown | undefined;
+}
+/**
+ * Point programs attached to an APY breakdown: icon + name for each program.
+ * Returns `null` when the SDK has none.
+ */
+export declare function PointsValue({ data, }: PointsValueProps): React.ReactElement | null;

package/dist/types/components/base/values/position-short-label.d.ts

@@ -2,7 +2,7 @@ import { StrategyPosition } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
 import { PositionShortLabelTest } from './constants';
 export { PositionShortLabelTest };
-/** "wstETH / WETH · 2.5x" — one open position, in a menu row. */
+/** "wstETH / WETH · 2.50x" — one open position, in a menu row. */
 export declare function PositionShortLabel({ data, }: {
     readonly data: StrategyPosition;
 }): React.ReactElement;

package/dist/types/components/base/values/position-status-badge.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export type PositionStatus = "active" | "repaid";
+export interface PositionStatusBadgeProps {
+    readonly data: PositionStatus;
+}
+/** Lifecycle chip of a strategy position: Active or Repaid. */
+export declare function PositionStatusBadge({ data, }: PositionStatusBadgeProps): React.ReactElement;

package/dist/types/components/base/values/position-type-badge.d.ts

@@ -6,6 +6,6 @@ export interface PositionTypeBadgeProps {
     readonly size?: "table" | "aside" | "title";
 }
 /**
- * Colored kind label of a position row: "Lender" / "Strategy" / "Liquidation".
+ * Colored kind label of a position row: "LP" / "Strategy" / "Liquidation".
  */
 export declare function PositionTypeBadge({ data, size, }: PositionTypeBadgeProps): React.ReactElement;

package/dist/types/components/base/values/scalars.d.ts

@@ -1,15 +1,34 @@
 import { ApyBreakdown, Bps, Leverage, Token } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
+/**
+ * Basis points as a percentage (`10000` = 100%); the model's `Bps` is `number`.
+ *
+ * Self-contained on purpose: `percentageTemplate` (format-money) carries a
+ * same-named, oppositely-scaled twin in `templates.tsx` (already-percent
+ * input), so a shared bps→percent step here would inherit that ambiguity.
+ * `bps` is the one place that owns the conversion.
+ */
+export declare function bps(value: Bps): string;
 export interface ApyValueProps {
     /** A breakdown (tooltip-able) or a bare rate; `undefined` renders a dash. */
     readonly data: ApyBreakdown | Bps | undefined;
+    /**
+     * Whether a breakdown carries its yield tooltip on hover. Off where the
+     * figure is already explained — a badge that states one rate, or a figure
+     * wrapped in a tooltip of its own, which would otherwise stack two.
+     *
+     * A bare `Bps` has no tooltip to begin with, so this does not reach it.
+     *
+     * @default true
+     */
+    readonly tooltip?: boolean;
 }
 /**
  * Any APY the model carries, in one place: `supplyApy`, `netApy`, `borrowApy`.
  * A breakdown renders the reference chip (reward icons + breakdown tooltip)
  * via `CompoundAPY`; a bare `Bps` stays a plain percentage.
  */
-export declare function ApyValue({ data }: ApyValueProps): React.ReactElement;
+export declare function ApyValue({ data, tooltip, }: ApyValueProps): React.ReactElement;
 export declare function UsdValue({ data, }: {
     readonly data: number | null | undefined;
 }): React.ReactElement;
@@ -27,8 +46,17 @@ export declare function HealthFactorValue({ data, }: {
  * A bare `bigint` in token units (simulate previews carry these): the only
  * value component that needs a denomination passed with it, because the SDK
  * hands these out without one.
+ *
+ * Shown to `formatAssetAmount`'s three decimals, with the exact amount in a
+ * tooltip — a metrics row reads better short, and nothing is lost: the figure
+ * behind the rounding stays a hover away.
  */
-export declare function TokenBigint({ data, token, }: {
+export declare function TokenBigint({ data, token, showSymbol, }: {
     readonly data: bigint | undefined;
     readonly token: Token | undefined;
+    /**
+     * Off where the row names the token itself — a `before → after` pair prints
+     * the symbol once for both amounts rather than twice.
+     */
+    readonly showSymbol?: boolean;
 }): React.ReactElement;

package/dist/types/components/base-table/base-table-line.d.ts

@@ -0,0 +1,21 @@
+import { default as React, ReactNode } from 'react';
+import { BaseTableColumn } from './types';
+export { BaseTableLineTest } from './constants';
+export interface BaseTableLineProps<TSort extends string = never> {
+    readonly columns: ReadonlyArray<BaseTableColumn<TSort>>;
+    readonly cells: Readonly<Record<string, ReactNode>>;
+    readonly last: boolean;
+    readonly href?: string;
+    readonly disabled?: boolean;
+    readonly disabledStyle?: boolean;
+    /** Extra row className, e.g. RWA accent tint. */
+    readonly accentClassName?: string;
+    readonly onRowClick?: () => void;
+    readonly "data-testid"?: string;
+    readonly minHeightClassName?: string;
+}
+/**
+ * One row of {@link BaseTable}: desktop cells from the column model, or a
+ * stacked mobile card driven by each column's `mobile` role.
+ */
+export declare function BaseTableLine<TSort extends string = never>({ columns, cells, last, href, disabled, disabledStyle, accentClassName, onRowClick, "data-testid": testId, minHeightClassName, }: BaseTableLineProps<TSort>): React.ReactElement;

package/dist/types/components/base-table/base-table.d.ts

@@ -0,0 +1,19 @@
+import { default as React, PropsWithChildren, ReactNode } from 'react';
+import { BaseTableColumn, BaseTableSortApi } from './types';
+export { BaseTableTest } from './constants';
+export type { BaseTableColumn, BaseTableSortApi } from './types';
+export interface BaseTableProps<TSort extends string = never> {
+    readonly columns: ReadonlyArray<BaseTableColumn<TSort>>;
+    readonly isLoading: boolean;
+    readonly emptyMessage: ReactNode;
+    readonly sort?: BaseTableSortApi<TSort>;
+    readonly rowHeight?: string;
+    readonly loaderRows?: number;
+    readonly className?: string;
+    readonly wrapperClassName?: string;
+}
+/**
+ * Declarative data table over {@link GridTable}: column model, sort headers,
+ * loading skeleton and empty state. Mobile collapses to a single track.
+ */
+export declare function BaseTable<TSort extends string = never>({ columns, isLoading, emptyMessage, sort, rowHeight, loaderRows, className, wrapperClassName, children, }: PropsWithChildren<BaseTableProps<TSort>>): React.ReactElement;

package/dist/types/components/base-table/constants.d.ts

@@ -0,0 +1,8 @@
+export declare class BaseTableTest {
+    static root: string;
+    static head: string;
+    static empty: string;
+}
+export declare class BaseTableLineTest {
+    static root: string;
+}

package/dist/types/components/base-table/index.d.ts

@@ -0,0 +1,3 @@
+export * from './base-table';
+export * from './base-table-line';
+export type * from './types';

package/dist/types/components/base-table/types.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+type BaseTableColumnJustify = "start" | "end";
+/**
+ * Mobile placement for a column inside {@link BaseTableLine}:
+ * - `title` — primary identity block (name / tokens)
+ * - `badge` — compact chip next to the title (also unclipped on desktop)
+ * - `stat` — labeled metric in the stats grid
+ * - `block` — full-width labeled block under the stats
+ * - `hidden` — desktop-only
+ */
+type BaseTableColumnMobile = "title" | "badge" | "stat" | "block" | "hidden";
+interface BaseTableColumnSort<TSort extends string = never> {
+    readonly field: TSort;
+    readonly defaultDirection: "asc" | "desc";
+    /** Plain string for HeadCell `sortField` (a11y / tooltip). */
+    readonly label: string;
+}
+/**
+ * Column model shared by {@link BaseTable} (tracks + header) and
+ * {@link BaseTableLine} (desktop cells + mobile labels).
+ */
+export interface BaseTableColumn<TSort extends string = never> {
+    readonly id: string;
+    readonly title: ReactNode;
+    /** CSS grid track, e.g. `"minmax(320px,3fr)"`. */
+    readonly track: string;
+    readonly justify?: BaseTableColumnJustify;
+    readonly sort?: BaseTableColumnSort<TSort>;
+    readonly headClassName?: string;
+    readonly cellClassName?: string;
+    readonly mobile?: BaseTableColumnMobile;
+}
+export interface BaseTableSortApi<TSort extends string> {
+    readonly getSortDirection: (field: TSort) => "asc" | "desc" | undefined;
+    readonly onSort: (field: TSort, defaultDirection: "asc" | "desc") => void;
+}
+export {};

package/dist/types/components/collateral-allocation-tooltip/allocation-wheel.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+export interface AllocationWheelProps {
+    /** Slice share in 0..1 of the total allocation. */
+    readonly share: number;
+    /** Palette index for token slices; ignored when {@link idle}. */
+    readonly colorIndex: number;
+    readonly idle?: boolean;
+}
+/** 20px donut showing one slice's share of the total. */
+export declare function AllocationWheel({ share, colorIndex, idle, }: AllocationWheelProps): React.ReactElement;

package/dist/types/components/collateral-allocation-tooltip/collateral-allocation-tooltip.d.ts

@@ -0,0 +1,23 @@
+import { Amount, Token } from '@gearbox-protocol/sdk/model';
+import { default as React } from 'react';
+export type CollateralAllocationSlice = {
+    kind: "token";
+    token: Token;
+    amount: Amount;
+} | {
+    kind: "idle";
+    amount: Amount;
+};
+export interface CollateralAllocation {
+    slices: ReadonlyArray<CollateralAllocationSlice>;
+}
+export interface CollateralAllocationTooltipProps {
+    readonly data: CollateralAllocation;
+    readonly children?: React.ReactNode;
+    readonly className?: string;
+}
+/**
+ * Pool collateral mix for Earn table hover — token rows plus an Idle remainder.
+ * Slice shares are derived from `amount.valueUsd`.
+ */
+export declare function CollateralAllocationTooltip({ data, children, className, }: CollateralAllocationTooltipProps): React.ReactElement;

package/dist/types/components/collateral-allocation-tooltip/constants.d.ts

@@ -0,0 +1,8 @@
+export declare class CollateralAllocationTooltipTest {
+    static root: string;
+    static row: string;
+    static wheel: string;
+}
+export declare class AllocationWheelTest {
+    static root: string;
+}

package/dist/types/components/collateral-allocation-tooltip/index.d.ts

@@ -0,0 +1,3 @@
+export * from './allocation-wheel';
+export * from './collateral-allocation-tooltip';
+export * from './constants';

package/dist/types/components/composites/pool-assets-table/constants.d.ts

@@ -0,0 +1,6 @@
+export declare class PoolAssetsTableTest {
+    static root: string;
+    static exposureCell: string;
+    static capCell: string;
+    static capUtilizationCell: string;
+}

package/dist/types/components/composites/pool-assets-table/index.d.ts

@@ -1,3 +1,4 @@
+export * from './constants';
 export * from './pool-assets-table';
 export * from './pool-assets-table-head';
 export * from './pool-assets-table-row';

package/dist/types/components/composites/pool-assets-table/pool-assets-table-head.d.ts

@@ -1,10 +1,9 @@
 import { default as React } from 'react';
 import { PoolAssetsTableSort } from './types';
-/** Props for {@link PoolAssetsTableHead}. */
 export interface PoolAssetsTableHeadProps {
     readonly sort: PoolAssetsTableSort;
 }
 /**
- * Header row: sortable Asset, Rate, and Limits columns (`components.poolAssetsTable.*` locale keys).
+ * Header row: sortable Name / Exposure / Cap / Cap utilization.
  */
 export declare function PoolAssetsTableHead({ sort, }: PoolAssetsTableHeadProps): React.ReactElement;

package/dist/types/components/composites/pool-assets-table/pool-assets-table-row.d.ts

@@ -1,15 +1,15 @@
-import { TokenData } from '@gearbox-protocol/sdk/common-utils';
+import { QuotaAsset, Token } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
-import { PoolAssetsTableQuotaRow } from './types';
-/** Props for {@link PoolAssetsTableRow}. */
 export interface PoolAssetsTableRowProps {
     readonly poolName: string;
-    readonly token: TokenData | undefined;
-    readonly currentQuota: PoolAssetsTableQuotaRow;
-    readonly underlyingToken: TokenData;
+    readonly asset: QuotaAsset;
+    readonly underlyingToken: Token;
     readonly last: boolean;
+    readonly isCompact: boolean;
+    readonly totalUsed: bigint;
+    readonly colorIndex: number;
 }
 /**
- * Single data row: token + pool name, `percentageTemplate` rate, and formatted usage vs limit.
+ * Single data row: token name, exposure (amount + pie), cap, and cap utilization.
  */
-export declare function PoolAssetsTableRow({ poolName, token, currentQuota, underlyingToken, last, }: PoolAssetsTableRowProps): React.ReactElement;
+export declare function PoolAssetsTableRow({ poolName, asset, underlyingToken, last, isCompact, totalUsed, colorIndex, }: PoolAssetsTableRowProps): React.ReactElement;

package/dist/types/components/composites/pool-assets-table/pool-assets-table.d.ts

@@ -1,27 +1,14 @@
-import { TokenData } from '@gearbox-protocol/sdk/common-utils';
+import { QuotaAsset, Token } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
-import { Address } from 'viem';
-import { PoolAssetsTableQuotaRow, PoolAssetsTableSort } from './types';
-/**
- * Props for {@link PoolAssetsTable}.
- */
+import { PoolAssetsTableSort } from './types';
 export interface PoolAssetsTableProps {
-    /** Quota rows to render (one per asset). */
-    readonly list: ReadonlyArray<PoolAssetsTableQuotaRow>;
-    /** Pool name shown under the asset title. */
+    readonly list: ReadonlyArray<QuotaAsset>;
     readonly poolName: string;
     readonly sort: PoolAssetsTableSort;
-    /** Token metadata keyed by token address (must include every `quota.token`). */
-    readonly tokensList: Partial<Record<Address, TokenData>>;
-    /** Underlying asset used for `TokenTemplate` amounts in the usage column. */
-    readonly underlyingToken: TokenData;
+    readonly underlyingToken: Token;
 }
 /**
- * Legacy GridTable of pool asset quotas (`TokenData` field props).
- * Canonical consumer table is client-v3 `PoolsAssetsTable` (`data: PoolOpportunityDetail`).
- * Do not add a third table in this pass — next-stage `table/` absorbs this.
- *
- * On viewports below the mobile breakpoint the header is hidden and each row
- * uses the compact `TableLineSm` layout.
+ * Grid table of pool asset quotas: exposure, cap, and cap utilization.
+ * Collapses into stacked cards below {@link COMPACT_WIDTH_THRESHOLD}.
  */
-export declare function PoolAssetsTable({ list, poolName, sort, tokensList, underlyingToken, }: PoolAssetsTableProps): React.ReactElement | null;
+export declare function PoolAssetsTable({ list, poolName, sort, underlyingToken, }: PoolAssetsTableProps): React.ReactElement | null;

package/dist/types/components/composites/pool-assets-table/types.d.ts

@@ -1,7 +1,7 @@
-import { Address } from 'viem';
+import { QuotaAsset } from '@gearbox-protocol/sdk/model';
 import { SortField, SortSetterFunction } from '../../../hooks';
 /** Column identifiers used by the pool assets table header sort controls. */
-export type PoolAssetsSortFields = "name" | "rate" | "usage";
+export type PoolAssetsSortFields = "name" | "exposure" | "cap" | "capUtilization";
 /**
  * Sort state + setter wired to `HeadCell` / `useSort` (same pattern as `PoolTable`).
  */
@@ -13,13 +13,5 @@ export interface PoolAssetsTableSort {
 export interface PoolAssetsFilterState {
     readonly sort: PoolAssetsTableSort;
 }
-/**
- * One asset line: quota limit, usage, and borrow rate.
- * Shape aligns with Gearbox SDK quota / QuotaInfo-style data.
- */
-export interface PoolAssetsTableQuotaRow {
-    readonly token: Address;
-    readonly limit: bigint;
-    readonly totalQuoted: bigint;
-    readonly rate: bigint;
-}
+/** One quota row — the SDK's {@link QuotaAsset}. */
+export type PoolAssetsTableQuotaRow = QuotaAsset;

package/dist/types/components/composites/tx-preview/confirm/amounts/TransactionConfirmAmountField.d.ts

@@ -1,3 +1,4 @@
+import { TokenAmount } from '@gearbox-protocol/sdk/model';
 import { VariantProps } from 'class-variance-authority';
 import { default as React } from 'react';
 import { TokenTemplateProps } from '../../../../token-template';
@@ -5,25 +6,57 @@ declare const rootVariants: (props?: ({
     position?: "first" | "last" | "inBetween" | "solo" | null | undefined;
     size?: "sm" | "md" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
-export interface TransactionConfirmAmountFieldProps extends VariantProps<typeof rootVariants> {
+type PrimarySlot = {
+    readonly value: TokenTemplateProps["value"];
+    readonly token?: TokenTemplateProps["token"];
+} | {
+    node: React.ReactNode;
+};
+type SecondarySlot = {
+    readonly valueUSD?: bigint | number;
+} | {
+    node: React.ReactNode;
+};
+/**
+ * Either hand over the SDK's {@link TokenAmount} whole, or fill the two slots
+ * yourself. The slot form stays for the `node` escape hatch and for callers
+ * that have no `TokenAmount` to give.
+ */
+type AmountSource = {
+    /**
+     * Value, token and the USD caption all read off one SDK amount.
+     * `null` means unavailable and renders like any other absent value.
+     */
+    readonly amount: TokenAmount | null;
+    readonly primaryAmount?: undefined;
+    readonly secondaryAmount?: undefined;
+} | {
+    readonly amount?: undefined;
+    readonly primaryAmount: PrimarySlot;
+    readonly secondaryAmount?: SecondarySlot;
+};
+export type TransactionConfirmAmountFieldProps = VariantProps<typeof rootVariants> & AmountSource & {
     readonly label: React.ReactNode;
-    readonly primaryAmount: {
-        readonly value: TokenTemplateProps["value"];
-        readonly token?: TokenTemplateProps["token"];
-    } | {
-        node: React.ReactNode;
-    };
-    readonly secondaryAmount?: {
-        readonly valueUSD?: bigint | number;
-    } | {
-        node: React.ReactNode;
-    };
     readonly loading?: boolean;
     readonly maxLength?: number;
     readonly approximate?: {
         isApproximate?: boolean;
         approximateSymbol?: string;
     };
-}
-export declare function TransactionConfirmAmountField({ label, primaryAmount, secondaryAmount, loading, position, size, maxLength, approximate, }: TransactionConfirmAmountFieldProps): React.ReactElement;
+};
+/**
+ * One SDK amount already carries all three things the field shows: the number,
+ * its token and the dollar value. Callers used to take it apart and hand the
+ * pieces back through two props; passing `amount` lets them stop.
+ *
+ * Takes the whole prop union so the slot form is picked by the discriminant
+ * rather than by a cast — `amount` is `TokenAmount | null`, never `undefined`,
+ * so a caller holding `TokenAmount | undefined` has to say `?? null` and
+ * cannot land here with nothing at all.
+ */
+export declare function resolveAmountSlots(source: AmountSource): {
+    readonly primaryAmount: PrimarySlot;
+    readonly secondaryAmount: SecondarySlot | undefined;
+};
+export declare function TransactionConfirmAmountField(props: TransactionConfirmAmountFieldProps): React.ReactElement;
 export {};

package/dist/types/components/composites/tx-preview/confirm/amounts/index.d.ts

@@ -1,2 +1,2 @@
 export * from './constants';
-export * from './TransactionConfirmAmountField';
+export { TransactionConfirmAmountField, type TransactionConfirmAmountFieldProps, } from './TransactionConfirmAmountField';

package/dist/types/components/composites/tx-preview/confirm/dialog/TransactionConfirmShell.d.ts

@@ -1,23 +1,27 @@
 import { default as React } from 'react';
-import { TransactionExecutionStepView } from '../stepper/transactionExecutionStepTypes';
-import { TransactionConfirmPhase } from './transactionConfirmPhase';
-export interface TransactionConfirmShellProps {
-    readonly phase?: TransactionConfirmPhase;
-    readonly header?: React.ReactNode;
-    readonly preview: React.ReactNode;
-    readonly previewLoading?: boolean;
-    readonly previewError?: Error | null;
-    readonly previewErrorTitle?: string;
-    readonly previewClassName?: string;
-    readonly execution: React.ReactNode;
-    readonly progressSteps?: ReadonlyArray<TransactionExecutionStepView>;
-    readonly renderProgressStepLabel?: (step: TransactionExecutionStepView) => React.ReactNode;
-    readonly result?: React.ReactNode;
-    readonly className?: string;
-    readonly "data-testid"?: string;
-}
+import { TransactionConfirmShellProps } from './transactionConfirmShellTypes';
 /**
+ * The one card every transaction confirmation renders, on every surface.
  *
- * Base shell component
+ * Callers describe *what the card shows* (`body`) and *how it is framed*
+ * (`mode`); everything else is decided here. This replaces the former
+ * `TransactionConfirmPageView` / `TransactionConfirmModalView` pair, which
+ * differed only in the frame yet each restated the whole prop list.
+ *
+ * Two traps from that pair are closed here rather than left to callers.
+ *
+ * The modal's height clamp is composed with `className` instead of being
+ * replaced by it, so a caller adding a class no longer drops the viewport
+ * clamp and the flex context the scrollable preview depends on by accident.
+ * `cn` is tailwind-merge, so a utility deliberately targeting the same
+ * property still wins — though arbitrary-property syntax such as
+ * `[max-height:50vh]` sits in a different group and will not displace it.
+ *
+ * And a `placeholder` or `error` body pins the phase to `confirm`, so those
+ * two can never be asked for a result view they were never given. Note the
+ * limit of that guarantee: a `ready` body driven to a terminal phase without a
+ * `result` still draws a header and nothing else, exactly as the views it
+ * replaces did. Requiring both halves of `result` is what keeps the promise
+ * whole once a caller opts into one.
  */
-export declare function TransactionConfirmShell({ phase, header, preview, previewLoading, previewError, previewErrorTitle, previewClassName, execution, progressSteps, renderProgressStepLabel, result, className, "data-testid": dataTestId, }: TransactionConfirmShellProps): React.ReactElement;
+export declare function TransactionConfirmShell(props: TransactionConfirmShellProps): React.ReactElement | null;

package/dist/types/components/composites/tx-preview/confirm/dialog/index.d.ts

@@ -1,5 +1,5 @@
 export * from './computeTransactionConfirmDialogLayout';
 export * from './constants';
-export * from './TransactionConfirmModalView';
-export * from './TransactionConfirmPageView';
+export * from './TransactionConfirmShell';
 export * from './transactionConfirmPhase';
+export * from './transactionConfirmShellTypes';

package/dist/types/components/composites/tx-preview/confirm/dialog/transactionConfirmPhase.d.ts

@@ -1,4 +1 @@
 export type TransactionConfirmPhase = "confirm" | "awaiting_receipt" | "success" | "failure";
-export interface TransactionConfirmSubmittedTx {
-    readonly hash: `0x${string}`;
-}