@stridge/kit 0.1.0-alpha.0

package/dist/shared/widgets/success-state/compound/components/MoreDetails.js

@@ -0,0 +1 @@
+"use client";import{useLingui as e}from"../../../../i18n/useLingui.js";import"../../../../../i18n/index.js";import{ChevronRightIcon as t}from"../../../../icons/ChevronRightIcon.js";import"../../../../../icons/index.js";import{Collapsible as n}from"../../../../ui/Collapsible/Collapsible.js";import"../../../../ui/Collapsible/index.js";import{Details as r}from"../../../../ui/Details/Details.js";import"../../../../ui/Details/index.js";import{useDirectionalChevronTransform as i}from"../../../../dialog/useDirectionalChevronTransform.js";import{SUCCESS_STATE_SLOTS as a}from"../SuccessState.slots.js";import{styles as o}from"../SuccessState.styles.js";import{useCallback as s,useState as c}from"react";import{jsx as l,jsxs as u}from"react/jsx-runtime";import*as d from"@stylexjs/stylex";function f({label:f,defaultOpen:p=!1,open:m,onOpenChange:h,children:g}){let{_}=e(),v=f??_({id:`LEbOpR`,message:`More details`}),y=typeof m==`boolean`,[b,x]=c(p),S=y?m:b,C=s(e=>{y||x(e),h?.(e)},[y,h]),w=d.props(o.moreDetailsTrigger,S?null:o.moreDetailsTriggerClosed),T=d.props(o.moreDetailsChevron),E=i(S);return u(n,{open:S,onOpenChange:C,children:[l(n.Trigger,{nativeButton:!1,render:l(r.Row,{"data-stridge-slot":a.moreDetailsTrigger,label:v,className:w.className,style:w.style,children:l(t,{"aria-hidden":!0,className:T.className,style:{...T.style,transform:E}})})}),l(n.Panel,{children:g})]})}export{f as SuccessStateMoreDetails};

package/dist/shared/widgets/success-state/compound/components/RouteValue.d.ts

@@ -0,0 +1,15 @@
+import { SuccessStateRouteValueProps } from "../types.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/widgets/success-state/compound/components/RouteValue.d.ts
+/**
+ * RouteValue helper — `Hop1 → Hop2 → Hop3`, the canonical composition
+ * used inside the Route row. Reuses the kit's `ArrowRightIcon` so the
+ * separator matches the visual language of the Send→Receive arrow in
+ * `TransferCrypto.Summary`.
+ */
+declare function SuccessStateRouteValue({
+  hops
+}: SuccessStateRouteValueProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SuccessStateRouteValue };

package/dist/shared/widgets/success-state/compound/components/RouteValue.js

@@ -0,0 +1 @@
+"use client";import{ArrowRightIcon as e}from"../../../../icons/ArrowRightIcon.js";import"../../../../../icons/index.js";import{text as t}from"../../../../ui/Text/Text.js";import"../../../../../ui/index.js";import{SUCCESS_STATE_SLOTS as n}from"../SuccessState.slots.js";import{styles as r}from"../SuccessState.styles.js";import{Fragment as i}from"react";import{jsx as a,jsxs as o}from"react/jsx-runtime";import*as s from"@stylexjs/stylex";function c({hops:c}){return a(`span`,{"data-stridge-slot":n.routeValue,...s.props(r.routeValue),children:c.map((n,c)=>o(i,{children:[c>0?a(e,{"aria-hidden":!0,...s.props(r.routeArrow)}):null,a(t.span,{size:`sm`,fontWeight:`medium`,leading:`tight`,children:n})]},`${n}-${c}`))})}export{c as SuccessStateRouteValue};

package/dist/shared/widgets/success-state/compound/components/Rows.d.ts

@@ -0,0 +1,69 @@
+import { SuccessStateRowProps } from "../types.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/widgets/success-state/compound/components/Rows.d.ts
+/**
+ * Predefined `Fill status` row — renders the kit's success status pill.
+ * Always renders.
+ */
+declare function SuccessStateFillStatusRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element;
+/**
+ * Predefined `Total time` row. Reads `totalTime` from the
+ * {@link SuccessState} root and renders nothing when the value is missing.
+ */
+declare function SuccessStateTotalTimeRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element | null;
+/**
+ * Predefined `Source` row — wallet icon + name + truncated address +
+ * explorer link. Reads `sourceWallet` from the {@link SuccessState} root
+ * and renders nothing when the wallet payload is missing.
+ */
+declare function SuccessStateSourceRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element | null;
+/**
+ * Predefined `Destination` row. Reads `creditedTo` from the
+ * {@link SuccessState} root, falling back to the credited asset's symbol.
+ */
+declare function SuccessStateDestinationRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element;
+/**
+ * Predefined `You receive` row — `<icon> amount symbol` composition. Reads
+ * `amount` and `creditedAsset` from the {@link SuccessState} root.
+ */
+declare function SuccessStateYouReceiveRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element;
+/**
+ * Predefined `Deposit tx` row inside `SuccessState.MoreDetails`. Reads
+ * `depositTx` from the {@link SuccessState} root and renders nothing when
+ * the tx is missing.
+ */
+declare function SuccessStateDepositTxRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element | null;
+/**
+ * Predefined `Settlement tx` row inside `SuccessState.MoreDetails`.
+ * Reads `completionTx` from the {@link SuccessState} root.
+ */
+declare function SuccessStateCompletionTxRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element | null;
+/**
+ * Predefined `Order submitted` row inside `SuccessState.MoreDetails`.
+ */
+declare function SuccessStateSubmittedAtRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element | null;
+/**
+ * Predefined `Order filled` row inside `SuccessState.MoreDetails`.
+ */
+declare function SuccessStateFilledAtRow({
+  label
+}?: SuccessStateRowProps): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { SuccessStateCompletionTxRow, SuccessStateDepositTxRow, SuccessStateDestinationRow, SuccessStateFillStatusRow, SuccessStateFilledAtRow, SuccessStateSourceRow, SuccessStateSubmittedAtRow, SuccessStateTotalTimeRow, SuccessStateYouReceiveRow };

package/dist/shared/widgets/success-state/compound/components/Rows.js

@@ -0,0 +1 @@
+"use client";import{useLingui as e}from"../../../../i18n/useLingui.js";import"../../../../../i18n/index.js";import{TxHashValue as t}from"../../../../primitives/TxHashValue/TxHashValue.js";import"../../../../primitives/TxHashValue/index.js";import{WalletValue as n}from"../../../../primitives/WalletValue/WalletValue.js";import"../../../../primitives/WalletValue/index.js";import{useSuccessStateContext as r}from"../context.js";import{SuccessStateAssetValue as i}from"./AssetValue.js";import{SuccessStateDetail as a}from"./Detail.js";import{SuccessStateStatusPill as o}from"./StatusPill.js";import{jsx as s}from"react/jsx-runtime";function c({label:t}={}){let{_:n}=e();return s(a,{label:t??n({id:`yxnt3y`,message:`Fill status`}),value:s(o,{})})}function l({label:t}={}){let n=r(`SuccessState.TotalTimeRow`),{_:i}=e();return n.totalTime===void 0?null:s(a,{label:t??i({id:`_kXBrK`,message:`Total time`}),value:n.totalTime})}function u({label:t}={}){let i=r(`SuccessState.SourceRow`),{_:o}=e();if(!i.sourceWallet)return null;let{name:c,address:l,explorerUrl:u}=i.sourceWallet;return s(a,{label:t??o({id:`wdxz7K`,message:`Source`}),value:s(n,{name:c??o({id:`sb9Y58`,message:`Wallet`}),address:l,...u?{explorerUrl:u}:{},density:`compact`,hideIcon:!0})})}function d({label:t}={}){let n=r(`SuccessState.DestinationRow`),{_:i}=e();return s(a,{label:t??i({id:`Enslfm`,message:`Destination`}),value:n.creditedTo??n.creditedAsset.symbol})}function f({label:t}={}){let n=r(`SuccessState.YouReceiveRow`),{_:o}=e(),c=n.creditedAsset;return s(a,{label:t??o({id:`88cUW-`,message:`You receive`}),value:s(i,{amount:n.amount,symbol:c.symbol,...c.chainId===void 0?{}:{chainId:c.chainId},...c.address?{address:c.address}:{},...c.isNative===void 0?{}:{isNative:c.isNative},...c.logoUrl?{logoUrl:c.logoUrl}:{}})})}function p({label:n}={}){let i=r(`SuccessState.DepositTxRow`),{_:o}=e();return i.depositTx?s(a,{label:n??o({id:`Q12Rrs`,message:`Deposit tx`}),value:s(t,{hash:i.depositTx.hash,...i.depositTx.explorerUrl?{explorerUrl:i.depositTx.explorerUrl}:{}})}):null}function m({label:n}={}){let i=r(`SuccessState.CompletionTxRow`),{_:o}=e();return i.completionTx?s(a,{label:n??o({id:`cxR5Qy`,message:`Settlement tx`}),value:s(t,{hash:i.completionTx.hash,...i.completionTx.explorerUrl?{explorerUrl:i.completionTx.explorerUrl}:{}})}):null}function h({label:t}={}){let n=r(`SuccessState.SubmittedAtRow`),{_:i}=e();return n.submittedAt===void 0?null:s(a,{label:t??i({id:`TT0aVH`,message:`Order submitted`}),value:n.submittedAt})}function g({label:t}={}){let n=r(`SuccessState.FilledAtRow`),{_:i}=e();return n.filledAt===void 0?null:s(a,{label:t??i({id:`lOEm_1`,message:`Order filled`}),value:n.filledAt})}export{m as SuccessStateCompletionTxRow,p as SuccessStateDepositTxRow,d as SuccessStateDestinationRow,c as SuccessStateFillStatusRow,g as SuccessStateFilledAtRow,u as SuccessStateSourceRow,h as SuccessStateSubmittedAtRow,l as SuccessStateTotalTimeRow,f as SuccessStateYouReceiveRow};

package/dist/shared/widgets/success-state/compound/components/StatusPill.d.ts

@@ -0,0 +1,13 @@
+import { SuccessStateStatusPillProps } from "../types.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/widgets/success-state/compound/components/StatusPill.d.ts
+/**
+ * StatusPill helper — small inline label tinted with the kit's
+ * success accent. Used inside the "Fill status" detail row.
+ */
+declare function SuccessStateStatusPill({
+  children
+}: SuccessStateStatusPillProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SuccessStateStatusPill };

package/dist/shared/widgets/success-state/compound/components/StatusPill.js

@@ -0,0 +1 @@
+"use client";import{useLingui as e}from"../../../../i18n/useLingui.js";import"../../../../../i18n/index.js";import{text as t}from"../../../../ui/Text/Text.js";import"../../../../../ui/index.js";import{SUCCESS_STATE_SLOTS as n}from"../SuccessState.slots.js";import{jsx as r}from"react/jsx-runtime";function i({children:i}){let{_:a}=e(),o=i??a({id:`olEUh2`,message:`Successful`});return r(t.span,{"data-stridge-slot":n.statusPill,size:`sm`,fontWeight:`semibold`,leading:`tight`,tracking:`tight`,color:`success`,children:o})}export{i as SuccessStateStatusPill};

package/dist/shared/widgets/success-state/compound/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 rendered inside <SuccessState>.`);return r}export{n as SuccessStateContext,r as useSuccessStateContext};

package/dist/shared/widgets/success-state/compound/index.d.ts

@@ -0,0 +1,3 @@
+import { SuccessStateActionsProps, SuccessStateAsset, SuccessStateAssetValueProps, SuccessStateBodyProps, SuccessStateDetailProps, SuccessStateDetailsProps, SuccessStateDialogProps, SuccessStateExplorer, SuccessStateHeaderProps, SuccessStateHeadlineProps, SuccessStateMoreDetailsProps, SuccessStateProps, SuccessStateRouteValueProps, SuccessStateRowProps, SuccessStateSourceWallet, SuccessStateStatusPillProps, SuccessStateTxRef } from "./types.js";
+import { SuccessState } from "./SuccessState.js";
+import { SUCCESS_STATE_SLOTS, SuccessStateSlot } from "./SuccessState.slots.js";

package/dist/shared/widgets/success-state/compound/index.js

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

package/dist/shared/widgets/success-state/compound/types.d.ts

@@ -0,0 +1,307 @@
+import { DialogShellControls } from "../../../dialog/DialogShell.js";
+import { AssetDescriptor } from "../../asset-descriptor.js";
+import { ComponentProps, ReactNode } from "react";
+import { DestinationDto, GatewayLegFromDto, GatewayLegToDto, GatewayPollResponse } from "@stridge/sdk";
+
+//#region src/shared/widgets/success-state/compound/types.d.ts
+/**
+ * The credited asset rendered in the Hero (icon + symbol) and used as the default suffix for the
+ * "CREDITED TO …" caption. Extends the kit-wide {@link AssetDescriptor} with the DTO + response
+ * slots headless integrators can read for the matched settlement.
+ */
+interface SuccessStateAsset extends AssetDescriptor {
+  /**
+   * Destination DTO carried from the matched (succeeded) settlement.
+   */
+  raw?: DestinationDto;
+  /**
+   * Full `gateway/{owner}` poll response that produced the destination.
+   */
+  responseRaw?: GatewayPollResponse;
+}
+/**
+ * Config for the secondary "View on …" link rendered inside the Actions
+ * footer. When omitted, the link is hidden and only the primary CTA
+ * remains.
+ */
+interface SuccessStateExplorer {
+  /** External URL the link opens in a new tab. */
+  url: string;
+  /** Visible link label. Defaults to `"View on Explorer"`. */
+  label?: string;
+}
+/**
+ * Props for `<SuccessState.Dialog>` — the dialog form of the
+ * SuccessState widget. Combines the widget root props with the shared
+ * dialog shell controls (`open` / `defaultOpen` / `onOpenChange` /
+ * `trigger`).
+ */
+type SuccessStateDialogProps = SuccessStateProps & DialogShellControls;
+/**
+ * Reference to a single transaction surfaced inside the {@link SuccessStateMoreDetails} panel.
+ * `hash` is pre-formatted (driver-truncated to `0x…<last 4>`); the compound never reformats.
+ */
+interface SuccessStateTxRef {
+  /** Pre-formatted hash string (e.g. `"0x…f6b72a"`). */
+  hash: string;
+  explorerUrl?: string;
+  /**
+   * Source leg DTO (`from` for the deposit tx, `to` for the completion tx).
+   */
+  raw?: GatewayLegFromDto | GatewayLegToDto;
+  /**
+   * Full `gateway/{owner}` poll response that produced the leg.
+   */
+  responseRaw?: GatewayPollResponse;
+}
+/**
+ * Public props accepted by the {@link SuccessState} root.
+ *
+ * Receipt-row data is pre-formatted by driver transformer code — `amount` arrives as the kit-
+ * formatted display string, timestamps arrive as locale-aware date strings, hashes arrive
+ * truncated. The compound is pure layout.
+ */
+interface SuccessStateProps {
+  /** Pre-formatted hero amount string (e.g. `"1.99580"`). */
+  amount: string;
+  /**
+   * The asset that landed — drives the Hero icon, the Hero amount-line symbol, the
+   * default "CREDITED TO …" caption, and the `<YouReceiveRow>`'s logo.
+   */
+  creditedAsset: SuccessStateAsset;
+  /**
+   * Optional caption suffix shown after `"CREDITED TO "`. Defaults to `creditedAsset.symbol`
+   * when omitted.
+   */
+  creditedTo?: string;
+  /**
+   * Optional secondary link rendered below the Done CTA in the Actions footer.
+   */
+  explorer?: SuccessStateExplorer;
+  /** Source-chain broadcast tx — surfaced inside `SuccessState.MoreDetails`. */
+  depositTx?: SuccessStateTxRef;
+  /** Destination-chain settlement tx — surfaced inside `SuccessState.MoreDetails`. */
+  completionTx?: SuccessStateTxRef;
+  /** Pre-formatted "order submitted" timestamp string (locale-aware). */
+  submittedAt?: string;
+  /** Pre-formatted "order filled" timestamp string (locale-aware). */
+  filledAt?: string;
+  /**
+   * Pre-formatted total-time string (e.g. `"23s"`). Surfaces as the
+   * `Total time` row inside `<SuccessState.TotalTimeRow />`.
+   */
+  totalTime?: string;
+  /**
+   * Source-wallet payload — surfaces as the `Source` row inside
+   * `<SuccessState.SourceRow />`.
+   */
+  sourceWallet?: SuccessStateSourceWallet;
+  /**
+   * Optional override for the `Header` title. Defaults to
+   * `"Deposit received"`.
+   */
+  headerTitle?: string;
+  /**
+   * Optional override for the `Headline` title. Defaults to
+   * `"Deposit successful"`.
+   */
+  headlineTitle?: string;
+  /**
+   * Optional override for the `Headline` description. Defaults to
+   * `"Your funds were successfully deposited."`.
+   */
+  headlineDescription?: string;
+  /**
+   * Click handler routed to the primary Done CTA on the Actions footer.
+   */
+  onDone?: () => void;
+  /**
+   * Optional secondary close-button click handler. When provided, the
+   * Actions footer renders a side-by-side pair (Close + Done).
+   */
+  onClose?: () => void;
+  /**
+   * Optional override for the Done CTA label. Defaults to `"Done"`.
+   */
+  doneLabel?: string;
+  /**
+   * Optional override for the Close CTA label. Defaults to `"Close"`.
+   */
+  closeLabel?: string;
+  /** Compound parts; see `SuccessState.Header`, `SuccessState.Hero`, etc. */
+  children?: ReactNode;
+}
+/**
+ * Source-wallet payload backing the predefined `Source` row.
+ */
+interface SuccessStateSourceWallet {
+  /** Wallet display name (e.g. `"Wallet"` or a host-supplied label). */
+  name?: string;
+  /** Pre-formatted address string. */
+  address: string;
+  /** Explorer URL for the wallet on its native chain. */
+  explorerUrl?: string;
+}
+/**
+ * Props for the predefined detail rows
+ * ({@link SuccessState.FillStatusRow},
+ * {@link SuccessState.TotalTimeRow},
+ * {@link SuccessState.SourceRow},
+ * {@link SuccessState.DestinationRow},
+ * {@link SuccessState.YouReceiveRow},
+ * {@link SuccessState.DepositTxRow},
+ * {@link SuccessState.CompletionTxRow},
+ * {@link SuccessState.SubmittedAtRow},
+ * {@link SuccessState.FilledAtRow}). Each row pulls its value from the
+ * {@link SuccessState} root's payload and renders nothing when its
+ * datum is missing.
+ */
+interface SuccessStateRowProps {
+  /** Override the row label. */
+  label?: string;
+}
+/**
+ * Body slot part props. Forwards every native `<div>` prop through to the
+ * underlying `Card.Body`, which becomes the scrollable region when the
+ * widget is mounted inside `Dialog.Content`.
+ */
+type SuccessStateBodyProps = ComponentProps<"div">;
+/**
+ * Header part props.
+ */
+interface SuccessStateHeaderProps {
+  /**
+   * Optional override for the title rendered in this slot. Defaults to
+   * the `headerTitle` set on the {@link SuccessState} root, falling
+   * back to `"Deposit received"`.
+   */
+  title?: string;
+}
+/**
+ * Details (list container) part props.
+ */
+interface SuccessStateDetailsProps {
+  /** `SuccessState.Detail` children. */
+  children?: ReactNode;
+}
+/**
+ * Detail (single row) part props.
+ */
+interface SuccessStateDetailProps {
+  /** Row label rendered on the leading edge. */
+  label: string;
+  /**
+   * Row value rendered on the trailing edge. Accepts a free-form
+   * `ReactNode` so callers can mount the canonical helpers
+   * (`<SuccessState.AssetValue>`, `<SuccessState.RouteValue>`) or
+   * arbitrary inline content.
+   */
+  value: ReactNode;
+}
+/**
+ * Actions part props.
+ */
+interface SuccessStateActionsProps {
+  /**
+   * Optional override for the primary CTA click handler. Defaults to
+   * the `onDone` set on the {@link SuccessState} root.
+   */
+  onDone?: () => void;
+  /**
+   * Optional override for the primary CTA label. Defaults to the
+   * `doneLabel` set on the {@link SuccessState} root, falling back to
+   * `"Done"`.
+   */
+  doneLabel?: string;
+  /**
+   * Optional override for the secondary close-button click handler.
+   * Defaults to the `onClose` set on the {@link SuccessState} root.
+   * When neither is provided, only the primary CTA renders.
+   */
+  onClose?: () => void;
+  /**
+   * Optional override for the secondary CTA label. Defaults to the
+   * `closeLabel` set on the {@link SuccessState} root, falling back to
+   * `"Close"`.
+   */
+  closeLabel?: string;
+}
+/**
+ * Headline part props — textual outcome banner that replaces the
+ * amount-leading {@link SuccessStateHero}. Renders a success ring
+ * over a centered title + optional sub-line.
+ */
+interface SuccessStateHeadlineProps {
+  /**
+   * Optional override for the title. Defaults to the `headlineTitle`
+   * set on the {@link SuccessState} root, falling back to `"Deposit
+   * successful"`.
+   */
+  title?: string;
+  /**
+   * Optional override for the sub-line rendered under the title.
+   * Defaults to the `headlineDescription` set on the
+   * {@link SuccessState} root, falling back to a friendly confirmation.
+   * Pass `""` to suppress.
+   */
+  description?: string;
+}
+/**
+ * MoreDetails part props — collapsible row that expands inline as
+ * additional flat sibling rows in the same `Details` card. Mirrors
+ * `ErrorState.MoreDetails`. Children should be `SuccessState.Detail`
+ * rows; they render under the trigger when expanded.
+ */
+interface SuccessStateMoreDetailsProps {
+  /** Trigger row label. Defaults to `"More details"`. */
+  label?: ReactNode;
+  /** Initial open state when uncontrolled. Defaults to `false`. */
+  defaultOpen?: boolean;
+  /** Controlled open state. When set, `defaultOpen` is ignored. */
+  open?: boolean;
+  /** Fires on open/close transitions. */
+  onOpenChange?: (open: boolean) => void;
+  /** `SuccessState.Detail` children rendered when expanded. */
+  children?: ReactNode;
+}
+/**
+ * StatusPill helper props — small inline label tinted with the kit's
+ * success accent. Used inside the `Fill status` detail row.
+ */
+interface SuccessStateStatusPillProps {
+  /** Pill text. Defaults to `"Successful"`. */
+  children?: ReactNode;
+}
+/**
+ * AssetValue helper props — renders the canonical `[icon] amount symbol` composition.
+ *
+ * Pre-formatted by driver transformer code (e.g. `quote.payload.receiveAmount.formatted`,
+ * `settlement.payload.receiveAmount.formatted`). The compound is pure layout and never invokes
+ * `Intl.NumberFormat` itself.
+ */
+interface SuccessStateAssetValueProps {
+  /** Pre-formatted amount string (e.g. `"8.99327"`). */
+  amount: string;
+  /** Asset symbol, e.g. `"USDT"`. */
+  symbol: string;
+  /**
+   * EIP-155 chain id used to resolve the asset's logo.
+   */
+  chainId?: number;
+  /** ERC-20 contract address on `chainId`. Omit for chain-native tokens. */
+  address?: string;
+  /** `true` for chain-native tokens (ETH, MATIC, …). */
+  isNative?: boolean;
+  /** Logo URL — final URL fallback before the gradient+letter visual. */
+  logoUrl?: string;
+}
+/**
+ * RouteValue helper props — renders the canonical
+ * `Hop1 → Hop2 → Hop3` chain used inside the Route row.
+ */
+interface SuccessStateRouteValueProps {
+  /** Ordered list of hop labels (e.g. `["BSC", "Ethereum"]`). */
+  hops: readonly string[];
+}
+//#endregion
+export { SuccessStateActionsProps, SuccessStateAsset, SuccessStateAssetValueProps, SuccessStateBodyProps, SuccessStateDetailProps, SuccessStateDetailsProps, SuccessStateDialogProps, SuccessStateExplorer, SuccessStateHeaderProps, SuccessStateHeadlineProps, SuccessStateMoreDetailsProps, SuccessStateProps, SuccessStateRouteValueProps, SuccessStateRowProps, SuccessStateSourceWallet, SuccessStateStatusPillProps, SuccessStateTxRef };

package/dist/storage/adapters.d.ts

@@ -0,0 +1,29 @@
+import { KitStorageAdapter, KitStoragePersistence } from "./types.js";
+
+//#region src/storage/adapters.d.ts
+/**
+ * Adapter backed by `window.sessionStorage`. Values survive `dialog.close → dialog.open`
+ * round-trips inside the same tab; closing the tab forgets every key. Default for
+ * `<KitProvider storage="session" />`.
+ */
+declare function createSessionStorageAdapter(): KitStorageAdapter;
+/**
+ * Adapter backed by `window.localStorage`. Values survive across tabs and across browser
+ * restarts. Useful for hosts that want banner acknowledgments / kit state to persist across
+ * sessions — pass via `<KitProvider storage="local" />`.
+ */
+declare function createLocalStorageAdapter(): KitStorageAdapter;
+/**
+ * In-memory adapter — values live for the lifetime of the React tree. Default substitute when
+ * `Storage` is unavailable; also the recommended choice for tests and headless integrations
+ * that want each render-tree to start from a clean slate.
+ */
+declare function createMemoryStorageAdapter(): KitStorageAdapter;
+/**
+ * Resolve a {@link KitStoragePersistence} value into a concrete {@link KitStorageAdapter}. The
+ * three string variants map to the bundled `session` / `local` / `memory` adapters; an object
+ * value is treated as a custom adapter and returned as-is.
+ */
+declare function resolveStorageAdapter(persistence: KitStoragePersistence): KitStorageAdapter;
+//#endregion
+export { createLocalStorageAdapter, createMemoryStorageAdapter, createSessionStorageAdapter, resolveStorageAdapter };

package/dist/storage/adapters.js

@@ -0,0 +1 @@
+function e(e){return{get(t){let n=e();if(!n)return null;try{return n.getItem(t)}catch{return null}},set(t,n){let r=e();if(r)try{r.setItem(t,n)}catch{}},delete(t){let n=e();if(n)try{n.removeItem(t)}catch{}},clear(){let t=e();if(t)try{t.clear()}catch{}}}}function t(){return e(()=>typeof window>`u`?void 0:window.sessionStorage)}function n(){return e(()=>typeof window>`u`?void 0:window.localStorage)}function r(){let e=new Map;return{get:t=>e.has(t)?e.get(t):null,set:(t,n)=>{e.set(t,n)},delete:t=>{e.delete(t)},clear:()=>{e.clear()}}}function i(e){return typeof e==`object`?e:e===`session`?t():e===`local`?n():r()}export{n as createLocalStorageAdapter,r as createMemoryStorageAdapter,t as createSessionStorageAdapter,i as resolveStorageAdapter};

package/dist/storage/context.d.ts

@@ -0,0 +1,62 @@
+import { KitStoragePersistence } from "./types.js";
+import { KitStorage } from "./createKitStorage.js";
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/storage/context.d.ts
+/**
+ * Default namespace for `<KitProvider />`'s storage. Versioned so the kit can bump
+ * (`storage:v1` → `storage:v2`) and treat older entries as absent without crashing on parse.
+ * Hosts that mount multiple kit instances on the same page should pass an explicit
+ * `storageNamespace` to keep state isolated.
+ */
+declare const DEFAULT_KIT_STORAGE_NAMESPACE = "stridge-kit:storage:v1";
+interface KitStorageProviderProps {
+  /**
+   * Persistence selection. `"session"` is the kit default — banner acks survive a `close()`/
+   * `open()` round-trip but are forgotten when the tab closes. `"local"` persists across tab
+   * + browser restarts; `"memory"` keeps state in-process for the lifetime of the React tree;
+   * an object value is treated as a custom {@link KitStorageAdapter}.
+   */
+  storage?: KitStoragePersistence;
+  /**
+   * Prefix every key the kit writes under. Two `<KitProvider />` instances on the same page
+   * with the same persistence backend should pick distinct namespaces to avoid colliding on
+   * each other's banner acks. Defaults to {@link DEFAULT_KIT_STORAGE_NAMESPACE}.
+   */
+  namespace?: string;
+  children: ReactNode;
+}
+/**
+ * Mounts a {@link KitStorage} into context, resolving `storage` into a concrete adapter and
+ * scoping every key under `namespace`. The instance is memoized on the resolved adapter +
+ * namespace; passing the same `storage` object across renders keeps the same instance.
+ *
+ * Hosts rarely mount this directly — `<KitProvider />` does it. Use `<KitStorageProvider />`
+ * only when wiring kit-storage-aware widgets without mounting the full provider tree (e.g.
+ * isolated tests, kit-internal stories).
+ */
+declare function KitStorageProvider({
+  storage,
+  namespace,
+  children
+}: KitStorageProviderProps): _$react_jsx_runtime0.JSX.Element;
+/**
+ * Access the kit's {@link KitStorage} handle. The returned object's identity is stable across
+ * renders so it is safe to capture in callbacks and dependency arrays. Use
+ * {@link useKitStorageValue} when you need a reactive read of a single key.
+ *
+ * Throws when no `<KitProvider />` / `<KitStorageProvider />` is mounted above the caller.
+ */
+declare function useKitStorage(): KitStorage;
+/**
+ * Reactively read the value at `key` from the kit's storage. Re-renders the calling component
+ * whenever any kit-storage mutation lands on this `key`. Pass `null` for "no key yet" — the
+ * hook returns `null` in that case without subscribing.
+ *
+ * SSR-safe: the server snapshot is `null` (matches "absent"); the client hydrates with the
+ * real value on first commit.
+ */
+declare function useKitStorageValue(key: string | null): string | null;
+//#endregion
+export { DEFAULT_KIT_STORAGE_NAMESPACE, KitStorageProvider, useKitStorage, useKitStorageValue };

package/dist/storage/context.js

@@ -0,0 +1 @@
+"use client";import{resolveStorageAdapter as e}from"./adapters.js";import{createKitStorage as t}from"./createKitStorage.js";import{createContext as n,use as r,useMemo as i,useSyncExternalStore as a}from"react";import{jsx as o}from"react/jsx-runtime";const s=`stridge-kit:storage:v1`,c=n(null);c.displayName=`KitStorageContext`;function l({storage:n=`session`,namespace:r=s,children:a}){let l=i(()=>t(e(n),r),[n,r]);return o(c.Provider,{value:l,children:a})}function u(){let e=r(c);if(e===null)throw Error(`useKitStorage must be used inside a <KitProvider /> or <KitStorageProvider />.`);return e}function d(e){let t=u();return a(t.subscribe,()=>e===null?null:t.get(e),()=>null)}export{s as DEFAULT_KIT_STORAGE_NAMESPACE,l as KitStorageProvider,u as useKitStorage,d as useKitStorageValue};

package/dist/storage/createKitStorage.d.ts

@@ -0,0 +1,45 @@
+import { KitStorageAdapter } from "./types.js";
+
+//#region src/storage/createKitStorage.d.ts
+/**
+ * Reactive façade over a {@link KitStorageAdapter}. All keys are namespaced under the provider's
+ * `storageNamespace` before reaching the adapter, so two `<KitProvider />` instances on the same
+ * page can share an underlying `sessionStorage` without colliding. Supports `subscribe()` for
+ * `useSyncExternalStore`-driven reactive reads — every call to `set` / `delete` / `clear`
+ * notifies all subscribers so dependent hooks re-render.
+ */
+interface KitStorage {
+  /** Read the value at `key`, scoped to the active namespace. `null` when absent. */
+  get(key: string): string | null;
+  /**
+   * Write `value` at `key`. Notifies every subscriber synchronously after the underlying adapter
+   * write completes. Silent no-op when the adapter rejects.
+   */
+  set(key: string, value: string): void;
+  /** `true` when {@link get} would return a non-`null` value. */
+  has(key: string): boolean;
+  /** Remove `key`. Notifies every subscriber synchronously. */
+  delete(key: string): void;
+  /**
+   * Remove every key the adapter manages, **regardless of namespace**. Useful for tests; not
+   * called by the kit's own widgets. Notifies every subscriber.
+   */
+  clear(): void;
+  /**
+   * Subscribe to mutation notifications. The returned function unsubscribes. Suitable as the
+   * `subscribe` arg to `useSyncExternalStore`.
+   */
+  subscribe(listener: () => void): () => void;
+}
+/**
+ * Build a {@link KitStorage} façade around `adapter`, scoping every key under `namespace`. The
+ * façade is a small in-memory wrapper — it does not cache values (every `get` reads from the
+ * adapter) but does maintain a listener set so React can re-render via `useSyncExternalStore`.
+ *
+ * The namespace prefix is appended with a literal `:` separator. Pass any non-empty string;
+ * the kit's default is `stridge-kit:storage:v1` so future shape changes can ignore the
+ * older suffix.
+ */
+declare function createKitStorage(adapter: KitStorageAdapter, namespace: string): KitStorage;
+//#endregion
+export { KitStorage, createKitStorage };

package/dist/storage/createKitStorage.js

@@ -0,0 +1 @@
+function e(e,t){let n=new Set,r=e=>`${t}:${e}`,i=()=>{for(let e of n)e()};return{get:t=>e.get(r(t)),set:(t,n)=>{e.set(r(t),n),i()},has:t=>e.get(r(t))!==null,delete:t=>{e.delete(r(t)),i()},clear:()=>{e.clear(),i()},subscribe:e=>(n.add(e),()=>{n.delete(e)})}}export{e as createKitStorage};

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+import { KitStorageAdapter, KitStoragePersistence } from "./types.js";
+import { createLocalStorageAdapter, createMemoryStorageAdapter, createSessionStorageAdapter, resolveStorageAdapter } from "./adapters.js";
+import { KitStorage, createKitStorage } from "./createKitStorage.js";
+import { DEFAULT_KIT_STORAGE_NAMESPACE, KitStorageProvider, useKitStorage, useKitStorageValue } from "./context.js";

package/dist/storage/index.js

@@ -0,0 +1 @@
+import"./adapters.js";import"./createKitStorage.js";import"./context.js";

package/dist/storage/types.d.ts

@@ -0,0 +1,26 @@
+//#region src/storage/types.d.ts
+/**
+ * Backing layer behind the kit's persistent {@link KitStorage}. Implementations are responsible
+ * for raw read / write of string values keyed by the fully-qualified, namespaced key the kit
+ * passes in — they should not interpret the key, mutate values, or throw on missing keys / quota
+ * exhaustion. The kit's adapters all fail silently because storage is never load-bearing for a
+ * render path.
+ */
+interface KitStorageAdapter {
+  /** Read the raw string value, or `null` when the key is absent. Never throws. */
+  get(key: string): string | null;
+  /** Write the raw string value. Silent no-op if the underlying storage rejects (quota, etc.). */
+  set(key: string, value: string): void;
+  /** Remove the key. Silent no-op if absent or rejected. */
+  delete(key: string): void;
+  /** Remove every key the adapter manages. Silent no-op if rejected. */
+  clear(): void;
+}
+/**
+ * Persistence selection consumed by `<KitProvider storage={…} />`. The string variants resolve
+ * to bundled adapters (`session` → `sessionStorage`, `local` → `localStorage`, `memory` →
+ * in-process `Map`); custom backends pass a {@link KitStorageAdapter} directly.
+ */
+type KitStoragePersistence = "session" | "local" | "memory" | KitStorageAdapter;
+//#endregion
+export { KitStorageAdapter, KitStoragePersistence };

package/dist/stridge/StridgeContext.d.ts

@@ -0,0 +1,29 @@
+import { DepositDriver } from "../flows/deposit/driver/types.js";
+//#region src/stridge/StridgeContext.d.ts
+/**
+ * Slim Stridge-specific context published by `<StridgeProvider />`. The driver itself is the
+ * single source of entity data — components reach for `useDepositSnapshot()` to read brand / target /
+ * addresses / balances / quote / settlement / wallet entities. This context exposes only the
+ * driver instance + a readiness flag so consumers can branch on bootstrap state.
+ */
+interface StridgeContextValue {
+  /** `true` once the driver's bootstrap (`gateway/start` + `supportedAssets`) has resolved. */
+  isReady: boolean;
+  /** The active {@link DepositDriver} instance, when bootstrap completed. */
+  driver: DepositDriver | undefined;
+}
+/**
+ * Read the {@link StridgeContextValue} from the nearest `<StridgeProvider />`. Throws when no
+ * provider is mounted. For BYO-driver hosts using `<KitProvider deposit={…} />` directly,
+ * `useStridge` is not applicable — use {@link useOptionalStridge} when the same component may
+ * render under either provider.
+ */
+declare function useStridge(): StridgeContextValue;
+/**
+ * Non-throwing variant of {@link useStridge}. Returns the context value when a
+ * `<StridgeProvider />` is mounted above, or `null` when the component renders under a plain
+ * `<KitProvider />`.
+ */
+declare function useOptionalStridge(): StridgeContextValue | null;
+//#endregion
+export { useOptionalStridge, useStridge };