@stridge/kit 0.1.0-alpha.55 → 0.1.0-alpha.57

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

@@ -1 +1 @@
-"use client";import{useOptionalActivityDriverInstance as e}from"../../activity/driver/context.js";import{useLingui as t}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{toFailure as n}from"../../../shared/orchestrator/toFailure.js";import{useDriverSettlementListener as r}from"../../../shared/orchestrator/useDriverSettlementListener.js";import{useEffectiveState as i}from"../../../shared/orchestrator/useEffectiveState.js";import{isUserRejectionFailure as a}from"../../../shared/orchestrator/userRejection.js";import{useSettlementWatcher as o}from"../../../shared/orchestrator/useSettlementWatcher.js";import"../../../shared/orchestrator/index.js";import{useDepositDriverInstance as s}from"../driver/context.js";import{initialState as c,reducer as l}from"./reducer.js";import{resolveAssetById as u}from"./resolveAssetById.js";import{createContext as d,use as f,useCallback as p,useEffect as m,useMemo as h,useReducer as g,useRef as _}from"react";import{jsx as v}from"react/jsx-runtime";const y={id:`ELhVSL`,message:`Failed to submit deposit.`},b={id:`Ej5HL9`,message:`Signature declined. Please try again.`},x=d(null);x.displayName=`GatewayControllerContext`;function S(){let e=f(x);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e}function C(){return f(x)}const w=d(void 0);w.displayName=`DepositMethodsConfigContext`;function T(){return f(w)}function E(){return S().state}function D(){return S().effectiveState}function O(){return S().actions}function k({methodsConfig:t,children:n}){let r=s(),a=e(),[o,u]=g(l,c),d=j(o,u,r,a);M(o,u,r),N(o,u,r,a);let f=i(o),p=A(o,u,r,d,t);return v(w,{value:t,children:v(x,{value:h(()=>({state:o,effectiveState:f,dispatch:u,controller:p,actions:d}),[o,f,p,d]),children:n})})}function A(e,t,n,r,i){let a=_(n);a.current=n;let o=_(i);o.current=i;let s=p(e=>{if(!e)return a.current.arm(),t({type:`OPEN`,input:void 0}),!0;if(o.current?.[e.method]?.disabled)return!1;if(e.method===`transfer`)return a.current.arm(),t({type:`OPEN`,input:{method:`transfer`}}),!0;if(e.method===`wallet`&&e.assetId!==void 0){let n=u(a.current.getSnapshot(),e.assetId);return a.current.arm(),n?(t({type:`OPEN`,input:{method:`wallet`,asset:n}}),!0):(t({type:`OPEN`,input:{method:`wallet`}}),!0)}return a.current.arm(),t({type:`OPEN`,input:{method:`wallet`}}),!0},[t]),c=p(()=>{t({type:`CLOSE`})},[t]);return h(()=>({open:s,close:c,actions:r}),[s,c,r])}function j(e,r,i,o){let s=_(e);s.current=e;let c=_(i);c.current=i;let l=_(o);l.current=o;let u=_(r);u.current=r;let{i18n:d}=t(),f=_(d);f.current=d;let m=p((e,t)=>{let r=c.current,i=new AbortController,o=F(e,t);r.submitDeposit(o,i.signal).then(e=>{if(!i.signal.aborted){try{r.invalidateBalances?.()}catch{}try{l.current?.invalidateActivity?.()}catch{}u.current({type:`DEPOSIT_SUBMITTED`,tx:e})}}).catch(e=>{if(i.signal.aborted)return;let t=n(e,f.current._(y));if(a(t)){u.current({type:`DEPOSIT_SIGNATURE_DECLINED`,notice:f.current._(b)});return}u.current({type:`DEPOSIT_SUBMISSION_FAILED`,failure:t})})},[]),g=p(e=>{u.current({type:`DEPOSIT_METHOD_SELECTED`,method:e})},[]),v=p(e=>{u.current({type:`ASSET_CONFIRMED`,asset:e})},[]),x=p(e=>{s.current.name===`amountEntry`&&u.current({type:`AMOUNT_CONFIRMED`,amount:e})},[]),S=p(()=>{let e=s.current;if(e.name!==`confirmDeposit`)return;let t=e.ctx.phase;if(t.kind===`failed`){u.current({type:`QUOTE_RETRY`});return}if(t.kind!==`ready`)return;let{asset:n,amount:r}=e.ctx;u.current({type:`DEPOSIT_CONFIRMED`}),m(n,r)},[m]),C=p(()=>{u.current({type:`BACK`})},[]),w=p(()=>{u.current({type:`CLOSE`})},[]),T=p(()=>{u.current({type:`SUCCESS_DONE`})},[]),E=p(()=>{u.current({type:`ERROR_TRY_AGAIN`})},[]),D=p((e,t)=>{u.current({type:`RESUME_TO_PROCESSING`,method:e,tx:t})},[]),O=p((e,t)=>{u.current({type:`RESUME_TO_SUCCESS`,method:e,tx:t})},[]),k=p(e=>{u.current({type:`RESUME_TO_ERROR`,...e?{tx:e}:{}})},[]),A=p(()=>{if(l.current==null){process.env.NODE_ENV!==`production`&&console.warn("[@stridge/kit] useDepositActions().openActivity() was called but no activity driver is mounted. Wrap the host with `<KitProvider activity={…}>` (or `<StridgeProvider>` with any flow enabled) to enable the activity surface.");return}let e=s.current;e.name!==`deposit`&&e.name!==`assetPicker`&&e.name!==`amountEntry`&&e.name!==`transferCrypto`||u.current({type:`OPEN_ACTIVITY`})},[]),j=p(e=>{u.current({type:`SELECT_SETTLEMENT`,settlementId:e})},[]);return h(()=>({selectMethod:g,confirmAsset:v,confirmAmount:x,confirmDeposit:S,back:C,close:w,successDone:T,tryAgain:E,resumeToProcessing:D,resumeToSuccess:O,resumeToError:k,openActivity:A,selectSettlement:j}),[g,v,x,S,C,w,T,E,D,O,k,A,j])}function M(e,t,r){m(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`loading`&&e.ctx.phase.kind!==`regenerating`)return;let i=new AbortController,a=P(e.ctx.asset,e.ctx.amount);return r.requestQuote(a,i.signal).catch(e=>{i.signal.aborted||t({type:`QUOTE_FAILED`,failure:n(e,`Failed to fetch quote.`)})}),()=>i.abort()},[e.name,e.name===`confirmDeposit`?e.ctx.phase.kind:void 0,e.name===`confirmDeposit`?e.ctx.asset:void 0,e.name===`confirmDeposit`?e.ctx.amount:void 0,r,t]),m(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`ready`)return;let n=e.ctx.phase.quoteExpiresAt,r=Math.max(0,n-Date.now()),i=setTimeout(()=>{t({type:`QUOTE_EXPIRED`})},r);return()=>clearTimeout(i)},[e.name,e.name===`confirmDeposit`&&e.ctx.phase.kind===`ready`?e.ctx.phase.quoteExpiresAt:void 0,t])}function N(e,t,n,i){let a=_(i);a.current=i;let s=e.name===`processing`?e.ctx.tx:void 0;o(n,s?{tx:s}:void 0,s?.hash),m(()=>{if(e.name!==`transferCrypto`||!n.watchSourceTx)return;let t=new AbortController,r;return n.watchSourceTx({},e=>{if(!t.signal.aborted&&!r){r=new AbortController,n.watchSettlement({tx:e},()=>{},r.signal);try{a.current?.invalidateActivity?.()}catch{}}},t.signal),()=>{t.abort(),r?.abort()}},[e.name,n]);let c=e.name===`activityList`||e.name===`activityDetail`;m(()=>{if(!c||!i)return;let e=new AbortController;return i.watchActivity(e.signal),()=>e.abort()},[c,i]),m(()=>{if(e.name===`closed`||e.name===`transferCrypto`||e.name===`processing`||c||!n.fetchActiveSettlement)return;let t=new AbortController,r,i,a=!1,o=async()=>{try{let e=await n.fetchActiveSettlement({},t.signal);if(a)return;if(e&&!r&&e.payload.kind===`pending`){let t=e.payload.txHash?.value;t&&(r=new AbortController,n.watchSettlement({tx:{hash:t}},()=>{},r.signal))}}catch{}a||(i=setTimeout(o,5e3))};return o(),()=>{a=!0,t.abort(),r?.abort(),i&&clearTimeout(i)}},[e.name,c,n]);let l=_(e);l.current=e,r(n,e=>{if(e===`pending`||e===`succeeded`||e===`failed`)try{n.invalidateBalances?.()}catch{}l.current.name===`processing`&&(e===`succeeded`?t({type:`PROCESSING_SUCCEEDED`}):e===`failed`&&t({type:`PROCESSING_FAILED`}))});let u=_(null);m(()=>{let e=()=>{let e=n.getSnapshot(),r=l.current,i=e.quote;i.status!==u.current&&(u.current=i.status,i.status===`ready`&&r.name===`confirmDeposit`?(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_RESOLVED`,expiresAt:i.payload.expiresAt}):i.status===`error`&&r.name===`confirmDeposit`&&(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_FAILED`,failure:{reason:i.error.message,code:i.error.name}}))},r=n.subscribe(e);return e(),r},[n,t])}function P(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build quote input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceTokenSymbol:e.symbol,sourceIsNative:e.isNative,amount:t,...e.priceUsd===void 0?{}:{sourcePriceUsd:e.priceUsd}}}function F(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build submit input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceIsNative:e.isNative,amount:t}}export{k as GatewayController,S as useControllerContext,O as useDepositActions,D as useDepositEffectiveState,T as useDepositMethodsConfig,E as useDepositState,C as useOptionalControllerContext};
+"use client";import{useOptionalActivityDriverInstance as e}from"../../activity/driver/context.js";import{useLingui as t}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{toFailure as n}from"../../../shared/orchestrator/toFailure.js";import{useDriverSettlementListener as r}from"../../../shared/orchestrator/useDriverSettlementListener.js";import{useEffectiveState as i}from"../../../shared/orchestrator/useEffectiveState.js";import{isUserRejectionFailure as a}from"../../../shared/orchestrator/userRejection.js";import{useSettlementWatcher as o}from"../../../shared/orchestrator/useSettlementWatcher.js";import"../../../shared/orchestrator/index.js";import{useDepositDriverInstance as s}from"../driver/context.js";import{initialState as c,reducer as l}from"./reducer.js";import{resolveAssetById as u}from"./resolveAssetById.js";import{createContext as d,use as f,useCallback as p,useEffect as m,useMemo as h,useReducer as g,useRef as _}from"react";import{jsx as v}from"react/jsx-runtime";const y={id:`ELhVSL`,message:`Failed to submit deposit.`},b={id:`Ej5HL9`,message:`Signature declined. Please try again.`},x=d(null);x.displayName=`GatewayControllerStateContext`;const S=d(null);S.displayName=`GatewayControllerStableContext`;function C(){let e=f(x),t=f(S);if(!e||!t)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return{...e,...t}}function w(){let e=f(S);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e}function T(){return f(S)}const E=d(void 0);E.displayName=`DepositMethodsConfigContext`;function D(){return f(E)}const O=d(!1);O.displayName=`CashRailUnlockedContext`;function k(){return f(O)}function A(e){let t=D();return h(()=>t?e.filter(e=>e.value===`cash`?t.cashRail?.disabled!==!0:!0):e,[e,t])}function j(){let e=f(x);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e.state}function M(){let e=f(x);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e.effectiveState}function N(){return w().actions}function P({methodsConfig:t,cashRailUnlocked:n=!1,children:r}){let a=s(),o=e(),[u,d]=g(l,c),f=I(u,d,a,o);L(u,d,a),R(u,d,a,o);let p=i(u),m=F(u,d,a,f,t);return v(E,{value:t,children:v(O,{value:n,children:v(S,{value:h(()=>({dispatch:d,controller:m,actions:f}),[d,m,f]),children:v(x,{value:h(()=>({state:u,effectiveState:p}),[u,p]),children:r})})})})}function F(e,t,n,r,i){let a=_(n);a.current=n;let o=_(i);o.current=i;let s=p(e=>{if(!e)return a.current.arm(),t({type:`OPEN`,input:void 0}),!0;if(o.current?.[e.method]?.disabled)return!1;if(e.method===`transfer`)return a.current.arm(),t({type:`OPEN`,input:{method:`transfer`}}),!0;if(e.method===`wallet`&&e.assetId!==void 0){let n=u(a.current.getSnapshot(),e.assetId);return a.current.arm(),n?(t({type:`OPEN`,input:{method:`wallet`,asset:n}}),!0):(t({type:`OPEN`,input:{method:`wallet`}}),!0)}return a.current.arm(),t({type:`OPEN`,input:{method:`wallet`}}),!0},[t]),c=p(()=>{t({type:`CLOSE`})},[t]);return h(()=>({open:s,close:c,actions:r}),[s,c,r])}function I(e,r,i,o){let s=_(e);s.current=e;let c=_(i);c.current=i;let l=_(o);l.current=o;let u=_(r);u.current=r;let{i18n:d}=t(),f=_(d);f.current=d;let m=p((e,t)=>{let r=c.current,i=new AbortController,o=B(e,t);r.submitDeposit(o,i.signal).then(e=>{if(!i.signal.aborted){try{r.invalidateBalances?.()}catch{}try{l.current?.invalidateActivity?.()}catch{}u.current({type:`DEPOSIT_SUBMITTED`,tx:e})}}).catch(e=>{if(i.signal.aborted)return;let t=n(e,f.current._(y));if(a(t)){u.current({type:`DEPOSIT_SIGNATURE_DECLINED`,notice:f.current._(b)});return}u.current({type:`DEPOSIT_SUBMISSION_FAILED`,failure:t})})},[]),g=p(e=>{u.current({type:`DEPOSIT_METHOD_SELECTED`,method:e})},[]),v=p(e=>{u.current({type:`CASH_METHOD_SELECTED`,cashMethod:e})},[]),x=p(e=>{u.current({type:`CASH_AMOUNT_CONFIRMED`,amount:e})},[]),S=p(()=>{u.current({type:`CASH_METHOD_READY`})},[]),C=p(e=>{u.current({type:`ASSET_CONFIRMED`,asset:e})},[]),w=p(e=>{s.current.name===`amountEntry`&&u.current({type:`AMOUNT_CONFIRMED`,amount:e})},[]),T=p(()=>{let e=s.current;if(e.name!==`confirmDeposit`)return;let t=e.ctx.phase;if(t.kind===`failed`){u.current({type:`QUOTE_RETRY`});return}if(t.kind!==`ready`)return;let{asset:n,amount:r}=e.ctx;u.current({type:`DEPOSIT_CONFIRMED`}),m(n,r)},[m]),E=p(()=>{u.current({type:`BACK`})},[]),D=p(()=>{u.current({type:`CLOSE`})},[]),O=p(()=>{u.current({type:`SUCCESS_DONE`})},[]),k=p(()=>{u.current({type:`ERROR_TRY_AGAIN`})},[]),A=p((e,t)=>{u.current({type:`RESUME_TO_PROCESSING`,method:e,tx:t})},[]),j=p((e,t)=>{u.current({type:`RESUME_TO_SUCCESS`,method:e,tx:t})},[]),M=p(e=>{u.current({type:`RESUME_TO_ERROR`,...e?{tx:e}:{}})},[]),N=p(()=>{if(l.current==null){process.env.NODE_ENV!==`production`&&console.warn("[@stridge/kit] useDepositActions().openActivity() was called but no activity driver is mounted. Wrap the host with `<KitProvider activity={…}>` (or `<StridgeProvider>` with any flow enabled) to enable the activity surface.");return}let e=s.current;e.name!==`deposit`&&e.name!==`assetPicker`&&e.name!==`amountEntry`&&e.name!==`transferCrypto`||u.current({type:`OPEN_ACTIVITY`})},[]),P=p(e=>{u.current({type:`SELECT_SETTLEMENT`,settlementId:e})},[]);return h(()=>({selectMethod:g,selectCashMethod:v,confirmCashAmount:x,cashMethodReady:S,confirmAsset:C,confirmAmount:w,confirmDeposit:T,back:E,close:D,successDone:O,tryAgain:k,resumeToProcessing:A,resumeToSuccess:j,resumeToError:M,openActivity:N,selectSettlement:P}),[g,v,x,S,C,w,T,E,D,O,k,A,j,M,N,P])}function L(e,t,r){m(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`loading`&&e.ctx.phase.kind!==`regenerating`)return;let i=new AbortController,a=z(e.ctx.asset,e.ctx.amount);return r.requestQuote(a,i.signal).catch(e=>{i.signal.aborted||t({type:`QUOTE_FAILED`,failure:n(e,`Failed to fetch quote.`)})}),()=>i.abort()},[e.name,e.name===`confirmDeposit`?e.ctx.phase.kind:void 0,e.name===`confirmDeposit`?e.ctx.asset:void 0,e.name===`confirmDeposit`?e.ctx.amount:void 0,r,t]),m(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`ready`)return;let n=e.ctx.phase.quoteExpiresAt,r=Math.max(0,n-Date.now()),i=setTimeout(()=>{t({type:`QUOTE_EXPIRED`})},r);return()=>clearTimeout(i)},[e.name,e.name===`confirmDeposit`&&e.ctx.phase.kind===`ready`?e.ctx.phase.quoteExpiresAt:void 0,t])}function R(e,t,n,i){let a=_(i);a.current=i;let s=e.name===`processing`?e.ctx.tx:void 0;o(n,s?{tx:s}:void 0,s?.hash),m(()=>{if(e.name!==`transferCrypto`||!n.watchSourceTx)return;let t=new AbortController,r;return n.watchSourceTx({},e=>{if(!t.signal.aborted&&!r){r=new AbortController,n.watchSettlement({tx:e},()=>{},r.signal);try{a.current?.invalidateActivity?.()}catch{}}},t.signal),()=>{t.abort(),r?.abort()}},[e.name,n]);let c=e.name===`activityList`||e.name===`activityDetail`;m(()=>{if(!c||!i)return;let e=new AbortController;return i.watchActivity(e.signal),()=>e.abort()},[c,i]),m(()=>{if(e.name===`closed`||e.name===`transferCrypto`||e.name===`processing`||c||!n.fetchActiveSettlement)return;let t=new AbortController,r,i,a=!1,o=async()=>{try{let e=await n.fetchActiveSettlement({},t.signal);if(a)return;if(e&&!r&&e.payload.kind===`pending`){let t=e.payload.txHash?.value;t&&(r=new AbortController,n.watchSettlement({tx:{hash:t}},()=>{},r.signal))}}catch{}a||(i=setTimeout(o,5e3))};return o(),()=>{a=!0,t.abort(),r?.abort(),i&&clearTimeout(i)}},[e.name,c,n]);let l=_(e);l.current=e,r(n,e=>{if(e===`pending`||e===`succeeded`||e===`failed`)try{n.invalidateBalances?.()}catch{}l.current.name===`processing`&&(e===`succeeded`?t({type:`PROCESSING_SUCCEEDED`}):e===`failed`&&t({type:`PROCESSING_FAILED`}))});let u=_(null);m(()=>{let e=()=>{let e=n.getSnapshot(),r=l.current,i=e.quote;i.status!==u.current&&(u.current=i.status,i.status===`ready`&&r.name===`confirmDeposit`?(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_RESOLVED`,expiresAt:i.payload.expiresAt}):i.status===`error`&&r.name===`confirmDeposit`&&(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_FAILED`,failure:{reason:i.error.message,code:i.error.name}}))},r=n.subscribe(e);return e(),r},[n,t])}function z(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build quote input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceTokenSymbol:e.symbol,sourceIsNative:e.isNative,amount:t,...e.priceUsd===void 0?{}:{sourcePriceUsd:e.priceUsd}}}function B(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build submit input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceIsNative:e.isNative,amount:t}}export{P as GatewayController,k as useCashRailUnlocked,C as useControllerContext,N as useDepositActions,M as useDepositEffectiveState,D as useDepositMethodsConfig,j as useDepositState,A as useEnabledRails,T as useOptionalStableControllerContext,w as useStableControllerContext};

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

@@ -0,0 +1,5 @@
+import { FailureInfo } from "../../../shared/orchestrator/types.js";
+import { CashConfirmPhase, CashMethodId, ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositMethodConfig, DepositMethodsConfig, DepositRailConfig, DepositState, DepositStateName, GatewayEvent, OpenInput, ResolvedOpenInput, RetryTargetSpec } from "./types.js";
+import { useDepositState } from "./controller.js";
+import { STEPS_WITH_OWN_SETTLEMENT_VIEW, stepRendersSettlement } from "./steps.js";
+import { useDeposit } from "./useDeposit.js";

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

@@ -0,0 +1 @@
+export { };

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

@@ -1 +1 @@
-import{createActivityReducers as e}from"../../../shared/orchestrator/createActivityReducers.js";import"../../../shared/orchestrator/index.js";const t={name:`closed`},{reduceFromActivityList:n,reduceFromActivityDetail:r}=e({activityList:e=>({name:`activityList`,ctx:{backTarget:e}}),activityDetail:(e,t,n)=>({name:`activityDetail`,ctx:{settlementId:e,backTarget:t,viaList:n}}),closed:()=>({name:`closed`}),restoreFromBackTarget:e=>m(e)});function i(e,t){if(t.type===`RESUME_TO_PROCESSING`)return e.name===`closed`?e:{name:`processing`,ctx:{method:t.method,tx:t.tx,retryTargetForFailure:{kind:`fresh`}}};if(t.type===`RESUME_TO_SUCCESS`)return e.name===`closed`?e:{name:`success`,ctx:{method:t.method,tx:t.tx}};if(t.type===`RESUME_TO_ERROR`)return e.name===`closed`?e:{name:`error`,ctx:{retryTarget:{kind:`fresh`},...t.tx?{tx:t.tx}:{}}};switch(e.name){case`closed`:return a(t);case`deposit`:return o(e,t);case`assetPicker`:return s(e,t);case`amountEntry`:return c(e,t);case`confirmDeposit`:return l(e,t);case`transferCrypto`:return u(e,t);case`processing`:return d(e,t);case`success`:return f(e,t);case`error`:return p(e,t);case`activityList`:return n(e,t);case`activityDetail`:return r(e,t);default:return g(e)}}function a(e){if(e.type!==`OPEN`)return{name:`closed`};let t=e.input;return t?t.method===`transfer`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`closed`}}:t.asset?{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`closed`}}:{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`closed`}}:{name:`deposit`,ctx:{backTarget:`closed`}}}function o(e,t){switch(t.type){case`DEPOSIT_METHOD_SELECTED`:return t.method===`wallet`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`deposit`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`deposit`,backTarget:`closed`}}};case`BACK`:case`CLOSE`:return{name:`closed`};default:return e}}function s(e,t){switch(t.type){case`ASSET_CONFIRMED`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`assetPicker`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`assetPicker`,method:`wallet`,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function c(e,t){switch(t.type){case`AMOUNT_CONFIRMED`:return{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.ctx.asset,amount:t.amount,phase:{kind:`loading`},backTarget:`amountEntry`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`amountEntry`,method:`wallet`,asset:e.ctx.asset,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function l(e,t){let n=e.ctx.phase;switch(t.type){case`QUOTE_RESOLVED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`ready`,quoteExpiresAt:t.expiresAt}}}:e;case`QUOTE_FAILED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`quote`}}}:e;case`QUOTE_RETRY`:return n.kind===`failed`?{...e,ctx:{...e.ctx,phase:{kind:`loading`}}}:e;case`QUOTE_EXPIRED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`}}}:e;case`DEPOSIT_CONFIRMED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`submitting`}}}:e;case`DEPOSIT_SUBMITTED`:if(n.kind===`submitting`){let n={kind:`confirmDepositReady`,method:`wallet`,asset:e.ctx.asset,amount:e.ctx.amount};return{name:`processing`,ctx:{method:`wallet`,tx:t.tx,retryTargetForFailure:n}}}return e;case`DEPOSIT_SUBMISSION_FAILED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`submission`}}}:e;case`DEPOSIT_SIGNATURE_DECLINED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`,...t.notice?{notice:t.notice}:{}}}}:e;case`BACK`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:e.ctx.asset,backTarget:`assetPicker`}};case`CLOSE`:return{name:`closed`};default:return e}}function u(e,t){switch(t.type){case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`transferCrypto`,method:`transfer`,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function d(e,t){switch(t.type){case`PROCESSING_SUCCEEDED`:return{name:`success`,ctx:{method:e.ctx.method,tx:e.ctx.tx}};case`PROCESSING_FAILED`:return{name:`error`,ctx:{retryTarget:e.ctx.retryTargetForFailure,tx:e.ctx.tx}};case`CLOSE`:return{name:`closed`};default:return e}}function f(e,t){return t.type===`SUCCESS_DONE`||t.type===`CLOSE`?{name:`closed`}:e}function p(e,t){return t.type===`ERROR_TRY_AGAIN`?h(e.ctx.retryTarget):t.type===`CLOSE`?{name:`closed`}:e}function m(e){return e.kind===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:e.backTarget}}:e.kind===`amountEntry`?{name:`amountEntry`,ctx:{method:`wallet`,asset:e.asset,backTarget:e.backTarget}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}}function h(e){return e.kind===`fresh`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`transferCrypto`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}:{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.asset,amount:e.amount,phase:{kind:`loading`},backTarget:`amountEntry`}}}function g(e){throw Error(`Unhandled state: ${JSON.stringify(e)}`)}export{t as initialState,i as reducer};
+import{createActivityReducers as e}from"../../../shared/orchestrator/createActivityReducers.js";import"../../../shared/orchestrator/index.js";import{assertNever as t}from"../../../shared/utils/assertNever.js";const n={name:`closed`},{reduceFromActivityList:r,reduceFromActivityDetail:i}=e({activityList:e=>({name:`activityList`,ctx:{backTarget:e}}),activityDetail:(e,t,n)=>({name:`activityDetail`,ctx:{settlementId:e,backTarget:t,viaList:n}}),closed:()=>({name:`closed`}),restoreFromBackTarget:e=>_(e)});function a(e,n){if(n.type===`RESUME_TO_PROCESSING`)return e.name===`closed`?e:{name:`processing`,ctx:{method:n.method,tx:n.tx,retryTargetForFailure:{kind:`fresh`}}};if(n.type===`RESUME_TO_SUCCESS`)return e.name===`closed`?e:{name:`success`,ctx:{method:n.method,tx:n.tx}};if(n.type===`RESUME_TO_ERROR`)return e.name===`closed`?e:{name:`error`,ctx:{retryTarget:{kind:`fresh`},...n.tx?{tx:n.tx}:{}}};switch(e.name){case`closed`:return o(n);case`deposit`:return s(e,n);case`assetPicker`:return c(e,n);case`amountEntry`:return l(e,n);case`cashAmountEntry`:return u(e,n);case`cashConfirm`:return d(e,n);case`confirmDeposit`:return f(e,n);case`transferCrypto`:return p(e,n);case`processing`:return m(e,n);case`success`:return h(e,n);case`error`:return g(e,n);case`activityList`:return r(e,n);case`activityDetail`:return i(e,n);default:return t(e)}}function o(e){if(e.type!==`OPEN`)return{name:`closed`};let t=e.input;return t?t.method===`transfer`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`closed`}}:t.asset?{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`closed`}}:{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`closed`}}:{name:`deposit`,ctx:{backTarget:`closed`}}}function s(e,t){switch(t.type){case`DEPOSIT_METHOD_SELECTED`:return t.method===`wallet`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`deposit`}};case`CASH_METHOD_SELECTED`:return{name:`cashAmountEntry`,ctx:{method:`cash`,cashMethod:t.cashMethod,backTarget:`deposit`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`deposit`,backTarget:`closed`}}};case`BACK`:case`CLOSE`:return{name:`closed`};default:return e}}function c(e,t){switch(t.type){case`ASSET_CONFIRMED`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`assetPicker`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`assetPicker`,method:`wallet`,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function l(e,t){switch(t.type){case`AMOUNT_CONFIRMED`:return{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.ctx.asset,amount:t.amount,phase:{kind:`loading`},backTarget:`amountEntry`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`amountEntry`,method:`wallet`,asset:e.ctx.asset,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function u(e,t){switch(t.type){case`CASH_AMOUNT_CONFIRMED`:return{name:`cashConfirm`,ctx:{method:`cash`,cashMethod:e.ctx.cashMethod,amount:t.amount,phase:{kind:`loading`},backTarget:`cashAmountEntry`}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function d(e,t){let n=e.ctx.phase;switch(t.type){case`CASH_METHOD_READY`:return n.kind===`loading`?{...e,ctx:{...e.ctx,phase:{kind:`ready`}}}:e;case`BACK`:return{name:`cashAmountEntry`,ctx:{method:`cash`,cashMethod:e.ctx.cashMethod,backTarget:`deposit`,amount:e.ctx.amount}};case`CLOSE`:return{name:`closed`};default:return e}}function f(e,t){let n=e.ctx.phase;switch(t.type){case`QUOTE_RESOLVED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`ready`,quoteExpiresAt:t.expiresAt}}}:e;case`QUOTE_FAILED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`quote`}}}:e;case`QUOTE_RETRY`:return n.kind===`failed`?{...e,ctx:{...e.ctx,phase:{kind:`loading`}}}:e;case`QUOTE_EXPIRED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`}}}:e;case`DEPOSIT_CONFIRMED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`submitting`}}}:e;case`DEPOSIT_SUBMITTED`:if(n.kind===`submitting`){let n={kind:`confirmDepositReady`,method:`wallet`,asset:e.ctx.asset,amount:e.ctx.amount};return{name:`processing`,ctx:{method:`wallet`,tx:t.tx,retryTargetForFailure:n}}}return e;case`DEPOSIT_SUBMISSION_FAILED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`submission`}}}:e;case`DEPOSIT_SIGNATURE_DECLINED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`,...t.notice?{notice:t.notice}:{}}}}:e;case`BACK`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:e.ctx.asset,backTarget:`assetPicker`}};case`CLOSE`:return{name:`closed`};default:return e}}function p(e,t){switch(t.type){case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`transferCrypto`,method:`transfer`,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function m(e,t){switch(t.type){case`PROCESSING_SUCCEEDED`:return{name:`success`,ctx:{method:e.ctx.method,tx:e.ctx.tx}};case`PROCESSING_FAILED`:return{name:`error`,ctx:{retryTarget:e.ctx.retryTargetForFailure,tx:e.ctx.tx}};case`CLOSE`:return{name:`closed`};default:return e}}function h(e,t){return t.type===`SUCCESS_DONE`||t.type===`CLOSE`?{name:`closed`}:e}function g(e,t){return t.type===`ERROR_TRY_AGAIN`?v(e.ctx.retryTarget):t.type===`CLOSE`?{name:`closed`}:e}function _(e){return e.kind===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:e.backTarget}}:e.kind===`amountEntry`?{name:`amountEntry`,ctx:{method:`wallet`,asset:e.asset,backTarget:e.backTarget}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}}function v(e){return e.kind===`fresh`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`transferCrypto`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}:{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.asset,amount:e.amount,phase:{kind:`loading`},backTarget:`amountEntry`}}}export{n as initialState,a as reducer};

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

@@ -8,6 +8,14 @@ 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,
@@ -28,14 +36,51 @@ interface DepositMethodConfig {
    */
   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.
+ * 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.
@@ -56,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.
  */
@@ -130,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: {
@@ -222,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;
@@ -350,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;
@@ -379,4 +484,4 @@ interface DepositActions {
   selectSettlement(settlementId: string): void;
 }
 //#endregion
-export { ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositMethodConfig, DepositMethodsConfig, 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.js

@@ -1 +1 @@
-"use client";import{useDepositDriverInstance as e}from"../driver/context.js";import{useControllerContext as t,useOptionalControllerContext as n}from"./controller.js";import{useCallback as r}from"react";function i(){return t().controller}function a(){return n()?.controller??null}function o(){let t=e();return r(()=>{t.arm()},[t])}export{i as useDeposit,a as useOptionalDeposit,o as usePrefetchDeposit};
+"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/amount-entry/AmountEntry.d.ts

@@ -1,8 +1,8 @@
 import { DialogShellControls } from "../../../../shared/dialog/DialogShell.js";
 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 { AmountEntryHeader } from "../../../../shared/widgets/amount-entry/compound/components/Header.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";

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

@@ -1 +1 @@
-"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{ActivityTrigger as l}from"../../../../shared/widgets/activity/ActivityTrigger.js";import"../../../../shared/widgets/activity/index.js";import{AmountEntry as u}from"../../../../shared/widgets/amount-entry/compound/AmountEntry.js";import"../../../../shared/widgets/amount-entry/compound/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 _(u,{...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:_(l,{onOpen:E})}:{},children:n??v(g,{children:[_(u.Header,{}),v(u.Body,{children:[_(u.Hero,{}),_(u.Pills,{}),_(u.Flow,{}),_(u.Notice,{})]}),_(u.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=u.Header,e.Body=u.Body,e.Hero=u.Hero,e.Pills=u.Pills,e.Flow=u.Flow,e.Footer=u.Footer,e.Notice=u.Notice})(b||={});export{b 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/cash-amount-entry/CashAmountEntry.d.ts

@@ -0,0 +1,71 @@
+import { DialogShellControls } from "../../../../shared/dialog/DialogShell.js";
+import { AmountEntryBodyProps } from "../../../../shared/widgets/amount-entry/compound/types.js";
+import { AmountEntryHeader } from "../../../../shared/widgets/amount-entry/compound/components/Header.js";
+import { AmountEntryDetails, AmountEntryDetailsRow } from "../../../../shared/widgets/amount-entry/compound/components/Details.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 { CashAmountEntryHeroLabel } from "./compound/components/HeroLabel.js";
+import { CashAmountEntryMethodChip } from "./compound/components/MethodChip.js";
+import { CashAmountEntryReceiveChip } from "./compound/components/ReceiveChip.js";
+import { ComponentProps, ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/cash-amount-entry/CashAmountEntry.d.ts
+interface CashAmountEntryProps extends ComponentProps<"div"> {
+  /**
+   * Optional custom composition. When omitted, the canonical default composition renders —
+   * `<Header />` + `<Body>` with method chip + YOU PAY label + Hero (Receive chip subLine) +
+   * fiat-absolute Pills + Details breakdown + Notice + `<Footer />`. Pass children to interleave
+   * your own elements between compound parts or replace the composition entirely.
+   */
+  children?: ReactNode;
+}
+/**
+ * Orchestrated `CashAmountEntry` widget — the screen between the cash-method picker and the
+ * per-method confirmation form. Reads the chosen cash method from the FSM's `cashAmountEntry.ctx`,
+ * the per-method limit from the driver's `cashMethods` entity, and computes the fee breakdown
+ * from the mock fixture in {@link computeMockCashBreakdown}. The `cashQuote` driver entity that
+ * backs this in production is deferred.
+ *
+ * Renders nothing on any other FSM state — the dialog routes it under
+ * `<Deposit.Step name="cashAmountEntry">`, and the guard inside this component is a belt-and-
+ * braces check against host compositions that don't honour the step routing.
+ */
+declare function CashAmountEntry({
+  children,
+  ...props
+}: CashAmountEntryProps): _$react_jsx_runtime0.JSX.Element | null;
+declare function CashAmountEntryDialog({
+  open,
+  defaultOpen,
+  onOpenChange,
+  trigger,
+  ...rootProps
+}: CashAmountEntry.DialogProps): _$react_jsx_runtime0.JSX.Element;
+declare namespace CashAmountEntry {
+  type Props = CashAmountEntryProps;
+  type DialogProps = CashAmountEntryProps & DialogShellControls;
+  const Dialog: typeof CashAmountEntryDialog;
+  /**
+   * Compound sub-parts aliased on the orchestrated widget so consumers can compose without
+   * importing the headless compound separately. Identity-equal to the parts on the compound
+   * exported from `@stridge/kit/deposit/compound`.
+   */
+  const MethodChip: typeof CashAmountEntryMethodChip;
+  const HeroLabel: typeof CashAmountEntryHeroLabel;
+  const ReceiveChip: typeof CashAmountEntryReceiveChip;
+  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;
+  const Details: typeof AmountEntryDetails;
+  const DetailsRow: typeof AmountEntryDetailsRow;
+}
+//#endregion
+export { CashAmountEntry };

package/dist/flows/deposit/widgets/cash-amount-entry/CashAmountEntry.js

@@ -0,0 +1 @@
+"use client";import{useKitI18n as e}from"../../../../shared/i18n/useKitI18n.js";import{Trans as t}from"../../../../shared/i18n/Trans.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{formatTokenAmount as o}from"../../../../shared/format/formatTokenAmount.js";import{formatUsd as s}from"../../../../shared/format/formatUsd.js";import{DialogShell as c}from"../../../../shared/dialog/DialogShell.js";import{MOCK_CASH_PRESETS as l,MOCK_RECEIVE_TOKEN as u,computeMockCashBreakdown as d}from"../../shared/cash.js";import{CashAmountEntry as f}from"./compound/CashAmountEntry.js";import"./compound/index.js";import{useEffect as p,useMemo as m,useRef as h,useState as g}from"react";import{Fragment as _,jsx as v,jsxs as y}from"react/jsx-runtime";function b({children:c,...b}){let x=r(),S=a(),{back:C,confirmCashAmount:w}=i(),{_:T}=n(),E=e(),D=S.name===`cashAmountEntry`?S.ctx.cashMethod:void 0,O=S.name===`cashAmountEntry`?S.ctx.amount:void 0,k=x.cashMethods,A=k?.status===`ready`||k?.status===`stale`?k.payload:void 0,j=D?A?.[D]?.limit?.value:void 0,M=D?A?.[D]?.limit?.formatted:void 0,N=l[0]?.value??0,P=O??N,[F,I]=g(P),[L,R]=g(()=>{let e=l.find(e=>e.value===P);return e?String(e.value):void 0}),z=h(D);p(()=>{D&&z.current!==D&&(z.current=D,I(N),R(String(N)))},[D,N]);let B=m(()=>l.map(e=>({value:String(e.value),label:e.label})),[]),V=e=>{let t=Number.parseInt(e,10);Number.isFinite(t)&&(I(t),R(e))},H=e=>{I(e),R(void 0)},U=j===0,W=()=>{if(!U){if(typeof j==`number`&&F!==null&&F>j){I(j),R(void 0);return}F===null||F<=0||!D||w(F)}};if(S.name!==`cashAmountEntry`||!D)return null;let G=!U&&typeof j==`number`&&F!==null&&F>j,K=U?v(t,{id:`FWbwx6`,message:`Cash deposit unavailable for your account`}):G&&M?v(t,{id:`GXkBas`,message:`Max {formattedLimit}`,values:{formattedLimit:M}}):void 0,q=G?T({id:`wkskq5`,message:`Use max`}):void 0,J=d(F,D),Y=o(J.receiveAmount,E,{maxDecimals:2,useGrouping:!0}),X=S.ctx.backTarget===`closed`?void 0:C;return v(f,{...b,cashMethod:D,breakdown:J,formattedReceive:Y,...X?{onChangeMethod:X}:{},amount:F,sendToken:{symbol:`USD`},receiveToken:u,...typeof j==`number`?{max:j}:{},headerTitle:T({id:`kj3M8S`,message:`Deposit`}),currencySymbol:`$`,onAmountChange:H,...X?{onBack:X}:{},presets:B,...L===void 0?{}:{activePreset:L},onPresetSelect:V,...q===void 0?{}:{footerLabel:q},...U?{}:{onContinue:W},notice:K,children:c??y(_,{children:[v(f.Header,{}),y(f.Body,{children:[v(f.MethodChip,{}),v(f.HeroLabel,{children:v(t,{id:`VAxOSg`,message:`You pay`})}),v(f.Hero,{}),v(f.Pills,{}),y(f.Details,{children:[v(f.DetailsRow,{label:v(t,{id:`hehnjM`,message:`Amount`}),children:s(J.amountUsd,E,{showSmallValueClamp:!1})}),v(f.DetailsRow,{label:v(t,{id:`vepIdX`,message:`Crypto price`}),children:v(t,{id:`eUbBqz`,message:`1 {0} = {1}`,values:{0:u.symbol,1:s(J.rate,E,{showSmallValueClamp:!1})}})}),y(f.DetailsRow,{label:v(t,{id:`QFwptY`,message:`Processing fee`}),info:v(t,{id:`C7cyXd`,message:`The processing fee covers the cost of processing your payment through the selected payment method.`}),children:[`− `,s(J.processingFeeUsd,E,{showSmallValueClamp:!1})]}),y(f.DetailsRow,{label:v(t,{id:`y62Dys`,message:`Network fee`}),info:v(t,{id:`f-nEg4`,message:`The network fee is paid to miners and validators of the blockchain to make sure the transaction is processed and confirmed.`}),children:[`− `,s(J.networkFeeUsd,E,{showSmallValueClamp:!1})]})]})]}),v(f.Footer,{children:v(f.Notice,{})})]})})}function x({open:e,defaultOpen:t,onOpenChange:n,trigger:r,...i}){return v(c,{open:e,defaultOpen:t,onOpenChange:n,trigger:r,children:v(b,{...i})})}(function(e){e.Dialog=x,e.MethodChip=f.MethodChip,e.HeroLabel=f.HeroLabel,e.ReceiveChip=f.ReceiveChip,e.Header=f.Header,e.Body=f.Body,e.Hero=f.Hero,e.Pills=f.Pills,e.Flow=f.Flow,e.Footer=f.Footer,e.Notice=f.Notice,e.Details=f.Details,e.DetailsRow=f.DetailsRow})(b||={});export{b as CashAmountEntry};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.d.ts

@@ -0,0 +1,69 @@
+import { AmountEntryBodyProps } from "../../../../../shared/widgets/amount-entry/compound/types.js";
+import { AmountEntryHeader } from "../../../../../shared/widgets/amount-entry/compound/components/Header.js";
+import { AmountEntryDetails, AmountEntryDetailsRow } from "../../../../../shared/widgets/amount-entry/compound/components/Details.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 { CashAmountEntryDialogProps, CashAmountEntryHeroLabelProps, CashAmountEntryMethodChipProps, CashAmountEntryProps } from "./types.js";
+import { CashAmountEntryHeroLabel } from "./components/HeroLabel.js";
+import { CashAmountEntryMethodChip } from "./components/MethodChip.js";
+import { CashAmountEntryReceiveChip } from "./components/ReceiveChip.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.d.ts
+/**
+ * Root of the CashAmountEntry compound. Wraps the shared {@link AmountEntryCompound} and provides
+ * cash-flow-specific context (cashMethod, breakdown, formattedReceive, onChangeMethod) to the
+ * three cash-flow-internal sub-parts (`MethodChip`, `HeroLabel`, `ReceiveChip`) so children render
+ * without prop-drilling from the host.
+ *
+ * Defaults the `subLine` slot to a `<CashAmountEntry.ReceiveChip />` when the host doesn't provide
+ * one explicitly — that's the canonical Paper composition. Pass `subLine={…}` to override.
+ *
+ * Parts:
+ * - {@link CashAmountEntry.MethodChip}
+ * - {@link CashAmountEntry.HeroLabel}
+ * - {@link CashAmountEntry.ReceiveChip}
+ *
+ * The AmountEntry compound parts (`Header`, `Body`, `Hero`, `Pills`, `Details`, `DetailsRow`,
+ * `Notice`, `Footer`) are re-exposed off the namespace too so consumers can compose the full tree
+ * without importing two compounds. Identity-equal to the parts on
+ * {@link AmountEntryCompound}.
+ *
+ * Dialog form: {@link CashAmountEntry.Dialog} pre-composes the widget into a
+ * `Dialog.Root + Dialog.Trigger + Dialog.Content` shell.
+ */
+declare function CashAmountEntry(props: CashAmountEntryProps): _$react_jsx_runtime0.JSX.Element;
+declare function CashAmountEntryDialog({
+  open,
+  defaultOpen,
+  onOpenChange,
+  trigger,
+  children,
+  ...rootProps
+}: CashAmountEntryDialogProps): _$react_jsx_runtime0.JSX.Element;
+declare namespace CashAmountEntry {
+  type Props = CashAmountEntryProps;
+  type MethodChipProps = CashAmountEntryMethodChipProps;
+  type HeroLabelProps = CashAmountEntryHeroLabelProps;
+  type DialogProps = CashAmountEntryDialogProps;
+  /** Cash-flow-specific sub-parts. */
+  const MethodChip: typeof CashAmountEntryMethodChip;
+  const HeroLabel: typeof CashAmountEntryHeroLabel;
+  const ReceiveChip: typeof CashAmountEntryReceiveChip;
+  /** AmountEntry compound parts re-exposed for one-stop composition. */
+  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;
+  const Details: typeof AmountEntryDetails;
+  const DetailsRow: typeof AmountEntryDetailsRow;
+  const Dialog: typeof CashAmountEntryDialog;
+}
+//#endregion
+export { CashAmountEntry };

package/dist/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.js

@@ -0,0 +1 @@
+"use client";import{DialogShell as e}from"../../../../../shared/dialog/DialogShell.js";import{AmountEntry as t}from"../../../../../shared/widgets/amount-entry/compound/AmountEntry.js";import"../../../../../shared/widgets/amount-entry/compound/index.js";import{CashAmountEntryHeroLabel as n}from"./components/HeroLabel.js";import{CashAmountEntryContext as r}from"./context.js";import{CashAmountEntryMethodChip as i}from"./components/MethodChip.js";import{CashAmountEntryReceiveChip as a}from"./components/ReceiveChip.js";import{useMemo as o}from"react";import{jsx as s}from"react/jsx-runtime";const c=s(a,{});function l(e){let{cashMethod:n,breakdown:i,formattedReceive:a,onChangeMethod:l,subLine:u,children:d,...f}=e;return s(r,{value:o(()=>({cashMethod:n,breakdown:i,formattedReceive:a,...l?{onChangeMethod:l}:{}}),[n,i,a,l]),children:s(t,{...f,subLine:u??c,children:d})})}function u({open:t,defaultOpen:n,onOpenChange:r,trigger:i,children:a,...o}){return s(e,{open:t,defaultOpen:n,onOpenChange:r,trigger:i,children:s(l,{...o,children:a})})}(function(e){e.MethodChip=i,e.HeroLabel=n,e.ReceiveChip=a,e.Header=t.Header,e.Body=t.Body,e.Hero=t.Hero,e.Pills=t.Pills,e.Flow=t.Flow,e.Footer=t.Footer,e.Notice=t.Notice,e.Details=t.Details,e.DetailsRow=t.DetailsRow,e.Dialog=u})(l||={});export{l as CashAmountEntry};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.slots.d.ts

@@ -0,0 +1,16 @@
+//#region src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.slots.d.ts
+/**
+ * `data-stridge-slot` constants for the cash-amount-entry widget's cash-flow-internal sub-parts
+ * (method chip, hero label, receive chip). The amount-input chrome itself stamps the shared
+ * `AMOUNT_ENTRY_SLOTS` from `#/shared/widgets/amount-entry`; this file only covers the cash
+ * additions.
+ */
+declare const CASH_AMOUNT_ENTRY_SLOTS: {
+  readonly methodChip: "cash-amount-entry-method-chip";
+  readonly methodChipChange: "cash-amount-entry-method-chip-change";
+  readonly heroLabel: "cash-amount-entry-hero-label";
+  readonly receiveChip: "cash-amount-entry-receive-chip";
+};
+type CashAmountEntrySlot = (typeof CASH_AMOUNT_ENTRY_SLOTS)[keyof typeof CASH_AMOUNT_ENTRY_SLOTS];
+//#endregion
+export { CASH_AMOUNT_ENTRY_SLOTS, CashAmountEntrySlot };

package/dist/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.slots.js

@@ -0,0 +1 @@
+const e={methodChip:`cash-amount-entry-method-chip`,methodChipChange:`cash-amount-entry-method-chip-change`,heroLabel:`cash-amount-entry-hero-label`,receiveChip:`cash-amount-entry-receive-chip`};export{e as CASH_AMOUNT_ENTRY_SLOTS};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.js

@@ -0,0 +1 @@
+const e={heroLabelWrap:{"CashAmountEntry__styles.heroLabelWrap":`CashAmountEntry__styles.heroLabelWrap`,"display-k1xSpc":`x78zum5`,"justifyContent-kjj79g":`xl56j7k`,"paddingInlineEnd-kwRFfy":`x1o5r3ls`,"paddingInlineStart-kZCmMZ":`xz7312c`,"paddingTop-kLKAdn":`xyamay9`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:12`},heroLabel:{"CashAmountEntry__styles.heroLabel":`CashAmountEntry__styles.heroLabel`,"margin-kogj98":`x1ghz6dp`,"letterSpacing-kb6lSQ":`x1labic3`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:19`},methodChipWrap:{"CashAmountEntry__styles.methodChipWrap":`CashAmountEntry__styles.methodChipWrap`,"display-k1xSpc":`x78zum5`,"justifyContent-kjj79g":`xl56j7k`,"paddingTop-kLKAdn":`xyamay9`,"paddingInlineEnd-kwRFfy":`x1o5r3ls`,"paddingInlineStart-kZCmMZ":`xz7312c`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:24`},methodChip:{"CashAmountEntry__styles.methodChip":`CashAmountEntry__styles.methodChip`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"gap-kOIVth":`x167g77z`,"paddingBlock-k8WAf4":`x1t0vds8`,"paddingInlineStart-kZCmMZ":`x25sj25`,"paddingInlineEnd-kwRFfy":`xpdmqnj`,"borderRadius-kaIpWk":`x1npxkrn`,"backgroundColor-kWkggS":`x1qkydf4`,"borderColor-kVAM5u":`x12c9lpl`,"borderStyle-ksu8eU":`x1y0btm7`,"borderWidth-kMzoRj":`xmkeg23`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:31`},methodChipIcon:{"CashAmountEntry__styles.methodChipIcon":`CashAmountEntry__styles.methodChipIcon`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"justifyContent-kjj79g":`xl56j7k`,"width-kzqmXN":`x17z2i9w`,"height-kZKoxP":`x17rw0jw`,"flexShrink-kmuXW":`x2lah0s`,"color-kMwMTN":`xzn0pkc`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:44`},methodChipLabel:{"CashAmountEntry__styles.methodChipLabel":`CashAmountEntry__styles.methodChipLabel`,"margin-kogj98":`x1ghz6dp`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:53`},methodChipChange:{"CashAmountEntry__styles.methodChipChange":`CashAmountEntry__styles.methodChipChange`,"appearance-kysU6D":`xjyslct`,"margin-kogj98":`x1ghz6dp`,"padding-kmVPX3":`x1717udv`,"font-kVVagm":`xln7xf2`,"color-kMwMTN":`xi96bwj`,"cursor-kkrTdU":`x1ypdohk`,":hover_color-kDPRdz":`xpscirx`,":focus-visible_outline-k3Woio":`x67ar3w`,":focus-visible_outlineOffset-kiEn40":`x7s97pk`,":focus-visible_borderRadius-k7aC84":`x63abuj`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:56`},receiveLine:{"CashAmountEntry__styles.receiveLine":`CashAmountEntry__styles.receiveLine`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"gap-kOIVth":`x167g77z`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:76`},receiveLabel:{"CashAmountEntry__styles.receiveLabel":`CashAmountEntry__styles.receiveLabel`,"margin-kogj98":`x1ghz6dp`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:81`},receiveChip:{"CashAmountEntry__styles.receiveChip":`CashAmountEntry__styles.receiveChip`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"gap-kOIVth":`x17d4w8g`,"paddingBlock-k8WAf4":`x12ulsxz`,"paddingInlineStart-kZCmMZ":`x25sj25`,"paddingInlineEnd-kwRFfy":`x2vl965`,"borderRadius-kaIpWk":`x1npxkrn`,"backgroundColor-kWkggS":`xvaq5cg`,"borderColor-kVAM5u":`x12c9lpl`,"borderStyle-ksu8eU":`x1y0btm7`,"borderWidth-kMzoRj":`xmkeg23`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:84`},receiveChipAmount:{"CashAmountEntry__styles.receiveChipAmount":`CashAmountEntry__styles.receiveChipAmount`,"margin-kogj98":`x1ghz6dp`,$$css:`@stridge/kit:src/flows/deposit/widgets/cash-amount-entry/compound/CashAmountEntry.styles.ts:97`}};export{e as styles};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/components/HeroLabel.d.ts

@@ -0,0 +1,13 @@
+import { CashAmountEntryHeroLabelProps } from "../types.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/cash-amount-entry/compound/components/HeroLabel.d.ts
+/**
+ * Small uppercase label rendered above the hero band on cash amount-entry. Mirrors the Paper
+ * design's "YOU PAY" reading. Cash-flow-internal — the wallet path doesn't use a hero label.
+ */
+declare function CashAmountEntryHeroLabel({
+  children
+}: CashAmountEntryHeroLabelProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { CashAmountEntryHeroLabel };

package/dist/flows/deposit/widgets/cash-amount-entry/compound/components/HeroLabel.js

@@ -0,0 +1 @@
+"use client";import{text as e}from"../../../../../../shared/ui/Text/Text.js";import"../../../../../../ui/index.js";import{CASH_AMOUNT_ENTRY_SLOTS as t}from"../CashAmountEntry.slots.js";import{styles as n}from"../CashAmountEntry.styles.js";import{jsx as r}from"react/jsx-runtime";import*as i from"@stylexjs/stylex";function a({children:a}){return r(`div`,{...i.props(n.heroLabelWrap),children:r(e.span,{size:`meta`,fontWeight:`medium`,leading:`tight`,color:`subdued`,transform:`uppercase`,"data-stridge-slot":t.heroLabel,...i.props(n.heroLabel),children:a})})}export{a as CashAmountEntryHeroLabel};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/components/MethodChip.d.ts

@@ -0,0 +1,18 @@
+import { CashAmountEntryMethodChipProps } from "../types.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/cash-amount-entry/compound/components/MethodChip.d.ts
+/**
+ * Compact chip above the hero showing which cash method the user picked, with a `Change` link
+ * that takes them back to the method picker. Cash-flow-internal — the crypto path has no equivalent
+ * (the asset picker fills the same "what's selected, change it" role inline on the deposit method
+ * tile).
+ *
+ * Reads `cashMethod` and `onChangeMethod` from context. Pass `onChange={null}` to suppress the
+ * `Change` link even when context supplies a callback; pass an explicit function to override.
+ */
+declare function CashAmountEntryMethodChip({
+  onChange
+}?: CashAmountEntryMethodChipProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { CashAmountEntryMethodChip };

package/dist/flows/deposit/widgets/cash-amount-entry/compound/components/MethodChip.js

@@ -0,0 +1 @@
+"use client";import{Trans as e}from"../../../../../../shared/i18n/Trans.js";import"../../../../../../i18n/index.js";import{ApplePayIcon as t}from"../../../../../../shared/icons/ApplePayIcon.js";import{CardIcon as n}from"../../../../../../shared/icons/CardIcon.js";import{GooglePayIcon as r}from"../../../../../../shared/icons/GooglePayIcon.js";import"../../../../../../icons/index.js";import{text as i}from"../../../../../../shared/ui/Text/Text.js";import"../../../../../../ui/index.js";import{CASH_AMOUNT_ENTRY_SLOTS as a}from"../CashAmountEntry.slots.js";import{styles as o}from"../CashAmountEntry.styles.js";import{useCashAmountEntryContext as s}from"../context.js";import{jsx as c,jsxs as l}from"react/jsx-runtime";import*as u from"@stylexjs/stylex";const d={width:13,height:13,"aria-hidden":!0};function f({onChange:t}={}){let n=s(`CashAmountEntry.MethodChip`),r=t===null?void 0:t??n.onChangeMethod;return c(`div`,{...u.props(o.methodChipWrap),children:l(`div`,{"data-stridge-slot":a.methodChip,...u.props(o.methodChip),children:[c(`span`,{...u.props(o.methodChipIcon),children:p(n.cashMethod)}),c(i.span,{size:`sm`,fontWeight:`medium`,leading:`tight`,...u.props(o.methodChipLabel),children:m(n.cashMethod)}),r?c(`button`,{type:`button`,onClick:r,"data-stridge-slot":a.methodChipChange,...u.props(o.methodChipChange),children:c(i.span,{size:`sm`,fontWeight:`medium`,leading:`tight`,color:`inherit`,children:c(e,{id:`o-XJ9D`,message:`Change`})})}):null]})})}function p(e){return c(e===`applePay`?t:e===`googlePay`?r:n,{...d})}function m(t){return t===`applePay`?c(e,{id:`TMA5Ot`,message:`Paying with Apple Pay`}):t===`googlePay`?c(e,{id:`FkAVbF`,message:`Paying with Google Pay`}):c(e,{id:`tInLgk`,message:`Paying with Card`})}export{f as CashAmountEntryMethodChip};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/components/ReceiveChip.d.ts

@@ -0,0 +1,14 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/cash-amount-entry/compound/components/ReceiveChip.d.ts
+/**
+ * Read-only receive chip slotted into the hero's `subLine` for cash amount-entry. Mirrors the
+ * Paper design's "Receive [USDC logo] 24.21 USDC" reading. Cash-flow-internal — the wallet path's
+ * Hero uses the swap toggle in this slot, not a static chip.
+ *
+ * Reads `formattedReceive` from context. The token is sourced from
+ * {@link MOCK_RECEIVE_TOKEN} while the cash backend is mocked.
+ */
+declare function CashAmountEntryReceiveChip(): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { CashAmountEntryReceiveChip };

package/dist/flows/deposit/widgets/cash-amount-entry/compound/components/ReceiveChip.js

@@ -0,0 +1 @@
+"use client";import{Trans as e}from"../../../../../../shared/i18n/Trans.js";import"../../../../../../i18n/index.js";import{text as t}from"../../../../../../shared/ui/Text/Text.js";import{TokenLogo as n}from"../../../../../../shared/ui/TokenLogo/TokenLogo.js";import"../../../../../../shared/ui/TokenLogo/index.js";import"../../../../../../ui/index.js";import{CASH_AMOUNT_ENTRY_SLOTS as r}from"../CashAmountEntry.slots.js";import{styles as i}from"../CashAmountEntry.styles.js";import{useCashAmountEntryContext as a}from"../context.js";import{MOCK_RECEIVE_TOKEN as o}from"../../../../shared/cash.js";import{jsx as s,jsxs as c}from"react/jsx-runtime";import*as l from"@stylexjs/stylex";function u(){let{formattedReceive:u}=a(`CashAmountEntry.ReceiveChip`),d=o;return c(`span`,{...l.props(i.receiveLine),children:[s(t.span,{size:`sm`,leading:`tight`,color:`subdued`,...l.props(i.receiveLabel),children:s(e,{id:`lDgVWA`,message:`Receive`})}),c(`span`,{"data-stridge-slot":r.receiveChip,...l.props(i.receiveChip),children:[s(n,{size:18,symbol:d.symbol,...d.chainId===void 0?{}:{chainId:d.chainId},...d.address===void 0?{}:{address:d.address},...d.isNative===void 0?{}:{isNative:d.isNative},...d.logoUrl===void 0?{}:{logoUrl:d.logoUrl},hideChainBadge:!0}),c(t.span,{size:`sm`,fontWeight:`medium`,leading:`tight`,...l.props(i.receiveChipAmount),children:[u,` `,d.symbol]})]})]})}export{u as CashAmountEntryReceiveChip};

package/dist/flows/deposit/widgets/cash-amount-entry/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 <CashAmountEntry>.`);return r}export{n as CashAmountEntryContext,r as useCashAmountEntryContext};

package/dist/flows/deposit/widgets/cash-amount-entry/compound/index.d.ts

@@ -0,0 +1,3 @@
+import { CashAmountEntryDialogProps, CashAmountEntryHeroLabelProps, CashAmountEntryMethodChipProps, CashAmountEntryProps } from "./types.js";
+import { CashAmountEntry } from "./CashAmountEntry.js";
+import { CASH_AMOUNT_ENTRY_SLOTS, CashAmountEntrySlot } from "./CashAmountEntry.slots.js";

package/dist/flows/deposit/widgets/cash-amount-entry/compound/index.js

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