@gearbox-protocol/ui-kit 4.0.0-next.4 → 4.0.0-next.41

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

@@ -2,5 +2,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 { PriceImpactValue, priceImpact } from './price-impact-value';
 export { ApyValue, type ApyValueProps, bps, HealthFactorValue, LeverageValue, TokenBigint, UsdValue, UtilizationValue, } from './scalars';

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

@@ -1,6 +1,12 @@
 import { PnlBreakdown } from '@gearbox-protocol/sdk/model';
 import { default as React } from 'react';
-/** Realised + unrealised PnL of a position, signed. */
+/**
+ * Realised + unrealised PnL, signed.
+ *
+ * A breakdown (a position's own) or a bare USD figure (a wallet's total, which
+ * the model carries as a plain number) — the same pairing {@link ApyValue}
+ * makes between a breakdown and a bare rate.
+ */
 export declare function PnlValue({ data, }: {
-    readonly data: PnlBreakdown | undefined;
+    readonly data: PnlBreakdown | number | null | undefined;
 }): 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/price-impact-value.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+/**
+ * A price impact as a percentage.
+ *
+ * The scale is `PERCENTAGE_FACTOR_1KK` — `1_000_000` is 100%, so `-10_000` is
+ * -1% — the legacy price-impact scale, a hundred times finer than the `Bps`
+ * the rest of this module speaks. The conversion is owned here for the same
+ * reason `bps` owns its own: `percentageTemplate` carries a same-named,
+ * differently-scaled twin, so a shared step would inherit that ambiguity.
+ *
+ * A loss is what this figure almost always is, and it prints its own minus.
+ * Only the rare route that beat the marginal price needs its sign spelled out,
+ * or a gain would read as a loss of the same size.
+ */
+export declare function priceImpact(value: bigint): string;
+/**
+ * What a routed operation gave up to market depth.
+ *
+ * Which of the three rates a caller shows — against the routed output, the
+ * equity or the position — is the caller's choice; this renders the one it is
+ * handed.
+ */
+export declare function PriceImpactValue({ data, }: {
+    readonly data: bigint | undefined;
+}): React.ReactElement;

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

@@ -12,13 +12,25 @@ 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;
+    /** When `"7d"`, the breakdown tooltip labels carry the averaging-window suffix. */
+    readonly period?: "7d";
 }
 /**
  * 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, period, }: ApyValueProps): React.ReactElement;
 export declare function UsdValue({ data, }: {
     readonly data: number | null | undefined;
 }): React.ReactElement;
@@ -36,8 +48,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/buttons/back-button/back-button.d.ts

@@ -16,5 +16,5 @@ export interface BackButtonProps extends VariantProps<typeof backButtonVariants>
     className?: string;
     LinkComponent?: React.ComponentType<LinkComponentProps>;
 }
-export declare function BackButton({ href, text, onClick, className, variant, size, LinkComponent, }: BackButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function BackButton({ href, text, onClick, className, variant, size, LinkComponent, }: BackButtonProps): import("react").JSX.Element;
 export { backButtonVariants };

package/dist/types/components/buttons/range-buttons/range-buttons.d.ts

@@ -46,4 +46,4 @@ export interface RangeButtonsProps<T> {
  * />
  * ```
  */
-export declare function RangeButtons<T>({ range, rangeList, setRange, className, }: RangeButtonsProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function RangeButtons<T>({ range, rangeList, setRange, className, }: RangeButtonsProps<T>): React.JSX.Element;

package/dist/types/components/cards/danger-zone/danger-zone.d.ts

@@ -16,4 +16,4 @@ import { CardProps } from '../card';
  * - for warnings or informational content (use regular Card with appropriate styling).
  * - when actions are not actually dangerous or destructive.
  */
-export declare function DangerZone({ children, ...props }: CardProps): import("react/jsx-runtime").JSX.Element;
+export declare function DangerZone({ children, ...props }: CardProps): import("react").JSX.Element;

package/dist/types/components/cards/expandable-call/expandable-call.d.ts

@@ -24,5 +24,5 @@ export interface ExpandablCallProps {
  * - for displaying transactions themselves (use ExpandableCard instead).
  * - outside of transaction context (use ExpandableCard or regular Card instead).
  */
-declare function ExpandablCall({ header, children, index, isExpandable, }: ExpandablCallProps): import("react/jsx-runtime").JSX.Element;
+declare function ExpandablCall({ header, children, index, isExpandable, }: ExpandablCallProps): React.JSX.Element;
 export { ExpandablCall };

package/dist/types/components/cards/expandable-card/expandable-card.d.ts

@@ -24,5 +24,5 @@ export interface ExpandableCardProps {
  * - when you need multiple independent expandable sections (consider using Tabs or separate ExpandableCards).
  * - for non-transaction content when a regular Card would suffice.
  */
-declare function ExpandableCard({ header, children, alwaysExpanded, }: ExpandableCardProps): import("react/jsx-runtime").JSX.Element;
+declare function ExpandableCard({ header, children, alwaysExpanded, }: ExpandableCardProps): React.JSX.Element;
 export { ExpandableCard };

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,16 @@
-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;
+    /** Base URL of the chain's explorer; absent leaves the row inert. */
+    readonly explorerUrl?: string;
 }
 /**
- * Single data row: token + pool name, `bps`-formatted 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({ asset, underlyingToken, last, isCompact, totalUsed, colorIndex, explorerUrl, }: PoolAssetsTableRowProps): React.ReactElement;

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

@@ -1,27 +1,18 @@
-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 poolName: string;
+    readonly list: ReadonlyArray<QuotaAsset>;
     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;
+    /**
+     * Block explorer base URL of the pool's chain. Given one, each row links to
+     * its token's address there; without one the rows stay inert.
+     */
+    readonly explorerUrl?: string;
 }
 /**
- * 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, sort, underlyingToken, explorerUrl, }: 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}`;
-}