@liberfi.io/ui-predict 0.1.146 → 1.0.1

package/README.md

@@ -67,6 +67,24 @@ These props enable framework-agnostic route link rendering and prefetching:
 | `EventDetailUI`       | `event`, `series`, `candlesticks`, `chartRange`, ...                    | Pure presentation for event detail.                  |
 | `EventDetailSkeleton` | `marketCount?`                                                          | Loading skeleton for the detail page.                |
 
+### Components — Matches (cross-platform pairs, v1.1)
+
+| Component         | Key Props                                                                   | Description                                                                                                                                       |
+| ----------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MatchesPage`     | `onSelectMatch`, `getMatchHref`, `onHover`, `LinkComponent`, `bgImageSrc`   | Full Matches page (hero + filter bar + virtualized card list). v1.1 cards have **no Buy CTA**.                                                    |
+| `MatchesWidget`   | `sortBy`, `sortAsc`, `minVolume`, `signal`, `onSelectMatch`, `getMatchHref` | Container that wires `useInfiniteMatchMarkets` to the card list and surfaces the new `signal` filter param.                                       |
+| `MatchMarketCard` | `match: MatchMarketFlat`, `onSelectMatch`, `getMatchHref`                   | Single pair card. Body click → internal pair detail. Each leg renders a small external link icon to the original platform via `leg.external_url`. |
+
+> v1.1 deprecates the old `onSelect` / `getMarketHref` props (they took a `(match, source)` pair and routed straight to the source platform). The new `onSelectMatch(match)` is the primary action; per-leg external links are intrinsic to the card and use `leg.external_url`.
+
+#### v1.1 visual changes
+
+- **GAP** label replaces "Spread" — represents `|A.best_price − B.best_price|` with no fee adjustment.
+- **SignalBadge** (`liquid_gap` / `active_gap` / `stale_gap` / `stale_data`) replaces the old confidence tier dot.
+- **Per-leg freshness dots** (`fresh` / `aging` / `stale`) appear next to each platform name based on `leg.age_seconds`.
+- **Compact relative age** is shown in the card footer.
+- **External link icon** per leg opens the source-platform URL in a new tab; no Buy CTA is rendered.
+
 ### Components — Trading
 
 | Component            | Description                                          |

package/dist/index.d.mts

@@ -13,7 +13,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.146";
+declare const _default: "1.0.1";
 
 /**
  * A single category entry in the static navigation model.
@@ -132,8 +132,14 @@ interface EventsPageProps {
     onHover?: (event: PredictEvent) => void;
     /** Optional background image for the Hero area. */
     bgImageSrc?: string;
+    /**
+     * Forwarded to the underlying trade modal: invoked when the user attempts
+     * to buy with an amount exceeding the available USDC balance for the
+     * market's source. Use this to open a Fund Wallet / deposit flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
-declare function EventsPage({ onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, bgImageSrc: _bgImageSrc, }: EventsPageProps): react_jsx_runtime.JSX.Element;
+declare function EventsPage({ onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, bgImageSrc: _bgImageSrc, onInsufficientBalance, }: EventsPageProps): react_jsx_runtime.JSX.Element;
 
 interface EventsWidgetProps {
     /** Category / tag selection from the categories widget. */
@@ -258,8 +264,15 @@ interface EventDetailPageProps {
         event: PredictEvent;
         walletAddress?: string;
     }) => React.ReactNode;
+    /**
+     * Forwarded to the inline TradeFormWidget and the mobile trade modal:
+     * invoked when the user attempts to buy with an amount exceeding the
+     * available USDC balance for the market's source. Use this to open a Fund
+     * Wallet / deposit flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
-declare function EventDetailPage({ eventSlug, source, chain, walletAddress, onSimilarEventClick, onSimilarEventHover, onBack, renderActivitySection, }: EventDetailPageProps): react_jsx_runtime.JSX.Element;
+declare function EventDetailPage({ eventSlug, source, chain, walletAddress, onSimilarEventClick, onSimilarEventHover, onBack, renderActivitySection, onInsufficientBalance, }: EventDetailPageProps): react_jsx_runtime.JSX.Element;
 
 type TradeOutcome = "yes" | "no";
 type TradeSide = "buy" | "sell";
@@ -301,6 +314,14 @@ interface UseTradeFormParams {
     market: PredictMarket;
     chain?: string;
     initialOutcome?: TradeOutcome;
+    /**
+     * Callback fired when the user attempts to submit a buy with an amount
+     * larger than the available USDC balance for the market's source. The
+     * consumer typically uses this to open a "Fund wallet" / Deposit flow.
+     * The callback is invoked BEFORE the inline validation errors are shown,
+     * giving the consumer a chance to redirect the user to a top-up flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
 interface UseTradeFormResult {
     outcome: TradeOutcome;
@@ -316,6 +337,10 @@ interface UseTradeFormResult {
     isMarketDataLoading: boolean;
     isSubmitting: boolean;
     validation: TradeFormValidation;
+    /** True when the user has entered an amount that exceeds the available USDC balance. */
+    isInsufficientBalance: boolean;
+    /** The provider source for this market, useful to map to the right wallet. */
+    source: ProviderSource;
     supportsLimitOrder: boolean;
     kycRequired: boolean;
     kycUrl: string | null;
@@ -332,8 +357,14 @@ interface UseTradeFormResult {
     setCustomDuration: (v: number) => void;
     setCustomDurationUnit: (u: DurationUnit) => void;
     submit: () => void;
+    /**
+     * Notify the consumer about an insufficient-balance attempt. The hook
+     * forwards the configured `onInsufficientBalance` callback (if any) so the
+     * UI layer can call it without re-threading the option from the consumer.
+     */
+    notifyInsufficientBalance: () => void;
 }
-declare function useTradeForm({ market, initialOutcome, }: UseTradeFormParams): UseTradeFormResult;
+declare function useTradeForm({ market, initialOutcome, onInsufficientBalance, }: UseTradeFormParams): UseTradeFormResult;
 
 interface EventDetailUIProps {
     event: PredictEvent;
@@ -455,6 +486,11 @@ type PredictTradeModalParams = {
     market: PredictMarket;
     initialOutcome?: TradeOutcome;
     chain?: string;
+    /**
+     * Called when the user presses Buy with insufficient USDC balance for the
+     * market's source. Allows the consumer to open a Fund Wallet flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 };
 type PredictTradeModalResult = void;
 declare const PREDICT_TRADE_MODAL_ID = "predict-trade";
@@ -498,6 +534,10 @@ interface TradeFormUIProps {
     isBalanceLoading: boolean;
     isValid: boolean;
     validationErrors: string[];
+    /** When true, pressing submit triggers the insufficient-balance handler (e.g. open Fund Wallet) instead of showing inline errors. */
+    isInsufficientBalance: boolean;
+    /** Invoked when the user presses submit while balance is insufficient. */
+    onInsufficientBalance?: () => void;
     supportsLimitOrder: boolean;
     kycRequired: boolean;
     kycUrl: string | null;
@@ -515,7 +555,7 @@ interface TradeFormUIProps {
     onCustomDurationUnitChange: (u: DurationUnit) => void;
     onSubmit: () => void;
 }
-declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, isValid, validationErrors, supportsLimitOrder, kycRequired, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, isValid, validationErrors, isInsufficientBalance, onInsufficientBalance, supportsLimitOrder, kycRequired, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
 
 interface TradeFormWidgetProps {
     event?: PredictEvent;
@@ -523,8 +563,14 @@ interface TradeFormWidgetProps {
     variant?: "bordered" | "flat";
     initialOutcome?: TradeOutcome;
     chain?: string;
+    /**
+     * Called when the user presses Buy with an amount larger than the available
+     * USDC balance for the market's source. Use this to show a top-up flow
+     * (e.g. open a Fund Wallet modal pre-selected for the right chain).
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
-declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, onInsufficientBalance, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PredictSellModalParams = {
     event: PredictEvent;
@@ -831,18 +877,24 @@ type SearchWidgetProps = {
 declare function SearchWidget({ onKeywordChange, onSelectEvent, getEventHref, LinkComponent, onHover, onEscape, source, }: SearchWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface MatchesPageProps {
-    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** v1.1: invoked when the user clicks the card body (internal pair detail). */
+    onSelectMatch?: (match: MatchMarketFlat) => void;
+    /** v1.1: returns the internal pair detail href for the card link. */
+    getMatchHref?: (match: MatchMarketFlat) => string | undefined;
     onHover?: (match: MatchMarketFlat) => void;
+    /** @deprecated v1.1 — use `onSelectMatch`. */
+    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** @deprecated v1.1 — fallback only; per-leg `external_url` is preferred. */
     getMarketHref?: (match: MatchMarketFlat, source: ProviderSource) => string | undefined;
     LinkComponent?: LinkComponentType;
     /** Path to the hero background image (e.g. "/matches-bg.webp") */
     bgImageSrc?: string;
-    /** @deprecated Use onSelect instead */
+    /** @deprecated Use onSelectMatch instead */
     onSelectEntry?: (event: never) => void;
-    /** @deprecated Use getMarketHref instead */
+    /** @deprecated Use getMatchHref instead */
     getEventHref?: (event: never) => string;
 }
-declare function MatchesPage({ onSelect, onHover, getMarketHref, LinkComponent, bgImageSrc, }: MatchesPageProps): react_jsx_runtime.JSX.Element;
+declare function MatchesPage({ onSelectMatch, getMatchHref, onHover, onSelect, getMarketHref, LinkComponent, bgImageSrc, }: MatchesPageProps): react_jsx_runtime.JSX.Element;
 
 interface MatchesHeroStats {
     activePairs: number;
@@ -862,14 +914,25 @@ interface MatchesWidgetProps {
     sortBy: MatchSortField;
     sortAsc: boolean;
     minVolume?: number;
-    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /**
+     * v1.1: comma-separated `signal_tag` filter (e.g. `"liquid_gap,active_gap"`).
+     * Pass `"any"` or omit to disable signal filtering.
+     */
+    signal?: string;
+    /** v1.1: card-body click → internal pair detail. */
+    onSelectMatch?: (match: MatchMarketFlat) => void;
+    /** v1.1: returns internal pair detail href. */
+    getMatchHref?: (match: MatchMarketFlat) => string | undefined;
     onHover?: (match: MatchMarketFlat) => void;
+    /** @deprecated v1.1 — use `onSelectMatch`. */
+    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** @deprecated v1.1 — fallback only when `leg.external_url` is missing. */
     getMarketHref?: (match: MatchMarketFlat, source: ProviderSource) => string | undefined;
     LinkComponent?: LinkComponentType;
     onStatsChange?: (stats: MatchesHeroStats) => void;
-    /** @deprecated Use onSelect instead */
+    /** @deprecated Use onSelectMatch instead */
     onSelectEntry?: (event: never) => void;
-    /** @deprecated Use getMarketHref instead */
+    /** @deprecated Use getMatchHref instead */
     getEventHref?: (event: never) => string;
 }
 declare const MatchesWidget: react.ForwardRefExoticComponent<MatchesWidgetProps & react.RefAttributes<MatchesWidgetRef>>;
@@ -882,14 +945,41 @@ interface MatchGroupCardProps {
 }
 declare function MatchGroupCard({ group, onSelectEntry, getEventHref, LinkComponent, }: MatchGroupCardProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Props for the v1.1 match card.
+ *
+ * v1.1 changes (PRD §5):
+ * - Card click now navigates to the internal pair detail page
+ *   (`getMatchHref` / `onSelectMatch`); the legacy "Buy on Platform"
+ *   CTA was removed because it implied execution which the platform
+ *   does not perform.
+ * - Each leg renders a small external-link icon that deep-links to the
+ *   original provider's market page (`leg.external_url`, with
+ *   `getMarketHref(match, source)` as backward-compat fallback).
+ * - `SignalBadge` replaces the confidence-tier dot and is sourced from
+ *   `match.signal_tag`.
+ */
 interface MatchMarketCardProps {
     match: MatchMarketFlat;
-    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** v1.1: invoked when the user clicks the card body (internal detail). */
+    onSelectMatch?: (match: MatchMarketFlat) => void;
+    /** v1.1: returns the internal pair detail href; renders card as a link. */
+    getMatchHref?: (match: MatchMarketFlat) => string | undefined;
     onHover?: (match: MatchMarketFlat) => void;
+    /**
+     * @deprecated v1.1 — kept for source compatibility. Used as a fallback
+     * when `match.legs[*].external_url` is missing.
+     */
     getMarketHref?: (match: MatchMarketFlat, source: ProviderSource) => string | undefined;
+    /**
+     * @deprecated v1.1 — the "buy on cheaper platform" affordance was
+     * removed (PRD §5.4). Per-leg clicks now open the provider page in a
+     * new tab via the external-link icon, no callback required.
+     */
+    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
     LinkComponent?: LinkComponentType;
 }
-declare function MatchMarketCard({ match, onSelect, onHover, getMarketHref, LinkComponent, }: MatchMarketCardProps): react_jsx_runtime.JSX.Element;
+declare function MatchMarketCard({ match, onSelectMatch, getMatchHref, onHover, getMarketHref, LinkComponent, }: MatchMarketCardProps): react_jsx_runtime.JSX.Element | null;
 
 interface MatchesStatsBarProps {
     matches: MatchGroup[];

package/dist/index.d.ts

@@ -13,7 +13,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.146";
+declare const _default: "1.0.1";
 
 /**
  * A single category entry in the static navigation model.
@@ -132,8 +132,14 @@ interface EventsPageProps {
     onHover?: (event: PredictEvent) => void;
     /** Optional background image for the Hero area. */
     bgImageSrc?: string;
+    /**
+     * Forwarded to the underlying trade modal: invoked when the user attempts
+     * to buy with an amount exceeding the available USDC balance for the
+     * market's source. Use this to open a Fund Wallet / deposit flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
-declare function EventsPage({ onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, bgImageSrc: _bgImageSrc, }: EventsPageProps): react_jsx_runtime.JSX.Element;
+declare function EventsPage({ onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, bgImageSrc: _bgImageSrc, onInsufficientBalance, }: EventsPageProps): react_jsx_runtime.JSX.Element;
 
 interface EventsWidgetProps {
     /** Category / tag selection from the categories widget. */
@@ -258,8 +264,15 @@ interface EventDetailPageProps {
         event: PredictEvent;
         walletAddress?: string;
     }) => React.ReactNode;
+    /**
+     * Forwarded to the inline TradeFormWidget and the mobile trade modal:
+     * invoked when the user attempts to buy with an amount exceeding the
+     * available USDC balance for the market's source. Use this to open a Fund
+     * Wallet / deposit flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
-declare function EventDetailPage({ eventSlug, source, chain, walletAddress, onSimilarEventClick, onSimilarEventHover, onBack, renderActivitySection, }: EventDetailPageProps): react_jsx_runtime.JSX.Element;
+declare function EventDetailPage({ eventSlug, source, chain, walletAddress, onSimilarEventClick, onSimilarEventHover, onBack, renderActivitySection, onInsufficientBalance, }: EventDetailPageProps): react_jsx_runtime.JSX.Element;
 
 type TradeOutcome = "yes" | "no";
 type TradeSide = "buy" | "sell";
@@ -301,6 +314,14 @@ interface UseTradeFormParams {
     market: PredictMarket;
     chain?: string;
     initialOutcome?: TradeOutcome;
+    /**
+     * Callback fired when the user attempts to submit a buy with an amount
+     * larger than the available USDC balance for the market's source. The
+     * consumer typically uses this to open a "Fund wallet" / Deposit flow.
+     * The callback is invoked BEFORE the inline validation errors are shown,
+     * giving the consumer a chance to redirect the user to a top-up flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
 interface UseTradeFormResult {
     outcome: TradeOutcome;
@@ -316,6 +337,10 @@ interface UseTradeFormResult {
     isMarketDataLoading: boolean;
     isSubmitting: boolean;
     validation: TradeFormValidation;
+    /** True when the user has entered an amount that exceeds the available USDC balance. */
+    isInsufficientBalance: boolean;
+    /** The provider source for this market, useful to map to the right wallet. */
+    source: ProviderSource;
     supportsLimitOrder: boolean;
     kycRequired: boolean;
     kycUrl: string | null;
@@ -332,8 +357,14 @@ interface UseTradeFormResult {
     setCustomDuration: (v: number) => void;
     setCustomDurationUnit: (u: DurationUnit) => void;
     submit: () => void;
+    /**
+     * Notify the consumer about an insufficient-balance attempt. The hook
+     * forwards the configured `onInsufficientBalance` callback (if any) so the
+     * UI layer can call it without re-threading the option from the consumer.
+     */
+    notifyInsufficientBalance: () => void;
 }
-declare function useTradeForm({ market, initialOutcome, }: UseTradeFormParams): UseTradeFormResult;
+declare function useTradeForm({ market, initialOutcome, onInsufficientBalance, }: UseTradeFormParams): UseTradeFormResult;
 
 interface EventDetailUIProps {
     event: PredictEvent;
@@ -455,6 +486,11 @@ type PredictTradeModalParams = {
     market: PredictMarket;
     initialOutcome?: TradeOutcome;
     chain?: string;
+    /**
+     * Called when the user presses Buy with insufficient USDC balance for the
+     * market's source. Allows the consumer to open a Fund Wallet flow.
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 };
 type PredictTradeModalResult = void;
 declare const PREDICT_TRADE_MODAL_ID = "predict-trade";
@@ -498,6 +534,10 @@ interface TradeFormUIProps {
     isBalanceLoading: boolean;
     isValid: boolean;
     validationErrors: string[];
+    /** When true, pressing submit triggers the insufficient-balance handler (e.g. open Fund Wallet) instead of showing inline errors. */
+    isInsufficientBalance: boolean;
+    /** Invoked when the user presses submit while balance is insufficient. */
+    onInsufficientBalance?: () => void;
     supportsLimitOrder: boolean;
     kycRequired: boolean;
     kycUrl: string | null;
@@ -515,7 +555,7 @@ interface TradeFormUIProps {
     onCustomDurationUnitChange: (u: DurationUnit) => void;
     onSubmit: () => void;
 }
-declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, isValid, validationErrors, supportsLimitOrder, kycRequired, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, isValid, validationErrors, isInsufficientBalance, onInsufficientBalance, supportsLimitOrder, kycRequired, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
 
 interface TradeFormWidgetProps {
     event?: PredictEvent;
@@ -523,8 +563,14 @@ interface TradeFormWidgetProps {
     variant?: "bordered" | "flat";
     initialOutcome?: TradeOutcome;
     chain?: string;
+    /**
+     * Called when the user presses Buy with an amount larger than the available
+     * USDC balance for the market's source. Use this to show a top-up flow
+     * (e.g. open a Fund Wallet modal pre-selected for the right chain).
+     */
+    onInsufficientBalance?: (source: ProviderSource) => void;
 }
-declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, onInsufficientBalance, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PredictSellModalParams = {
     event: PredictEvent;
@@ -831,18 +877,24 @@ type SearchWidgetProps = {
 declare function SearchWidget({ onKeywordChange, onSelectEvent, getEventHref, LinkComponent, onHover, onEscape, source, }: SearchWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface MatchesPageProps {
-    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** v1.1: invoked when the user clicks the card body (internal pair detail). */
+    onSelectMatch?: (match: MatchMarketFlat) => void;
+    /** v1.1: returns the internal pair detail href for the card link. */
+    getMatchHref?: (match: MatchMarketFlat) => string | undefined;
     onHover?: (match: MatchMarketFlat) => void;
+    /** @deprecated v1.1 — use `onSelectMatch`. */
+    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** @deprecated v1.1 — fallback only; per-leg `external_url` is preferred. */
     getMarketHref?: (match: MatchMarketFlat, source: ProviderSource) => string | undefined;
     LinkComponent?: LinkComponentType;
     /** Path to the hero background image (e.g. "/matches-bg.webp") */
     bgImageSrc?: string;
-    /** @deprecated Use onSelect instead */
+    /** @deprecated Use onSelectMatch instead */
     onSelectEntry?: (event: never) => void;
-    /** @deprecated Use getMarketHref instead */
+    /** @deprecated Use getMatchHref instead */
     getEventHref?: (event: never) => string;
 }
-declare function MatchesPage({ onSelect, onHover, getMarketHref, LinkComponent, bgImageSrc, }: MatchesPageProps): react_jsx_runtime.JSX.Element;
+declare function MatchesPage({ onSelectMatch, getMatchHref, onHover, onSelect, getMarketHref, LinkComponent, bgImageSrc, }: MatchesPageProps): react_jsx_runtime.JSX.Element;
 
 interface MatchesHeroStats {
     activePairs: number;
@@ -862,14 +914,25 @@ interface MatchesWidgetProps {
     sortBy: MatchSortField;
     sortAsc: boolean;
     minVolume?: number;
-    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /**
+     * v1.1: comma-separated `signal_tag` filter (e.g. `"liquid_gap,active_gap"`).
+     * Pass `"any"` or omit to disable signal filtering.
+     */
+    signal?: string;
+    /** v1.1: card-body click → internal pair detail. */
+    onSelectMatch?: (match: MatchMarketFlat) => void;
+    /** v1.1: returns internal pair detail href. */
+    getMatchHref?: (match: MatchMarketFlat) => string | undefined;
     onHover?: (match: MatchMarketFlat) => void;
+    /** @deprecated v1.1 — use `onSelectMatch`. */
+    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** @deprecated v1.1 — fallback only when `leg.external_url` is missing. */
     getMarketHref?: (match: MatchMarketFlat, source: ProviderSource) => string | undefined;
     LinkComponent?: LinkComponentType;
     onStatsChange?: (stats: MatchesHeroStats) => void;
-    /** @deprecated Use onSelect instead */
+    /** @deprecated Use onSelectMatch instead */
     onSelectEntry?: (event: never) => void;
-    /** @deprecated Use getMarketHref instead */
+    /** @deprecated Use getMatchHref instead */
     getEventHref?: (event: never) => string;
 }
 declare const MatchesWidget: react.ForwardRefExoticComponent<MatchesWidgetProps & react.RefAttributes<MatchesWidgetRef>>;
@@ -882,14 +945,41 @@ interface MatchGroupCardProps {
 }
 declare function MatchGroupCard({ group, onSelectEntry, getEventHref, LinkComponent, }: MatchGroupCardProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Props for the v1.1 match card.
+ *
+ * v1.1 changes (PRD §5):
+ * - Card click now navigates to the internal pair detail page
+ *   (`getMatchHref` / `onSelectMatch`); the legacy "Buy on Platform"
+ *   CTA was removed because it implied execution which the platform
+ *   does not perform.
+ * - Each leg renders a small external-link icon that deep-links to the
+ *   original provider's market page (`leg.external_url`, with
+ *   `getMarketHref(match, source)` as backward-compat fallback).
+ * - `SignalBadge` replaces the confidence-tier dot and is sourced from
+ *   `match.signal_tag`.
+ */
 interface MatchMarketCardProps {
     match: MatchMarketFlat;
-    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
+    /** v1.1: invoked when the user clicks the card body (internal detail). */
+    onSelectMatch?: (match: MatchMarketFlat) => void;
+    /** v1.1: returns the internal pair detail href; renders card as a link. */
+    getMatchHref?: (match: MatchMarketFlat) => string | undefined;
     onHover?: (match: MatchMarketFlat) => void;
+    /**
+     * @deprecated v1.1 — kept for source compatibility. Used as a fallback
+     * when `match.legs[*].external_url` is missing.
+     */
     getMarketHref?: (match: MatchMarketFlat, source: ProviderSource) => string | undefined;
+    /**
+     * @deprecated v1.1 — the "buy on cheaper platform" affordance was
+     * removed (PRD §5.4). Per-leg clicks now open the provider page in a
+     * new tab via the external-link icon, no callback required.
+     */
+    onSelect?: (match: MatchMarketFlat, source: ProviderSource) => void;
     LinkComponent?: LinkComponentType;
 }
-declare function MatchMarketCard({ match, onSelect, onHover, getMarketHref, LinkComponent, }: MatchMarketCardProps): react_jsx_runtime.JSX.Element;
+declare function MatchMarketCard({ match, onSelectMatch, getMatchHref, onHover, getMarketHref, LinkComponent, }: MatchMarketCardProps): react_jsx_runtime.JSX.Element | null;
 
 interface MatchesStatsBarProps {
     matches: MatchGroup[];