@liberfi.io/ui-predict 0.1.145 → 1.0.0

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.145";
+declare const _default: "1.0.0";
 
 /**
  * A single category entry in the static navigation model.
@@ -831,18 +831,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 +868,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 +899,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.145";
+declare const _default: "1.0.0";
 
 /**
  * A single category entry in the static navigation model.
@@ -831,18 +831,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 +868,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 +899,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[];