@latchprotocol/widgets 0.1.0

package/dist/components/swap/state.d.ts

@@ -0,0 +1,208 @@
+/**
+ * The swap widget's state, as pure functions.
+ *
+ * `SwapWidget` renders; everything it decides lives here so it can be tested
+ * without a DOM (the unit suite renders through `react-dom/server`, where no
+ * effect runs and no button can be pressed). The shape:
+ *
+ * - A **pair** is unordered but anchored: `token` is the thing being traded,
+ *   `quote` what it is priced in. A **side** orients it - `buy` pays the quote
+ *   and receives the token, `sell` the reverse. The Sell / Buy panels always
+ *   show the oriented view; the anchor is what a host pins with `pair` and what
+ *   `side` flips over, so a side change never touches the selection itself.
+ * - The flip button turns the trade around: the amount the current quote
+ *   would have delivered becomes the amount you pay (the widget is exact-input
+ *   only, so the typed number cannot stay on the panel it was typed for), and
+ *   with no quote in hand the field is cleared. A side change that did not
+ *   come from the flip (a host's controlled `side`) keeps the typed amount.
+ *   Either way the quote re-reads and nothing of the old one is shown. The
+ *   price-impact acknowledgement is reset because it was given for a
+ *   different trade.
+ * - Portions are fractions of the input balance. There is no balance without
+ *   a wallet, so a portion without one is refused, never estimated.
+ */
+import type { RouteStep, SwapQuoteResult, TokenInfo } from "../../adapters/protocol.js";
+import type { PriceImpactSeverity, QuoteBreakdown } from "../../core/math.js";
+import type { AsyncStatus } from "../../hooks/useAsyncResource.js";
+/** Which way a pinned pair is traded: `buy` pays the quote for the token. */
+export type SwapSide = "buy" | "sell";
+/**
+ * A pair for {@link SwapWidget}'s `pair` prop, by address or by `TokenInfo`.
+ * `{ token, quote }` is the anchored form; `{ tokenIn, tokenOut }` is the same
+ * pair given in its `buy` orientation (`tokenIn` is the quote).
+ */
+export type SwapPair = {
+    readonly token: string | TokenInfo;
+    readonly quote: string | TokenInfo;
+} | {
+    readonly tokenIn: string | TokenInfo;
+    readonly tokenOut: string | TokenInfo;
+};
+/** A pair reduced to its anchored form. */
+export interface AnchoredPair<T> {
+    readonly token: T;
+    readonly quote: T;
+}
+/** The two panels' tokens. */
+export interface OrientedPair<T> {
+    readonly tokenIn: T;
+    readonly tokenOut: T;
+}
+/** Reduces either `SwapPair` shape to `{ token, quote }`. */
+export declare function normalizePair(pair: SwapPair): AnchoredPair<string | TokenInfo>;
+/** The address of a pair entry, lower-cased. */
+export declare function pairEntryAddress(entry: string | TokenInfo): string;
+/** A stable key for a pair prop, so a re-render with an equal pair is not a re-pin. */
+export declare function pairKey(pair: SwapPair | undefined): string | null;
+/** Finds a token in a list by address, case-insensitively. */
+export declare function findToken(tokens: readonly TokenInfo[], address: string | undefined): TokenInfo | null;
+/**
+ * Resolves a pair entry: a `TokenInfo` is taken as given; an address is looked
+ * up in the list. `null` means the list does not carry it (the widget then asks
+ * the adapter for the token contract).
+ */
+export declare function resolvePairEntry(entry: string | TokenInfo, tokens: readonly TokenInfo[]): TokenInfo | null;
+/** Orients an anchored pair for the panels: `buy` pays the quote. */
+export declare function orientPair<T>(anchor: AnchoredPair<T>, side: SwapSide): OrientedPair<T>;
+/** The inverse of {@link orientPair}: what the panels show, as an anchor. */
+export declare function unorientPair<T>(oriented: OrientedPair<T>, side: SwapSide): AnchoredPair<T>;
+/** The other side. */
+export declare function oppositeSide(side: SwapSide): SwapSide;
+/** The widget's default portion chips: 25%, 50%, 75% and Max (the design's four quick amounts). */
+export declare const DEFAULT_PORTIONS: readonly number[];
+/**
+ * Validates a `portions` prop. Every entry must be a finite fraction in
+ * `(0, 1]`; the order given is the order rendered. An empty list hides the
+ * chips. Throws, like every other bad widget config, rather than rendering a
+ * chip that would compute a nonsense amount.
+ */
+export declare function normalizePortions(portions: readonly number[] | undefined): readonly number[];
+/** The chip label for a fraction: `1` is "Max", the rest a percentage. */
+export declare function portionLabel(fraction: number): string;
+/**
+ * A fraction of a balance, in the token's smallest unit. On the native asset
+ * the whole balance keeps a sliver for gas; any smaller fraction, and any
+ * ERC-20, is exact. Uses basis-point precision so `0.333` is not lost.
+ */
+export declare function balancePortion(balance: bigint, fraction: number, token: TokenInfo): bigint;
+/**
+ * The amount text a portion chip writes into the input, or `null` when there
+ * is nothing to take a portion of: no input token, or no balance because no
+ * wallet is connected. `null` is a refusal - the widget never guesses a
+ * balance - and the caller decides whether to ask for a wallet.
+ *
+ * Plain decimal text, exact to the token's decimals and never grouped: it is
+ * parsed back by `parseAmount`, which takes no thousands separator.
+ */
+export declare function portionAmountText(token: TokenInfo | null, balance: bigint | null, fraction: number): string | null;
+/** What the widget holds between renders. */
+export interface SwapWidgetState {
+    /** The anchored selection; `null` entries mean nothing chosen yet. */
+    readonly anchor: AnchoredPair<TokenInfo | null>;
+    /** The widget's own side. Ignored while the host controls `side`. */
+    readonly side: SwapSide;
+    /** The typed input amount, verbatim. */
+    readonly amountText: string;
+    /** Whether the user acknowledged the current trade's price impact. */
+    readonly impactAck: boolean;
+}
+/** Every transition the widget makes. */
+export type SwapWidgetAction = 
+/** The token list arrived (or the defaults changed) and nothing is selected yet. */
+{
+    readonly type: "seed";
+    readonly tokens: readonly TokenInfo[];
+    readonly defaultTokenIn?: string;
+    readonly defaultTokenOut?: string;
+    readonly side: SwapSide;
+}
+/** The host's `pair` resolved. Overrides the selection; keeps the amount. */
+ | {
+    readonly type: "pin";
+    readonly anchor: AnchoredPair<TokenInfo | null>;
+}
+/** The Sell panel's selector picked a token. */
+ | {
+    readonly type: "select-in";
+    readonly token: TokenInfo;
+    readonly side: SwapSide;
+}
+/** The Buy panel's selector picked a token. */
+ | {
+    readonly type: "select-out";
+    readonly token: TokenInfo;
+    readonly side: SwapSide;
+}
+/** The direction flipped (flip button, `flip()` or a controlled `side` change). */
+ | {
+    readonly type: "set-side";
+    readonly side: SwapSide;
+    readonly amountText?: string;
+} | {
+    readonly type: "amount";
+    readonly text: string;
+} | {
+    readonly type: "ack";
+    readonly value: boolean;
+};
+/** The state before anything is known. */
+export declare const INITIAL_SWAP_STATE: SwapWidgetState;
+/**
+ * The initial state for a mount: a pair given as `TokenInfo`s is selected
+ * synchronously, so a locked pair renders its chips on the first frame (and in
+ * a server render); an address waits for the list.
+ */
+export declare function initialSwapState(options: {
+    readonly pair?: SwapPair;
+    readonly side?: SwapSide;
+}): SwapWidgetState;
+/** Applies one action. Pure; the component wraps it in `useReducer`. */
+export declare function swapWidgetReducer(state: SwapWidgetState, action: SwapWidgetAction): SwapWidgetState;
+/** One quote as a host sees it through `onQuote`. Smallest units throughout. */
+export interface SwapQuoteView {
+    readonly tokenIn: TokenInfo;
+    readonly tokenOut: TokenInfo;
+    readonly amountIn: bigint;
+    /** What the user receives after the integrator fee. */
+    readonly amountOut: bigint;
+    /** Output before the integrator fee, as the pool quotes it. */
+    readonly grossAmountOut: bigint;
+    /** The floor after slippage and the integrator fee - what the transaction enforces. */
+    readonly minReceived: bigint;
+    readonly integratorFee: bigint;
+    readonly slippageBps: number;
+    /** `null` when the pool's fee is hook-set: an impact that silently included it would be an invented number. */
+    readonly priceImpactBps: number | null;
+    readonly priceImpactSeverity: PriceImpactSeverity;
+    readonly lpFee: {
+        readonly pips: number;
+        readonly unknown: boolean;
+        /** Ready to print: a percentage, or `dynamic (hook-set)`. */
+        readonly label: string;
+    };
+    readonly route: readonly RouteStep[];
+    /** The route's token symbols, input first. */
+    readonly routeSymbols: readonly string[];
+    /** Output units per input unit, for display. */
+    readonly rate: number | null;
+    readonly status: AsyncStatus;
+    /** `true` while a newer quote is being read over this one. */
+    readonly isRefreshing: boolean;
+    readonly isMock: boolean;
+    readonly updatedAt: number | null;
+}
+/** Symbols along a route, input first, blanks dropped. */
+export declare function routeSymbols(route: readonly RouteStep[]): readonly string[];
+/** Builds the `onQuote` payload, or `null` while there is no quote to report. */
+export declare function buildSwapQuoteView(input: {
+    readonly tokenIn: TokenInfo | null;
+    readonly tokenOut: TokenInfo | null;
+    readonly quote: SwapQuoteResult | null;
+    readonly breakdown: QuoteBreakdown | null;
+    readonly rate: number | null;
+    readonly status: AsyncStatus;
+    readonly isRefreshing: boolean;
+    readonly isMock: boolean;
+    readonly updatedAt: number | null;
+}): SwapQuoteView | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/components/swap/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/components/swap/state.ts"],"names":[],"mappings":"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"}

package/dist/config/chain.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Chain and deployment configuration.
+ *
+ * LatchProtocol targets many chains, and nothing in this package knows which one
+ * you are on. There are no bundled RPC URLs and no address book: every address
+ * and every transport arrives from the embedder through a {@link ChainConfig}.
+ * That is deliberate - a hardcoded address is a bug that ships to every host.
+ */
+import { type Address, type Transport } from "viem";
+/** Native asset metadata for a chain. */
+export interface NativeCurrencyConfig {
+    readonly name: string;
+    readonly symbol: string;
+    readonly decimals: number;
+}
+/**
+ * Deployed contract addresses.
+ *
+ * Only `vault` and at least one pool manager are structurally required. The
+ * rest are required by the operations that use them, and the widgets fail with
+ * a named error rather than a decoding failure when one is missing.
+ */
+export interface ContractAddresses {
+    /** The singleton that custodies every token in the protocol. */
+    readonly vault: Address;
+    /** Concentrated-liquidity pool manager. */
+    readonly clPoolManager?: Address;
+    /** Liquidity-book (bin) pool manager. */
+    readonly binPoolManager?: Address;
+    /** Universal router - the entry point for swaps and integrator fees. */
+    readonly universalRouter?: Address;
+    /** Position manager for concentrated-liquidity positions. */
+    readonly clPositionManager?: Address;
+    /** Position manager for liquidity-book positions. */
+    readonly binPositionManager?: Address;
+    /** Permit2, used by the router to pull the input currency. */
+    readonly permit2?: Address;
+    /** Off-path CL quoter (`CLQuoter`), if one is deployed. Quotes concentrated-liquidity hops. */
+    readonly quoter?: Address;
+    /** Off-path `BinQuoter`, if one is deployed. Quotes liquidity-book hops. */
+    readonly binQuoter?: Address;
+    /**
+     * `LaunchGuardHook`, the hook that backs the launch widget.
+     *
+     * Not a launchpad and not a sale contract: it is the hook a launch pool names
+     * in its `PoolKey`, and the launch widget reads its per-pool schedule. Leave
+     * it unset on a chain where no `LaunchGuardHook` is deployed — the widget
+     * renders a "not configured on this chain" state, which is the truth. Setting
+     * it to an address that is not a `LaunchGuardHook` produces read failures,
+     * not a fallback.
+     */
+    readonly launchGuardHook?: Address;
+    /**
+     * How `launchGuardHook` measures time: `"timestamp"` for the current build,
+     * `"contract-block"` for the block-numbered one still deployed on Robinhood.
+     * Take it from `LatchDeployment.durationClocks.launchGuardHook` in the SDK.
+     * When omitted, the live adapter uses the SDK record if the address matches it,
+     * and otherwise asks the hook (`CLOCK_MODE()`), never guessing.
+     */
+    readonly launchGuardHookClock?: "timestamp" | "contract-block";
+    /**
+     * `BinLaunchGuardHook`: the launch guard a Bin (liquidity-book) launch pool
+     * names in its `PoolKey`. Same schedule, same gates, same `getLaunch` shape
+     * as the CL guard; only ever built on `block.timestamp`. Leave it unset where
+     * none is deployed.
+     */
+    readonly binLaunchGuardHook?: Address;
+    /**
+     * `LaunchpadKitV2`, the locked-launch kit. With it set, a launch can be
+     * looked up by its TOKEN (`legsOf(token)` names every pool the launch
+     * opened) instead of by one pool id. The pools themselves must still be in
+     * the host's pool list: the singleton enumerates nothing.
+     */
+    readonly launchpadKitV2?: Address;
+}
+/** Everything the widgets need to know about the chain they are pointed at. */
+export interface ChainConfig {
+    readonly chainId: number;
+    readonly name: string;
+    readonly nativeCurrency: NativeCurrencyConfig;
+    readonly contracts: ContractAddresses;
+    /**
+     * viem transport for reads. Omitted when the host drives reads itself (for
+     * example through wagmi).
+     */
+    readonly transport?: Transport;
+    readonly blockExplorerUrl?: string;
+    /** Seconds added to `block.timestamp` for transaction deadlines. */
+    readonly defaultDeadlineSeconds?: number;
+}
+/** Names of the addresses a caller can require. */
+export type ContractName = keyof ContractAddresses;
+/** Raised when the chain config cannot support a requested operation. */
+export declare class ChainConfigError extends Error {
+    readonly chainId: number;
+    readonly contract: ContractName | null;
+    constructor(message: string, chainId: number, contract?: ContractName | null);
+}
+/**
+ * Structural validation of a chain config.
+ *
+ * Checks shape only. It cannot tell you an address is wrong, just that it is
+ * well-formed and present.
+ */
+export declare function assertValidChainConfig(config: ChainConfig): void;
+/**
+ * Reads a required address, failing with a message that names what is missing
+ * and which operation needed it.
+ */
+export declare function requireContract(config: ChainConfig, name: ContractName, usedFor: string): Address;
+/**
+ * The best reading of the clock the NEXT block will carry: the later of the
+ * pending block's timestamp and the latest block's, ignoring whichever could
+ * not be read; `null` when neither was.
+ *
+ * WHY THE PENDING BLOCK. `max(latest.timestamp, localNow)` covers an idle
+ * chain whose clock matches wall time, and a chain whose clock is AHEAD of
+ * wall time (a devnet after `evm_increaseTime`) while it is busy. It does not
+ * cover the two together: a chain running ahead of wall time whose last block
+ * is older than the deadline window. Its next block is stamped about
+ * `localNow + offset`, later than `latest + window`, and `localNow` is below
+ * `latest`, so neither term reaches it and the transaction arrives expired.
+ * Nothing on the client can know the offset without asking the node; the
+ * pending block is that question (anvil and geth-style nodes stamp it with the
+ * next block's time). Where the RPC has no pending block it refuses or echoes
+ * the latest, and the bound falls back to the latest block's - the residual
+ * case is then that one combination on such an RPC, which the window's size
+ * (20 minutes by default) makes rare, and the user's wallet reports as the
+ * router's deadline error rather than a loss.
+ */
+export declare function nextBlockClock(pending: bigint | null, latest: bigint | null): bigint | null;
+/**
+ * Default transaction deadline: base + configured window, as a unix timestamp,
+ * where base = max(chain clock, local clock).
+ *
+ * `nowSeconds` should be the chain's clock (the next block's, see
+ * {@link nextBlockClock} and {@link chainDeadline}); the local clock is only
+ * the fallback. The later of the two is used, so an idle chain whose last block
+ * is old does not produce a deadline that has passed by the time the next
+ * block is mined, and a chain ahead of wall time is not given a deadline in
+ * its past.
+ */
+export declare function defaultDeadline(config: ChainConfig, nowSeconds?: number | bigint): bigint;
+/**
+ * The deadline for a transaction about to be built: the chain's clock (the
+ * adapter's `getBlockTimestamp`, which the viem adapter reads from the pending
+ * block where the RPC serves one) or the local clock, whichever is later, +
+ * the configured window. A failed
+ * block read falls back to the local clock rather than blocking the trade.
+ */
+export declare function chainDeadline(config: ChainConfig, adapter: {
+    getBlockTimestamp?(): Promise<bigint>;
+}): Promise<bigint>;
+/**
+ * Explorer link for a transaction hash, or `null` when no explorer is set.
+ *
+ * The one place a widget builds an explorer link. An empty (or whitespace-only)
+ * `blockExplorerUrl` is NO explorer: a host running against a local devnet
+ * passes "" or leaves it out, and a link to "/tx/0x…" would open this page.
+ * Callers render the bare hash instead.
+ */
+export declare function explorerTxUrl(config: Pick<ChainConfig, "blockExplorerUrl">, hash: string): string | null;
+//# sourceMappingURL=chain.d.ts.map

package/dist/config/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/config/chain.ts"],"names":[],"mappings":"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"}

package/dist/config/integrator.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Integrator fee attribution.
+ *
+ * This is the module that makes the widgets worth embedding. An integrator -
+ * the team whose app hosts the widget - names a `referrer` address and a fee in
+ * basis points, and that fee is taken out of the swap's **output** currency and
+ * paid to the referrer inside the same transaction as the swap.
+ *
+ * The fee is not an accounting entry we settle later. It is an action in the
+ * swap plan (`TAKE_PORTION`), or a command in the router plan (`PAY_PORTION`),
+ * so it either happens atomically with the swap or the whole transaction
+ * reverts. Nothing is trusted, escrowed or owed.
+ *
+ * ## Invariants enforced here
+ *
+ * 1. `feeBps` is an integer in `[0, MAX_INTEGRATOR_FEE_BPS]`.
+ * 2. A non-zero `feeBps` requires a syntactically valid, non-zero `referrer`.
+ *    Configuring a fee with no destination is a loud failure, never a silent
+ *    zero: the alternative is a widget that quietly earns the embedder nothing.
+ * 3. The predicted fee uses the same arithmetic as the contracts
+ *    (`amount * bps / 10_000`, truncating), so the number shown in the UI is
+ *    the number the chain pays out - not an estimate.
+ */
+import { type Address } from "viem";
+/** Basis-point denominator. 10_000 bps = 100%. */
+export declare const BPS_DENOMINATOR = 10000;
+/**
+ * Largest integrator fee the widgets will encode, in basis points (1.00%).
+ *
+ * The on-chain `BipsLibrary.calculatePortion` only rejects values above
+ * 10_000 bps, so this ceiling is a client-side policy, not a contract limit.
+ * It exists so an embedder cannot ship a widget that quietly takes a third of
+ * a user's output, which would poison the widget for every other integrator.
+ * Anything above this is a configuration error, not a business decision.
+ */
+export declare const MAX_INTEGRATOR_FEE_BPS = 100;
+/** The zero address, rejected as a fee destination. */
+export declare const ZERO_ADDRESS: Address;
+/**
+ * Where the integrator fee is taken in the call path.
+ *
+ * - `take-portion` - a `TAKE_PORTION` action inside the swap plan. The vault
+ *   credit is split before anything leaves the singleton, so the router never
+ *   custodies the fee. This is the default.
+ * - `pay-portion` - the swap takes its full output to the router, then a
+ *   router-level `PAY_PORTION` command forwards the fee and `SWEEP` returns the
+ *   remainder. Needed when the fee must be taken across a multi-command plan.
+ */
+export type IntegratorFeeMode = "take-portion" | "pay-portion";
+/** Integrator fee configuration, as an embedder writes it. */
+export interface IntegratorConfig {
+    /** Address that receives the fee. Required whenever `feeBps > 0`. */
+    readonly referrer: Address;
+    /** Fee in basis points of the swap output, `0 .. MAX_INTEGRATOR_FEE_BPS`. */
+    readonly feeBps: number;
+    /** Where in the call path the fee is taken. Defaults to `take-portion`. */
+    readonly feeMode?: IntegratorFeeMode;
+    /**
+     * Free-form label recorded in widget analytics events. Never sent on-chain.
+     */
+    readonly label?: string;
+}
+/** Machine-readable reasons an integrator config can be rejected. */
+export type IntegratorConfigErrorCode = "FEE_BPS_NOT_A_NUMBER" | "FEE_BPS_NOT_AN_INTEGER" | "FEE_BPS_NEGATIVE" | "FEE_BPS_ABOVE_MAX" | "REFERRER_MISSING" | "REFERRER_MALFORMED" | "REFERRER_ZERO_ADDRESS" | "FEE_MODE_UNKNOWN";
+/** Thrown when an integrator config cannot be used to build a call path. */
+export declare class IntegratorConfigError extends Error {
+    readonly code: IntegratorConfigErrorCode;
+    constructor(code: IntegratorConfigErrorCode, message: string);
+}
+/**
+ * A validated integrator config.
+ *
+ * Only this type reaches the call-path builders. There is no way to construct
+ * one except through {@link validateIntegratorConfig}, so an unvalidated fee can
+ * never be encoded into a transaction.
+ */
+export interface ResolvedIntegratorConfig {
+    readonly referrer: Address;
+    readonly feeBps: number;
+    readonly feeMode: IntegratorFeeMode;
+    readonly label: string | null;
+    /** `true` when `feeBps > 0`, i.e. the call path gains a fee step. */
+    readonly active: boolean;
+    /** Non-fatal configuration remarks worth surfacing in a dev console. */
+    readonly warnings: readonly string[];
+}
+/**
+ * Validates and normalises an integrator config.
+ *
+ * @throws {IntegratorConfigError} on any violation of the documented rules.
+ */
+export declare function validateIntegratorConfig(config: IntegratorConfig): ResolvedIntegratorConfig;
+/** The resolved config used when an embedder configures no integrator at all. */
+export declare const NO_INTEGRATOR_FEE: ResolvedIntegratorConfig;
+/** Validates an optional config, falling back to {@link NO_INTEGRATOR_FEE}. */
+export declare function resolveIntegratorConfig(config: IntegratorConfig | undefined | null): ResolvedIntegratorConfig;
+/**
+ * The integrator's cut of `grossAmount`, in the output currency's smallest unit.
+ *
+ * Mirrors `BipsLibrary.calculatePortion`: multiply first, then divide, so the
+ * rounding matches the chain exactly. Integer division truncates, which favours
+ * the user by at most one wei.
+ */
+export declare function calculateIntegratorFee(grossAmount: bigint, feeBps: number): bigint;
+/** A gross output amount split into the integrator's cut and the user's. */
+export interface IntegratorFeeSplit {
+    /** Output before the integrator fee. */
+    readonly grossAmount: bigint;
+    /** Amount routed to the referrer. Zero when no fee is active. */
+    readonly integratorFee: bigint;
+    /** Amount the user actually receives. */
+    readonly netAmount: bigint;
+    readonly feeBps: number;
+    /** Fee destination, or `null` when no fee is active. */
+    readonly referrer: Address | null;
+}
+/** Splits a gross output amount according to a validated integrator config. */
+export declare function splitIntegratorFee(grossAmount: bigint, config: ResolvedIntegratorConfig): IntegratorFeeSplit;
+/** Human-readable percentage for a bps value, e.g. `25 -> "0.25%"`. */
+export declare function formatBps(bps: number): string;
+//# sourceMappingURL=integrator.d.ts.map

package/dist/config/integrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrator.d.ts","sourceRoot":"","sources":["../../src/config/integrator.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAE3D,kDAAkD;AAClD,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,uDAAuD;AACvD,eAAO,MAAM,YAAY,EAAE,OAAsD,CAAC;AAElF;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,aAAa,CAAC;AAE/D,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,MAAM,yBAAyB,GACjC,sBAAsB,GACtB,wBAAwB,GACxB,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,GACpB,uBAAuB,GACvB,kBAAkB,CAAC;AAEvB,4EAA4E;AAC5E,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;gBAE7B,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM;CAK7D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAQD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,wBAAwB,CAsG3F;AAED,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,wBAO/B,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,GAC1C,wBAAwB,CAG1B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUlF;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,wBAAwB,GAC/B,kBAAkB,CAkBpB;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C"}

package/dist/context/WidgetProvider.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The one piece of shared state every widget reads.
+ *
+ * `WidgetProvider` holds the adapter, the chain config and - critically - the
+ * *validated* integrator config. Validation happens once, here, at mount:
+ * a bad `feeBps` or a missing `referrer` fails immediately and visibly rather
+ * than at the moment a user presses Swap.
+ */
+import { type ReactNode } from "react";
+import type { ProtocolAdapter } from "../adapters/protocol.js";
+import type { ChainConfig } from "../config/chain.js";
+import { type IntegratorConfig, type ResolvedIntegratorConfig } from "../config/integrator.js";
+/** Colour scheme applied to the styled widgets. */
+export type WidgetTheme = "light" | "dark" | "system";
+/** Value exposed to every widget beneath the provider. */
+export interface WidgetContextValue {
+    readonly adapter: ProtocolAdapter;
+    readonly chain: ChainConfig;
+    /** Always validated. Never optional at this layer. */
+    readonly integrator: ResolvedIntegratorConfig;
+    readonly defaultSlippageBps: number;
+    readonly theme: WidgetTheme;
+    /** Locale used by number formatting; defaults to the browser's. */
+    readonly locale: string | undefined;
+    /**
+     * What the "Connect wallet" call to action does when pressed, for every
+     * widget under this provider. `undefined` leaves that CTA a disabled label.
+     */
+    readonly onConnectRequest: (() => void) | undefined;
+}
+/**
+ * The context itself. Exported so a host can detect whether a provider is
+ * mounted above it (`useContext(WidgetContext) === null`) instead of catching
+ * the throw from {@link useWidgetContext}; {@link useOptionalWidgetContext}
+ * is the same test as a hook.
+ */
+export declare const WidgetContext: import("react").Context<WidgetContextValue | null>;
+/** Props accepted by {@link WidgetProvider}. */
+export interface WidgetProviderProps {
+    /** Where chain reads and writes go. Mock in dev, viem-backed in production. */
+    readonly adapter: ProtocolAdapter;
+    /**
+     * Integrator fee attribution.
+     *
+     * Omit it and the widgets work, earning you nothing. Supplying it is the
+     * entire commercial reason to embed them.
+     */
+    readonly integrator?: IntegratorConfig;
+    readonly defaultSlippageBps?: number;
+    readonly theme?: WidgetTheme;
+    readonly locale?: string;
+    /**
+     * Opens the host's wallet-connect flow (RainbowKit's `openConnectModal`,
+     * a custom modal, whatever the host has). While no account is connected the
+     * widgets' primary button reads "Connect wallet"; with this set it is an
+     * enabled button that calls it, without it the button stays a disabled label
+     * and the visitor connects through the host's own control. A widget's own
+     * `onConnectRequest` prop overrides this one.
+     */
+    readonly onConnectRequest?: () => void;
+    readonly children: ReactNode;
+}
+/** Root provider. Wrap every widget in exactly one of these. */
+export declare function WidgetProvider(props: WidgetProviderProps): JSX.Element;
+/** Reads the widget context. Throws when used outside a {@link WidgetProvider}. */
+export declare function useWidgetContext(): WidgetContextValue;
+/**
+ * Reads the widget context, or `null` when no {@link WidgetProvider} is
+ * mounted above. For hosts that mount the provider late (once a pool
+ * directory is read, say) and want to render a waiting state in the
+ * meantime without an error boundary.
+ */
+export declare function useOptionalWidgetContext(): WidgetContextValue | null;
+/** Convenience accessor for the adapter. */
+export declare function useProtocolAdapter(): ProtocolAdapter;
+/** Convenience accessor for the validated integrator config. */
+export declare function useIntegrator(): ResolvedIntegratorConfig;
+//# sourceMappingURL=WidgetProvider.d.ts.map

package/dist/context/WidgetProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetProvider.d.ts","sourceRoot":"","sources":["../../src/context/WidgetProvider.tsx"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AAGjC,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACrD;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CA2DtE;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,kBAAkB,CASrD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,GAAG,IAAI,CAEpE;AAED,4CAA4C;AAC5C,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,IAAI,wBAAwB,CAExD"}