@liberfi.io/ui-predict 0.1.53 → 0.1.55

package/README.md

@@ -0,0 +1,263 @@
+# @liberfi.io/ui-predict
+
+Prediction market UI components, data hooks, and client for the Liberfi React SDK. Provides a full-stack prediction market experience — from event browsing and detail views to trading, order management, and real-time price feeds. Consumed by template apps (e.g. `dex-nextjs-template`) and composed with `@liberfi.io/ui` base components.
+
+## Design Philosophy
+
+- **Script / UI / Widget separation** — Each feature area (events, trade-form, order-book, etc.) is split into a `.script` (data hook), `.ui` (pure presentation), and `.widget` (wiring) layer. Presentational components are reusable without the full data stack.
+- **Inversion of Control** — Navigation, side effects, and framework-specific behaviour (e.g. Next.js `<Link>`) are injected via callbacks and component props. The package never imports a router or framework directly.
+- **V1 / V2 coexistence** — Legacy DFlow-backed components coexist with the prediction-server v2 client. Consumers migrate at their own pace; both APIs are stable and exported.
+- **Provider-based client injection** — `PredictProvider` / `PredictV2Provider` supply the API client via React Context. Hooks pull the client from context, keeping components testable and decoupled from concrete HTTP implementations.
+
+## Installation
+
+```bash
+pnpm add @liberfi.io/ui-predict
+```
+
+### Peer dependencies
+
+The consumer must provide:
+
+| Package                 | Version |
+| ----------------------- | ------- |
+| `react`                 | >= 18   |
+| `react-dom`             | >= 18   |
+| `@tanstack/react-query` | ^5.90.2 |
+
+## API Reference
+
+### Providers
+
+| Provider              | Props                                     | Description                                                                  |
+| --------------------- | ----------------------------------------- | ---------------------------------------------------------------------------- |
+| `PredictProvider`     | `client: IPredictClient`                  | Supplies the legacy DFlow predict client to all descendant hooks/components. |
+| `PredictV2Provider`   | `client: PredictClientV2`                 | Supplies the v2 prediction-server client.                                    |
+| `UserPredictProvider` | `walletAddress: string, enabled: boolean` | Provides user-specific prediction context (positions, orders).               |
+
+### Components — Events (V2)
+
+| Component            | Key Props                                                                                                                             | Description                                                                                                             |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `EventsPageV2`       | `onSelect`, `onSelectOutcome`, `getEventHref`, `LinkComponent`, `onHover`                                                             | Full events page with categories, toolbar, filters, and grid.                                                           |
+| `EventsWidgetV2`     | `tagSlugSelection`, `limit`, `status`, `sort_by`, `source`, `onSelect`, `onSelectOutcome`, `getEventHref`, `LinkComponent`, `onHover` | Container that wires `useEventsV2` data to `EventsV2UI`.                                                                |
+| `EventsV2UI`         | `events`, `hasMore`, `onFetchMore`, `onSelect`, `onSelectOutcome`, `getEventHref`, `LinkComponent`, `onHover`                         | Virtualized grid (react-window) rendering `EventItemV2UI` cards.                                                        |
+| `EventItemV2UI`      | `event`, `href`, `LinkComponent`, `onSelect`, `onSelectOutcome`, `onHover`                                                            | Single event card. Uses `Linkable` from `@liberfi.io/ui` — renders as a `<Link>` when `href` is set, `<div>` otherwise. |
+| `CategoriesWidgetV2` | `onSelect`, `trailing`                                                                                                                | Category/tag navigation (slug-based).                                                                                   |
+
+#### Link integration props
+
+These props enable framework-agnostic route link rendering and prefetching:
+
+- **`getEventHref?: (event: V2Event) => string`** — Generates the URL for each event card. When provided, cards render as link elements instead of plain divs.
+- **`LinkComponent?: LinkComponentType`** — A custom link component (e.g. `next/link`). Falls back to `<a>` when `href` is set without this prop. Import `LinkComponentType` from `@liberfi.io/ui`.
+- **`onHover?: (event: V2Event) => void`** — Called when a card is hovered (`onMouseEnter`). Use this to trigger data prefetching (e.g. `queryClient.prefetchQuery`).
+
+### Components — Event Detail
+
+| Component             | Key Props                                                               | Description                                          |
+| --------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------- |
+| `EventDetailPage`     | `eventId`, `onTradeAction`                                              | Full detail page composing detail + trade form.      |
+| `EventDetailWidget`   | `eventId`, `initialMarketTickers`, `initialChartRange`, `onTradeAction` | Event detail with candlestick chart and market list. |
+| `EventDetailUI`       | `event`, `series`, `candlesticks`, `chartRange`, ...                    | Pure presentation for event detail.                  |
+| `EventDetailSkeleton` | `marketCount?`                                                          | Loading skeleton for the detail page.                |
+
+### Components — Trading
+
+| Component            | Description                                          |
+| -------------------- | ---------------------------------------------------- |
+| `TradeFormWidget`    | Trade form wiring (market, side, amount, execution). |
+| `OrderBookWidget`    | Live order book with depth visualization.            |
+| `OpenOrdersWidget`   | User's open orders with cancel support.              |
+| `TradeHistoryWidget` | Recent trade history.                                |
+| `PositionsWidget`    | User's prediction market positions.                  |
+
+### Hooks — Events
+
+| Hook                     | Params                       | Return                  | Description                                    |
+| ------------------------ | ---------------------------- | ----------------------- | ---------------------------------------------- |
+| `useEventsV2`            | `UseEventsV2Params`          | `UseEventsV2Result`     | V2 infinite-scroll events list (cursor-based). |
+| `useEventByIdQuery`      | `{ id, withNestedMarkets? }` | TanStack Query result   | Single event by ID/slug.                       |
+| `useEventsQuery`         | `EventQueryParams`           | TanStack Query result   | Legacy paginated events.                       |
+| `useEventsInfiniteQuery` | `EventQueryParams`           | TanStack infinite query | Legacy infinite-scroll events.                 |
+
+### Hooks — Markets & Data
+
+| Hook                                                      | Description                     |
+| --------------------------------------------------------- | ------------------------------- |
+| `useMarketsQuery`                                         | Markets by event.               |
+| `useMarketByIdQuery`                                      | Single market by ticker.        |
+| `useMarketByMintQuery`                                    | Market lookup by mint address.  |
+| `useMarketsBatchQuery`                                    | Batch market lookup.            |
+| `useOrderBookQuery`                                       | Order book for a market.        |
+| `useTradesQuery`                                          | Recent trades.                  |
+| `useOnchainTradesQuery` / `useOnchainTradesInfiniteQuery` | On-chain trade history.         |
+| `usePriceHistoryQuery`                                    | Candlestick data.               |
+| `useForecastHistoryQuery`                                 | AI forecast percentile history. |
+| `useLiveDataQuery`                                        | Real-time market data.          |
+| `useSeriesQuery`                                          | Series metadata.                |
+| `useCategoriesQuery`                                      | Tag/category list.              |
+| `useSearchQuery`                                          | Search events.                  |
+
+### Hooks — User & Trading
+
+| Hook                        | Description                      |
+| --------------------------- | -------------------------------- |
+| `usePositionsByWalletQuery` | User positions by wallet.        |
+| `useMarketPositions`        | Positions for a specific market. |
+| `useQuoteQuery`             | Trade quote.                     |
+| `useSwapMutation`           | Execute a swap/trade.            |
+| `useOrderQuery`             | Place a limit order.             |
+| `useIntentQuery`            | Intent-based trading.            |
+| `useOutcomeMintsQuery`      | Outcome token mints.             |
+| `useTokensQuery`            | Token list.                      |
+| `useVenuesQuery`            | Venue list.                      |
+
+### Hooks — WebSocket
+
+| Hook                       | Description                               |
+| -------------------------- | ----------------------------------------- |
+| `useWsConnection`          | WebSocket connection lifecycle.           |
+| `useWsClient`              | Access the WS client instance.            |
+| `usePricesSubscription`    | Subscribe to real-time price updates.     |
+| `useTradesSubscription`    | Subscribe to real-time trade updates.     |
+| `useOrderbookSubscription` | Subscribe to real-time orderbook updates. |
+
+### Hooks — V2
+
+| Hook                 | Description                             |
+| -------------------- | --------------------------------------- |
+| `usePredictV2Client` | Access the v2 prediction-server client. |
+| `useEventsV2Query`   | V2 events query (single page).          |
+| `useEventV2Query`    | V2 single event query.                  |
+
+### Functions / Utilities
+
+| Function                     | Signature                                                                             | Description                                                                         |
+| ---------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `eventByIdQueryKey`          | `(params: UseEventByIdQueryParams) => unknown[]`                                      | Stable query key for `useEventByIdQuery`. Useful for prefetching.                   |
+| `fetchEventById`             | `(client: IPredictClient, params: UseEventByIdQueryParams) => Promise<StandardEvent>` | Standalone fetch function for event detail. Useful for `queryClient.prefetchQuery`. |
+| `marketCandlesticksQueryKey` | `(params) => unknown[]`                                                               | Query key for candlestick data.                                                     |
+| `fetchMarketCandlesticks`    | `(client, params) => Promise<CandlesticksResponse>`                                   | Standalone candlestick fetch.                                                       |
+| `createPredictClientV2`      | `(baseURL: string) => PredictClientV2`                                                | Factory for the v2 client.                                                          |
+| `createPredictWsClient`      | `(config: WsClientConfig) => PredictWsClient`                                         | Factory for the WebSocket client.                                                   |
+
+### Key Types
+
+| Type               | Description                                               |
+| ------------------ | --------------------------------------------------------- | ---- | ---- | ------ |
+| `V2Event`          | V2 event with markets, metadata, and volume.              |
+| `V2Market`         | V2 market with outcomes, status, and pricing.             |
+| `StandardEvent`    | Legacy event model.                                       |
+| `StandardMarket`   | Legacy market model.                                      |
+| `IPredictClient`   | Interface for the prediction API client.                  |
+| `IPredictWsClient` | Interface for the WebSocket client.                       |
+| `TagSlugSelection` | Category/tag selection state `{ categorySlug, tagSlug }`. |
+| `ChartRangeType`   | `"1d"                                                     | "1w" | "1m" | "all"` |
+
+### Constants
+
+| Constant                    | Value                                   | Description                          |
+| --------------------------- | --------------------------------------- | ------------------------------------ |
+| `DEFAULT_PAGE_SIZE`         | 48                                      | Default events per page.             |
+| `MAX_PRICE_HISTORY_MARKETS` | 4                                       | Max markets for candlestick queries. |
+| `ChartRange`                | `{ ONE_DAY, ONE_WEEK, ONE_MONTH, ALL }` | Chart time range enum.               |
+| `CandlestickPeriod`         | `{ ONE_MINUTE, ONE_HOUR, ONE_DAY }`     | Candlestick granularity.             |
+
+## Usage Examples
+
+### Basic event list with Next.js Link prefetching
+
+```tsx
+import { useCallback } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import {
+  EventsPageV2,
+  eventByIdQueryKey,
+  fetchEventById,
+  usePredictClient,
+} from "@liberfi.io/ui-predict";
+import type { V2Event } from "@liberfi.io/ui-predict";
+
+function PredictListPage() {
+  const router = useRouter();
+  const queryClient = useQueryClient();
+  const predictClient = usePredictClient();
+
+  // TanStack Query data prefetch on hover
+  const handleHover = useCallback(
+    (event: V2Event) => {
+      queryClient.prefetchQuery({
+        queryKey: eventByIdQueryKey({
+          id: event.slug,
+          withNestedMarkets: true,
+        }),
+        queryFn: () =>
+          fetchEventById(predictClient, {
+            id: event.slug,
+            withNestedMarkets: true,
+          }),
+        staleTime: 30_000,
+      });
+    },
+    [queryClient, predictClient],
+  );
+
+  return (
+    <EventsPageV2
+      getEventHref={(event) => `/predict/${event.slug}`}
+      LinkComponent={Link}
+      onHover={handleHover}
+      onSelect={(event) => router.push(`/predict/${event.slug}`)}
+    />
+  );
+}
+```
+
+### Event list without Link (callback-only, backward compatible)
+
+```tsx
+import { EventsPageV2 } from "@liberfi.io/ui-predict";
+
+function PredictListPage() {
+  return (
+    <EventsPageV2
+      onSelect={(event) => console.log("selected", event.slug)}
+      onSelectOutcome={(event, market, side) =>
+        console.log("outcome", event.slug, market.slug, side)
+      }
+    />
+  );
+}
+```
+
+### Provider setup
+
+```tsx
+import {
+  PredictProvider,
+  PredictV2Provider,
+  PredictClient,
+  createPredictClientV2,
+} from "@liberfi.io/ui-predict";
+
+const legacyClient = new PredictClient("https://api.example.com");
+const v2Client = createPredictClientV2("https://predict-v2.example.com");
+
+function App({ children }) {
+  return (
+    <PredictProvider client={legacyClient}>
+      <PredictV2Provider client={v2Client}>{children}</PredictV2Provider>
+    </PredictProvider>
+  );
+}
+```
+
+## Future Improvements
+
+- Migrate remaining v1 components (events list, categories) to v2 client, then deprecate v1 hooks and types.
+- Add `onHover` callback support to `EventDetailWidget` for prefetching related series/candlestick data.
+- Consider a `usePrefetchEventDetail` convenience hook that combines route prefetch + query prefetch in one call.
+- Extract common virtualized grid logic (`EventsV2UI` pattern) into a shared `@liberfi.io/ui` component for reuse in token lists and channel lists.

package/dist/client/index.d.mts

@@ -1 +1 @@
-export { aR as BasePredictClient, aU as DflowPredictClient, aV as DflowPredictWsClient, aU as PredictClient, P as PredictClientV2, aV as PredictWsClient, c as V2Event, V as V2EventSortField, e as V2EventStatus, k as V2ListEventsParams, d as V2Market, aZ as V2MarketResult, a_ as V2MarketStatus, a$ as V2Outcome, l as V2Page, b0 as V2ProviderMeta, b as V2ProviderSource, b1 as V2SettlementSource, b2 as V2Tag, aX as WsClientConfig, aS as buildQuery, aW as createDflowPredictWsClient, aY as createPredictClientV2, aW as createPredictWsClient, aT as toRecord } from '../index-DIcC-37S.mjs';
+export { aR as BasePredictClient, aU as DflowPredictClient, aV as DflowPredictWsClient, aU as PredictClient, P as PredictClientV2, aV as PredictWsClient, c as V2Event, V as V2EventSortField, e as V2EventStatus, l as V2ListEventsParams, d as V2Market, aZ as V2MarketResult, a_ as V2MarketStatus, a$ as V2Outcome, j as V2Page, b0 as V2ProviderMeta, b as V2ProviderSource, b1 as V2SettlementSource, b2 as V2Tag, aX as WsClientConfig, aS as buildQuery, aW as createDflowPredictWsClient, aY as createPredictClientV2, aW as createPredictWsClient, aT as toRecord } from '../index-DcarFHcQ.mjs';

package/dist/client/index.d.ts

@@ -1 +1 @@
-export { aR as BasePredictClient, aU as DflowPredictClient, aV as DflowPredictWsClient, aU as PredictClient, P as PredictClientV2, aV as PredictWsClient, c as V2Event, V as V2EventSortField, e as V2EventStatus, k as V2ListEventsParams, d as V2Market, aZ as V2MarketResult, a_ as V2MarketStatus, a$ as V2Outcome, l as V2Page, b0 as V2ProviderMeta, b as V2ProviderSource, b1 as V2SettlementSource, b2 as V2Tag, aX as WsClientConfig, aS as buildQuery, aW as createDflowPredictWsClient, aY as createPredictClientV2, aW as createPredictWsClient, aT as toRecord } from '../index-DIcC-37S.js';
+export { aR as BasePredictClient, aU as DflowPredictClient, aV as DflowPredictWsClient, aU as PredictClient, P as PredictClientV2, aV as PredictWsClient, c as V2Event, V as V2EventSortField, e as V2EventStatus, l as V2ListEventsParams, d as V2Market, aZ as V2MarketResult, a_ as V2MarketStatus, a$ as V2Outcome, j as V2Page, b0 as V2ProviderMeta, b as V2ProviderSource, b1 as V2SettlementSource, b2 as V2Tag, aX as WsClientConfig, aS as buildQuery, aW as createDflowPredictWsClient, aY as createPredictClientV2, aW as createPredictWsClient, aT as toRecord } from '../index-DcarFHcQ.js';

package/dist/{index-DIcC-37S.d.mts → index-DcarFHcQ.d.mts}

@@ -1601,4 +1601,4 @@ declare class DflowPredictWsClient implements IPredictWsClient {
  */
 declare function createDflowPredictWsClient(config: WsClientConfig): DflowPredictWsClient;
 
-export { type QuoteResponse as $, type LiveDataByEventQueryParams as A, type LiveDataByMintQueryParams as B, type CandlesticksResponse as C, type SeriesQueryParams as D, type EventQueryParams as E, type ForecastPercentileHistoryQueryParams as F, type SeriesListResponse as G, type TagsByCategoriesResponse as H, type IPredictClient as I, type FiltersBySportsResponse as J, type SearchQueryParams as K, type LiveDataQueryParams as L, type MarketQueryParams as M, type SearchResponse as N, type OrderResponse as O, PredictClientV2 as P, type PositionsByWalletQueryParams as Q, type WalletPositionsResponse as R, type StandardEvent as S, type TradesQueryParams as T, type OutcomeMintsQueryParams as U, type V2EventSortField as V, type WalletPositionItem as W, type OutcomeMintsResponse as X, type FilterOutcomeMintsRequest as Y, type FilterOutcomeMintsResponse as Z, type QuoteQueryParams as _, type StandardMarket as a, type V2Outcome as a$, type SwapRequestBody as a0, type SwapResponse as a1, type SwapInstructionsResponse as a2, type OrderQueryParams as a3, type OrderStatusQueryParams as a4, type IntentQuoteQueryParams as a5, type IntentQuoteResponse as a6, type IntentSwapRequestBody as a7, type IntentSwapResponse as a8, type PredictionMarketInitQueryParams as a9, type RoutePlanLeg as aA, type PlatformFee as aB, type ComputeBudgetInfo as aC, type PrioritizationType as aD, type AccountMetaResponse as aE, type InstructionResponse as aF, type BlockhashWithMetadata as aG, type OrderFill as aH, type OrderRevert as aI, type IntentExpiry as aJ, type TokenWithDecimals as aK, type OrderbookQueryParams as aL, type PrioritizationFeeLamports as aM, type DestinationTokenAccountParam as aN, type CreateFeeAccountParams as aO, type PositiveSlippageParams as aP, type WsSubscribeOptions as aQ, BasePredictClient as aR, buildQuery as aS, toRecord as aT, DflowPredictClient as aU, DflowPredictWsClient as aV, createDflowPredictWsClient as aW, type WsClientConfig as aX, createPredictClientV2 as aY, type V2MarketResult as aZ, type V2MarketStatus as a_, type PredictionMarketInitResponse as aa, type TokenListResponse as ab, type TokenListWithDecimalsResponse as ac, type VenueListResponse as ad, type WsConnectionStatus as ae, type WsPriceUpdate as af, type WsTradeUpdate as ag, type WsOrderbookUpdate as ah, type ProviderType as ai, type MarketStatus as aj, type SortField as ak, type SortOrder as al, type OrderStatus as am, type PlatformFeeMode as an, type SlippageTolerance as ao, type PriorityLevel as ap, type ExecutionMode as aq, type SettlementSource as ar, type MarketAccountInfo as as, type OnchainTrade as at, type OnchainTradeSortBy as au, type OnchainTradesBaseQueryParams as av, type CandlestickOHLC as aw, type CandlestickDataPoint as ax, type ForecastPercentileDataPoint as ay, type SeriesSettlementSource as az, type V2ProviderSource as b, type V2ProviderMeta as b0, type V2SettlementSource as b1, type V2Tag as b2, type V2Event as c, type V2Market as d, type V2EventStatus as e, type OrderStatusResponse as f, type SeriesResponse as g, type OrderbookLevel as h, type SingleTradeResponse as i, type IPredictWsClient as j, type V2ListEventsParams as k, type V2Page as l, type StandardEventsResponse as m, type StandardMarketsResponse as n, type MarketsBatchRequest as o, type OrderbookResponse as p, type MultiTradeResponse as q, type TradesByMintQueryParams as r, type OnchainTradesByWalletQueryParams as s, type MultiOnchainTradeResponse as t, type OnchainTradesByEventQueryParams as u, type OnchainTradesByMarketQueryParams as v, type CandlesticksQueryParams as w, type ForecastPercentileHistoryResponse as x, type ForecastPercentileHistoryByMintQueryParams as y, type LiveDataResponse as z };
+export { type QuoteResponse as $, type LiveDataByEventQueryParams as A, type LiveDataByMintQueryParams as B, type CandlesticksResponse as C, type SeriesQueryParams as D, type EventQueryParams as E, type ForecastPercentileHistoryQueryParams as F, type SeriesListResponse as G, type TagsByCategoriesResponse as H, type IPredictClient as I, type FiltersBySportsResponse as J, type SearchQueryParams as K, type LiveDataQueryParams as L, type MarketQueryParams as M, type SearchResponse as N, type OrderResponse as O, PredictClientV2 as P, type PositionsByWalletQueryParams as Q, type WalletPositionsResponse as R, type StandardEvent as S, type TradesQueryParams as T, type OutcomeMintsQueryParams as U, type V2EventSortField as V, type WalletPositionItem as W, type OutcomeMintsResponse as X, type FilterOutcomeMintsRequest as Y, type FilterOutcomeMintsResponse as Z, type QuoteQueryParams as _, type StandardMarket as a, type V2Outcome as a$, type SwapRequestBody as a0, type SwapResponse as a1, type SwapInstructionsResponse as a2, type OrderQueryParams as a3, type OrderStatusQueryParams as a4, type IntentQuoteQueryParams as a5, type IntentQuoteResponse as a6, type IntentSwapRequestBody as a7, type IntentSwapResponse as a8, type PredictionMarketInitQueryParams as a9, type RoutePlanLeg as aA, type PlatformFee as aB, type ComputeBudgetInfo as aC, type PrioritizationType as aD, type AccountMetaResponse as aE, type InstructionResponse as aF, type BlockhashWithMetadata as aG, type OrderFill as aH, type OrderRevert as aI, type IntentExpiry as aJ, type TokenWithDecimals as aK, type OrderbookQueryParams as aL, type PrioritizationFeeLamports as aM, type DestinationTokenAccountParam as aN, type CreateFeeAccountParams as aO, type PositiveSlippageParams as aP, type WsSubscribeOptions as aQ, BasePredictClient as aR, buildQuery as aS, toRecord as aT, DflowPredictClient as aU, DflowPredictWsClient as aV, createDflowPredictWsClient as aW, type WsClientConfig as aX, createPredictClientV2 as aY, type V2MarketResult as aZ, type V2MarketStatus as a_, type PredictionMarketInitResponse as aa, type TokenListResponse as ab, type TokenListWithDecimalsResponse as ac, type VenueListResponse as ad, type WsConnectionStatus as ae, type WsPriceUpdate as af, type WsTradeUpdate as ag, type WsOrderbookUpdate as ah, type ProviderType as ai, type MarketStatus as aj, type SortField as ak, type SortOrder as al, type OrderStatus as am, type PlatformFeeMode as an, type SlippageTolerance as ao, type PriorityLevel as ap, type ExecutionMode as aq, type SettlementSource as ar, type MarketAccountInfo as as, type OnchainTrade as at, type OnchainTradeSortBy as au, type OnchainTradesBaseQueryParams as av, type CandlestickOHLC as aw, type CandlestickDataPoint as ax, type ForecastPercentileDataPoint as ay, type SeriesSettlementSource as az, type V2ProviderSource as b, type V2ProviderMeta as b0, type V2SettlementSource as b1, type V2Tag as b2, type V2Event as c, type V2Market as d, type V2EventStatus as e, type OrderStatusResponse as f, type SeriesResponse as g, type OrderbookLevel as h, type SingleTradeResponse as i, type V2Page as j, type IPredictWsClient as k, type V2ListEventsParams as l, type StandardEventsResponse as m, type StandardMarketsResponse as n, type MarketsBatchRequest as o, type OrderbookResponse as p, type MultiTradeResponse as q, type TradesByMintQueryParams as r, type OnchainTradesByWalletQueryParams as s, type MultiOnchainTradeResponse as t, type OnchainTradesByEventQueryParams as u, type OnchainTradesByMarketQueryParams as v, type CandlesticksQueryParams as w, type ForecastPercentileHistoryResponse as x, type ForecastPercentileHistoryByMintQueryParams as y, type LiveDataResponse as z };

package/dist/{index-DIcC-37S.d.ts → index-DcarFHcQ.d.ts}

@@ -1601,4 +1601,4 @@ declare class DflowPredictWsClient implements IPredictWsClient {
  */
 declare function createDflowPredictWsClient(config: WsClientConfig): DflowPredictWsClient;
 
-export { type QuoteResponse as $, type LiveDataByEventQueryParams as A, type LiveDataByMintQueryParams as B, type CandlesticksResponse as C, type SeriesQueryParams as D, type EventQueryParams as E, type ForecastPercentileHistoryQueryParams as F, type SeriesListResponse as G, type TagsByCategoriesResponse as H, type IPredictClient as I, type FiltersBySportsResponse as J, type SearchQueryParams as K, type LiveDataQueryParams as L, type MarketQueryParams as M, type SearchResponse as N, type OrderResponse as O, PredictClientV2 as P, type PositionsByWalletQueryParams as Q, type WalletPositionsResponse as R, type StandardEvent as S, type TradesQueryParams as T, type OutcomeMintsQueryParams as U, type V2EventSortField as V, type WalletPositionItem as W, type OutcomeMintsResponse as X, type FilterOutcomeMintsRequest as Y, type FilterOutcomeMintsResponse as Z, type QuoteQueryParams as _, type StandardMarket as a, type V2Outcome as a$, type SwapRequestBody as a0, type SwapResponse as a1, type SwapInstructionsResponse as a2, type OrderQueryParams as a3, type OrderStatusQueryParams as a4, type IntentQuoteQueryParams as a5, type IntentQuoteResponse as a6, type IntentSwapRequestBody as a7, type IntentSwapResponse as a8, type PredictionMarketInitQueryParams as a9, type RoutePlanLeg as aA, type PlatformFee as aB, type ComputeBudgetInfo as aC, type PrioritizationType as aD, type AccountMetaResponse as aE, type InstructionResponse as aF, type BlockhashWithMetadata as aG, type OrderFill as aH, type OrderRevert as aI, type IntentExpiry as aJ, type TokenWithDecimals as aK, type OrderbookQueryParams as aL, type PrioritizationFeeLamports as aM, type DestinationTokenAccountParam as aN, type CreateFeeAccountParams as aO, type PositiveSlippageParams as aP, type WsSubscribeOptions as aQ, BasePredictClient as aR, buildQuery as aS, toRecord as aT, DflowPredictClient as aU, DflowPredictWsClient as aV, createDflowPredictWsClient as aW, type WsClientConfig as aX, createPredictClientV2 as aY, type V2MarketResult as aZ, type V2MarketStatus as a_, type PredictionMarketInitResponse as aa, type TokenListResponse as ab, type TokenListWithDecimalsResponse as ac, type VenueListResponse as ad, type WsConnectionStatus as ae, type WsPriceUpdate as af, type WsTradeUpdate as ag, type WsOrderbookUpdate as ah, type ProviderType as ai, type MarketStatus as aj, type SortField as ak, type SortOrder as al, type OrderStatus as am, type PlatformFeeMode as an, type SlippageTolerance as ao, type PriorityLevel as ap, type ExecutionMode as aq, type SettlementSource as ar, type MarketAccountInfo as as, type OnchainTrade as at, type OnchainTradeSortBy as au, type OnchainTradesBaseQueryParams as av, type CandlestickOHLC as aw, type CandlestickDataPoint as ax, type ForecastPercentileDataPoint as ay, type SeriesSettlementSource as az, type V2ProviderSource as b, type V2ProviderMeta as b0, type V2SettlementSource as b1, type V2Tag as b2, type V2Event as c, type V2Market as d, type V2EventStatus as e, type OrderStatusResponse as f, type SeriesResponse as g, type OrderbookLevel as h, type SingleTradeResponse as i, type IPredictWsClient as j, type V2ListEventsParams as k, type V2Page as l, type StandardEventsResponse as m, type StandardMarketsResponse as n, type MarketsBatchRequest as o, type OrderbookResponse as p, type MultiTradeResponse as q, type TradesByMintQueryParams as r, type OnchainTradesByWalletQueryParams as s, type MultiOnchainTradeResponse as t, type OnchainTradesByEventQueryParams as u, type OnchainTradesByMarketQueryParams as v, type CandlesticksQueryParams as w, type ForecastPercentileHistoryResponse as x, type ForecastPercentileHistoryByMintQueryParams as y, type LiveDataResponse as z };
+export { type QuoteResponse as $, type LiveDataByEventQueryParams as A, type LiveDataByMintQueryParams as B, type CandlesticksResponse as C, type SeriesQueryParams as D, type EventQueryParams as E, type ForecastPercentileHistoryQueryParams as F, type SeriesListResponse as G, type TagsByCategoriesResponse as H, type IPredictClient as I, type FiltersBySportsResponse as J, type SearchQueryParams as K, type LiveDataQueryParams as L, type MarketQueryParams as M, type SearchResponse as N, type OrderResponse as O, PredictClientV2 as P, type PositionsByWalletQueryParams as Q, type WalletPositionsResponse as R, type StandardEvent as S, type TradesQueryParams as T, type OutcomeMintsQueryParams as U, type V2EventSortField as V, type WalletPositionItem as W, type OutcomeMintsResponse as X, type FilterOutcomeMintsRequest as Y, type FilterOutcomeMintsResponse as Z, type QuoteQueryParams as _, type StandardMarket as a, type V2Outcome as a$, type SwapRequestBody as a0, type SwapResponse as a1, type SwapInstructionsResponse as a2, type OrderQueryParams as a3, type OrderStatusQueryParams as a4, type IntentQuoteQueryParams as a5, type IntentQuoteResponse as a6, type IntentSwapRequestBody as a7, type IntentSwapResponse as a8, type PredictionMarketInitQueryParams as a9, type RoutePlanLeg as aA, type PlatformFee as aB, type ComputeBudgetInfo as aC, type PrioritizationType as aD, type AccountMetaResponse as aE, type InstructionResponse as aF, type BlockhashWithMetadata as aG, type OrderFill as aH, type OrderRevert as aI, type IntentExpiry as aJ, type TokenWithDecimals as aK, type OrderbookQueryParams as aL, type PrioritizationFeeLamports as aM, type DestinationTokenAccountParam as aN, type CreateFeeAccountParams as aO, type PositiveSlippageParams as aP, type WsSubscribeOptions as aQ, BasePredictClient as aR, buildQuery as aS, toRecord as aT, DflowPredictClient as aU, DflowPredictWsClient as aV, createDflowPredictWsClient as aW, type WsClientConfig as aX, createPredictClientV2 as aY, type V2MarketResult as aZ, type V2MarketStatus as a_, type PredictionMarketInitResponse as aa, type TokenListResponse as ab, type TokenListWithDecimalsResponse as ac, type VenueListResponse as ad, type WsConnectionStatus as ae, type WsPriceUpdate as af, type WsTradeUpdate as ag, type WsOrderbookUpdate as ah, type ProviderType as ai, type MarketStatus as aj, type SortField as ak, type SortOrder as al, type OrderStatus as am, type PlatformFeeMode as an, type SlippageTolerance as ao, type PriorityLevel as ap, type ExecutionMode as aq, type SettlementSource as ar, type MarketAccountInfo as as, type OnchainTrade as at, type OnchainTradeSortBy as au, type OnchainTradesBaseQueryParams as av, type CandlestickOHLC as aw, type CandlestickDataPoint as ax, type ForecastPercentileDataPoint as ay, type SeriesSettlementSource as az, type V2ProviderSource as b, type V2ProviderMeta as b0, type V2SettlementSource as b1, type V2Tag as b2, type V2Event as c, type V2Market as d, type V2EventStatus as e, type OrderStatusResponse as f, type SeriesResponse as g, type OrderbookLevel as h, type SingleTradeResponse as i, type V2Page as j, type IPredictWsClient as k, type V2ListEventsParams as l, type StandardEventsResponse as m, type StandardMarketsResponse as n, type MarketsBatchRequest as o, type OrderbookResponse as p, type MultiTradeResponse as q, type TradesByMintQueryParams as r, type OnchainTradesByWalletQueryParams as s, type MultiOnchainTradeResponse as t, type OnchainTradesByEventQueryParams as u, type OnchainTradesByMarketQueryParams as v, type CandlesticksQueryParams as w, type ForecastPercentileHistoryResponse as x, type ForecastPercentileHistoryByMintQueryParams as y, type LiveDataResponse as z };

package/dist/index.d.mts

@@ -1,10 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { S as StandardEvent, a as StandardMarket, E as EventQueryParams, V as V2EventSortField, b as V2ProviderSource, c as V2Event, d as V2Market, e as V2EventStatus, O as OrderResponse, f as OrderStatusResponse, g as SeriesResponse, C as CandlesticksResponse, h as OrderbookLevel, i as SingleTradeResponse, I as IPredictClient, j as IPredictWsClient, W as WalletPositionItem, P as PredictClientV2, k as V2ListEventsParams, l as V2Page, m as StandardEventsResponse, M as MarketQueryParams, n as StandardMarketsResponse, o as MarketsBatchRequest, p as OrderbookResponse, T as TradesQueryParams, q as MultiTradeResponse, r as TradesByMintQueryParams, s as OnchainTradesByWalletQueryParams, t as MultiOnchainTradeResponse, u as OnchainTradesByEventQueryParams, v as OnchainTradesByMarketQueryParams, w as CandlesticksQueryParams, F as ForecastPercentileHistoryQueryParams, x as ForecastPercentileHistoryResponse, y as ForecastPercentileHistoryByMintQueryParams, L as LiveDataQueryParams, z as LiveDataResponse, A as LiveDataByEventQueryParams, B as LiveDataByMintQueryParams, D as SeriesQueryParams, G as SeriesListResponse, H as TagsByCategoriesResponse, J as FiltersBySportsResponse, K as SearchQueryParams, N as SearchResponse, Q as PositionsByWalletQueryParams, R as WalletPositionsResponse, U as OutcomeMintsQueryParams, X as OutcomeMintsResponse, Y as FilterOutcomeMintsRequest, Z as FilterOutcomeMintsResponse, _ as QuoteQueryParams, $ as QuoteResponse, a0 as SwapRequestBody, a1 as SwapResponse, a2 as SwapInstructionsResponse, a3 as OrderQueryParams, a4 as OrderStatusQueryParams, a5 as IntentQuoteQueryParams, a6 as IntentQuoteResponse, a7 as IntentSwapRequestBody, a8 as IntentSwapResponse, a9 as PredictionMarketInitQueryParams, aa as PredictionMarketInitResponse, ab as TokenListResponse, ac as TokenListWithDecimalsResponse, ad as VenueListResponse, ae as WsConnectionStatus, af as WsPriceUpdate, ag as WsTradeUpdate, ah as WsOrderbookUpdate } from './index-DIcC-37S.mjs';
-export { aE as AccountMetaResponse, aR as BasePredictClient, aG as BlockhashWithMetadata, ax as CandlestickDataPoint, aw as CandlestickOHLC, aC as ComputeBudgetInfo, aO as CreateFeeAccountParams, aN as DestinationTokenAccountParam, aU as DflowPredictClient, aV as DflowPredictWsClient, aq as ExecutionMode, ay as ForecastPercentileDataPoint, aF as InstructionResponse, aJ as IntentExpiry, as as MarketAccountInfo, aj as MarketStatus, at as OnchainTrade, au as OnchainTradeSortBy, av as OnchainTradesBaseQueryParams, aH as OrderFill, aI as OrderRevert, am as OrderStatus, aL as OrderbookQueryParams, aB as PlatformFee, an as PlatformFeeMode, aP as PositiveSlippageParams, aU as PredictClient, aV as PredictWsClient, aM as PrioritizationFeeLamports, aD as PrioritizationType, ap as PriorityLevel, ai as ProviderType, aA as RoutePlanLeg, az as SeriesSettlementSource, ar as SettlementSource, ao as SlippageTolerance, ak as SortField, al as SortOrder, aK as TokenWithDecimals, aZ as V2MarketResult, a_ as V2MarketStatus, a$ as V2Outcome, b0 as V2ProviderMeta, b1 as V2SettlementSource, b2 as V2Tag, aX as WsClientConfig, aQ as WsSubscribeOptions, aS as buildQuery, aW as createDflowPredictWsClient, aY as createPredictClientV2, aW as createPredictWsClient, aT as toRecord } from './index-DIcC-37S.mjs';
-import * as react from 'react';
-import { PropsWithChildren } from 'react';
+import { S as StandardEvent, a as StandardMarket, E as EventQueryParams, V as V2EventSortField, b as V2ProviderSource, c as V2Event, d as V2Market, e as V2EventStatus, O as OrderResponse, f as OrderStatusResponse, g as SeriesResponse, C as CandlesticksResponse, h as OrderbookLevel, i as SingleTradeResponse, j as V2Page, I as IPredictClient, k as IPredictWsClient, W as WalletPositionItem, P as PredictClientV2, l as V2ListEventsParams, m as StandardEventsResponse, M as MarketQueryParams, n as StandardMarketsResponse, o as MarketsBatchRequest, p as OrderbookResponse, T as TradesQueryParams, q as MultiTradeResponse, r as TradesByMintQueryParams, s as OnchainTradesByWalletQueryParams, t as MultiOnchainTradeResponse, u as OnchainTradesByEventQueryParams, v as OnchainTradesByMarketQueryParams, w as CandlesticksQueryParams, F as ForecastPercentileHistoryQueryParams, x as ForecastPercentileHistoryResponse, y as ForecastPercentileHistoryByMintQueryParams, L as LiveDataQueryParams, z as LiveDataResponse, A as LiveDataByEventQueryParams, B as LiveDataByMintQueryParams, D as SeriesQueryParams, G as SeriesListResponse, H as TagsByCategoriesResponse, J as FiltersBySportsResponse, K as SearchQueryParams, N as SearchResponse, Q as PositionsByWalletQueryParams, R as WalletPositionsResponse, U as OutcomeMintsQueryParams, X as OutcomeMintsResponse, Y as FilterOutcomeMintsRequest, Z as FilterOutcomeMintsResponse, _ as QuoteQueryParams, $ as QuoteResponse, a0 as SwapRequestBody, a1 as SwapResponse, a2 as SwapInstructionsResponse, a3 as OrderQueryParams, a4 as OrderStatusQueryParams, a5 as IntentQuoteQueryParams, a6 as IntentQuoteResponse, a7 as IntentSwapRequestBody, a8 as IntentSwapResponse, a9 as PredictionMarketInitQueryParams, aa as PredictionMarketInitResponse, ab as TokenListResponse, ac as TokenListWithDecimalsResponse, ad as VenueListResponse, ae as WsConnectionStatus, af as WsPriceUpdate, ag as WsTradeUpdate, ah as WsOrderbookUpdate } from './index-DcarFHcQ.mjs';
+export { aE as AccountMetaResponse, aR as BasePredictClient, aG as BlockhashWithMetadata, ax as CandlestickDataPoint, aw as CandlestickOHLC, aC as ComputeBudgetInfo, aO as CreateFeeAccountParams, aN as DestinationTokenAccountParam, aU as DflowPredictClient, aV as DflowPredictWsClient, aq as ExecutionMode, ay as ForecastPercentileDataPoint, aF as InstructionResponse, aJ as IntentExpiry, as as MarketAccountInfo, aj as MarketStatus, at as OnchainTrade, au as OnchainTradeSortBy, av as OnchainTradesBaseQueryParams, aH as OrderFill, aI as OrderRevert, am as OrderStatus, aL as OrderbookQueryParams, aB as PlatformFee, an as PlatformFeeMode, aP as PositiveSlippageParams, aU as PredictClient, aV as PredictWsClient, aM as PrioritizationFeeLamports, aD as PrioritizationType, ap as PriorityLevel, ai as ProviderType, aA as RoutePlanLeg, az as SeriesSettlementSource, ar as SettlementSource, ao as SlippageTolerance, ak as SortField, al as SortOrder, aK as TokenWithDecimals, aZ as V2MarketResult, a_ as V2MarketStatus, a$ as V2Outcome, b0 as V2ProviderMeta, b1 as V2SettlementSource, b2 as V2Tag, aX as WsClientConfig, aQ as WsSubscribeOptions, aS as buildQuery, aW as createDflowPredictWsClient, aY as createPredictClientV2, aW as createPredictWsClient, aT as toRecord } from './index-DcarFHcQ.mjs';
+import { LinkComponentType } from '@liberfi.io/ui';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseInfiniteQueryOptions, InfiniteData, UseMutationOptions } from '@tanstack/react-query';
+import * as react from 'react';
+import { PropsWithChildren } from 'react';
 
 declare global {
     interface Window {
@@ -13,7 +14,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.53";
+declare const _default: "0.1.55";
 
 interface EventsPageProps {
     /** Callback when an event is selected */
@@ -213,8 +214,14 @@ interface EventsPageV2Props {
     onSelect?: (event: V2Event) => void;
     /** Callback when an outcome button (yes / no) is pressed */
     onSelectOutcome?: (event: V2Event, market: V2Market, side: "yes" | "no") => void;
+    /** Generate href for each event card. When set, cards render as links. */
+    getEventHref?: (event: V2Event) => string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    /** Called when a card is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
 }
-declare function EventsPageV2({ onSelect, onSelectOutcome }: EventsPageV2Props): react_jsx_runtime.JSX.Element;
+declare function EventsPageV2({ onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, }: EventsPageV2Props): react_jsx_runtime.JSX.Element;
 
 interface EventsWidgetV2Props {
     /**
@@ -238,8 +245,14 @@ interface EventsWidgetV2Props {
     onSelect?: (event: V2Event) => void;
     /** Callback when an outcome button (yes/no) is pressed */
     onSelectOutcome?: (event: V2Event, market: V2Market, side: "yes" | "no") => void;
+    /** Generate href for each event card. When set, cards render as links. */
+    getEventHref?: (event: V2Event) => string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    /** Called when a card is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
 }
-declare function EventsWidgetV2({ tagSlugSelection, limit, status, sort_by, sort_asc, source, with_markets, onSelect, onSelectOutcome, }: EventsWidgetV2Props): react_jsx_runtime.JSX.Element;
+declare function EventsWidgetV2({ tagSlugSelection, limit, status, sort_by, sort_asc, source, with_markets, onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, }: EventsWidgetV2Props): react_jsx_runtime.JSX.Element;
 
 /** Parameters for useEventsV2 */
 interface UseEventsV2Params {
@@ -313,15 +326,27 @@ type EventsV2UIProps = {
     onSelect?: (event: V2Event) => void;
     /** Callback when an outcome button (yes/no) is pressed */
     onSelectOutcome?: (event: V2Event, market: V2Market, side: "yes" | "no") => void;
+    /** Generate href for each event card. When set, cards render as links. */
+    getEventHref?: (event: V2Event) => string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    /** Called when a card is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
 };
-declare function EventsV2UI({ events, hasMore, onFetchMore, onSelect, onSelectOutcome, }: EventsV2UIProps): react_jsx_runtime.JSX.Element;
+declare function EventsV2UI({ events, hasMore, onFetchMore, onSelect, onSelectOutcome, getEventHref, LinkComponent, onHover, }: EventsV2UIProps): react_jsx_runtime.JSX.Element;
 
 type EventItemV2UIProps = {
     event: V2Event;
+    /** URL for the detail page. When set, card renders as a link via Linkable. */
+    href?: string;
+    /** Custom link component (e.g. next/link). Passed to Linkable. */
+    LinkComponent?: LinkComponentType;
     onSelect?: (event: V2Event) => void;
     onSelectOutcome?: (event: V2Event, market: V2Market, side: "yes" | "no") => void;
+    /** Called when the card is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
 };
-declare function EventItemV2UI({ event, onSelect, onSelectOutcome, }: EventItemV2UIProps): react_jsx_runtime.JSX.Element;
+declare function EventItemV2UI({ event, href, LinkComponent, onSelect, onSelectOutcome, onHover, }: EventItemV2UIProps): react_jsx_runtime.JSX.Element;
 
 /** Default page size for list queries */
 declare const DEFAULT_PAGE_SIZE = 48;
@@ -944,6 +969,128 @@ interface CategoriesWidgetV2Props {
 }
 declare function CategoriesWidgetV2({ onSelect, trailing, className, }: CategoriesWidgetV2Props): react_jsx_runtime.JSX.Element;
 
+type PredictSearchModalParams = {
+    /** Generate href for each event row. When set, rows render as links. */
+    getEventHref?: (event: V2Event) => string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    /** Called when a row is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
+};
+type PredictSearchModalResult = V2Event;
+declare const PREDICT_SEARCH_MODAL_ID = "predict-search";
+declare function PredictSearchModal({ id, }: {
+    id?: string;
+}): react_jsx_runtime.JSX.Element;
+
+type SearchEventsButtonProps = {
+    /** Callback when an event is selected from the search modal */
+    onSelectEvent?: (event: V2Event) => void;
+    /** Params forwarded to the search modal (getEventHref, LinkComponent, onHover) */
+    modalParams?: Omit<PredictSearchModalParams, never>;
+    className?: string;
+};
+declare function SearchEventsButton({ onSelectEvent, modalParams, className, }: SearchEventsButtonProps): react_jsx_runtime.JSX.Element;
+
+declare function usePredictSearchHistory(): {
+    histories: string[];
+    addHistory: (keyword: string) => void;
+    clearHistories: () => void;
+};
+
+type SearchHistoryUIProps = {
+    histories: string[];
+    onSelect?: (keyword: string) => void;
+    onClear?: () => void;
+    className?: string;
+};
+declare function SearchHistoryUI({ histories, onSelect, onClear, className, }: SearchHistoryUIProps): react_jsx_runtime.JSX.Element | null;
+
+type SearchHistoryWidgetProps = {
+    /** Callback when a history keyword is selected */
+    onSelect?: (keyword: string) => void;
+    className?: string;
+};
+declare function SearchHistoryWidget({ onSelect, className, }: SearchHistoryWidgetProps): react_jsx_runtime.JSX.Element;
+
+type SearchInputUIProps = {
+    /** Controlled input value */
+    value: string;
+    /** Called on every keystroke */
+    onValueChange: (value: string) => void;
+    /** Called when clear button is pressed */
+    onClear?: () => void;
+    /** Called when Esc button is pressed */
+    onEscape?: () => void;
+    className?: string;
+};
+declare function SearchInputUI({ value, onValueChange, onClear, onEscape, className, }: SearchInputUIProps): react_jsx_runtime.JSX.Element;
+
+type SearchResultItemUIProps = {
+    event: V2Event;
+    /** URL for the detail page. When set, the row renders as a link via Linkable. */
+    href?: string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    onSelect?: (event: V2Event) => void;
+    /** Called when the row is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
+    className?: string;
+};
+declare function SearchResultItemUI({ event, href, LinkComponent, onSelect, onHover, className, }: SearchResultItemUIProps): react_jsx_runtime.JSX.Element;
+
+interface UseSearchResultListScriptParams {
+    keyword: string;
+    limit?: number;
+}
+declare function useSearchResultListScript({ keyword, limit, }: UseSearchResultListScriptParams): {
+    events: V2Event[];
+    isLoading: boolean;
+    isFetchingNextPage: boolean;
+    hasNextPage: boolean;
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<V2Page<V2Event>, unknown>, Error>>;
+};
+
+type SearchResultListWidgetProps = {
+    onSelect?: (event: V2Event) => void;
+    /** Generate href for each event row. When set, rows render as links. */
+    getEventHref?: (event: V2Event) => string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    /** Called when a row is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
+    className?: string;
+} & UseSearchResultListScriptParams;
+declare function SearchResultListWidget({ onSelect, getEventHref, LinkComponent, onHover, className, ...scriptParams }: SearchResultListWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface UseSearchScriptParams {
+    /** Callback when the debounced keyword changes */
+    onKeywordChange?: (keyword: string) => void;
+}
+declare function useSearchScript({ onKeywordChange }: UseSearchScriptParams): {
+    text: string;
+    keyword: string;
+    setText: (v: string) => void;
+    setKeyword: (value: string) => void;
+    clearKeyword: () => void;
+};
+
+type SearchWidgetProps = {
+    /** Callback when the debounced keyword changes */
+    onKeywordChange?: (keyword: string) => void;
+    /** Callback when an event is selected */
+    onSelectEvent?: (event: V2Event) => void;
+    /** Generate href for each event row. When set, rows render as links. */
+    getEventHref?: (event: V2Event) => string;
+    /** Custom link component (e.g. next/link). */
+    LinkComponent?: LinkComponentType;
+    /** Called when a row is hovered (for data prefetching). */
+    onHover?: (event: V2Event) => void;
+    /** Called when the Esc button / key is pressed. */
+    onEscape?: () => void;
+};
+declare function SearchWidget({ onKeywordChange, onSelectEvent, getEventHref, LinkComponent, onHover, onEscape, }: SearchWidgetProps): react_jsx_runtime.JSX.Element;
+
 interface PredictContextValue {
     /** The predict API client instance */
     client: IPredictClient;
@@ -1089,6 +1236,33 @@ interface UseEventV2QueryParams {
  */
 declare function useEventV2Query(params: UseEventV2QueryParams, queryOptions?: Omit<UseQueryOptions<V2Event, Error, V2Event, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<V2Event, Error>;
 
+interface UseSearchEventsInfiniteQueryParams {
+    /** Search keyword */
+    keyword: string;
+    /** Page size (default: 20) */
+    limit?: number;
+    /** Event status filter (default: "open") */
+    status?: V2EventStatus;
+    /** Include nested markets (default: false for lighter search payloads) */
+    with_markets?: boolean;
+}
+/**
+ * Infinite query hook for searching prediction events via the V2 `listEvents`
+ * endpoint with a `search` parameter.
+ *
+ * Designed to be consumed by component-level scripts that flatten the paginated
+ * data for rendering.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, hasNextPage, fetchNextPage } =
+ *   useSearchEventsInfiniteQuery({ keyword: "trump" });
+ * ```
+ */
+declare function useSearchEventsInfiniteQuery(params: UseSearchEventsInfiniteQueryParams, queryOptions?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<V2Page<V2Event>, unknown>, Error>;
+
 declare function usePredictContext(): PredictContextValue;
 
 declare function usePredictClient(): IPredictClient;
@@ -1428,4 +1602,4 @@ interface UseOrderbookSubscriptionResult {
  */
 declare function useOrderbookSubscription({ client, all, tickers, enabled, onUpdate, }: UseOrderbookSubscriptionParams): UseOrderbookSubscriptionResult;
 
-export { CATEGORIES_V2, CHART_RANGE_DURATION, CHART_RANGE_PERIOD, CHART_RANGE_SAMPLE_INTERVAL, CandlestickPeriod, type CandlestickPeriodType, CandlesticksQueryParams, CandlesticksResponse, CategoriesSkeleton, CategoriesUI, type CategoriesUIProps, CategoriesWidget, type CategoriesWidgetProps, CategoriesWidgetV2, type CategoriesWidgetV2Props, type CategoryItemV2, type CategorySelection, ChartRange, type ChartRangeType, DEFAULT_CHART_RANGE, DEFAULT_FILTER_STATE, DEFAULT_PAGE_SIZE, DEFAULT_PRICE_HISTORY_INTERVAL, type EventCategory, EventDetailPage, type EventDetailPageProps, EventDetailSkeleton, type EventDetailSkeletonProps, EventDetailUI, type EventDetailUIProps, EventDetailWidget, type EventDetailWidgetProps, EventItemSkeleton, type EventItemSkeletonProps, EventItemUI, type EventItemUIProps, EventItemV2UI, type EventItemV2UIProps, EventMarketDetailWidget, type EventMarketDetailWidgetProps, EventQueryParams, type EventsFilterState, EventsFilterV2UI, type EventsFilterV2UIProps, EventsPage, type EventsPageProps, EventsPageV2, type EventsPageV2Props, EventsSkeleton, type EventsSkeletonProps, EventsToolbarV2UI, type EventsToolbarV2UIProps, EventsUI, type EventsUIProps, EventsV2UI, type EventsV2UIProps, EventsWidget, type EventsWidgetProps, EventsWidgetV2, type EventsWidgetV2Props, FilterOutcomeMintsRequest, FilterOutcomeMintsResponse, FiltersBySportsResponse, ForecastPercentileHistoryByMintQueryParams, ForecastPercentileHistoryQueryParams, ForecastPercentileHistoryResponse, IPredictClient, IPredictWsClient, IntentQuoteQueryParams, IntentQuoteResponse, IntentSwapRequestBody, IntentSwapResponse, LiveDataByEventQueryParams, LiveDataByMintQueryParams, LiveDataQueryParams, LiveDataResponse, MAX_PRICE_HISTORY_MARKETS, type MarketPositionsResult, MarketQueryParams, MarketsBatchRequest, MultiOnchainTradeResponse, MultiTradeResponse, ORDER_MAX_PRICE, ORDER_MIN_PRICE, ORDER_MIN_QUANTITY, ORDER_PRICE_STEP, OnchainTradesByEventQueryParams, OnchainTradesByMarketQueryParams, OnchainTradesByWalletQueryParams, OpenOrdersUI, type OpenOrdersUIProps, OpenOrdersWidget, type OpenOrdersWidgetProps, type Order, type OrderBookRow, OrderBookUI, type OrderBookUIProps, OrderBookWidget, type OrderBookWidgetProps, OrderQueryParams, OrderResponse, OrderStatusQueryParams, OrderStatusResponse, type OrderbookData, OrderbookLevel, OrderbookResponse, OutcomeMintsQueryParams, OutcomeMintsResponse, PRICE_HISTORY_SAMPLE_INTERVAL, type Position, PositionsByWalletQueryParams, type PositionsSummary, PositionsUI, type PositionsUIProps, PositionsWidget, type PositionsWidgetProps, PredictClientV2, PredictContext, type PredictContextValue, PredictProvider, type PredictProviderProps, PredictV2Context, type PredictV2ContextValue, PredictV2Provider, type PredictV2ProviderProps, PredictionMarketInitQueryParams, PredictionMarketInitResponse, type PriceData, PriceHistoryInterval, type PriceHistoryIntervalType, QuoteQueryParams, QuoteResponse, SORT_PRESETS, SearchQueryParams, SearchResponse, SeriesListResponse, SeriesQueryParams, SeriesResponse, SingleTradeResponse, type SortPreset, StandardEvent, StandardEventsResponse, StandardMarket, StandardMarketsResponse, SwapInstructionsResponse, SwapRequestBody, SwapResponse, type TagItemV2, type TagSlugSelection, TagsByCategoriesResponse, TokenListResponse, TokenListWithDecimalsResponse, type TradeData, TradeFormSkeleton, TradeFormUI, type TradeFormUIProps, type TradeFormValidation, TradeFormWidget, type TradeFormWidgetProps, TradeHistoryUI, type TradeHistoryUIProps, TradeHistoryWidget, type TradeHistoryWidgetProps, type TradeOutcome, type TradeSide, TradesByMintQueryParams, TradesQueryParams, type UseEventByIdQueryParams, type UseEventCandlesticksParams, type UseEventDetailParams, type UseEventV2QueryParams, type UseEventsCategoriesResult, type UseEventsParams, type UseEventsResult, type UseEventsV2Params, type UseEventsV2Result, type UseMarketByIdQueryParams, type UseMarketCandlesticksByMintParams, type UseMarketCandlesticksParams, type UseOpenOrdersParams, type UseOpenOrdersResult, type UseOrderBookParams, type UseOrderBookResult, type UseOrderbookSubscriptionParams, type UseOrderbookSubscriptionResult, type UsePositionsParams, type UsePositionsResult, type UsePricesSubscriptionParams, type UsePricesSubscriptionResult, type UseTradeFormParams, type UseTradeFormResult, type UseTradeHistoryParams, type UseTradeHistoryResult, type UseTradesSubscriptionParams, type UseTradesSubscriptionResult, type UseWsClientResult, type UseWsConnectionParams, type UseWsConnectionResult, UserPredictContext, type UserPredictContextValue, UserPredictProvider, type UserPredictProviderProps, V2Event, V2EventSortField, V2EventStatus, V2ListEventsParams, V2Market, V2Page, V2ProviderSource, VenueListResponse, WalletPositionItem, WalletPositionsResponse, WsConnectionStatus, WsOrderbookUpdate, WsPriceUpdate, WsTradeUpdate, countActiveFilters, createSwap, createSwapInstructions, eventByIdQueryKey, eventCandlesticksQueryKey, eventV2QueryKey, eventsInfiniteQueryKey, eventsQueryKey, eventsV2QueryKey, fetchEventById, fetchEventCandlesticks, fetchEventV2, fetchEvents, fetchEventsV2, fetchFiltersBySports, fetchForecastPercentileHistory, fetchForecastPercentileHistoryByMint, fetchIntentQuote, fetchLiveData, fetchLiveDataByEvent, fetchLiveDataByMint, fetchMarketById, fetchMarketByMint, fetchMarketCandlesticks, fetchMarketCandlesticksByMint, fetchMarkets, fetchMarketsBatch, fetchOnchainTradesByEvent, fetchOnchainTradesByMarket, fetchOnchainTradesByWallet, fetchOrder, fetchOrderBook, fetchOrderBookByMint, fetchOrderStatus, fetchOutcomeMints, fetchPositionsByWallet, fetchQuote, fetchSearch, fetchSeries, fetchSeriesByTicker, fetchTagsByCategories, fetchTokens, fetchTokensWithDecimals, fetchTrades, fetchTradesByMint, fetchVenues, filterOutcomeMints, filtersBySportsQueryKey, forecastPercentileHistoryByMintQueryKey, forecastPercentileHistoryQueryKey, initPredictionMarket, intentQuoteQueryKey, liveDataByEventQueryKey, liveDataByMintQueryKey, liveDataQueryKey, marketByIdQueryKey, marketByMintQueryKey, marketCandlesticksByMintQueryKey, marketCandlesticksQueryKey, marketsBatchQueryKey, marketsQueryKey, onchainTradesByEventInfiniteQueryKey, onchainTradesByEventQueryKey, onchainTradesByMarketInfiniteQueryKey, onchainTradesByMarketQueryKey, onchainTradesByWalletInfiniteQueryKey, onchainTradesByWalletQueryKey, orderBookByMintQueryKey, orderBookQueryKey, orderQueryKey, orderStatusQueryKey, outcomeMintsQueryKey, positionsByWalletQueryKey, quoteQueryKey, searchQueryKey, seriesByTickerQueryKey, seriesQueryKey, submitIntentSwap, tagsByCategoriesQueryKey, tokensQueryKey, tokensWithDecimalsQueryKey, tradesByMintQueryKey, tradesQueryKey, useCategoriesQuery, useCreateSwapInstructionsMutation, useCreateSwapMutation, useEventByIdQuery, useEventCandlesticksQuery, useEventDetail, useEventV2Query, useEvents, useEventsCategories, useEventsInfiniteQuery, useEventsQuery, useEventsV2, useEventsV2Query, useFilterOutcomeMintsMutation, useFiltersBySportsQuery, useForecastPercentileHistoryByMintQuery, useForecastPercentileHistoryQuery, useInitPredictionMarketMutation, useIntentQuoteQuery, useLiveDataByEventQuery, useLiveDataByMintQuery, useLiveDataQuery, useMarketByIdQuery, useMarketByMintQuery, useMarketCandlesticksByMintQuery, useMarketCandlesticksQuery, useMarketPositions, useMarketsBatchQuery, useMarketsQuery, useOnchainTradesByEventInfiniteQuery, useOnchainTradesByEventQuery, useOnchainTradesByMarketInfiniteQuery, useOnchainTradesByMarketQuery, useOnchainTradesByWalletInfiniteQuery, useOnchainTradesByWalletQuery, useOpenOrders, useOrderBook, useOrderBookByMintQuery, useOrderBookQuery, useOrderQuery, useOrderStatusQuery, useOrderbookSubscription, useOutcomeMintsQuery, usePositions, usePositionsByWalletQuery, usePredictClient, usePredictContext, usePredictV2Client, usePredictV2Context, usePriceHistoryQuery, usePricesSubscription, useQuoteQuery, useSearchQuery, useSeriesByTickerQuery, useSeriesQuery, useSubmitIntentSwapMutation, useTagsByCategoriesQuery, useTokensQuery, useTokensWithDecimalsQuery, useTradeForm, useTradeHistory, useTradesByMintQuery, useTradesQuery, useTradesSubscription, useUserPredictContext, useVenuesQuery, useWsClient, useWsConnection, venuesQueryKey, _default as version };
+export { CATEGORIES_V2, CHART_RANGE_DURATION, CHART_RANGE_PERIOD, CHART_RANGE_SAMPLE_INTERVAL, CandlestickPeriod, type CandlestickPeriodType, CandlesticksQueryParams, CandlesticksResponse, CategoriesSkeleton, CategoriesUI, type CategoriesUIProps, CategoriesWidget, type CategoriesWidgetProps, CategoriesWidgetV2, type CategoriesWidgetV2Props, type CategoryItemV2, type CategorySelection, ChartRange, type ChartRangeType, DEFAULT_CHART_RANGE, DEFAULT_FILTER_STATE, DEFAULT_PAGE_SIZE, DEFAULT_PRICE_HISTORY_INTERVAL, type EventCategory, EventDetailPage, type EventDetailPageProps, EventDetailSkeleton, type EventDetailSkeletonProps, EventDetailUI, type EventDetailUIProps, EventDetailWidget, type EventDetailWidgetProps, EventItemSkeleton, type EventItemSkeletonProps, EventItemUI, type EventItemUIProps, EventItemV2UI, type EventItemV2UIProps, EventMarketDetailWidget, type EventMarketDetailWidgetProps, EventQueryParams, type EventsFilterState, EventsFilterV2UI, type EventsFilterV2UIProps, EventsPage, type EventsPageProps, EventsPageV2, type EventsPageV2Props, EventsSkeleton, type EventsSkeletonProps, EventsToolbarV2UI, type EventsToolbarV2UIProps, EventsUI, type EventsUIProps, EventsV2UI, type EventsV2UIProps, EventsWidget, type EventsWidgetProps, EventsWidgetV2, type EventsWidgetV2Props, FilterOutcomeMintsRequest, FilterOutcomeMintsResponse, FiltersBySportsResponse, ForecastPercentileHistoryByMintQueryParams, ForecastPercentileHistoryQueryParams, ForecastPercentileHistoryResponse, IPredictClient, IPredictWsClient, IntentQuoteQueryParams, IntentQuoteResponse, IntentSwapRequestBody, IntentSwapResponse, LiveDataByEventQueryParams, LiveDataByMintQueryParams, LiveDataQueryParams, LiveDataResponse, MAX_PRICE_HISTORY_MARKETS, type MarketPositionsResult, MarketQueryParams, MarketsBatchRequest, MultiOnchainTradeResponse, MultiTradeResponse, ORDER_MAX_PRICE, ORDER_MIN_PRICE, ORDER_MIN_QUANTITY, ORDER_PRICE_STEP, OnchainTradesByEventQueryParams, OnchainTradesByMarketQueryParams, OnchainTradesByWalletQueryParams, OpenOrdersUI, type OpenOrdersUIProps, OpenOrdersWidget, type OpenOrdersWidgetProps, type Order, type OrderBookRow, OrderBookUI, type OrderBookUIProps, OrderBookWidget, type OrderBookWidgetProps, OrderQueryParams, OrderResponse, OrderStatusQueryParams, OrderStatusResponse, type OrderbookData, OrderbookLevel, OrderbookResponse, OutcomeMintsQueryParams, OutcomeMintsResponse, PREDICT_SEARCH_MODAL_ID, PRICE_HISTORY_SAMPLE_INTERVAL, type Position, PositionsByWalletQueryParams, type PositionsSummary, PositionsUI, type PositionsUIProps, PositionsWidget, type PositionsWidgetProps, PredictClientV2, PredictContext, type PredictContextValue, PredictProvider, type PredictProviderProps, PredictSearchModal, type PredictSearchModalParams, type PredictSearchModalResult, PredictV2Context, type PredictV2ContextValue, PredictV2Provider, type PredictV2ProviderProps, PredictionMarketInitQueryParams, PredictionMarketInitResponse, type PriceData, PriceHistoryInterval, type PriceHistoryIntervalType, QuoteQueryParams, QuoteResponse, SORT_PRESETS, SearchEventsButton, type SearchEventsButtonProps, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchQueryParams, SearchResponse, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchWidget, type SearchWidgetProps, SeriesListResponse, SeriesQueryParams, SeriesResponse, SingleTradeResponse, type SortPreset, StandardEvent, StandardEventsResponse, StandardMarket, StandardMarketsResponse, SwapInstructionsResponse, SwapRequestBody, SwapResponse, type TagItemV2, type TagSlugSelection, TagsByCategoriesResponse, TokenListResponse, TokenListWithDecimalsResponse, type TradeData, TradeFormSkeleton, TradeFormUI, type TradeFormUIProps, type TradeFormValidation, TradeFormWidget, type TradeFormWidgetProps, TradeHistoryUI, type TradeHistoryUIProps, TradeHistoryWidget, type TradeHistoryWidgetProps, type TradeOutcome, type TradeSide, TradesByMintQueryParams, TradesQueryParams, type UseEventByIdQueryParams, type UseEventCandlesticksParams, type UseEventDetailParams, type UseEventV2QueryParams, type UseEventsCategoriesResult, type UseEventsParams, type UseEventsResult, type UseEventsV2Params, type UseEventsV2Result, type UseMarketByIdQueryParams, type UseMarketCandlesticksByMintParams, type UseMarketCandlesticksParams, type UseOpenOrdersParams, type UseOpenOrdersResult, type UseOrderBookParams, type UseOrderBookResult, type UseOrderbookSubscriptionParams, type UseOrderbookSubscriptionResult, type UsePositionsParams, type UsePositionsResult, type UsePricesSubscriptionParams, type UsePricesSubscriptionResult, type UseSearchEventsInfiniteQueryParams, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseTradeFormParams, type UseTradeFormResult, type UseTradeHistoryParams, type UseTradeHistoryResult, type UseTradesSubscriptionParams, type UseTradesSubscriptionResult, type UseWsClientResult, type UseWsConnectionParams, type UseWsConnectionResult, UserPredictContext, type UserPredictContextValue, UserPredictProvider, type UserPredictProviderProps, V2Event, V2EventSortField, V2EventStatus, V2ListEventsParams, V2Market, V2Page, V2ProviderSource, VenueListResponse, WalletPositionItem, WalletPositionsResponse, WsConnectionStatus, WsOrderbookUpdate, WsPriceUpdate, WsTradeUpdate, countActiveFilters, createSwap, createSwapInstructions, eventByIdQueryKey, eventCandlesticksQueryKey, eventV2QueryKey, eventsInfiniteQueryKey, eventsQueryKey, eventsV2QueryKey, fetchEventById, fetchEventCandlesticks, fetchEventV2, fetchEvents, fetchEventsV2, fetchFiltersBySports, fetchForecastPercentileHistory, fetchForecastPercentileHistoryByMint, fetchIntentQuote, fetchLiveData, fetchLiveDataByEvent, fetchLiveDataByMint, fetchMarketById, fetchMarketByMint, fetchMarketCandlesticks, fetchMarketCandlesticksByMint, fetchMarkets, fetchMarketsBatch, fetchOnchainTradesByEvent, fetchOnchainTradesByMarket, fetchOnchainTradesByWallet, fetchOrder, fetchOrderBook, fetchOrderBookByMint, fetchOrderStatus, fetchOutcomeMints, fetchPositionsByWallet, fetchQuote, fetchSearch, fetchSeries, fetchSeriesByTicker, fetchTagsByCategories, fetchTokens, fetchTokensWithDecimals, fetchTrades, fetchTradesByMint, fetchVenues, filterOutcomeMints, filtersBySportsQueryKey, forecastPercentileHistoryByMintQueryKey, forecastPercentileHistoryQueryKey, initPredictionMarket, intentQuoteQueryKey, liveDataByEventQueryKey, liveDataByMintQueryKey, liveDataQueryKey, marketByIdQueryKey, marketByMintQueryKey, marketCandlesticksByMintQueryKey, marketCandlesticksQueryKey, marketsBatchQueryKey, marketsQueryKey, onchainTradesByEventInfiniteQueryKey, onchainTradesByEventQueryKey, onchainTradesByMarketInfiniteQueryKey, onchainTradesByMarketQueryKey, onchainTradesByWalletInfiniteQueryKey, onchainTradesByWalletQueryKey, orderBookByMintQueryKey, orderBookQueryKey, orderQueryKey, orderStatusQueryKey, outcomeMintsQueryKey, positionsByWalletQueryKey, quoteQueryKey, searchQueryKey, seriesByTickerQueryKey, seriesQueryKey, submitIntentSwap, tagsByCategoriesQueryKey, tokensQueryKey, tokensWithDecimalsQueryKey, tradesByMintQueryKey, tradesQueryKey, useCategoriesQuery, useCreateSwapInstructionsMutation, useCreateSwapMutation, useEventByIdQuery, useEventCandlesticksQuery, useEventDetail, useEventV2Query, useEvents, useEventsCategories, useEventsInfiniteQuery, useEventsQuery, useEventsV2, useEventsV2Query, useFilterOutcomeMintsMutation, useFiltersBySportsQuery, useForecastPercentileHistoryByMintQuery, useForecastPercentileHistoryQuery, useInitPredictionMarketMutation, useIntentQuoteQuery, useLiveDataByEventQuery, useLiveDataByMintQuery, useLiveDataQuery, useMarketByIdQuery, useMarketByMintQuery, useMarketCandlesticksByMintQuery, useMarketCandlesticksQuery, useMarketPositions, useMarketsBatchQuery, useMarketsQuery, useOnchainTradesByEventInfiniteQuery, useOnchainTradesByEventQuery, useOnchainTradesByMarketInfiniteQuery, useOnchainTradesByMarketQuery, useOnchainTradesByWalletInfiniteQuery, useOnchainTradesByWalletQuery, useOpenOrders, useOrderBook, useOrderBookByMintQuery, useOrderBookQuery, useOrderQuery, useOrderStatusQuery, useOrderbookSubscription, useOutcomeMintsQuery, usePositions, usePositionsByWalletQuery, usePredictClient, usePredictContext, usePredictSearchHistory, usePredictV2Client, usePredictV2Context, usePriceHistoryQuery, usePricesSubscription, useQuoteQuery, useSearchEventsInfiniteQuery, useSearchQuery, useSearchResultListScript, useSearchScript, useSeriesByTickerQuery, useSeriesQuery, useSubmitIntentSwapMutation, useTagsByCategoriesQuery, useTokensQuery, useTokensWithDecimalsQuery, useTradeForm, useTradeHistory, useTradesByMintQuery, useTradesQuery, useTradesSubscription, useUserPredictContext, useVenuesQuery, useWsClient, useWsConnection, venuesQueryKey, _default as version };