@stridge/kit 0.1.0-alpha.6 → 0.1.0-alpha.60

package/dist/flows/deposit/orchestrator/types.d.ts

@@ -1,7 +1,6 @@
 import { TxRef } from "../../../shared/driver/types.js";
 import { BalanceItemPayload } from "../driver/payloads.js";
 import { FailureInfo } from "../../../shared/orchestrator/types.js";
-
 //#region src/flows/deposit/orchestrator/types.d.ts
 /**
  * Deposit method picked on the `Deposit` widget. `wallet` enters Path A
@@ -9,6 +8,80 @@ import { FailureInfo } from "../../../shared/orchestrator/types.js";
  * (transfer-crypto → process).
  */
 type DepositMethod = "wallet" | "transfer";
+/**
+ * Cash-rail method id. Mirrors the keys on `CashMethodsPayload` (`card` / `applePay` / `googlePay`)
+ * so the picker tile, the chosen-method chip, and the FSM ctx all share one vocabulary. Routed
+ * through its own `CASH_METHOD_SELECTED` reducer event (separate from `DEPOSIT_METHOD_SELECTED`)
+ * because the cash rail lands in a method-specific amount-entry surface today and per-method
+ * confirm forms tomorrow.
+ */
+type CashMethodId = "card" | "applePay" | "googlePay";
+/**
+ * Host-supplied disable lever for a single payment method on the deposit-method picker. The host
+ * decides eligibility — the kit ships no per-host inference (embedded vs. external wallet,
+ * region, KYC tier, …). When `disabled` is true the tile stays in the picker (preserves
+ * discoverability), renders natively disabled, can't be selected, and shows `disabledHint` as
+ * the inline meta line below the title (also folded into the tile's accessible name so screen
+ * readers convey the reason).
+ */
+interface DepositMethodConfig {
+  /** When true, the method is rendered disabled and can't be selected. */
+  disabled?: boolean;
+  /**
+   * Plain-text reason shown inline as the tile's meta line — replaces the address+balance
+   * reading on the wallet tile and the `"No limit · Instant"` reading on the transfer tile so
+   * the explanation is unmissable and the auto-derived signals (which can read misleadingly,
+   * e.g. an embedded wallet's $0.00) are suppressed. Also folded into the tile's accessible
+   * name so screen readers convey it alongside the title. Ignored when `disabled` is falsy.
+   */
+  disabledHint?: string;
+}
+/**
+ * Per-rail host configuration for the deposit picker. Distinct from
+ * {@link DepositMethodConfig} — a rail toggle removes the rail tab entirely
+ * from the `RailPicker` rather than disabling a single tile, so there is no
+ * `disabledHint` slot (there is no tile to surface the hint on). When only
+ * one rail remains after filtering, the orchestrated widget's default
+ * composition collapses the `RailPicker` chrome and renders the surviving
+ * rail's content directly at the body root.
+ */
+interface DepositRailConfig {
+  /**
+   * Opt-IN gate for the rail. The cash rail is hidden by default — hosts that want
+   * the `Use Cash` tab in their picker must set `enabled: true` and have a driver that
+   * surfaces the matching entity (e.g. `cashMethods`). Crypto-only integrators upgrade
+   * transparently because the default is `enabled !== true`. Set explicitly to `false`
+   * is equivalent to leaving it unset.
+   */
+  enabled?: boolean;
+  /**
+   * Legacy opt-OUT toggle. Kept for back-compatibility with the brief window where the
+   * rail shipped on by default and integrators had to set this to hide it. New code
+   * should prefer {@link DepositRailConfig.enabled}; setting `disabled: true` continues
+   * to hide the rail regardless of `enabled`.
+   */
+  disabled?: boolean;
+}
+/**
+ * Per-method host configuration for the deposit picker. Omitting a method (or the whole object)
+ * keeps default behavior; supply `{ disabled: true, disabledHint: "…" }` to mark an option as
+ * unavailable for the current user. `cashRail` is a rail-level toggle — see
+ * {@link DepositRailConfig}.
+ *
+ * Cash-method keys (`card`, `applePay`, `googlePay`) are additive flat keys that mirror the
+ * crypto methods' shape so existing integrators upgrade without touching their config. A future
+ * version may restructure to nested-by-rail (`{ crypto: { wallet, transfer }, cash: { … } }`);
+ * that restructure is a breaking-change PR and is intentionally deferred until cash methods
+ * stabilize.
+ */
+interface DepositMethodsConfig {
+  wallet?: DepositMethodConfig;
+  transfer?: DepositMethodConfig;
+  card?: DepositMethodConfig;
+  applePay?: DepositMethodConfig;
+  googlePay?: DepositMethodConfig;
+  cashRail?: DepositRailConfig;
+}
 /**
  * Confirm-deposit phase sub-union. Drives the confirm-deposit widget's hero / footer chrome.
  * Phase data is pure navigation; the actual quote payload comes from the driver's `quote` entity.
@@ -28,6 +101,17 @@ type ConfirmDepositPhase = {
   failure: FailureInfo;
   recoverFrom: "quote" | "submission";
 };
+/**
+ * Cash-confirm phase sub-union. Drives the per-method cash confirm widget's body slot — `loading`
+ * paints the skeleton placeholder, `ready` renders the filled card form / QR / pay button. Phase
+ * is pure navigation; the actual card data / QR payload / pay button content lives in the widget's
+ * mocks today and will surface through a future `cashConfirm` driver entity.
+ */
+type CashConfirmPhase = {
+  kind: "loading";
+} | {
+  kind: "ready";
+};
 /**
  * Where `ERROR_TRY_AGAIN` lands. Encoded once at error-entry time so retry is deterministic.
  */
@@ -47,6 +131,33 @@ type RetryTargetSpec = {
    */
   kind: "fresh";
 };
+/**
+ * Where `BACK` lands when the user exits the activity surface. Encoded once at `OPEN_ACTIVITY`
+ * time so the back chevron can restore each pre-commit source state lossless — same precedent
+ * as {@link RetryTargetSpec}, just for the activity-exit path instead of the error-retry path.
+ *
+ * The discriminant `kind` mirrors the source-state name. The remaining fields carry exactly the
+ * ctx slots needed to rebuild that state (method, asset, inner backTarget). Direct-entry into
+ * the per-flow activity is no longer possible — that path migrated to the standalone
+ * `useActivity()` hook — so every reachable backTarget identifies a concrete source step.
+ */
+type ActivityBackTarget = {
+  kind: "deposit";
+  backTarget: "closed";
+} | {
+  kind: "assetPicker";
+  method: "wallet";
+  backTarget: "closed" | "deposit";
+} | {
+  kind: "amountEntry";
+  method: "wallet";
+  asset: BalanceItemPayload;
+  backTarget: "closed" | "assetPicker";
+} | {
+  kind: "transferCrypto";
+  method: "transfer";
+  backTarget: "closed" | "deposit";
+};
 /**
  * State machine state nodes. Per-state discriminated ctx narrows what is available — illegal
  * states (e.g. `confirmDeposit` without an asset) are unrepresentable.
@@ -75,6 +186,28 @@ type DepositState = {
     asset: BalanceItemPayload;
     backTarget: "closed" | "assetPicker";
   };
+} | {
+  name: "cashAmountEntry";
+  ctx: {
+    method: "cash";
+    cashMethod: CashMethodId;
+    backTarget: "closed" | "deposit";
+    /**
+     * Optional initial amount, restored when the user backs out of `cashConfirm` so the
+     * fiat band keeps the value they entered before continuing. Absent on first entry
+     * (the widget falls back to the first preset).
+     */
+    amount?: number;
+  };
+} | {
+  name: "cashConfirm";
+  ctx: {
+    method: "cash";
+    cashMethod: CashMethodId;
+    amount: number;
+    phase: CashConfirmPhase;
+    backTarget: "cashAmountEntry";
+  };
 } | {
   name: "confirmDeposit";
   ctx: {
@@ -115,6 +248,31 @@ type DepositState = {
     failure?: FailureInfo; /** Source-chain tx hash when the error followed a successful broadcast. */
     tx?: TxRef;
   };
+} | {
+  /**
+   * Activity list — reachable from any pre-commit state via the header icon.
+   * `backTarget` snapshots the source state at `OPEN_ACTIVITY` time so the back chevron
+   * can restore it lossless.
+   */
+  name: "activityList";
+  ctx: {
+    backTarget: ActivityBackTarget;
+  };
+} | {
+  /**
+   * Activity per-settlement detail — reached from `activityList` via
+   * `SELECT_SETTLEMENT`. Carries the selected row's id, the same `backTarget` so `BACK`
+   * collapses through `activityList` to the original source step, and a `viaList` flag
+   * that disambiguates "reached via the list" from "reached imperatively"; the latter
+   * skips the list interlude on `BACK`. For direct-entry into the activity surface,
+   * see {@link useActivity}.
+   */
+  name: "activityDetail";
+  ctx: {
+    settlementId: string;
+    backTarget: ActivityBackTarget;
+    viaList: boolean;
+  };
 };
 type DepositStateName = DepositState["name"];
 /**
@@ -142,6 +300,14 @@ type GatewayEvent = {
 } | {
   type: "DEPOSIT_METHOD_SELECTED";
   method: DepositMethod;
+} | {
+  type: "CASH_METHOD_SELECTED";
+  cashMethod: CashMethodId;
+} | {
+  type: "CASH_AMOUNT_CONFIRMED";
+  amount: number;
+} | {
+  type: "CASH_METHOD_READY";
 } | {
   type: "ASSET_CONFIRMED";
   asset: BalanceItemPayload;
@@ -205,11 +371,30 @@ type GatewayEvent = {
    */
   type: "RESUME_TO_ERROR";
   tx?: TxRef;
+} | {
+  /**
+   * User tapped the header activity icon. Legal from every pre-commit state
+   * (`deposit | assetPicker | amountEntry | transferCrypto`); ignored elsewhere. The
+   * reducer snapshots the source state into a {@link ActivityBackTarget} so the back
+   * chevron can restore it lossless.
+   */
+  type: "OPEN_ACTIVITY";
+} | {
+  /**
+   * User tapped a row in the activity list. Legal only from `activityList`; transitions
+   * to `activityDetail` carrying the selected `settlementId` and the same `backTarget`,
+   * so a later `BACK` from the list step restores the original source state.
+   */
+  type: "SELECT_SETTLEMENT";
+  settlementId: string;
 };
 /**
  * Public open-input variant accepted by `useDeposit().open()`. Hosts pass the small ID-based
- * shape; the controller resolves IDs against the driver's `balances` entity and rejects when the
- * lookup fails.
+ * shape; the controller resolves `assetId` against the driver's `balances` entity before
+ * dispatching. Lookup misses fall through to the asset picker — the host's click never silently
+ * no-ops.
+ *
+ * For direct-entry into the activity surface, see {@link useActivity}.
  */
 type OpenInput = undefined | {
   method: "wallet";
@@ -226,11 +411,14 @@ interface DepositController {
    *
    * - `open()` → `deposit` (method picker)
    * - `open({ method: "wallet" })` → `assetPicker`
-   * - `open({ method: "wallet", assetId })` → `amountEntry` (rejects if `assetId` doesn't resolve)
+   * - `open({ method: "wallet", assetId })` → `amountEntry` when `assetId` resolves, otherwise
+   *   falls through to `assetPicker`
    * - `open({ method: "transfer" })` → `transferCrypto`
    *
-   * Returns `false` when `assetId` is provided but doesn't match any asset on the kit's
-   * `balances` entity.
+   * Returns `false` only when the requested `method` is disabled via
+   * {@link DepositMethodsConfig}.
+   *
+   * For direct-entry into the activity surface, see {@link useActivity}.
    */
   open(input?: OpenInput): boolean;
   /** Close the deposit dialog. Idempotent. */
@@ -248,6 +436,25 @@ interface DepositController {
  */
 interface DepositActions {
   selectMethod(method: DepositMethod): void;
+  /**
+   * Promotes the FSM from `deposit` (method picker) into `cashAmountEntry` for the chosen cash
+   * method. Distinct from {@link selectMethod} because cash methods route to a method-specific
+   * surface today (and per-method confirm forms tomorrow), while {@link selectMethod} stays
+   * scoped to the crypto rail's two methods.
+   */
+  selectCashMethod(cashMethod: CashMethodId): void;
+  /**
+   * Promotes the FSM from `cashAmountEntry` into `cashConfirm{loading}` carrying the entered
+   * fiat amount. The cash-confirm widget mounts in its loading state, schedules its own
+   * `cashMethodReady` dispatch after the mock load delay, and re-renders with the filled body.
+   */
+  confirmCashAmount(amount: number): void;
+  /**
+   * Flips `cashConfirm{loading}` → `cashConfirm{ready}`. Dispatched by the cash-confirm widget
+   * itself once its mock loading timer elapses. Real card-form / Apple Pay / Google Pay
+   * lifecycles will replace this with bindings-driven signals.
+   */
+  cashMethodReady(): void;
   confirmAsset(asset: BalanceItemPayload): void;
   confirmAmount(amount: number): void;
   confirmDeposit(): void;
@@ -261,6 +468,20 @@ interface DepositActions {
   resumeToSuccess(method: DepositMethod, tx: TxRef): void;
   /** Banner-driven jump into the error widget. */
   resumeToError(tx?: TxRef): void;
+  /**
+   * Header-icon entry into the activity surface. Legal only from the pre-quote states
+   * (`deposit | assetPicker | amountEntry | transferCrypto`); ignored from `confirmDeposit`
+   * onwards and from terminal states. Snapshots the current state into a
+   * {@link ActivityBackTarget} so `back()` can restore it lossless. No-ops with a dev-mode
+   * warning when no activity driver is mounted (host wired the action without
+   * `<KitProvider activity={…}>`).
+   */
+  openActivity(): void;
+  /**
+   * Open the detail view for a settlement listed on the activity surface. Legal only from
+   * `activityList`; transitions the FSM to `activityDetail`.
+   */
+  selectSettlement(settlementId: string): void;
 }
 //#endregion
-export { ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositState, DepositStateName, GatewayEvent, OpenInput, ResolvedOpenInput, RetryTargetSpec };
+export { CashConfirmPhase, CashMethodId, ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositMethodConfig, DepositMethodsConfig, DepositRailConfig, DepositState, DepositStateName, GatewayEvent, OpenInput, ResolvedOpenInput, RetryTargetSpec };

package/dist/flows/deposit/orchestrator/useDeposit.d.ts

@@ -31,5 +31,49 @@ import { DepositController } from "./types.js";
  * ```
  */
 declare function useDeposit(): DepositController;
+/**
+ * Non-throwing variant of {@link useDeposit} — returns `null` when called outside a
+ * `<KitProvider deposit={…} />`. Lets hosts mount `<StridgeProvider />` conditionally
+ * (e.g. only after a wallet is connected) without descendants crashing the moment they render
+ * before the provider exists.
+ *
+ * @example
+ * ```tsx
+ * const deposit = useOptionalDeposit();
+ * return (
+ *     <button onClick={() => deposit?.open()} disabled={!deposit}>
+ *         Deposit
+ *     </button>
+ * );
+ * ```
+ */
+declare function useOptionalDeposit(): DepositController | null;
+/**
+ * Headless prefetch handle for the deposit driver. Returns a stable function that arms the
+ * driver — kicks off the deferred `gateway/start` + `supportedAssets` + initial `balance/onchain`
+ * bootstrap. Calling it before the user opens the dialog warms the cache so the subsequent
+ * `useDeposit().open()` lands on populated data without a perceptible loading window.
+ *
+ * The function is fire-and-forget: returns `void`. To observe bootstrap state, read
+ * `useDepositSnapshot().target.status` directly — the snapshot is the single source of truth.
+ *
+ * The most common use is hover-to-warm:
+ *
+ * ```tsx
+ * const deposit = useDeposit();
+ * const prefetchDeposit = usePrefetchDeposit();
+ * <button onMouseEnter={prefetchDeposit} onClick={() => deposit.open()}>Deposit</button>;
+ * ```
+ *
+ * Headless balance widgets that need data on render call this in an effect:
+ *
+ * ```tsx
+ * const prefetchDeposit = usePrefetchDeposit();
+ * useEffect(() => { prefetchDeposit(); }, [prefetchDeposit]);
+ * ```
+ *
+ * Idempotent — subsequent calls are no-ops while the driver is already armed.
+ */
+declare function usePrefetchDeposit(): () => void;
 //#endregion
-export { useDeposit };
+export { useDeposit, useOptionalDeposit, usePrefetchDeposit };

package/dist/flows/deposit/orchestrator/useDeposit.js

@@ -1 +1 @@
-"use client";import{useControllerContext as e}from"./controller.js";function t(){return e().controller}export{t as useDeposit};
+"use client";import{useDepositDriverInstance as e}from"../driver/context.js";import{useOptionalStableControllerContext as t,useStableControllerContext as n}from"./controller.js";import{useCallback as r}from"react";function i(){return n().controller}function a(){return t()?.controller??null}function o(){let t=e();return r(()=>{t.arm()},[t])}export{i as useDeposit,a as useOptionalDeposit,o as usePrefetchDeposit};

package/dist/flows/deposit/shared/cash.d.ts

@@ -0,0 +1,20 @@
+//#region src/flows/deposit/shared/cash.d.ts
+/**
+ * Mock breakdown computed in-widget from the entered amount + chosen cash method. Returns the
+ * same shape the future `cashQuote` driver entity will surface, so the widget only swaps its
+ * source from this helper to `useDepositSnapshot().cashQuote` when the backend ships.
+ */
+interface CashAmountBreakdown {
+  /** USD amount the user is paying — surfaced on the Amount row and the hero band. */
+  amountUsd: number;
+  /** USDC the user receives after fees. Drives the Receive chip + hero sub-line. */
+  receiveAmount: number;
+  /** USDC quoted-per-USD rate. Drives the Crypto price row. */
+  rate: number;
+  /** Processing fee charged by the cash method (USD, deducted from amount). */
+  processingFeeUsd: number;
+  /** Network fee paid to settle on-chain (USD, deducted from amount). */
+  networkFeeUsd: number;
+}
+//#endregion
+export { CashAmountBreakdown };

package/dist/flows/deposit/shared/cash.js

@@ -0,0 +1 @@
+const e={symbol:`USDC`,chainId:1,address:`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`},t=[{value:200,label:`$200`},{value:500,label:`$500`},{value:1e3,label:`$1k`},{value:2e3,label:`$2k`}],n={card:.029,applePay:.025,googlePay:.025};function r(e,t){let r=e??0,i=+(r*n[t]).toFixed(2),a=.4;return{amountUsd:r,receiveAmount:Math.max(0,r-i-a)/1,rate:1,processingFeeUsd:i,networkFeeUsd:a}}export{t as MOCK_CASH_PRESETS,e as MOCK_RECEIVE_TOKEN,r as computeMockCashBreakdown};

package/dist/flows/deposit/widgets/activity/DepositActivityDetail.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/activity/DepositActivityDetail.d.ts
+interface DepositActivityDetailOwnProps {
+  /**
+   * Optional custom composition forwarded to the underlying `<ActivityDetail>`
+   * compound. Defaults to mounting all three per-kind parts; each gates internally on the
+   * resolved payload's `kind`.
+   */
+  children?: ReactNode;
+}
+/**
+ * Orchestrated activity detail wrapper for the deposit dialog. Mounts the cross-flow
+ * `<ActivityDetail>` compound and exposes per-kind parts (`Processing`, `Succeeded`,
+ * `Failed`) as namespace members. Renders `null` while the FSM is not on `activityDetail`.
+ */
+declare function DepositActivityDetail({
+  children
+}: DepositActivityDetailOwnProps): _$react_jsx_runtime0.JSX.Element | null;
+declare namespace DepositActivityDetail {
+  type Props = DepositActivityDetailOwnProps;
+  const Processing: ({
+    children
+  }: {
+    children?: ReactNode;
+  }) => _$react_jsx_runtime0.JSX.Element | null;
+  const Succeeded: ({
+    children
+  }: {
+    children?: ReactNode;
+  }) => _$react_jsx_runtime0.JSX.Element | null;
+  const Failed: ({
+    children
+  }: {
+    children?: ReactNode;
+  }) => _$react_jsx_runtime0.JSX.Element | null;
+}
+//#endregion
+export { DepositActivityDetail };

package/dist/flows/deposit/widgets/activity/DepositActivityDetail.js

@@ -0,0 +1 @@
+"use client";import{ActivitySourceProvider as e}from"../../../../shared/widgets/activity/compound/context.js";import{ActivityDetail as t}from"../../../../shared/widgets/activity/compound/ActivityDetail.js";import"../../../../shared/widgets/activity/compound/index.js";import{useDepositActivitySource as n}from"./useDepositActivitySource.js";import{jsx as r}from"react/jsx-runtime";function i({children:i}){let{sourceValue:a,step:o}=n();return o!==`activityDetail`||!a?null:r(e,{value:a,children:r(t,{children:i})})}(function(e){e.Processing=t.Processing,e.Succeeded=t.Succeeded,e.Failed=t.Failed})(i||={});export{i as DepositActivityDetail};

package/dist/flows/deposit/widgets/activity/DepositActivityList.d.ts

@@ -0,0 +1,38 @@
+import { ActivityHeader, ActivityListHeader } from "../../../../shared/widgets/activity/compound/components/ActivityHeader.js";
+import { ActivityEmpty } from "../../../../shared/widgets/activity/compound/components/Empty.js";
+import { ActivityErrorView } from "../../../../shared/widgets/activity/compound/components/ErrorView.js";
+import { ActivityList } from "../../../../shared/widgets/activity/compound/components/List.js";
+import { ActivityRow } from "../../../../shared/widgets/activity/compound/components/Row.js";
+import { ComponentProps, ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/activity/DepositActivityList.d.ts
+interface DepositActivityListOwnProps {
+  /**
+   * Optional custom composition forwarded to the underlying `<Activity>` compound.
+   * Defaults to the compound's `<Header /> + <List />` shape.
+   */
+  children?: ReactNode;
+}
+/**
+ * Orchestrated activity list wrapper for the deposit dialog. Bridges the deposit
+ * flow's snapshot + actions + FSM state into the cross-flow `<Activity>` compound's
+ * source value. Renders `null` while the FSM is not on `activityList` — the dialog's step
+ * router only matches the active step, but the no-op guard keeps the component safe to mount
+ * in custom dialog compositions that skip the step router.
+ */
+declare function DepositActivityList({
+  children,
+  ...props
+}: ComponentProps<"div"> & DepositActivityListOwnProps): _$react_jsx_runtime0.JSX.Element | null;
+declare namespace DepositActivityList {
+  type Props = ComponentProps<"div"> & DepositActivityListOwnProps;
+  const Header: typeof ActivityHeader;
+  const ListHeader: typeof ActivityListHeader;
+  const List: typeof ActivityList;
+  const Row: typeof ActivityRow;
+  const Empty: typeof ActivityEmpty;
+  const ErrorView: typeof ActivityErrorView;
+}
+//#endregion
+export { DepositActivityList };

package/dist/flows/deposit/widgets/activity/DepositActivityList.js

@@ -0,0 +1 @@
+"use client";import{ActivitySourceProvider as e}from"../../../../shared/widgets/activity/compound/context.js";import{Activity as t}from"../../../../shared/widgets/activity/compound/Activity.js";import"../../../../shared/widgets/activity/compound/index.js";import{useDepositActivitySource as n}from"./useDepositActivitySource.js";import{jsx as r}from"react/jsx-runtime";function i({children:i,...a}){let{sourceValue:o,step:s}=n();return s!==`activityList`||!o?null:r(e,{value:o,children:r(t,{...a,children:i})})}(function(e){e.Header=t.Header,e.ListHeader=t.ListHeader,e.List=t.List,e.Row=t.Row,e.Empty=t.Empty,e.ErrorView=t.ErrorView})(i||={});export{i as DepositActivityList};

package/dist/flows/deposit/widgets/activity/index.d.ts

@@ -0,0 +1,2 @@
+import { DepositActivityDetail } from "./DepositActivityDetail.js";
+import { DepositActivityList } from "./DepositActivityList.js";

package/dist/flows/deposit/widgets/activity/index.js

@@ -0,0 +1 @@
+import"./DepositActivityDetail.js";import"./DepositActivityList.js";

package/dist/flows/deposit/widgets/activity/useDepositActivitySource.js

@@ -0,0 +1 @@
+"use client";import{useOptionalActivityDriverInstance as e,useOptionalActivitySnapshot as t}from"../../../activity/driver/context.js";import{useLingui as n}from"../../../../shared/i18n/useLingui.js";import"../../../../i18n/index.js";import{useDepositSnapshot as r}from"../../driver/context.js";import{useDepositActions as i,useDepositEffectiveState as a}from"../../orchestrator/controller.js";import{defaultBlockExplorers as o}from"../../../../shared/utils/explorers.js";import{useCallback as s,useMemo as c}from"react";function l(){let l=r(),u=i(),d=e(),f=t(),p=a(),{i18n:m}=n(),h=s(e=>{d?.refreshActivity(e)},[d]),g=p.name===`activityList`||p.name===`activityDetail`,_=p.name===`activityDetail`?p.ctx.settlementId:void 0,v=g;return{sourceValue:c(()=>{if(!g||!f)return null;let e=l.wallet,t=f.activity,n=e.status===`ready`||e.status===`stale`?e.payload.address.value:t.status===`ready`||t.status===`stale`?t.response.owner:`0x0000000000000000000000000000000000000000`,r=t.status===`ready`||t.status===`stale`?t.payload.brandName:void 0,i=l.brand,a=i.status===`ready`||i.status===`stale`?i.payload.name:void 0,s=r??a,c={i18n:m,sourceWallet:{name:`Wallet`,address:n},explorers:o(),...s?{brandName:s}:{}};return{entity:f.activity,refresh:h,selectSettlement:u.selectSettlement,...v?{back:u.back}:{},..._===void 0?{}:{settlementId:_},settlementContext:c}},[f,l,u,g,_,m,h,v]),settlementId:_,step:p.name===`activityList`?`activityList`:p.name===`activityDetail`?`activityDetail`:`other`}}export{l as useDepositActivitySource};

package/dist/flows/deposit/widgets/amount-entry/AmountEntry.d.ts

@@ -1,5 +1,12 @@
 import { DialogShellControls } from "../../../../shared/dialog/DialogShell.js";
-import { ComponentProps } from "react";
+import { AmountEntryBodyProps } from "../../../../shared/widgets/amount-entry/compound/types.js";
+import { AmountEntryHeader } from "../../../../shared/widgets/amount-entry/compound/components/Header.js";
+import { AmountEntryFlow } from "../../../../shared/widgets/amount-entry/compound/components/Flow.js";
+import { AmountEntryFooter } from "../../../../shared/widgets/amount-entry/compound/components/Footer.js";
+import { AmountEntryHero } from "../../../../shared/widgets/amount-entry/compound/components/Hero/Hero.js";
+import { AmountEntryNotice } from "../../../../shared/widgets/amount-entry/compound/components/Notice.js";
+import { AmountEntryPills } from "../../../../shared/widgets/amount-entry/compound/components/Pills.js";
+import { ComponentProps, ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/flows/deposit/widgets/amount-entry/AmountEntry.d.ts
@@ -14,11 +21,24 @@ import * as _$react_jsx_runtime0 from "react/jsx-runtime";
  * minimum-deposit USD floor from the driver's `target` entity. Renders nothing on any other
  * FSM state.
  *
- * Honors `target.payload.minDepositUsd.value`: when the entered amount is below it, the footer
+ * Honors `target.payload.minAmountUsd.value`: when the entered amount is below it, the footer
  * CTA flips to "Update order" and clicking auto-snaps the amount up to the floor. The widget
  * also prefills the entry to the floor on first render so the user starts at a valid amount.
  */
-declare function AmountEntry(props: ComponentProps<"div">): _$react_jsx_runtime0.JSX.Element | null;
+interface AmountEntryOwnProps {
+  /**
+   * Optional custom composition. Defaults to `<Header />` + `<Body><Hero /><Pills /><Flow />`
+   * + validation-notice slot `</Body>` + `<Footer />`. Pass children to interleave your own
+   * elements between compound parts. Note — the default composition embeds a runtime-driven
+   * `<NoticeSlot />` that surfaces validation hints (min / max / insufficient-balance); custom
+   * children replace it entirely.
+   */
+  children?: ReactNode;
+}
+declare function AmountEntry({
+  children,
+  ...props
+}: ComponentProps<"div"> & AmountEntryOwnProps): _$react_jsx_runtime0.JSX.Element | null;
 declare function AmountEntryDialog({
   open,
   defaultOpen,
@@ -27,9 +47,16 @@ declare function AmountEntryDialog({
   ...rootProps
 }: AmountEntry.DialogProps): _$react_jsx_runtime0.JSX.Element;
 declare namespace AmountEntry {
-  type Props = ComponentProps<"div">;
-  type DialogProps = ComponentProps<"div"> & DialogShellControls;
+  type Props = ComponentProps<"div"> & AmountEntryOwnProps;
+  type DialogProps = ComponentProps<"div"> & DialogShellControls & AmountEntryOwnProps;
   const Dialog: typeof AmountEntryDialog;
+  const Header: typeof AmountEntryHeader;
+  const Body: (props: AmountEntryBodyProps) => _$react_jsx_runtime0.JSX.Element;
+  const Hero: typeof AmountEntryHero;
+  const Pills: typeof AmountEntryPills;
+  const Flow: typeof AmountEntryFlow;
+  const Footer: typeof AmountEntryFooter;
+  const Notice: typeof AmountEntryNotice;
 }
 //#endregion
 export { AmountEntry };

package/dist/flows/deposit/widgets/amount-entry/AmountEntry.js

@@ -1 +1 @@
-"use client";import{useDepositSnapshot as e}from"../../driver/context.js";import{useKitI18n as t}from"../../../../shared/i18n/useKitI18n.js";import{Trans as n}from"../../../../shared/i18n/Trans.js";import{useLingui as r}from"../../../../shared/i18n/useLingui.js";import"../../../../i18n/index.js";import{useDepositActions as i,useDepositEffectiveState as a}from"../../orchestrator/controller.js";import{formatTokenAmount as o}from"../../../../shared/format/formatTokenAmount.js";import{DialogShell as s}from"../../../../shared/dialog/DialogShell.js";import{text as c}from"../../../../shared/ui/Text/Text.js";import"../../../../shared/ui/Text/index.js";import{AmountEntry as l}from"../../../../shared/widgets/amount-entry/compound/AmountEntry.js";import"../../../../shared/widgets/amount-entry/compound/index.js";import{toAssetDescriptor as u}from"../../../../shared/widgets/asset-descriptor.js";import{useEffect as d,useMemo as f,useRef as p,useState as m}from"react";import{jsx as h,jsxs as g}from"react/jsx-runtime";const _=[{value:`25`,label:`25%`},{value:`50`,label:`50%`},{value:`75`,label:`75%`},{value:`max`,label:`Max`}];function v(s){let v=e(),y=a(),{confirmAmount:b,back:x}=i(),{_:S}=r(),C=t(),w=v.target,T=w.status===`ready`||w.status===`stale`?w.payload:void 0,E=y.name===`amountEntry`?y.ctx.asset:void 0,D=E?.amountUsd?.value??0,O=T?.minDepositUsd?.value,k=T?.minDepositUsd?.formatted,A=E?.priceUsd,[j,M]=m(O??null),[N,P]=m(),F=p(void 0),I=E?`${E.eip155Id??``}:${E.address??``}`:void 0;d(()=>{I&&F.current!==I&&(F.current=I,typeof O==`number`&&(M(O),P(void 0)))},[I,O]);let L=e=>{P(e);let t=e===`max`?1:Number.parseInt(e,10)/100;Number.isFinite(t)&&M(D*t)},R=e=>{M(e),P(void 0)},z=f(()=>typeof O!=`number`||O<=0?!1:j===null||j<O,[j,O]),B=f(()=>typeof D!=`number`||D<=0?!1:j!==null&&j>D,[j,D]),V=()=>{if(B){M(D),P(`max`);return}if(z&&typeof O==`number`){M(O),P(void 0);return}j!==null&&b(A&&A>0?j/A:j)};if(y.name!==`amountEntry`||!E||!T)return null;let H=y.ctx.backTarget===`closed`?void 0:x,U=u(E)??{symbol:E.symbol},W=u(T)??{symbol:T.symbol},G=`${o((j??0)/1,C,{maxDecimals:5})} ${T.symbol}`,K=B?S({id:`9cCjMJ`,message:`Deposit max balance`}):z&&k?S({id:`bOZXx5`,message:`Update order`}):void 0;return g(l,{...s,amount:j,sendToken:U,receiveToken:W,max:D,...O===void 0?{}:{min:O},onAmountChange:R,...H?{onBack:H}:{},subLineAmount:G,presets:_,...N===void 0?{}:{activePreset:N},onPresetSelect:L,...K===void 0?{}:{footerLabel:K},onContinue:V,children:[h(l.Header,{}),g(l.Body,{children:[h(l.Hero,{}),h(l.Pills,{}),B?h(c.p,{size:`sm`,color:`subdued`,className:`AmountEntry__noticeStyles.root x2b8uid x1vvogim`,"data-style-src":`@stridge/kit:src/flows/deposit/widgets/amount-entry/AmountEntry.tsx:16`,children:h(n,{id:`znqB4T`,message:`Insufficient balance`})}):null,h(l.Flow,{}),!B&&z&&k?h(c.p,{size:`sm`,color:`subdued`,className:`AmountEntry__noticeStyles.root x2b8uid x1vvogim`,"data-style-src":`@stridge/kit:src/flows/deposit/widgets/amount-entry/AmountEntry.tsx:16`,children:h(n,{id:`3eKjkO`,message:`{formattedMin} minimum deposit`,values:{formattedMin:k}})}):null]}),h(l.Footer,{})]})}function y({open:e,defaultOpen:t,onOpenChange:n,trigger:r,...i}){return h(s,{open:e,defaultOpen:t,onOpenChange:n,trigger:r,children:h(v,{...i})})}(function(e){e.Dialog=y})(v||={});export{v as AmountEntry};
+"use client";import{useOptionalActivityDriverInstance as e}from"../../../activity/driver/context.js";import{useKitI18n as t}from"../../../../shared/i18n/useKitI18n.js";import{Trans as n}from"../../../../shared/i18n/Trans.js";import{useLingui as r}from"../../../../shared/i18n/useLingui.js";import"../../../../i18n/index.js";import{useDepositSnapshot as i}from"../../driver/context.js";import{useDepositActions as a,useDepositEffectiveState as ee}from"../../orchestrator/controller.js";import{formatTokenAmount as o}from"../../../../shared/format/formatTokenAmount.js";import{useKitEmitter as s}from"../../../../events/emit/useKitEmitter.js";import"../../../../events/emit/index.js";import{DialogShell as c}from"../../../../shared/dialog/DialogShell.js";import{AmountEntry as l}from"../../../../shared/widgets/amount-entry/compound/AmountEntry.js";import"../../../../shared/widgets/amount-entry/compound/index.js";import{ActivityTrigger as u}from"../../../../shared/widgets/activity/ActivityTrigger.js";import"../../../../shared/widgets/activity/index.js";import{toAssetDescriptor as d}from"../../../../shared/widgets/asset-descriptor.js";import{effectiveMaxUsd as f,resolveFooterIntent as te}from"./footerIntent.js";import{useEffect as p,useRef as m,useState as h}from"react";import{Fragment as g,jsx as _,jsxs as v}from"react/jsx-runtime";const y=[{value:`25`,label:`25%`},{value:`50`,label:`50%`},{value:`75`,label:`75%`},{value:`max`,label:`Max`}];function b({children:n,...c}){let b=i(),C=ee(),{confirmAmount:w,back:T,openActivity:E}=a(),D=e()!==null,{_:O}=r(),k=t(),A=b.target,j=A.status===`ready`||A.status===`stale`?A.payload:void 0,M=C.name===`amountEntry`?C.ctx.asset:void 0,N=M?.amountUsd?.value??0,P=j?.minAmountUsd?.value,F=j?.minAmountUsd?.formatted,I=j?.maxAmountUsd?.value,L=j?.maxAmountUsd?.formatted,R=f(N,I),z=M?.priceUsd,[B,V]=h(P??null),[H,U]=h(),W=s(),G=e=>{W({type:`deposit.amount.changed`,flow:`deposit`,tier:`ui`,payload:{raw:e===null?``:String(e),numeric:e}})},K=m(void 0),q=M?`${M.eip155Id??``}:${M.address??``}`:void 0;p(()=>{q&&K.current!==q&&(K.current=q,typeof P==`number`&&(V(P),U(void 0)))},[q,P]);let J=e=>{U(e);let t=e===`max`?1:Number.parseInt(e,10)/100;if(Number.isFinite(t)){let n=R*t;V(n),G(n),e===`max`&&W({type:`deposit.max.clicked`,flow:`deposit`,tier:`ui`,payload:{}})}},Y=e=>{V(e),U(void 0),G(e)},X=te({amount:B,...P===void 0?{}:{minAmountUsd:P},...I===void 0?{}:{maxAmountUsd:I},walletBalanceUsd:N}),Z=()=>{if(X===`aboveBalance`||X===`aboveCap`){V(R),U(`max`);return}if(X===`belowMin`&&typeof P==`number`){V(P),U(void 0);return}B!==null&&w(z&&z>0?B/z:B)};if(C.name!==`amountEntry`||!M||!j)return null;let Q=C.ctx.backTarget===`closed`?void 0:T,ne=d(M)??{symbol:M.symbol},re=d(j)??{symbol:j.symbol},ie=`${o((B??0)/1,k,{maxDecimals:5})} ${j.symbol}`,$=x(X,{updateOrder:O({id:`bOZXx5`,message:`Update order`}),depositMax:O({id:`9cCjMJ`,message:`Deposit max balance`})}),ae=S(X,L,F);return _(l,{...c,amount:B,sendToken:ne,receiveToken:re,max:R,...P===void 0?{}:{min:P},onAmountChange:Y,...Q?{onBack:Q}:{},subLineAmount:ie,presets:y,...H===void 0?{}:{activePreset:H},onPresetSelect:J,...$===void 0?{}:{footerLabel:$},onContinue:Z,notice:ae,...D?{headerTrailing:_(u,{onOpen:E})}:{},children:n??v(g,{children:[_(l.Header,{}),v(l.Body,{children:[_(l.Hero,{}),_(l.Pills,{}),_(l.Flow,{}),_(l.Notice,{})]}),_(l.Footer,{})]})})}function x(e,t){if(e===`aboveCap`||e===`belowMin`)return t.updateOrder;if(e===`aboveBalance`)return t.depositMax}function S(e,t,r){if(e===`aboveCap`&&t)return _(n,{id:`-I_tc5`,message:`Max {formattedCap}`,values:{formattedCap:t}});if(e===`aboveBalance`)return _(n,{id:`znqB4T`,message:`Insufficient balance`});if(e===`belowMin`&&r)return _(n,{id:`3eKjkO`,message:`{formattedMin} minimum deposit`,values:{formattedMin:r}})}function C({open:e,defaultOpen:t,onOpenChange:n,trigger:r,...i}){return _(c,{open:e,defaultOpen:t,onOpenChange:n,trigger:r,children:_(b,{...i})})}(function(e){e.Dialog=C,e.Header=l.Header,e.Body=l.Body,e.Hero=l.Hero,e.Pills=l.Pills,e.Flow=l.Flow,e.Footer=l.Footer,e.Notice=l.Notice})(b||={});export{b as AmountEntry};

package/dist/flows/deposit/widgets/amount-entry/footerIntent.js

@@ -0,0 +1 @@
+function e(e){let{amount:r,minAmountUsd:i,maxAmountUsd:a,walletBalanceUsd:o}=e,s=t(o,a);return r!==null&&s>0&&r>s?n(o,a)?`aboveCap`:`aboveBalance`:typeof i==`number`&&i>0&&(r===null||r<i)?`belowMin`:`ready`}function t(e,t){return typeof t==`number`&&t>0?Math.min(e,t):e}function n(e,t){return typeof t==`number`&&t>0&&t<=e}export{t as effectiveMaxUsd,e as resolveFooterIntent};

package/dist/flows/deposit/widgets/asset-picker/AssetPicker.d.ts

@@ -1,5 +1,10 @@
 import { DialogShellControls } from "../../../../shared/dialog/DialogShell.js";
-import { ComponentProps } from "react";
+import { AssetPickerBodyProps } from "../../../../shared/widgets/asset-picker/compound/types.js";
+import { AssetPickerEmpty } from "../../../../shared/widgets/asset-picker/compound/components/Empty.js";
+import { AssetPickerFooter } from "../../../../shared/widgets/asset-picker/compound/components/Footer.js";
+import { AssetPickerHeader } from "../../../../shared/widgets/asset-picker/compound/components/Header.js";
+import { AssetPickerList } from "../../../../shared/widgets/asset-picker/compound/components/List.js";
+import { ComponentProps, ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/flows/deposit/widgets/asset-picker/AssetPicker.d.ts
@@ -8,7 +13,17 @@ import * as _$react_jsx_runtime0 from "react/jsx-runtime";
  * entity and the destination header title from `target`. Owns the selected-id state locally and
  * routes the footer Continue through orchestrator's `confirmAsset`.
  */
-declare function AssetPicker(props: ComponentProps<"div">): _$react_jsx_runtime0.JSX.Element | null;
+interface AssetPickerOwnProps {
+  /**
+   * Optional custom composition. Defaults to `<Header />` + `<Body><List /></Body>` + `<Footer />`.
+   * Pass children to interleave your own elements between compound parts.
+   */
+  children?: ReactNode;
+}
+declare function AssetPicker({
+  children,
+  ...props
+}: ComponentProps<"div"> & AssetPickerOwnProps): _$react_jsx_runtime0.JSX.Element | null;
 declare function AssetPickerDialog({
   open,
   defaultOpen,
@@ -17,9 +32,14 @@ declare function AssetPickerDialog({
   ...rootProps
 }: AssetPicker.DialogProps): _$react_jsx_runtime0.JSX.Element;
 declare namespace AssetPicker {
-  type Props = ComponentProps<"div">;
-  type DialogProps = ComponentProps<"div"> & DialogShellControls;
+  type Props = ComponentProps<"div"> & AssetPickerOwnProps;
+  type DialogProps = ComponentProps<"div"> & DialogShellControls & AssetPickerOwnProps;
   const Dialog: typeof AssetPickerDialog;
+  const Header: typeof AssetPickerHeader;
+  const Body: (props: AssetPickerBodyProps) => _$react_jsx_runtime0.JSX.Element;
+  const List: typeof AssetPickerList;
+  const Footer: typeof AssetPickerFooter;
+  const Empty: typeof AssetPickerEmpty;
 }
 //#endregion
 export { AssetPicker };