@stridge/kit 0.1.0-alpha.0

package/dist/shared/chains/index.d.ts

@@ -0,0 +1,40 @@
+//#region src/shared/chains/index.d.ts
+/**
+ * Chain catalog for `@stridge/kit`. Exports the `chains` namespace (EIP-155 chain ids keyed by
+ * slug, suitable for IDE autocomplete) and a normalizer that converts any accepted form
+ * (slug, EIP-155 number, Stridge networkId) into the wire-shape `network_id` string the gateway
+ * expects.
+ *
+ * @example
+ * ```ts
+ * import { chains } from "@stridge/kit";
+ *
+ * <StridgeProvider asset={{ chain: chains.bsc, symbol: "USDC" }} ... />;
+ * <StridgeProvider asset={{ chain: 56, symbol: "USDC" }} ... />;             // also valid
+ * <StridgeProvider asset={{ chain: "bsc", symbol: "USDC" }} ... />;          // also valid
+ * <StridgeProvider asset={{ chain: "9006", symbol: "USDC" }} ... />;         // also valid
+ * ```
+ */
+/**
+ * EIP-155 chain ids for the chains Stridge's gateway routes to. Keyed by lowercase slug for
+ * IDE autocomplete; the value is a plain number so consumers can pass `chains.bsc` directly to
+ * any prop that accepts a chain id.
+ */
+declare const chains: {
+  readonly ethereum: 1;
+  readonly bsc: 56;
+  readonly polygon: 137;
+  readonly arbitrum: 42161;
+  readonly base: 8453;
+};
+type ChainSlug = keyof typeof chains;
+/**
+ * The accepted shape of a `chain` field on kit configuration props. Any of:
+ *
+ * - `number` — EIP-155 chain id (`56`, `137`).
+ * - `string` — chain slug (`"bsc"`), the matching EIP-155 id as text (`"56"`), or a Stridge
+ *   `network_id` (`"9006"`). The kit normalizes via {@link normalizeChainToNetworkId}.
+ */
+type ChainInput = string | number;
+//#endregion
+export { ChainInput, ChainSlug, chains };

package/dist/shared/chains/index.js

@@ -0,0 +1 @@
+const e={ethereum:1,bsc:56,polygon:137,arbitrum:42161,base:8453},t={ethereum:`60`,bsc:`9006`,polygon:`966`,arbitrum:`9001`,base:`8453`},n={1:`60`,56:`9006`,137:`966`,42161:`9001`,8453:`8453`};function r(e){if(typeof e==`number`)return n[e]??String(e);let r=e.toLowerCase();return r in t?t[r]:/^\d+$/.test(e)?n[Number(e)]??e:e}export{e as chains,r as normalizeChainToNetworkId};

package/dist/shared/constants/brand-links.js

@@ -0,0 +1 @@
+const e={support:`https://stridge.com/support`,terms:`https://stridge.com/terms`};export{e as BRAND_LINKS};

package/dist/shared/dialog/DialogShell.d.ts

@@ -0,0 +1,63 @@
+import { ReactElement, ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/dialog/DialogShell.d.ts
+/**
+ * Open-state and trigger controls shared by every widget's `.Dialog`
+ * form (and the generic {@link DialogShell}). Mirrors the controlled /
+ * uncontrolled / programmatic shapes that `Dialog.Root` already accepts.
+ */
+interface DialogShellControls {
+  /** Controlled open state. Pair with `onOpenChange` for full control. */
+  open?: boolean;
+  /** Initial open state when uncontrolled. Ignored if `open` is set. */
+  defaultOpen?: boolean;
+  /** Fires whenever the dialog open state changes. */
+  onOpenChange?: (open: boolean) => void;
+  /**
+   * Element rendered as the `Dialog.Trigger`. Omit when the dialog is
+   * opened programmatically via `open`.
+   */
+  trigger?: ReactElement;
+}
+interface DialogShellProps extends DialogShellControls {
+  /**
+   * Widget JSX rendered inside `Dialog.Content`. Each widget detects
+   * the dialog context and swaps to its bare frame, so the same
+   * composition that works inline as `Card variant="frame"` paints
+   * the same surface chrome here.
+   */
+  children?: ReactNode;
+}
+/**
+ * Pre-composed dialog shell for a kit widget. Wraps `Dialog.Root` +
+ * (optional) `Dialog.Trigger` + `Dialog.Content` so consumers don't
+ * re-stitch those three primitives every time they want to open a
+ * widget in a modal.
+ *
+ * Each widget also exposes a typed `.Dialog` form (`Deposit.Dialog`,
+ * `AssetPicker.Dialog`, …) that wraps this shell and forwards the
+ * widget's own root props — that's the recommended entry point for
+ * production usage. Reach for `DialogShell` directly when you have
+ * already-rendered widget JSX (an inline `<Deposit>` element) and just
+ * want to lift it into a dialog.
+ *
+ * @example
+ * ```tsx
+ * <DialogShell trigger={<Button>Deposit</Button>}>
+ *   <Deposit token={token}>
+ *     <Deposit.Header />
+ *     <Deposit.Body>…</Deposit.Body>
+ *   </Deposit>
+ * </DialogShell>
+ * ```
+ */
+declare function DialogShell({
+  open,
+  defaultOpen,
+  onOpenChange,
+  trigger,
+  children
+}: DialogShellProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DialogShell, DialogShellControls, DialogShellProps };

package/dist/shared/dialog/DialogShell.js

@@ -0,0 +1 @@
+"use client";import{Dialog as e}from"../ui/Dialog/Dialog.js";import"../ui/Dialog/index.js";import{jsx as t,jsxs as n}from"react/jsx-runtime";function r({open:r,defaultOpen:i,onOpenChange:a,trigger:o,children:s}){return n(e,{open:r,defaultOpen:i,onOpenChange:a,children:[o?t(e.Trigger,{render:o}):null,t(e.Content,{children:s})]})}export{r as DialogShell};

package/dist/shared/dialog/Frame.js

@@ -0,0 +1 @@
+"use client";import{useKitConfig as e}from"../../scope/context.js";import{useIsInsideDialogContent as t}from"../ui/Dialog/Dialog.js";import"../ui/Dialog/index.js";import{Card as n}from"../ui/Card/Card.js";import"../../ui/index.js";import{jsx as r}from"react/jsx-runtime";function i({className:i,style:a,dir:o,...s}){let c=t(),{direction:l}=e(),u=o??l;if(c){let e={className:`Frame__styles.bare x78zum5 xdt5ytf x12lumcd x2lwn1j x7giv3`,"data-style-src":`@stridge/kit:src/shared/dialog/Frame.tsx:25`};return r(`div`,{...s,dir:u,className:[e.className,i].filter(Boolean).join(` `)||void 0,style:{...e.style,...a}})}return r(n,{variant:`frame`,dir:u,className:i,style:a,...s})}export{i as Frame};

package/dist/shared/dialog/GatewayKitRoot.js

@@ -0,0 +1 @@
+"use client";import{joinClassNames as e}from"../utils/joinClassNames.js";import{jsx as t}from"react/jsx-runtime";function n({children:n,className:r}){let i={className:`GatewayKitRoot__styles.root x78zum5 xdt5ytf x12lumcd x2lwn1j`,"data-style-src":`@stridge/kit:src/shared/dialog/GatewayKitRoot.tsx:13`};return t(`div`,{className:e(`stridge-kit-root`,i.className,r),style:i.style,children:n})}export{n as GatewayKitRoot};

package/dist/shared/dialog/StepTransition.js

@@ -0,0 +1 @@
+"use client";import{useEffect as e,useLayoutEffect as t,useRef as n}from"react";import{jsx as r}from"react/jsx-runtime";import{AnimatePresence as i,motion as a}from"motion/react";const o=[.3,0,.06,1],s={enter:e=>({opacity:0,x:e>=0?16:-16,filter:`blur(6px)`}),center:{opacity:1,x:0,filter:`blur(0px)`,transition:{duration:.22,delay:.12,ease:o}},exit:e=>({opacity:0,x:e>=0?-16:16,filter:`blur(6px)`,transition:{duration:.14,ease:o}})};function c({stateKey:o,children:c}){let l=n([]),u=n(null),d=l.current,f=d[d.length-1],p=0;o!==f&&(p=d.indexOf(o)>=0?-1:1);let m=n(null),h=n(o),g=n(null),_=n(null);return e(()=>{let e=l.current;if(e[e.length-1]===o)return;let t=e.indexOf(o);l.current=t>=0?e.slice(0,t+1):[...e,o]},[o]),t(()=>{let e=u.current;if(!e)return;let t=e.getBoundingClientRect().height;if(h.current===o){m.current=t;return}let n=m.current;if(h.current=o,m.current=t,n===null||n===t)return;let r=e.style.transition;e.style.transition=`none`,e.style.height=`${n}px`,e.offsetHeight,e.style.transition=r,_.current!==null&&window.cancelAnimationFrame(_.current),_.current=window.requestAnimationFrame(()=>{_.current=null,u.current&&(u.current.style.height=`${t}px`)}),g.current!==null&&window.clearTimeout(g.current),g.current=window.setTimeout(()=>{g.current=null;let e=u.current;e&&(e.style.height=``)},320)}),e(()=>()=>{g.current!==null&&(window.clearTimeout(g.current),g.current=null),_.current!==null&&(window.cancelAnimationFrame(_.current),_.current=null)},[]),r(`div`,{ref:u,style:{position:`relative`,overflow:`hidden`,transition:`height 260ms cubic-bezier(0.3, 0, 0.06, 1)`,flex:`0 1 auto`,minHeight:0,display:`flex`,flexDirection:`column`},children:r(i,{mode:`popLayout`,custom:p,initial:!1,children:r(a.div,{custom:p,variants:s,initial:`enter`,animate:`center`,exit:`exit`,tabIndex:-1,style:{display:`flex`,flexDirection:`column`,flex:`1 1 auto`,minHeight:0,outline:`none`},children:c},o)})})}export{c as StepTransition};

package/dist/shared/dialog/useDirectionalChevronTransform.js

@@ -0,0 +1 @@
+"use client";import{useKitConfig as e}from"../../scope/context.js";function t(t){let{direction:n}=e(),r=n===`rtl`;return t?r?`scaleX(-1) rotate(-90deg)`:`rotate(90deg)`:r?`scaleX(-1)`:void 0}export{t as useDirectionalChevronTransform};

package/dist/shared/driver/types.d.ts

@@ -0,0 +1,69 @@
+//#region src/shared/driver/types.d.ts
+/**
+ * Canonical home for the kit's driver-layer types that are shared across deposit and withdraw
+ * flows. Lives under `shared/driver/` so neither flow has to cross-import the other; both flows
+ * import from here, and the per-flow driver `index.ts` re-exports for back-compat with the
+ * public `@stridge/kit/<flow>/driver` surface.
+ */
+/**
+ * On-chain transaction reference. Drivers return one of these from any imperative wallet action
+ * (`submitDeposit`, `submitWithdrawal`); the orchestrator stamps it on the FSM's `tx` slot until
+ * the matching settlement entity catches up and exposes a richer `txHash` / `txExplorerUrl` pair.
+ */
+interface TxRef {
+  hash: string;
+  explorerUrl?: string;
+}
+/**
+ * Stable classification of why a settlement failed. The widget maps each kind to a localized
+ * headline + reason via `useT()`; keeping the discriminator here as an enum (not free-text)
+ * preserves the kit's "payload is data, copy lives in widget" boundary.
+ */
+type SettlementFailureKind = /** The route's expected output drifted while the on-chain submission was pending. */"slippage" /** The bridge could not fund the destination transaction (gas budget exhausted). */ | "insufficient-gas" /** Destination-leg transaction reverted on-chain. */ | "execution-reverted" /** Settlement failed for a reason the driver could not classify. */ | "unknown";
+/**
+ * Lifecycle envelope for every reactive entity exposed by a kit driver. Each variant narrows
+ * what the consumer can read:
+ *
+ * - `idle` — the entity has no data and no fetch is in flight (e.g. the user has not entered an
+ *   amount yet, so there is no quote to display).
+ * - `loading` — a fetch is in flight; no payload available.
+ * - `ready` — a fresh value arrived. `payload` is the kit-formatted, locale-aware shape kit
+ *   components and host headless code render. `raw` is the source-of-truth DTO from the backend
+ *   (one item out of a list / response). `response` is the full HTTP response that contained the
+ *   entity, exposed for headless integrators that want the entire envelope.
+ * - `stale` — the previously-ready value is past its freshness window (e.g. an expired quote).
+ *   The `payload` is still safe to render in a "Refresh" affordance; downstream FSM logic chooses
+ *   when to re-request.
+ * - `error` — the latest fetch failed. The original `error` is kept so analytics + UI can present
+ *   it. No `payload` — components show their error fallback.
+ *
+ * Components in `@stridge/kit/<flow>/widgets` and `@stridge/kit/<flow>/compound` only ever read
+ * `payload`. The `raw` and `response` slots are part of the public contract for headless
+ * integrators (e.g. an analytics pipeline that wants the wire-shaped settlement record, or a
+ * custom React tree that wants to surface a backend field the kit's payload does not include).
+ *
+ * @template P - Payload shape — the kit-formatted, locale-aware data the kit's components render.
+ * @template R - Raw shape — the DTO of THIS specific entity (e.g. one settlement record, not the
+ *               whole poll response).
+ * @template Resp - Response shape — the full HTTP response that contained `R`.
+ */
+type Entity<P, R, Resp> = {
+  status: "idle";
+} | {
+  status: "loading";
+} | {
+  status: "ready";
+  payload: P;
+  raw: R;
+  response: Resp;
+} | {
+  status: "stale";
+  payload: P;
+  raw: R;
+  response: Resp;
+} | {
+  status: "error";
+  error: Error;
+};
+//#endregion
+export { Entity, SettlementFailureKind, TxRef };

package/dist/shared/error-handling/components/GatewayKitBoundary.js

@@ -0,0 +1 @@
+"use client";import{GatewayKitRoot as e}from"../../dialog/GatewayKitRoot.js";import{isWagmiProviderMissingError as t}from"../lib/isWagmiProviderMissingError.js";import{GatewayKitRecoveryError as n}from"./GatewayKitRecoveryError.js";import{GatewayKitSetupError as r}from"./GatewayKitSetupError.js";import{Component as i}from"react";import{jsx as a}from"react/jsx-runtime";function o(e){return a(s,{...e})}var s=class extends i{state={error:null};static getDerivedStateFromError(e){return{error:e}}componentDidCatch(e,t){process.env.NODE_ENV!==`production`&&console.error(`[Stridge Kit] Render error`,e,t),this.props.onError?.(e,t)}reset=()=>{this.props.onReset?.(),this.setState({error:null})};render(){let{error:i}=this.state;return i?a(e,{children:this.props.fallback??(t(i)?a(r,{error:i}):a(n,{error:i,onRetry:this.reset}))}):a(e,{children:this.props.children})}};export{o as GatewayKitBoundary};

package/dist/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.js

@@ -0,0 +1 @@
+"use client";import{joinClassNames as e}from"../../../utils/joinClassNames.js";import{GATEWAY_KIT_ERROR_CARD_SLOTS as t}from"./GatewayKitErrorCard.slots.js";import{styles as n}from"./GatewayKitErrorCard.styles.js";import{GatewayKitErrorCardAction as r}from"./components/Action.js";import{GatewayKitErrorCardActions as i}from"./components/Actions.js";import{GatewayKitErrorCardCodeSample as a}from"./components/CodeSample.js";import{GatewayKitErrorCardDescription as o}from"./components/Description.js";import{GatewayKitErrorCardGuidance as s}from"./components/Guidance.js";import{GatewayKitErrorCardContext as c}from"./context.js";import{GatewayKitErrorCardTechnicalDetails as l}from"./components/TechnicalDetails.js";import{GatewayKitErrorCardTechnicalDetailsToggle as u}from"./components/TechnicalDetailsToggle.js";import{GatewayKitErrorCardTitle as d}from"./components/Title.js";import{useId as f,useMemo as p,useState as m}from"react";import{jsx as h}from"react/jsx-runtime";import*as g from"@stylexjs/stylex";function _({error:r,defaultErrorName:i,defaultErrorMessage:a,className:o,"data-testid":s,children:l}){let[u,d]=m(!1),_=f(),v=process.env.NODE_ENV!==`production`,y=r?.name??i,b=r?.message??a,x=r?.stack,S=!!y||!!b||v&&!!x,C=p(()=>({showTechnicalDetails:u,toggleTechnicalDetails:()=>d(e=>!e),hasTechnicalDetails:S,detailsId:_,resolvedErrorName:y,resolvedErrorMessage:b,errorStack:x,isDevelopment:v}),[u,S,_,y,b,x,v]),w=g.props(n.card);return h(c.Provider,{value:C,children:h(`div`,{"data-stridge-slot":t.root,"data-testid":s,className:e(w.className,o),style:w.style,children:l})})}(function(e){e.Title=d,e.Description=o,e.Guidance=s,e.Actions=i,e.Action=r,e.CodeSample=a,e.TechnicalDetails=l,e.TechnicalDetailsToggle=u})(_||={});export{_ as GatewayKitErrorCard};

package/dist/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.slots.js

@@ -0,0 +1 @@
+const e={root:`gateway-kit-error-card`,title:`gateway-kit-error-card-title`,description:`gateway-kit-error-card-description`,guidance:`gateway-kit-error-card-guidance`,actions:`gateway-kit-error-card-actions`,action:`gateway-kit-error-card-action`,technicalDetailsToggle:`gateway-kit-error-card-technical-details-toggle`,codeSample:`gateway-kit-error-card-code-sample`,codeSampleSection:`gateway-kit-error-card-code-sample-section`,technicalDetails:`gateway-kit-error-card-technical-details`,detailRow:`gateway-kit-error-card-detail-row`};export{e as GATEWAY_KIT_ERROR_CARD_SLOTS};

package/dist/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.js

@@ -0,0 +1 @@
+import{colors as e}from"../../../styles/tokens.stylex.js";`${e.destructiveSoft}`,`${e.destructiveSoft}${e.foreground}`,`${e.destructiveBorder}`,`${e.destructiveBorder}`,e.destructiveSoftForeground,`${e.destructiveSoftForeground}${e.foreground}`,e.destructive,e.destructiveForeground,`${e.destructive}${e.foreground}`,`${e.background}`;const t={card:{"GatewayKitErrorCard__styles.card":`GatewayKitErrorCard__styles.card`,"borderWidth-kMzoRj":`xmkeg23`,"borderStyle-ksu8eU":`x1y0btm7`,"borderColor-kVAM5u":`x1fxxxea`,"borderRadius-kaIpWk":`x13pkpm2`,"padding-kmVPX3":`x163h9xw`,"fontFamily-kMv6JI":`xlaww2m`,"backgroundColor-kWkggS":`x1o9k46r`,"color-kMwMTN":`x19vemxs`,"boxShadow-kGVxlE":`x1lo0mqj`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:24`},title:{"GatewayKitErrorCard__styles.title":`GatewayKitErrorCard__styles.title`,"marginBottom-k1K539":`xji1aa`,"fontWeight-k63SB2":`x1qvi77d`,"fontSize-kGuDYH":`x1ll9jre`,"lineHeight-kLWn49":`x2fnr2h`,"letterSpacing-kb6lSQ":`x17krmmv`,"color-kMwMTN":`xreodjm`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:35`},bodyText:{"GatewayKitErrorCard__styles.bodyText":`GatewayKitErrorCard__styles.bodyText`,"lineHeight-kLWn49":`x1ppnlvb`,"color-kMwMTN":`x19vemxs`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:43`},guidance:{"GatewayKitErrorCard__styles.guidance":`GatewayKitErrorCard__styles.guidance`,"marginTop-keoZOQ":`x1u1y36e`,"lineHeight-kLWn49":`x1ppnlvb`,"color-kMwMTN":`xtb34l4`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:47`},actionsRow:{"GatewayKitErrorCard__styles.actionsRow":`GatewayKitErrorCard__styles.actionsRow`,"display-k1xSpc":`x78zum5`,"flexWrap-kwnvtZ":`x1a02dak`,"gap-kOIVth":`x1a6yh9e`,"marginTop-keoZOQ":`xq9mr0s`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:52`},section:{"GatewayKitErrorCard__styles.section":`GatewayKitErrorCard__styles.section`,"borderRadius-kaIpWk":`x12ur2as`,"backgroundColor-kWkggS":`xij6k22`,"borderWidth-kMzoRj":`xmkeg23`,"borderStyle-ksu8eU":`x1y0btm7`,"borderColor-kVAM5u":`x1fxxxea`,"padding-kmVPX3":`xewtfw4`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:58`},sectionTitle:{"GatewayKitErrorCard__styles.sectionTitle":`GatewayKitErrorCard__styles.sectionTitle`,"marginBottom-k1K539":`x1anr4k7`,"fontSize-kGuDYH":`x1oae1zf`,"lineHeight-kLWn49":`x2fnr2h`,"letterSpacing-kb6lSQ":`xen6mf`,"textTransform-kP9fke":`xtvhhri`,"opacity-kSiTet":`x27vdmw`,"fontWeight-k63SB2":`x1qvi77d`,"color-kMwMTN":`xreodjm`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:66`},codeSample:{"GatewayKitErrorCard__styles.codeSample":`GatewayKitErrorCard__styles.codeSample`,"margin-kogj98":`x1ghz6dp`,"overflowX-kXHlph":`xw2csxc`,"whiteSpace-khDVqt":`x1sdyfia`,"fontSize-kGuDYH":`x14qa7mu`,"lineHeight-kLWn49":`x1ppnlvb`,"color-kMwMTN":`xzn0pkc`,"fontFamily-kMv6JI":`x47j52l`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:76`},detailSubheading:{"GatewayKitErrorCard__styles.detailSubheading":`GatewayKitErrorCard__styles.detailSubheading`,"marginBottom-k1K539":`x1782xsq`,"fontSize-kGuDYH":`x14qa7mu`,"lineHeight-kLWn49":`x14vj8e1`,"fontWeight-k63SB2":`x1qvi77d`,"color-kMwMTN":`xzn0pkc`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:85`},stack:{"GatewayKitErrorCard__styles.stack":`GatewayKitErrorCard__styles.stack`,"margin-kogj98":`x1ghz6dp`,"overflowX-kXHlph":`xw2csxc`,"whiteSpace-khDVqt":`x126k92a`,"wordBreak-kTgw9":`x13faqbe`,"fontSize-kGuDYH":`x1oae1zf`,"lineHeight-kLWn49":`x1ppnlvb`,"color-kMwMTN":`xzn0pkc`,"fontFamily-kMv6JI":`x47j52l`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:92`},detailRow:{"GatewayKitErrorCard__styles.detailRow":`GatewayKitErrorCard__styles.detailRow`,"display-k1xSpc":`xrvj5dj`,"gap-kOIVth":`x1r05nms`,"marginTop-keoZOQ":`x1u1y36e`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:102`},detailLabel:{"GatewayKitErrorCard__styles.detailLabel":`GatewayKitErrorCard__styles.detailLabel`,"fontSize-kGuDYH":`x14qa7mu`,"lineHeight-kLWn49":`x14vj8e1`,"fontWeight-k63SB2":`x1qvi77d`,"color-kMwMTN":`x19vemxs`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:107`},detailValue:{"GatewayKitErrorCard__styles.detailValue":`GatewayKitErrorCard__styles.detailValue`,"display-k1xSpc":`x1lliihq`,"borderRadius-kaIpWk":`x143j3yi`,"backgroundColor-kWkggS":`xij6k22`,"paddingTop-kLKAdn":`x2tg1xt`,"paddingBottom-kGO01o":`x1ww8orz`,"paddingInline-kg3NbH":`x1fk34n2`,"fontSize-kGuDYH":`x14qa7mu`,"lineHeight-kLWn49":`x14vj8e1`,"color-kMwMTN":`xzn0pkc`,"wordBreak-kTgw9":`x13faqbe`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:113`},primaryAction:{"GatewayKitErrorCard__styles.primaryAction":`GatewayKitErrorCard__styles.primaryAction`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"justifyContent-kjj79g":`xl56j7k`,"minHeight-kAzted":`x21xpn4`,"borderRadius-kaIpWk":`x143j3yi`,"paddingInline-kg3NbH":`x1fk34n2`,"backgroundColor-kWkggS":`x1qvyn6m`,"color-kMwMTN":`x18o46el`,"textDecoration-kybGjl":`x1hl2dhg`,"fontSize-kGuDYH":`x14qa7mu`,"fontWeight-k63SB2":`x1qvi77d`,"borderWidth-kMzoRj":`xc342km`,"borderStyle-ksu8eU":`x1y0btm7`,"cursor-kkrTdU":`xt0e3qv`,":hover_backgroundColor-kGzVvX":`x8av6v9`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:125`},secondaryAction:{"GatewayKitErrorCard__styles.secondaryAction":`GatewayKitErrorCard__styles.secondaryAction`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"justifyContent-kjj79g":`xl56j7k`,"minHeight-kAzted":`x21xpn4`,"borderRadius-kaIpWk":`x143j3yi`,"paddingInline-kg3NbH":`x1fk34n2`,"borderWidth-kMzoRj":`xmkeg23`,"borderStyle-ksu8eU":`x1y0btm7`,"borderColor-kVAM5u":`x84ybii`,"backgroundColor-kWkggS":`xjbqb8w`,"color-kMwMTN":`xreodjm`,"textDecoration-kybGjl":`x1hl2dhg`,"fontSize-kGuDYH":`x14qa7mu`,"fontWeight-k63SB2":`x1qvi77d`,"cursor-kkrTdU":`xt0e3qv`,":hover_backgroundColor-kGzVvX":`x1ehxjrm`,$$css:`@stridge/kit:src/shared/error-handling/components/GatewayKitErrorCard/GatewayKitErrorCard.styles.ts:144`}};export{t as styles};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/Action.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{jsx as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({href:i,onClick:a,variant:o=`primary`,children:s}){let c=r.props(o===`secondary`?t.secondaryAction:t.primaryAction);return i?n(`a`,{"data-stridge-slot":e.action,href:i,target:`_blank`,rel:`noreferrer`,className:c.className,style:c.style,children:s}):n(`button`,{"data-stridge-slot":e.action,type:`button`,onClick:a,className:c.className,style:c.style,children:s})}export{i as GatewayKitErrorCardAction};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/Actions.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{jsx as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({children:i}){return n(`div`,{"data-stridge-slot":e.actions,...r.props(t.actionsRow),children:i})}export{i as GatewayKitErrorCardActions};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/CodeSample.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{Section as n}from"./Section.js";import{jsx as r}from"react/jsx-runtime";import*as i from"@stylexjs/stylex";function a({title:a,children:o}){return r(n,{"data-stridge-slot":e.codeSampleSection,title:a,style:{marginTop:14},children:r(`pre`,{"data-stridge-slot":e.codeSample,...i.props(t.codeSample),children:o})})}export{a as GatewayKitErrorCardCodeSample};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/Description.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{jsx as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({children:i}){return n(`div`,{"data-stridge-slot":e.description,...r.props(t.bodyText),children:i})}export{i as GatewayKitErrorCardDescription};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/DetailRow.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{jsx as n,jsxs as r}from"react/jsx-runtime";import*as i from"@stylexjs/stylex";function a({label:a,value:o}){return r(`div`,{"data-stridge-slot":e.detailRow,...i.props(t.detailRow),children:[n(`div`,{...i.props(t.detailLabel),children:a}),n(`code`,{...i.props(t.detailValue),children:o})]})}export{a as DetailRow};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/Guidance.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{jsx as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({children:i}){return n(`div`,{"data-stridge-slot":e.guidance,...r.props(t.guidance),children:i})}export{i as GatewayKitErrorCardGuidance};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/Section.js

@@ -0,0 +1 @@
+"use client";import{styles as e}from"../GatewayKitErrorCard.styles.js";import{jsx as t,jsxs as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({title:i,children:a,id:o,style:s,"data-stridge-slot":c}){let l=r.props(e.section);return n(`div`,{id:o,"data-stridge-slot":c,className:l.className,style:{...l.style,...s},children:[t(`div`,{...r.props(e.sectionTitle),children:i}),a]})}export{i as Section};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/TechnicalDetails.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{Section as n}from"./Section.js";import{useGatewayKitErrorCardContext as r}from"../context.js";import{DetailRow as i}from"./DetailRow.js";import{jsx as a,jsxs as o}from"react/jsx-runtime";import*as s from"@stylexjs/stylex";function c({title:c}){let l=r(`GatewayKitErrorCard.TechnicalDetails`);return!l.hasTechnicalDetails||!l.showTechnicalDetails?null:o(n,{id:l.detailsId,"data-stridge-slot":e.technicalDetails,title:c,style:{marginTop:14},children:[l.resolvedErrorName?a(i,{label:`Error`,value:l.resolvedErrorName}):null,l.resolvedErrorMessage?a(i,{label:`Message`,value:l.resolvedErrorMessage}):null,l.isDevelopment&&l.errorStack?o(`div`,{style:{marginTop:10},children:[a(`div`,{...s.props(t.detailSubheading),children:`Stack`}),a(`pre`,{...s.props(t.stack),children:l.errorStack})]}):null]})}export{c as GatewayKitErrorCardTechnicalDetails};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/TechnicalDetailsToggle.js

@@ -0,0 +1 @@
+"use client";import{useLingui as e}from"../../../../i18n/useLingui.js";import"../../../../../i18n/index.js";import{GATEWAY_KIT_ERROR_CARD_SLOTS as t}from"../GatewayKitErrorCard.slots.js";import{styles as n}from"../GatewayKitErrorCard.styles.js";import{useGatewayKitErrorCardContext as r}from"../context.js";import{jsx as i}from"react/jsx-runtime";import*as a from"@stylexjs/stylex";function o({showLabel:o,hideLabel:s}={}){let c=r(`GatewayKitErrorCard.TechnicalDetailsToggle`),{_:l}=e();if(!c.hasTechnicalDetails)return null;let u=o??l({id:`aiEUrg`,message:`Show technical details`}),d=s??l({id:`DoS2vD`,message:`Hide technical details`}),f=a.props(n.secondaryAction);return i(`button`,{"data-stridge-slot":t.technicalDetailsToggle,type:`button`,onClick:c.toggleTechnicalDetails,"aria-expanded":c.showTechnicalDetails,"aria-controls":c.detailsId,className:f.className,style:f.style,children:c.showTechnicalDetails?d:u})}export{o as GatewayKitErrorCardTechnicalDetailsToggle};

package/dist/shared/error-handling/components/GatewayKitErrorCard/components/Title.js

@@ -0,0 +1 @@
+"use client";import{GATEWAY_KIT_ERROR_CARD_SLOTS as e}from"../GatewayKitErrorCard.slots.js";import{styles as t}from"../GatewayKitErrorCard.styles.js";import{jsx as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({children:i}){return n(`div`,{"data-stridge-slot":e.title,...r.props(t.title),children:i})}export{i as GatewayKitErrorCardTitle};

package/dist/shared/error-handling/components/GatewayKitErrorCard/context.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t}from"react";const n=e(null);function r(e){let r=t(n);if(!r)throw Error(`${e} must be used inside <GatewayKitErrorCard>.`);return r}export{n as GatewayKitErrorCardContext,r as useGatewayKitErrorCardContext};

package/dist/shared/error-handling/components/GatewayKitErrorCard/index.js

@@ -0,0 +1 @@
+import"./GatewayKitErrorCard.slots.js";import"./GatewayKitErrorCard.js";

package/dist/shared/error-handling/components/GatewayKitRecoveryError.js

@@ -0,0 +1 @@
+"use client";import{Trans as e}from"../../i18n/Trans.js";import"../../../i18n/index.js";import{GatewayKitErrorCard as t}from"./GatewayKitErrorCard/GatewayKitErrorCard.js";import"./GatewayKitErrorCard/index.js";import{jsx as n,jsxs as r}from"react/jsx-runtime";function i({error:i,onRetry:a,className:o}){return r(t,{"data-testid":`gateway-kit-recovery-error`,className:o,error:i,defaultErrorName:`Error`,defaultErrorMessage:`The kit hit an unexpected error and could not finish rendering.`,children:[n(t.Title,{children:n(e,{id:`nwtY4N`,message:`Something went wrong`})}),n(t.Description,{children:n(`p`,{children:n(e,{id:`G-SK3q`,message:`The kit hit an unexpected error and could not finish rendering. Try again, or close this dialog and retry from the host.`})})}),r(t.Actions,{children:[a?n(t.Action,{onClick:a,variant:`primary`,children:n(e,{id:`KDw4GX`,message:`Try again`})}):null,n(t.TechnicalDetailsToggle,{})]}),n(t.TechnicalDetails,{title:`Technical details`})]})}export{i as GatewayKitRecoveryError};

package/dist/shared/error-handling/components/GatewayKitSetupError.js

@@ -0,0 +1 @@
+"use client";import{GatewayKitErrorCard as e}from"./GatewayKitErrorCard/GatewayKitErrorCard.js";import"./GatewayKitErrorCard/index.js";import{GATEWAY_KIT_GUIDES as t}from"../constants/guides.js";import{WAGMI_SETUP_CODE_SAMPLE as n}from"../constants/snippets.js";import{jsx as r,jsxs as i}from"react/jsx-runtime";function a({error:a,className:o}){return i(e,{"data-testid":`gateway-kit-setup-error`,className:o,error:a,defaultErrorName:`WagmiProviderNotFoundError`,defaultErrorMessage:"useConfig must be used within `WagmiProvider`",children:[r(e.Title,{children:`Missing wallet provider`}),r(e.Description,{children:i(`p`,{children:[`Stridge Kit requires a `,r(`code`,{children:`WagmiProvider`}),` above it in the React tree.`]})}),r(e.Guidance,{children:i(`p`,{className:`GatewayKitSetupError__styles.guidance x4z9k3i`,"data-style-src":`@stridge/kit:src/shared/error-handling/components/GatewayKitSetupError.tsx:8`,children:[`Add `,r(`code`,{children:`WagmiProvider`}),` at your app root, then render the kit inside that provider so wallet state is available.`]})}),i(e.Actions,{children:[r(e.Action,{href:t.wagmiSetup,variant:`primary`,children:`View integration docs`}),r(e.TechnicalDetailsToggle,{})]}),r(e.CodeSample,{title:`Setup example`,children:n}),r(e.TechnicalDetails,{title:`Technical details`})]})}export{a as GatewayKitSetupError};

package/dist/shared/error-handling/constants/guides.js

@@ -0,0 +1 @@
+const e={wagmiSetup:`/docs/integration/wagmi`};export{e as GATEWAY_KIT_GUIDES};

package/dist/shared/error-handling/constants/snippets.js

@@ -0,0 +1,6 @@
+const e=`import { WagmiProvider } from 'wagmi'
+import { wagmiConfig } from './config'
+
+<WagmiProvider config={wagmiConfig}>
+  <App />
+</WagmiProvider>`;export{e as WAGMI_SETUP_CODE_SAMPLE};

package/dist/shared/error-handling/index.js

@@ -0,0 +1 @@
+import"./components/GatewayKitErrorCard/GatewayKitErrorCard.js";import"./components/GatewayKitErrorCard/index.js";import"./components/GatewayKitRecoveryError.js";import"./constants/guides.js";import"./constants/snippets.js";import"./components/GatewayKitSetupError.js";import"./components/GatewayKitBoundary.js";

package/dist/shared/error-handling/lib/isWagmiProviderMissingError.js

@@ -0,0 +1 @@
+import{WagmiProviderNotFoundError as e}from"wagmi";function t(t){return t instanceof e?!0:t instanceof Error?t.name===`WagmiProviderNotFoundError`||t.message.includes("must be used within `WagmiProvider`"):!1}export{t as isWagmiProviderMissingError};

package/dist/shared/format/formatDurationCoarse.d.ts

@@ -0,0 +1,29 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatDurationCoarse.d.ts
+/**
+ * Formats a millisecond duration as a coarse human-readable label, suited for deposit ETA
+ * displays where minor wire jitter should not change the rendered value. Buckets:
+ *
+ * - `< 60_000` → `"< 1 min"`
+ * - `< 3_600_000` → `"N min"` (rounded down to whole minutes)
+ * - otherwise → `"N hr"` (rounded down to whole hours)
+ *
+ * Sub-second precision is intentionally absent. The unit suffix runs through Lingui so the result
+ * localizes (e.g. `"5 min"` in English, `"5 دقيقة"` in Arabic) without callers having to compose
+ * their own translation keys.
+ *
+ * @example
+ *
+ * ```ts
+ * formatDurationCoarse(15_000, i18n);     // → "< 1 min"
+ * formatDurationCoarse(305_000, i18n);    // → "5 min"
+ * formatDurationCoarse(7_200_000, i18n);  // → "2 hr"
+ * ```
+ *
+ * @param ms - Elapsed time in milliseconds.
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n._(…)` resolves the unit suffix.
+ */
+declare function formatDurationCoarse(ms: number, i18n: I18n): string;
+//#endregion
+export { formatDurationCoarse };

package/dist/shared/format/formatDurationCoarse.js

@@ -0,0 +1 @@
+function e(e,t){if(e<6e4)return t._({id:`< 1 min`,message:`< 1 min`});if(e<36e5){let n=Math.floor(e/6e4);return t._({id:`{minutes} min`,message:`{minutes} min`,values:{minutes:n}})}let n=Math.floor(e/36e5);return t._({id:`{hours} hr`,message:`{hours} hr`,values:{hours:n}})}export{e as formatDurationCoarse};

package/dist/shared/format/formatDurationCompact.d.ts

@@ -0,0 +1,28 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatDurationCompact.d.ts
+/**
+ * Formats an elapsed millisecond duration as a compact total — used for the success receipt's
+ * "Total time" row.
+ *
+ * Examples (en-US):
+ * - `7_000` → `"7s"`
+ * - `107_000` → `"1m 47s"`
+ * - `3_725_000` → `"1h 2m 5s"`
+ *
+ * Each unit suffix runs through Lingui so the result localizes (e.g. `"1 د 47 ث"` in Arabic)
+ * without callers composing their own translation keys.
+ *
+ * @example
+ *
+ * ```ts
+ * formatDurationCompact(7000, i18n);     // → "7s"
+ * formatDurationCompact(107_000, i18n);  // → "1m 47s"
+ * ```
+ *
+ * @param ms - Elapsed time in milliseconds.
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n._(…)` resolves each unit suffix.
+ */
+declare function formatDurationCompact(ms: number, i18n: I18n): string;
+//#endregion
+export { formatDurationCompact };

package/dist/shared/format/formatDurationCompact.js

@@ -0,0 +1 @@
+function e(e,t){let n=Math.max(0,Math.round(e/1e3)),r=Math.floor(n/3600),i=Math.floor(n%3600/60),a=n%60,o=e=>t._({id:`{n}h`,message:`{n}h`,values:{n:e}}),s=e=>t._({id:`{n}m`,message:`{n}m`,values:{n:e}}),c=e=>t._({id:`{n}s`,message:`{n}s`,values:{n:e}});return r>0?`${o(r)} ${s(i)} ${c(a)}`:i>0?`${s(i)} ${c(a)}`:c(a)}export{e as formatDurationCompact};

package/dist/shared/format/formatNetworkName.d.ts

@@ -0,0 +1,27 @@
+//#region src/shared/format/formatNetworkName.d.ts
+/**
+ * Normalize a wire network name into the kit's display form. Stridge gateway responses (and most
+ * upstream catalogs) emit network names in lowercase canonical form (`"ethereum"`, `"bsc"`,
+ * `"arbitrum"`); the kit's chrome shows them title-cased so picker rows, pill labels, and headers
+ * read consistently regardless of which driver supplied the value.
+ *
+ * Names whose uppercased form matches a registered acronym (`BSC`, `BNB`, `ETH`, `USDC`, `USDT`,
+ * `USD`) are uppercased entirely — preserving the natural shape readers expect for those tickers.
+ * Every other input is left as-is from the second character onward and only the first letter is
+ * upper-cased; pre-cased input like `"Polygon"` is returned unchanged rather than re-cased.
+ *
+ * @example
+ *
+ * ```ts
+ * formatNetworkName("ethereum"); // → "Ethereum"
+ * formatNetworkName("bsc");      // → "BSC"
+ * formatNetworkName("Polygon");  // → "Polygon"
+ * formatNetworkName("");          // → ""
+ * ```
+ *
+ * @param name - Wire-supplied network name. Empty input round-trips to the empty string so callers
+ *               can pass DTO fields directly without a guard.
+ */
+declare function formatNetworkName(name: string): string;
+//#endregion
+export { formatNetworkName };

package/dist/shared/format/formatNetworkName.js

@@ -0,0 +1 @@
+function e(e){if(!e)return``;let n=e.toUpperCase();return t.has(n)?n:e.charAt(0).toUpperCase()+e.slice(1)}const t=new Set([`BSC`,`BNB`,`ETH`,`USDC`,`USDT`,`USD`]);export{e as formatNetworkName};

package/dist/shared/format/formatPercent.d.ts

@@ -0,0 +1,23 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatPercent.d.ts
+/**
+ * Formats a percent value (the input is in **percent units** — `0.21` means `0.21%`) as a
+ * locale-aware decimal string with the `%` glyph appended. The glyph is appended manually instead
+ * of relying on `Intl.NumberFormatOptions.style: "percent"` so the symbol placement stays
+ * consistent across locales.
+ *
+ * @example
+ *
+ * ```ts
+ * formatPercent(0.21, i18n);   // → "0.21%"
+ * formatPercent(12.5, i18n);   // → "12.50%"
+ * ```
+ *
+ * @param value - Percent value (`0.21` for `0.21%`, NOT `0.0021`).
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n.locale` drives `Intl.NumberFormat`.
+ * @param options - Optional override for the default 2-decimal `Intl.NumberFormatOptions`.
+ */
+declare function formatPercent(value: number, i18n: I18n, options?: Intl.NumberFormatOptions): string;
+//#endregion
+export { formatPercent };

package/dist/shared/format/formatPercent.js

@@ -0,0 +1 @@
+const e={minimumFractionDigits:2,maximumFractionDigits:2};function t(t,n,r){return`${new Intl.NumberFormat(n.locale,r??e).format(t)}%`}export{t as formatPercent};

package/dist/shared/format/formatTimestamp.d.ts

@@ -0,0 +1,22 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatTimestamp.d.ts
+/**
+ * Formats a unix-millisecond timestamp for display, locale-aware.
+ *
+ * @example
+ *
+ * ```ts
+ * formatTimestamp(1_778_086_787_000, i18n);
+ * // → "May 6, 16:59"     (en-US)
+ * // → "6 may, 16:59"     (es)
+ * // → "٦ مايو، 16:59"   (ar)
+ * ```
+ *
+ * @param epochMs - Unix milliseconds.
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n.locale` drives the formatter.
+ * @param options - Optional override for the default short-form `Intl.DateTimeFormatOptions`.
+ */
+declare function formatTimestamp(epochMs: number, i18n: I18n, options?: Intl.DateTimeFormatOptions): string;
+//#endregion
+export { formatTimestamp };

package/dist/shared/format/formatTimestamp.js

@@ -0,0 +1 @@
+const e={month:`short`,day:`numeric`,hour:`2-digit`,minute:`2-digit`,hour12:!1};function t(t,n,r){return new Intl.DateTimeFormat(n.locale,r??e).format(new Date(t))}export{t as formatTimestamp};

package/dist/shared/format/formatTokenAmount.d.ts

@@ -0,0 +1,46 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatTokenAmount.d.ts
+/**
+ * Optional knobs for {@link formatTokenAmount}.
+ */
+interface FormatTokenAmountOptions {
+  /**
+   * Maximum decimal places to render. Defaults to `6`.
+   */
+  maxDecimals?: number;
+  /**
+   * Groups the integer part with locale-appropriate separators (e.g. `1,234.5678`). Defaults to
+   * `false`, except when `compact` is enabled and the magnitude reaches `≥ 1000`.
+   */
+  useGrouping?: boolean;
+  /**
+   * When `true`, picks `maxDecimals` adaptively from magnitude (`< 1` → 6, `< 1,000` → 4,
+   * `≥ 1,000` → 2 with grouping forced on). The explicit `maxDecimals` (when provided) caps the
+   * picked value. Defaults to `false`.
+   */
+  compact?: boolean;
+}
+/**
+ * Formats a human-readable token amount as a locale-aware decimal string. Accepts a pre-scaled
+ * decimal value (e.g. `2` USDT, `1.99580` USDC, `0.000977` ETH) — never the on-chain base-unit
+ * integer.
+ *
+ * Tiny non-zero values (below the `maxDecimals` epsilon) render as `< 0.000001` instead of
+ * collapsing to zero, so balance lists never read as "no balance" when there's actual dust.
+ *
+ * @example
+ *
+ * ```ts
+ * formatTokenAmount(1.99580, i18n);              // → "1.9958"
+ * formatTokenAmount(1234.5, i18n, { compact: true }); // → "1,234.50"
+ * formatTokenAmount(0.000000934, i18n);          // → "< 0.000001"
+ * ```
+ *
+ * @param value - Decimal token amount (post-scale, not base units).
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n.locale` drives `Intl.NumberFormat`.
+ * @param options - See {@link FormatTokenAmountOptions}.
+ */
+declare function formatTokenAmount(value: number, i18n: I18n, options?: FormatTokenAmountOptions): string;
+//#endregion
+export { FormatTokenAmountOptions, formatTokenAmount };

package/dist/shared/format/formatTokenAmount.js

@@ -0,0 +1 @@
+function e(e){return 10**-e}function t(e){let t=Math.abs(e);return t>=1e3?2:t>=1?4:6}function n(n,r,i={}){let a=i.maxDecimals,o=i.compact??!1,s=o?t(n):6,c=a===void 0?s:Math.min(a,s),l=i.useGrouping??(o&&Math.abs(n)>=1e3);if(n===0)return new Intl.NumberFormat(r.locale,{minimumFractionDigits:0,maximumFractionDigits:c,useGrouping:l}).format(0);let u=e(c),d=Math.abs(n);if(d>0&&d<u){let e=new Intl.NumberFormat(r.locale,{minimumFractionDigits:0,maximumFractionDigits:c,useGrouping:l}).format(u);return n<0?`> -${e}`:`< ${e}`}return new Intl.NumberFormat(r.locale,{minimumFractionDigits:0,maximumFractionDigits:c,useGrouping:l}).format(n)}export{n as formatTokenAmount};

package/dist/shared/format/formatUsd.d.ts

@@ -0,0 +1,41 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatUsd.d.ts
+/**
+ * Optional knobs for {@link formatUsd}.
+ */
+interface FormatUsdOptions {
+  /**
+   * When `true` (the default), non-zero values that would round to `$0.00` render as `< $0.01`
+   * instead — keeps tiny balances visible in lists where `$0.00` reads as "no balance". Set to
+   * `false` for breakdown views where the rounding to `$0.00` is the right signal.
+   */
+  showSmallValueClamp?: boolean;
+  /**
+   * Override the default 2-decimal currency `Intl.NumberFormatOptions`. Useful for callers that
+   * want extra precision (e.g. for rate displays).
+   */
+  intlOptions?: Intl.NumberFormatOptions;
+}
+/**
+ * Formats a USD amount as `"$0.00"` — locale-aware currency, two decimals.
+ *
+ * Non-zero values smaller than one cent render as `< $0.01` so display lists never visually read
+ * as "zero" when there's a real-but-tiny balance. Pass `{ showSmallValueClamp: false }` to opt
+ * out (e.g. for breakdown views where rounding to `$0.00` is intentional).
+ *
+ * @example
+ *
+ * ```ts
+ * formatUsd(2.0, i18n);          // → "$2.00"
+ * formatUsd(0.005, i18n);        // → "< $0.01"
+ * formatUsd(0.005, i18n, { showSmallValueClamp: false }); // → "$0.01"
+ * ```
+ *
+ * @param value - USD amount.
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n.locale` drives `Intl.NumberFormat`.
+ * @param options - See {@link FormatUsdOptions}.
+ */
+declare function formatUsd(value: number, i18n: I18n, options?: FormatUsdOptions): string;
+//#endregion
+export { FormatUsdOptions, formatUsd };

package/dist/shared/format/formatUsd.js

@@ -0,0 +1 @@
+const e={style:`currency`,currency:`USD`,minimumFractionDigits:2,maximumFractionDigits:2};function t(t,n,r={}){let i=r.intlOptions??e,a=r.showSmallValueClamp??!0,o=new Intl.NumberFormat(n.locale,i);return a&&t>0&&t<.01?`< ${o.format(.01)}`:o.format(t)}export{t as formatUsd};

package/dist/shared/format/shortenAddress.d.ts

@@ -0,0 +1,27 @@
+//#region src/shared/format/shortenAddress.d.ts
+/**
+ * Truncates a 0x-prefixed hex string (wallet address, transaction hash, contract address, …) to
+ * the kit's canonical compact form: the leading `0x` followed by a Unicode horizontal ellipsis
+ * (`…`, U+2026) and the last four characters of the input.
+ *
+ * The canonical form is **identical** for every entity that carries an on-chain identifier in a
+ * driver `payload` — wallet addresses, deposit-tx hashes, settlement-tx hashes, deposit-address
+ * pills. Components never re-truncate; they render the formatted string the transformer produced.
+ *
+ * @example
+ *
+ * ```ts
+ * shortenAddress("0xCA8779a5FD7cEAf54211177A2b22dB5E0480685c");
+ * // → "0x…685c"
+ *
+ * shortenAddress("0xa15b11eb774cfac27b369f3d1908b0d1d8aa48b893d7a1e89612d8438920650f");
+ * // → "0x…650f"
+ * ```
+ *
+ * @param value - The full hex identifier. Must start with `0x` and have at least four characters
+ *                after the prefix; otherwise the input is returned unchanged so callers never see
+ *                a truncated form that would be ambiguous.
+ */
+declare function shortenAddress(value: string): string;
+//#endregion
+export { shortenAddress };

package/dist/shared/format/shortenAddress.js

@@ -0,0 +1 @@
+function e(e){return!e.startsWith(`0x`)||e.length<6?e:`0x…${e.slice(-4)}`}export{e as shortenAddress};