@latchprotocol/widgets 0.1.0

package/dist/components/LockerWidget.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `LockerWidget`: lock liquidity and tokens with Latch from any React app.
+ *
+ *   Lock liquidity  time-lock a CL position NFT in `LatchPositionLock`
+ *   Lock tokens     a time lock or cliff + linear vesting in `LatchTokenLock`
+ *   My locks        the connected wallet's locks: collect fees, extend,
+ *                   withdraw after the date, claim what has vested, accept an
+ *                   offered lock
+ *
+ * The fee is read live from each contract (`feeWei` and any announced
+ * `pendingFee`) and shown before anything is signed; it is the contract's, not
+ * this widget's, so every caller pays the same. Approvals are exact (this one
+ * NFT; exactly the amount), and only when the chain says one is missing. Every
+ * call is simulated with its exact bytes before the wallet sees it, and every
+ * receipt is checked: a mined revert is reported as one. Errors read through
+ * the widgets' decoder.
+ *
+ * The wallet is `wallet` (the `WidgetWallet` surface `createViemAdapter`
+ * takes), else the mounted `WidgetProvider`'s adapter. Reads go through
+ * `client`, on the lock contracts' chain.
+ */
+import { type Address, type Hex, type PublicClient } from "viem";
+import type { WidgetWallet } from "../adapters/viem.js";
+import { type WidgetTheme } from "../context/WidgetProvider.js";
+import { type LockerContracts } from "../hooks/useLocker.js";
+export interface LockerWidgetProps {
+    readonly client: PublicClient;
+    readonly contracts: LockerContracts;
+    readonly wallet?: WidgetWallet;
+    readonly native?: {
+        readonly symbol: string;
+        readonly decimals: number;
+    };
+    readonly theme?: WidgetTheme;
+    readonly title?: string;
+    readonly defaultTab?: LockerTab;
+    /** Prefill the token tab. */
+    readonly defaultToken?: Address;
+    /** Opens the host's wallet connect flow; falls back to the provider's. */
+    readonly onConnectRequest?: () => void;
+    /** Links a transaction hash to an explorer; `null` for no link. */
+    readonly explorerTxUrl?: (hash: Hex) => string | null;
+    /** The Latch mark (brand kit `masters/latch-mark.svg`, or `-onlight` on a light ground) beside the
+     * title, at the kit's 24 px minimum. The intrinsic size is the master's real viewBox so the shape
+     * is reserved correctly; CSS decides how big it draws. Omit for none. */
+    readonly brandMarkUrl?: string;
+    readonly className?: string;
+}
+export type LockerTab = "position" | "token" | "mine";
+export declare function LockerWidget(props: LockerWidgetProps): JSX.Element;
+//# sourceMappingURL=LockerWidget.d.ts.map

package/dist/components/LockerWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockerWidget.d.ts","sourceRoot":"","sources":["../../src/components/LockerWidget.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAgD,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAsB/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,EAAiF,KAAK,eAAe,EAAqC,MAAM,uBAAuB,CAAC;AAoB/K,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD;;6EAEyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAictD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,CAAC,OAAO,CA8DlE"}

package/dist/components/LocksWidgets.d.ts

@@ -0,0 +1,61 @@
+/**
+ * `LocksBadge` and `LocksPanel`: "is this liquidity (or this token) locked,
+ * until when?", read live from the Latch lock contracts.
+ *
+ * - `LocksBadge` is one line: the locked share of a pool's ACTIVE liquidity
+ *   (or of a token's supply), a countdown to the next unlock, and a link to
+ *   the lock page. For beside a pool or a token, anywhere.
+ * - `LocksPanel` is the list: every lock with its owner, liquidity or amount,
+ *   unlock date, countdown and status.
+ *
+ * Both take a viem `PublicClient` and the lock contract's address from the
+ * host's address book; `null` renders the not-deployed state instead of a
+ * read. No provider, no wallet, no writes. Themed by the same `--latch-*`
+ * properties as every other widget; `theme` falls back to a mounted
+ * `WidgetProvider`'s, then to `system`.
+ */
+import type { PublicClient } from "viem";
+import { type WidgetTheme } from "../context/WidgetProvider.js";
+import { type NativeCurrencyMeta } from "../hooks/useLocks.js";
+import { type LocksTarget } from "../locks/model.js";
+/** Props shared by {@link LocksBadge} and {@link LocksPanel}. */
+export interface LocksWidgetProps {
+    /** Reads go here. The chain it is connected to is the chain the lock address is on. */
+    readonly client: PublicClient;
+    /** A pool id with the chain's `LatchPositionLock`, or a token with its `LatchTokenLock`. `null` address = the chain has no such contract in the host address book; the widget renders "coming soon". */
+    readonly target: LocksTarget;
+    /** Base URL of a Latch app; the widget links to `<siteUrl>/app/locks/...`. Omit to render no link. */
+    readonly siteUrl?: string;
+    /** The lock pages' path under `siteUrl`; default `/app/locks` (e.g. `/locks` for the public pages). */
+    readonly lockPathBase?: string;
+    /** Appended to the lock page URL, e.g. `net=robinhood`. */
+    readonly lockQuery?: string;
+    /** Anchor target for the lock page link, e.g. `_blank` when the badge is inside an iframe. */
+    readonly linkTarget?: "_blank" | "_top" | "_self";
+    /**
+     * `embed`: the "Locked by Latch" badge's words (`../locks/embedModel.ts`): a
+     * token reads as the share of supply NOT YET VESTED ("Y% of supply locked")
+     * rather than what the locker holds. Same reads either way.
+     */
+    readonly wording?: "default" | "embed";
+    /**
+     * The Latch mark (the brand kit's `masters/latch-mark.svg`, e.g.
+     * `<latch site>/brand/masters/latch-mark.svg` — or `latch-mark-onlight.svg` on a light
+     * ground, because the current mark is two-tone), shown at the kit's 24 px minimum
+     * beside "Read from chain". Omit for no mark.
+     */
+    readonly brandMarkUrl?: string;
+    readonly theme?: WidgetTheme;
+    /** Native currency display facts (default ETH, 18). */
+    readonly native?: NativeCurrencyMeta;
+    /** Re-read interval in ms; default 60,000. */
+    readonly refetchIntervalMs?: number;
+    readonly className?: string;
+}
+/** One line: the share locked, the countdown to the next unlock, a link. */
+export declare function LocksBadge(props: LocksWidgetProps): JSX.Element;
+/** The list of every lock for the target, under the badge's summary. */
+export declare function LocksPanel(props: LocksWidgetProps & {
+    readonly title?: string;
+}): JSX.Element;
+//# sourceMappingURL=LocksWidgets.d.ts.map

package/dist/components/LocksWidgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocksWidgets.d.ts","sourceRoot":"","sources":["../../src/components/LocksWidgets.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAIL,KAAK,kBAAkB,EAGxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAkBL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAO3B,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,wMAAwM;IACxM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,sGAAsG;IACtG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAoGD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CA0C/D;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CA2C7F"}

package/dist/components/SwapWidget.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Drop-in swap widget.
+ *
+ * Everything below the presentation is the headless layer: `useSwapQuote` and
+ * `useSwapExecute` do the work, this file only renders it. An integrator who
+ * wants their own look imports those two hooks and deletes this component from
+ * their bundle.
+ *
+ * The presentation is the one people expect from a swap: two large amount
+ * panels (You pay / You receive) with a token selector dialog each, a flip button between
+ * them, one call-to-action that always says what the next step is (connect,
+ * enter an amount, insufficient balance, approve, swap, confirming), and a
+ * details disclosure with the rate, price impact, every fee, the guaranteed
+ * minimum and the route. Overlays are Radix primitives (MIT) portalled into the
+ * widget so they work inside the shadow-root embed.
+ *
+ * The integrator fee, when configured, is shown as its own line in the details.
+ * That is a deliberate product decision, not a legal one: a fee the user can see
+ * is a fee that does not become a scandal, and an integrator whose users trust
+ * the widget keeps earning from it.
+ *
+ * There is no dollar figure anywhere. Nothing in the adapter prices a token in
+ * USD, and a number that looks priced and is not would be an invented one.
+ *
+ * A host that frames the widget - a token page with Buy / Sell tabs, a swap
+ * page that deep-links a pair - drives it through props rather than remounts:
+ * `pair` pins the pair (`lockPair` makes the selectors read-only chips), `side`
+ * orients it, `onQuote` reports every quote, `slots` add the host's own chrome,
+ * and a `ref` gives an imperative handle for the host's own percent chips. All
+ * of it is opt-in; without those props the widget is the one it always was.
+ *
+ * `variant="compact"` is the token page's trade box: a Buy / Sell pill where
+ * the title and the flip button were, one "You pay" panel with its quick-amount
+ * chips, and every line - you receive, price impact, pool fee, the creator tax
+ * when the host passes it, minimum received - always visible, each on its own
+ * line, above the call to action. Same quote, same simulation, same button.
+ * The state behind them is pure (`swap/state.ts`) and tested without a DOM.
+ */
+import { type ReactNode } from "react";
+import { type TokenListInput } from "../core/tokenLists.js";
+import { type SwapPair, type SwapQuoteView, type SwapSide } from "./swap/state.js";
+/** Props for {@link SwapWidget}. */
+export interface SwapWidgetProps {
+    /** Pre-selects the input token by address. */
+    readonly defaultTokenIn?: string;
+    /** Pre-selects the output token by address. */
+    readonly defaultTokenOut?: string;
+    readonly title?: string;
+    /** Show the slippage control. Defaults to `true`. */
+    readonly showSlippageControl?: boolean;
+    readonly onSwapConfirmed?: (hash: string) => void;
+    /**
+     * Token lists (Uniswap Token Lists standard) to offer beside the adapter's
+     * own tokens: documents already in hand, or URLs fetched and schema-validated
+     * through the SDK. Order is precedence - the first list to name an address
+     * wins - and the picker groups entries by list and badges tokenised stocks.
+     * The adapter's tokens (the pools this site routes through) always come first.
+     */
+    readonly tokenLists?: readonly TokenListInput[];
+    /**
+     * Makes the "Connect wallet" call to action a working button that opens
+     * the host's connect flow. Absent (and absent on the provider too), the CTA
+     * is a disabled label and the visitor connects through the host's control.
+     */
+    readonly onConnectRequest?: () => void;
+    /**
+     * The pair to trade, pinned: by address (resolved against the token list,
+     * then read off the contract when the list lacks it) or as `TokenInfo`s
+     * (selected on the first frame). `{ token, quote }` is anchored - `side`
+     * says which way it is traded; `{ tokenIn, tokenOut }` is the same pair in
+     * its buy orientation. A change of `pair` re-pins without a remount, so the
+     * typed amount survives a host switching legs. Without `lockPair` the
+     * visitor may still pick other tokens; the pin returns when the prop changes.
+     */
+    readonly pair?: SwapPair;
+    /**
+     * With `pair`: the token selectors become read-only chips (the token, no
+     * dropdown) and the pair cannot be changed from inside the widget. The flip
+     * button stays - it flips the side, not the pair. Defaults to `false`.
+     */
+    readonly lockPair?: boolean;
+    /**
+     * The direction, controlled: `buy` pays the quote and receives the token,
+     * `sell` the reverse. When set, the widget's flip button only reports through
+     * `onSideChange` and the host decides; when absent the widget owns its side
+     * and still reports. A side change keeps the typed amount as the amount you
+     * pay and re-quotes - it never clears the field.
+     */
+    readonly side?: SwapSide;
+    /** Fired by the flip button and by `flip()`, with the side the widget wants to be on. */
+    readonly onSideChange?: (side: SwapSide) => void;
+    /**
+     * The balance portions offered as chips under the input, as fractions in
+     * `(0, 1]`; `1` renders as "Max". Defaults to `[0.25, 0.5, 0.75, 1]`; an empty
+     * list hides the chips. The chips only show once a balance has been read -
+     * without a wallet there is no balance to take a portion of.
+     */
+    readonly portions?: readonly number[];
+    /**
+     * Called when a portion is asked for (a chip, or `setPortion` on the handle)
+     * and there is no balance to take it from because no wallet is connected.
+     * The widget never estimates a balance; the host may open its connect flow
+     * here. Absent, the request is a no-op.
+     */
+    readonly onNeedsWallet?: () => void;
+    /**
+     * Reports every quote the widget holds - the net output, the guaranteed
+     * minimum, the price impact (`null` when the pool's fee is hook-set), the LP
+     * fee label and the route - and `null` when there is none (empty amount, no
+     * route, unmounted). Fires when the quote changes, including on refresh.
+     */
+    readonly onQuote?: (quote: SwapQuoteView | null) => void;
+    /**
+     * The host's own chrome, rendered inside the widget: `header` between the
+     * title row and the panels (a leg switcher, a note), `aboveButton` between
+     * the panels and the call to action, `footer` after the details and before
+     * the brand line. The brand line itself is not a slot.
+     */
+    readonly slots?: {
+        readonly header?: ReactNode;
+        readonly aboveButton?: ReactNode;
+        readonly footer?: ReactNode;
+    };
+    /**
+     * `"default"` (two panels, the flip button, a details disclosure under the
+     * button) or `"compact"`: a Buy / Sell pill in the header in place of the
+     * title and the flip button, one "You pay" panel, and the lines always
+     * visible above the button. Meant with a pinned `pair`; the pill changes the
+     * side exactly as `side` / `onSideChange` do, never the pair.
+     */
+    readonly variant?: "default" | "compact";
+    /**
+     * The pool's creator tax as the host read it from the launch guard: the rate
+     * a buy and a sell pay NOW, in bps (pass 0 once the tax has expired - it
+     * ends with no transaction). Rendered as its own line for the current side,
+     * never folded into the pool fee or the price impact. Absent, there is no
+     * line; `null` says the pool takes none.
+     */
+    readonly creatorTax?: {
+        readonly buyBps: number;
+        readonly sellBps: number;
+    } | null;
+}
+/**
+ * What a `ref` on {@link SwapWidget} gives the host: the amount, the balance
+ * portions and the direction, so a page can draw its own percent chips or
+ * Buy / Sell tabs and still leave the trade to the widget.
+ */
+export interface SwapWidgetHandle {
+    /** Writes the input amount, as the user would type it (`"1.5"`). */
+    setAmountIn(text: string): void;
+    /**
+     * Writes a fraction of the input balance (`0.75`, `1` for Max with the
+     * native gas sliver kept back). Returns `false` - and calls `onNeedsWallet` -
+     * when there is no balance to take it from; nothing is written then.
+     */
+    setPortion(fraction: number): boolean;
+    /** Flips the direction, exactly like the widget's own flip button. */
+    flip(): void;
+    /** Re-reads the quote now rather than on the next interval. */
+    refreshQuote(): void;
+}
+/** The styled swap widget. */
+export declare const SwapWidget: import("react").ForwardRefExoticComponent<SwapWidgetProps & import("react").RefAttributes<SwapWidgetHandle>>;
+//# sourceMappingURL=SwapWidget.d.ts.map

package/dist/components/SwapWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapWidget.d.ts","sourceRoot":"","sources":["../../src/components/SwapWidget.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAWL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAMf,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAgB3E,OAAO,EAcL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAIzB,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;QACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;KAC7B,CAAC;IACF;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,sEAAsE;IACtE,IAAI,IAAI,IAAI,CAAC;IACb,+DAA+D;IAC/D,YAAY,IAAI,IAAI,CAAC;CACtB;AAuDD,8BAA8B;AAC9B,eAAO,MAAM,UAAU,8GAserB,CAAC"}

package/dist/components/TokenTrustPanel.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `TokenTrustPanel`: one place, for one token, with what the Latch contracts
+ * hold about it - its liquidity locks per pool (time-locked and permanent LP
+ * locker, as the locked share of ACTIVE liquidity), its token locks and
+ * vesting, the creator tax a Kit v2 launch guard takes, each pool's LP fee and
+ * protocol fee, and what LatchRegistry records about each pool's hook. Every
+ * row names the contract, the view and the blocks it was read at.
+ *
+ * Read-only: a viem `PublicClient` and the chain's contract addresses from the
+ * host's address book. No wallet, no provider. Four states, each distinct:
+ * reading, the rows, "could not be read" when the chain does not answer, and
+ * "coming soon" when `contracts` is `null` — a feature that has not arrived is not an outage, and the two read differently. It never says
+ * "safe": a listing is what the registry records, not an audit.
+ */
+import type { Address, Hex, PublicClient } from "viem";
+import { type WidgetTheme } from "../context/WidgetProvider.js";
+import { type TokenTrustTarget } from "../hooks/useTokenTrust.js";
+export interface TokenTrustPanelProps extends TokenTrustTarget {
+    readonly client: PublicClient;
+    readonly theme?: WidgetTheme;
+    readonly title?: string;
+    /** Links each source contract to an explorer. Return `null` for no link (e.g. a devnet). */
+    readonly explorerAddressUrl?: (address: Address) => string | null;
+    /** Links each pool to its lock page. Return `null` for no link. */
+    readonly poolLockUrl?: (poolId: Hex) => string | null;
+    /** Anchor target for those links, e.g. `_blank` inside an iframe. */
+    readonly linkTarget?: "_blank" | "_top" | "_self";
+    readonly refetchIntervalMs?: number;
+    readonly className?: string;
+}
+export declare function TokenTrustPanel(props: TokenTrustPanelProps): JSX.Element;
+//# sourceMappingURL=TokenTrustPanel.d.ts.map

package/dist/components/TokenTrustPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenTrustPanel.d.ts","sourceRoot":"","sources":["../../src/components/TokenTrustPanel.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEvD,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKjF,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAClE,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAClD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAyCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,GAAG,CAAC,OAAO,CA4FxE"}

package/dist/components/lockCharts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Two compact lock visuals the lock widgets share, in plain SVG / CSS (no
+ * chart library, so the embed bundle stays small):
+ *
+ * - `ShareBar`: a whole split into its locked parts (permanent LP locker,
+ *   time-locked, unvested, vested-unclaimed); the empty track is "not
+ *   locked". Grows in from the left. Each part states its exact share on
+ *   hover (title) and to a screen reader (the bar's label).
+ * - `ScheduleSpark`: a token's cumulative release schedule (the SDK's
+ *   `vestedAt`, the contract's own formula), drawn on, with a "now" rule.
+ *   Pointer or arrow keys read any point: its date and the amount vested by
+ *   then.
+ *
+ * Themed only by `--latch-*` properties; motion is CSS and is switched off
+ * under `prefers-reduced-motion`. Nothing is drawn that was not read.
+ */
+import { type LocksTokenMeta, type SchedulePoint, type ShareBarView } from "../locks/model.js";
+export declare function ShareBar({ view, label, keyed }: {
+    view: ShareBarView;
+    label: string;
+    keyed?: boolean;
+}): JSX.Element;
+export declare function ScheduleSpark({ points, total, now, token, }: {
+    points: readonly SchedulePoint[];
+    total: bigint;
+    now: bigint | null;
+    token: Pick<LocksTokenMeta, "symbol" | "decimals">;
+}): JSX.Element | null;
+//# sourceMappingURL=lockCharts.d.ts.map

package/dist/components/lockCharts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockCharts.d.ts","sourceRoot":"","sources":["../../src/components/lockCharts.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAA8C,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI3I,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAY,EAAE,EAAE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CA4B3H;AAKD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,GAAG,EACH,KAAK,GACN,EAAE;IACD,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;CACpD,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CA4DrB"}

package/dist/components/portal.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Where overlays render. Radix portals default to `document.body`, which is
+ * outside a shadow root and outside the `.latch-widget` theme scope. The shell
+ * provides its own element instead, so dialogs and popovers inherit the theme
+ * variables and stay styled inside the web component.
+ */
+export declare const PortalContainerProvider: import("react").Provider<HTMLElement | null>;
+/** The element overlays should portal into, or `undefined` for Radix's default. */
+export declare function usePortalContainer(): HTMLElement | undefined;
+//# sourceMappingURL=portal.d.ts.map

package/dist/components/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/components/portal.tsx"],"names":[],"mappings":"AACA;;;;;GAKG;AAMH,eAAO,MAAM,uBAAuB,8CAAkC,CAAC;AAEvE,mFAAmF;AACnF,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,SAAS,CAE5D"}

package/dist/components/primitives.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Presentational primitives shared by the three styled widgets.
+ *
+ * Nothing here holds protocol state. Each piece is a thin, accessible shell
+ * over native form elements: a real `<label>` for every input, a real `<button>`
+ * for every action, and one polite live region per widget so a screen reader
+ * hears quote and transaction changes without the focus moving.
+ */
+import { type ReactNode } from "react";
+import type { TokenInfo } from "../adapters/protocol.js";
+/** Props for {@link WidgetShell}. */
+export interface WidgetShellProps {
+    readonly title: string;
+    readonly subtitle?: string;
+    readonly children: ReactNode;
+    /** Rendered at the top-right of the header, e.g. a settings control. */
+    readonly headerAction?: ReactNode;
+    /**
+     * Rendered in the header in place of the visible title (the swap widget's
+     * Buy / Sell pill). The title stays the section's name and its heading, for
+     * assistive technology only.
+     */
+    readonly headerContent?: ReactNode;
+    readonly className?: string;
+}
+/**
+ * The outer frame: theme attribute, stylesheet injection and the mock warning.
+ *
+ * The mock banner is rendered from `adapter.isMock` and takes no prop, so an
+ * integrator cannot configure it away while still showing fabricated numbers.
+ */
+export declare function WidgetShell(props: WidgetShellProps): JSX.Element;
+/** Permanent, non-dismissible warning shown whenever the adapter is a mock. */
+export declare function MockBanner(): JSX.Element;
+/** Props for {@link AmountField}. */
+export interface AmountFieldProps {
+    readonly label: string;
+    readonly value: string;
+    readonly onValueChange?: (value: string) => void;
+    readonly readOnly?: boolean;
+    readonly token: TokenInfo | null;
+    readonly tokens: readonly TokenInfo[];
+    readonly onTokenChange?: (token: TokenInfo) => void;
+    readonly balance?: bigint | null;
+    readonly onUseMax?: () => void;
+    readonly error?: string | null;
+    readonly secondaryText?: string;
+    readonly placeholder?: string;
+}
+/** An amount input paired with a token selector and a balance line. */
+export declare function AmountField(props: AmountFieldProps): JSX.Element;
+/** One label/value pair inside a summary block. */
+export interface SummaryRowProps {
+    readonly label: string;
+    readonly value: ReactNode;
+    readonly emphasis?: "fee";
+    readonly severity?: "low" | "elevated" | "high" | "severe" | "unknown";
+    readonly title?: string;
+}
+/** A `<dt>`/`<dd>` pair. Must be rendered inside {@link SummaryList}. */
+export declare function SummaryRow(props: SummaryRowProps): JSX.Element;
+/** A definition list wrapper for {@link SummaryRow}s. */
+export declare function SummaryList(props: {
+    readonly children: ReactNode;
+}): JSX.Element;
+/** Props for {@link StatusRegion}. */
+export interface StatusRegionProps {
+    readonly message: string;
+    readonly tone?: "neutral" | "error" | "success";
+    /** `assertive` for errors that need to interrupt; `polite` otherwise. */
+    readonly assertive?: boolean;
+}
+/**
+ * The widget's single live region.
+ *
+ * Quote refreshes and transaction transitions are announced here rather than by
+ * moving focus, so a keyboard user is never yanked out of the amount field
+ * mid-typing by a background re-quote.
+ */
+export declare function StatusRegion(props: StatusRegionProps): JSX.Element;
+/** Props for {@link ActionButton}. */
+export interface ActionButtonProps {
+    readonly children: ReactNode;
+    readonly onClick?: () => void;
+    readonly disabled?: boolean;
+    readonly busy?: boolean;
+    readonly type?: "button" | "submit";
+    readonly variant?: "primary" | "secondary" | "danger";
+    /**
+     * True while the widget is waiting for a wallet. The button then becomes
+     * the connect call to action: enabled and calling `onConnectRequest` when
+     * the host gave one, otherwise the disabled label it always was. `type`,
+     * `disabled` and `onClick` are ignored in that state.
+     */
+    readonly needsConnect?: boolean;
+    /** See {@link connectCtaProps}. */
+    readonly onConnectRequest?: () => void;
+}
+/**
+ * The attributes of a primary button while no wallet is connected.
+ *
+ * With a handler the button is a real button that asks the host to open its
+ * connect flow; without one it is disabled, so a host that renders its own
+ * connect control somewhere else keeps exactly the behaviour it had. Never a
+ * submit: pressing it must not run the form's swap/add/buy handler.
+ */
+export declare function connectCtaProps(onConnectRequest: (() => void) | undefined): {
+    readonly type: "button";
+    readonly disabled: boolean;
+    readonly onClick: (() => void) | undefined;
+};
+/** The widget's primary call to action. */
+export declare function ActionButton(props: ActionButtonProps): JSX.Element;
+/** A labelled progress bar backed by a real `progressbar` role. */
+export declare function ProgressBar(props: {
+    readonly label: string;
+    readonly percent: number;
+}): JSX.Element;
+/** A radio-style segmented control. */
+export declare function SegmentedControl<T extends string>(props: {
+    readonly label: string;
+    readonly value: T;
+    readonly options: readonly {
+        readonly value: T;
+        readonly label: string;
+    }[];
+    readonly onChange: (value: T) => void;
+}): JSX.Element;
+/** Renders a route as a chain of token chips. */
+export declare function RouteSummary(props: {
+    readonly tokens: readonly string[];
+    readonly detail?: string;
+}): JSX.Element;
+/** An error panel with `role="alert"`. */
+export declare function ErrorPanel(props: {
+    readonly error: Error | null;
+    readonly context?: "quote" | "swap" | "liquidity" | "transaction";
+}): JSX.Element | null;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/components/primitives.d.ts.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * Swap settings in a Radix Popover: slippage tolerance (auto, presets, custom)
+ * and the high-impact acknowledgement. Nothing here is hidden from the
+ * summary: the chosen tolerance is always printed in the details.
+ */
+export interface SwapSettingsProps {
+    readonly slippageBps: number;
+    readonly defaultSlippageBps: number;
+    readonly onSlippageChange: (bps: number) => void;
+}
+export declare function SwapSettings(props: SwapSettingsProps): JSX.Element;
+//# sourceMappingURL=SwapSettings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SwapSettings.d.ts","sourceRoot":"","sources":["../../../src/components/swap/SwapSettings.tsx"],"names":[],"mappings":"AACA;;;;GAIG;AAUH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAsElE"}

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

@@ -0,0 +1,61 @@
+/**
+ * The token selector: a Radix Dialog with search, common tokens, balances for
+ * the connected account and paste-an-address lookup through the adapter.
+ *
+ * Tokens carry their provenance. An entry that came from a token list
+ * (`SwapWidget`'s `tokenLists`) is grouped under that list's name and says
+ * which other lists also carry it; the adapter's own tokens - the tokens of the
+ * pools this site routes through - come first, ungrouped. A tokenised stock
+ * (`extensions.stock`) gets an issuer badge, and a REBASING one a warning,
+ * because the issuer's control over the token is the thing a trader has to
+ * know before choosing it. A pasted address that is in no list is looked up on
+ * chain and labelled as unlisted; it is never silently promoted.
+ *
+ * Portals render INTO the widget root (see `PortalContainer`) rather than
+ * `document.body`, so the same component works inside the shadow-root web
+ * component, where body-level portals would render unstyled.
+ */
+import type { TokenInfo } from "../../adapters/protocol.js";
+/**
+ * A token's logo, or a monogram of its symbol. `https://` loads directly;
+ * `ipfs://` resolves through the SDK's first allow-listed gateway; a URL that
+ * fails to load falls back to the monogram rather than a broken image.
+ */
+export declare function TokenLogo(props: {
+    readonly token: TokenInfo | null;
+    readonly size?: number;
+}): JSX.Element;
+/** A stable hue per token (0-359), so a token without a logo is still recognisable at a glance. */
+export declare function hueOf(key: string): number;
+/** The badges a row carries: the issuer of a stock, a rebasing warning, a test-token mark. */
+export declare function TokenBadges(props: {
+    readonly token: TokenInfo;
+}): JSX.Element | null;
+/**
+ * The read-only form of the selector, for a pinned pair (`SwapWidget`'s
+ * `lockPair`): the same chip, the token it shows, no chevron and no dialog.
+ * A `<span>`, not a disabled button, so it is not announced as a control that
+ * happens to be off; the label says the pair is fixed.
+ */
+export declare function TokenChip(props: {
+    readonly value: TokenInfo | null;
+    readonly label: string;
+}): JSX.Element;
+export interface TokenSelectProps {
+    readonly value: TokenInfo | null;
+    readonly tokens: readonly TokenInfo[];
+    readonly onChange: (token: TokenInfo) => void;
+    /** The other side of the pair, greyed out in the list. */
+    readonly exclude?: TokenInfo | null;
+    readonly label: string;
+    /** Lists that were asked for and did not load, shown as a note so an empty group is explained. */
+    readonly listFailures?: readonly {
+        readonly url: string;
+        readonly message: string;
+    }[];
+    /** `true` while lists are still loading. */
+    readonly listsLoading?: boolean;
+}
+/** The trigger button plus its dialog. */
+export declare function TokenSelect(props: TokenSelectProps): JSX.Element;
+//# sourceMappingURL=TokenSelect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TokenSelect.d.ts","sourceRoot":"","sources":["../../../src/components/swap/TokenSelect.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAS5D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAkB1G;AAED,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzC;AAWD,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAmBpF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAO1G;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtF,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAwPhE"}