@gearbox-protocol/ui-kit 3.14.0-next.9 → 4.0.0-next.10

package/dist/types/components/base/stat-badge/stat-badge.d.ts

@@ -0,0 +1,27 @@
+import { default as React, ReactNode } from 'react';
+import { TitleText } from '../text';
+import { StatBadgeTest } from './constants';
+export { StatBadgeTest };
+export type StatBadgeSize = "sm" | "md" | "default";
+export interface StatBadgeProps {
+    /** A messageId (formatted here) or a node. */
+    readonly title: TitleText;
+    readonly value: React.ReactNode;
+    /** Optional control in the top-right of the card, e.g. a Claim button. */
+    readonly action?: ReactNode;
+    readonly className?: string;
+    /** Swaps `value` for a skeleton; the badge owns that decision, not the caller. */
+    readonly isLoading?: boolean;
+    /** Overrides the badge's own test id, so a screen can name each of its badges. */
+    readonly testId?: string;
+    readonly size?: StatBadgeSize;
+}
+export declare function StatBadge({ title, value, isLoading, size, action, className, testId, }: StatBadgeProps): React.ReactElement;
+export interface StatBadgeGridProps {
+    readonly cols?: 1 | 2 | 3 | 4;
+    readonly colsLg?: 1 | 2 | 3 | 4;
+    readonly gap?: "sm" | "default" | "lg";
+    readonly children: ReactNode;
+    readonly className?: string;
+}
+export declare function StatBadgeGrid({ cols, colsLg, gap, children, className, }: StatBadgeGridProps): React.ReactElement;

package/dist/types/components/base/sticky-bar/constants.d.ts

@@ -0,0 +1,3 @@
+export declare class StickyBarTest {
+    static root: string;
+}

package/dist/types/components/base/sticky-bar/index.d.ts

@@ -0,0 +1 @@
+export * from './sticky-bar';

package/dist/types/components/base/sticky-bar/sticky-bar.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { StickyBarTest } from './constants';
+export { StickyBarTest };
+export interface StickyBarProps {
+    readonly children: React.ReactNode;
+    readonly className?: string;
+    readonly testId?: string;
+}
+export declare function StickyBar({ children, className, testId, }: StickyBarProps): React.ReactElement;

package/dist/types/components/base/strategy-apy-breakdown-card/constants.d.ts

@@ -0,0 +1,5 @@
+export declare class StrategyApyBreakdownCardTest {
+    static root: string;
+    static row: string;
+    static net: string;
+}

package/dist/types/components/base/strategy-apy-breakdown-card/index.d.ts

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './strategy-apy-breakdown-card';

package/dist/types/components/base/strategy-apy-breakdown-card/strategy-apy-breakdown-card.d.ts

@@ -0,0 +1,17 @@
+import { ApyBreakdown, Bps, Leverage } from '@gearbox-protocol/sdk/model';
+import { default as React } from 'react';
+import { StrategyApyBreakdownCardTest } from './constants';
+export { StrategyApyBreakdownCardTest };
+export interface StrategyApyBreakdownData {
+    readonly collateralApy?: ApyBreakdown;
+    readonly borrowApy?: Bps;
+    readonly additionalBorrowApy?: Bps;
+    readonly maxLeverage?: Leverage;
+}
+export interface StrategyApyBreakdownCardProps {
+    readonly data: StrategyApyBreakdownData;
+    /** Selected leverage from the chart toolbar chips. Falls back to max. */
+    readonly leverage?: Leverage;
+}
+/** Net APY formula beside the strategy yield chart. Chart itself is unchanged. */
+export declare function StrategyApyBreakdownCard({ data, leverage: leverageProp, }: StrategyApyBreakdownCardProps): React.ReactElement;

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

@@ -0,0 +1,5 @@
+export declare class TabberTest {
+    static root: string;
+    static bar: string;
+    static section: string;
+}

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

@@ -0,0 +1,2 @@
+export * from './tabber';
+export * from './use-detail-scroll-spy';

package/dist/types/components/base/tabber/tabber.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+import { TitleText } from '../text';
+import { TabberTest } from './constants';
+export { TabberTest };
+export interface TabberSectionProps {
+    readonly id: string;
+    /** Tab label: a messageId (formatted here) or a node. */
+    readonly title: TitleText;
+    readonly heading?: TitleText;
+    readonly actions?: React.ReactNode;
+    readonly children?: React.ReactNode;
+    /**
+     * Render this section above the sticky tab bar (overview badges). The tab
+     * still appears in the bar and scroll-spy still tracks the section.
+     */
+    readonly beforeBar?: boolean;
+    /** Skip the in-section h2 — overview has badges, not a heading. */
+    readonly hideHeading?: boolean;
+}
+export declare function TabberSection({ id, title, heading, actions, children, hideHeading, }: TabberSectionProps): React.ReactElement;
+export declare namespace TabberSection {
+    var displayName: string;
+}
+export interface TabberProps {
+    readonly children: React.ReactNode;
+    readonly observeKey?: string;
+    readonly initialSection?: string;
+    readonly testId?: string;
+    /** Injected by {@link DetailsViewLeftPane} on narrow screens. */
+    readonly mobileManagePane?: React.ReactNode;
+}
+export declare function Tabber({ children, observeKey, initialSection, testId, mobileManagePane, }: TabberProps): React.ReactElement;
+export declare function isTabber(node: React.ReactNode): boolean;

package/dist/types/components/base/tabber/use-detail-scroll-spy.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+/**
+ * Highlights the tab for the page section most visible in the viewport (Morpho-style scroll spy).
+ * Generic over section id union.
+ */
+export declare function useDetailScrollSpy<T extends string>(refs: Record<T, React.RefObject<HTMLElement | null>>, sectionOrder: readonly T[], 
+/** Re-attach observer when this changes (e.g. data loads, entity address changes) */
+observeKey: string | undefined): {
+    activeSection: T;
+    scrollToSection: (id: T) => void;
+};

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

@@ -0,0 +1 @@
+export * from './use-title-text';

package/dist/types/components/base/text/use-title-text.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { LocaleKeys } from '../../../locale';
+/**
+ * Base components take `title: LocaleKeys | ReactNode`: a messageId is
+ * formatted through `intl`, anything else is rendered as given. Keeps text
+ * ownership inside the component and messageIds at the call site.
+ */
+export type TitleText = LocaleKeys | React.ReactNode;
+export declare function useTitleText(): (title: TitleText) => React.ReactNode;

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

@@ -0,0 +1,5 @@
+export declare class TimeToLiquidationBlockTest {
+    static root: string;
+    static value: string;
+    static valueTo: string;
+}

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

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './time-to-liquidation-block';

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

@@ -0,0 +1,27 @@
+import { default as React } from 'react';
+import { TitleText } from '../text';
+import { TTLZones } from '../../../utils/ttl';
+import { TimeToLiquidationBlockTest } from './constants';
+export { TimeToLiquidationBlockTest };
+export interface TimeToLiquidationBlockProps {
+    /**
+     * SDK `timeToLiquidation` in milliseconds; `null` renders "N/A", omit to
+     * render "—" (value not available).
+     */
+    readonly data?: bigint | null;
+    /** Time after the operation; renders a from → to transition. */
+    readonly dataTo?: bigint | null;
+    /** Pre-computed zone; if not set, derived from the value. */
+    readonly zone?: TTLZones;
+    readonly isLoading?: boolean;
+    /** Label override; defaults to the "Time to liquidation" locale string. */
+    readonly title?: TitleText;
+    /** Tooltip override; defaults to the standard explanation. */
+    readonly tip?: React.ReactNode;
+    readonly testId?: string;
+}
+/**
+ * "Time to liquidation" row of a preview: label + help tip, the remaining
+ * time as `Nmo` / `Nd` / `<1d` with a zone dot, optionally from → to.
+ */
+export declare function TimeToLiquidationBlock({ data, dataTo, zone, isLoading, title, tip, testId, }: TimeToLiquidationBlockProps): React.ReactElement;

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

@@ -0,0 +1,6 @@
+export declare class TitleMetaTest {
+    static root: string;
+    static network: string;
+    static curator: string;
+    static link: string;
+}

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

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './title-meta';

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

@@ -0,0 +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, links, testId, networkTestId, curatorTestId, }: TitleMetaProps): React.ReactElement;

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

@@ -0,0 +1,3 @@
+export declare class TokenAmountTest {
+    static root: string;
+}

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

@@ -0,0 +1 @@
+export * from './token-amount';

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

@@ -0,0 +1,27 @@
+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.
+ *
+ * The model's `TokenAmount` says what it is denominated in, so that is all this
+ * takes. The few groups the SDK hands out as a bare `Amount` (a pool's
+ * `totalSupply` / `totalBorrow`, implicitly in the market underlying) name their
+ * token alongside.
+ */
+type TokenAmountDataProps = {
+    /** `null` means unavailable and renders an em-dash. */
+    readonly data: TokenAmountModel | null;
+    readonly token?: undefined;
+} | {
+    readonly data: Amount | null;
+    readonly token: Token;
+};
+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/token-pair-symbol/constants.d.ts

@@ -0,0 +1,3 @@
+export declare class TokenPairSymbolTest {
+    static root: string;
+}

package/dist/types/components/base/token-pair-symbol/index.d.ts

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './token-pair-symbol';

package/dist/types/components/base/token-pair-symbol/token-pair-symbol.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { TokenSymbolProps } from '../../token-symbol';
+import { TokenPairSymbolTest } from './constants';
+export { TokenPairSymbolTest };
+export interface TokenPairSymbolProps {
+    /** Collateral / strategy token (left). */
+    readonly collateral: TokenSymbolProps["token"] | undefined;
+    /** Debt / underlying token (right). */
+    readonly underlying: TokenSymbolProps["token"] | undefined;
+    readonly size?: number;
+    readonly offset?: number;
+    readonly className?: string;
+}
+/** Two token icons overlapping: collateral in front, underlying behind. */
+export declare function TokenPairSymbol({ collateral, underlying, size, offset, className, }: TokenPairSymbolProps): React.ReactElement | null;

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

@@ -0,0 +1,3 @@
+export declare class TokenPairTitleTest {
+    static root: string;
+}

package/dist/types/components/base/token-pair-title/index.d.ts

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './token-pair-title';

package/dist/types/components/base/token-pair-title/token-pair-title.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { TokenPairTitleTest } from './constants';
+export { TokenPairTitleTest };
+export interface TokenPairTitleProps {
+    /** Collateral / strategy side of the title. */
+    readonly name: React.ReactNode;
+    /** Debt side symbol; hidden when undefined. */
+    readonly debtSymbol?: string;
+}
+/** "Collateral / debt" title: names separated by a muted slash. */
+export declare function TokenPairTitle({ name, debtSymbol, }: TokenPairTitleProps): React.ReactElement;

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

@@ -0,0 +1,14 @@
+export declare class ValueTest {
+    static apy: string;
+    static usd: string;
+    static leverage: string;
+    static utilization: string;
+    static healthFactor: string;
+    static pnl: string;
+    static tokenBigint: string;
+    static points: string;
+    static placeholder: string;
+}
+export declare class PositionShortLabelTest {
+    static root: string;
+}

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

@@ -0,0 +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, bps, HealthFactorValue, LeverageValue, TokenBigint, UsdValue, UtilizationValue, } from './scalars';

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

@@ -0,0 +1,6 @@
+import { PnlBreakdown } from '@gearbox-protocol/sdk/model';
+import { default as React } from 'react';
+/** Realised + unrealised PnL of a position, signed. */
+export declare function PnlValue({ data, }: {
+    readonly data: PnlBreakdown | undefined;
+}): React.ReactElement;

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

@@ -0,0 +1,8 @@
+import { StrategyPosition } from '@gearbox-protocol/sdk/model';
+import { default as React } from 'react';
+import { PositionShortLabelTest } from './constants';
+export { PositionShortLabelTest };
+/** "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

@@ -0,0 +1,11 @@
+import { PositionKind } from '@gearbox-protocol/sdk/model';
+import { default as React } from 'react';
+export interface PositionTypeBadgeProps {
+    /** The SDK's `Position.kind`. */
+    readonly data: PositionKind;
+    readonly size?: "table" | "aside" | "title";
+}
+/**
+ * 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

@@ -0,0 +1,43 @@
+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;
+}
+/**
+ * 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 UsdValue({ data, }: {
+    readonly data: number | null | undefined;
+}): React.ReactElement;
+export declare function LeverageValue({ data, }: {
+    readonly data: Leverage | undefined;
+}): React.ReactElement;
+export declare function UtilizationValue({ data, }: {
+    readonly data: Bps | undefined;
+}): React.ReactElement;
+/** Health factor with its zone: below 1 the account is liquidatable. */
+export declare function HealthFactorValue({ data, }: {
+    readonly data: Bps | undefined;
+}): React.ReactElement;
+/**
+ * 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.
+ */
+export declare function TokenBigint({ data, token, }: {
+    readonly data: bigint | undefined;
+    readonly token: Token | undefined;
+}): React.ReactElement;

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

@@ -1,7 +1,7 @@
 import { VariantProps } from 'class-variance-authority';
 import * as React from "react";
 declare const linkVariants: (props?: ({
-    size?: "default" | "xs" | "sm" | "unset" | null | undefined;
+    size?: "default" | "unset" | "sm" | "xs" | null | undefined;
     variant?: "default" | "unset" | "underlined" | null | undefined;
     color?: "main" | "default" | "secondary" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;

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/block-sync-pill/block-sync-pill.d.ts

@@ -0,0 +1,35 @@
+import { BlockSyncProps } from '../../types/footer';
+import type * as React from "react";
+export interface BlockSyncPillProps extends BlockSyncProps {
+    /**
+     * Label rendered inside the status pill. Defaults to `Status`.
+     */
+    statusLabel?: React.ReactNode;
+    /**
+     * Additional class names applied to the pill wrapper.
+     */
+    className?: string;
+}
+/**
+ * BlockSyncPill — backend-sync status rendered as an {@link AppFooter}-style
+ * pill: a thin bordered, rounded badge with a status dot and a label.
+ *
+ * Reflects the **liveness** of the data-refresh loop rather than raw block age:
+ * - **loading** (no successful sync yet): the dot is a pulsing neutral gray;
+ * - **synced** (within `syncIntervalMs * staleMultiplier`, no errors): green,
+ *   pulsing while a refresh is in flight;
+ * - **error / stalled**: red.
+ *
+ * Hovering reveals per-chain block numbers and the local time of the last sync.
+ *
+ * @example
+ * ```tsx
+ * <BlockSyncPill
+ *   blockByChain={blockByChain}
+ *   explorerAddresses={explorerAddresses}
+ *   networkById={networkById}
+ *   syncIntervalMs={300000}
+ * />
+ * ```
+ */
+export declare function BlockSyncPill({ blockByChain, explorerAddresses, networkById, syncIntervalMs, staleMultiplier, statusLabel, className, }: BlockSyncPillProps): React.ReactElement;

package/dist/types/components/block-sync-pill/block-sync-status.d.ts

@@ -0,0 +1,29 @@
+import { BlockByChain } from '../../types/footer';
+/**
+ * Liveness state of the data-refresh loop, derived from per-chain sync info:
+ * - `loading` — nothing has successfully synced yet (initial state);
+ * - `synced` — at least one chain synced and none are stale/failing;
+ * - `error` — a chain reported an error, or the oldest sync is stale.
+ */
+export type BlockSyncState = "loading" | "synced" | "error";
+export interface BlockSyncStatus {
+    state: BlockSyncState;
+    /** True while any chain has a refresh in flight. */
+    isSyncing: boolean;
+}
+export interface GetBlockSyncStatusProps {
+    blockByChain: BlockByChain | undefined;
+    /** Reference "now" timestamp (ms) used to evaluate staleness. */
+    now: number;
+    /** Age (ms) after which the oldest sync is considered stale. */
+    staleAfterMs: number;
+}
+/**
+ * Pure derivation of the {@link BlockSyncState} from chain sync info.
+ *
+ * A chain counts as "synced" only when it has both a real block (`> 0`) and a
+ * local sync timestamp. Staleness is measured against the **oldest** synced
+ * chain, so a single lagging chain is enough to flag the whole indicator.
+ * Errors take priority over everything else.
+ */
+export declare function getBlockSyncStatus({ blockByChain, now, staleAfterMs, }: GetBlockSyncStatusProps): BlockSyncStatus;

package/dist/types/components/block-sync-pill/index.d.ts

@@ -0,0 +1 @@
+export * from './block-sync-pill';