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

package/dist/scope/context.d.ts

@@ -1,7 +1,9 @@
+import { Presentation } from "../shared/presentation/types.js";
 //#region src/scope/context.d.ts
 type KitRadius = "sharp" | "subtle" | "rounded" | "pill";
 type KitTheme = "dark" | "light";
 type KitDirection = "ltr" | "rtl";
+type KitAttribution = "visible" | "hidden";
 /**
  * Destination token credited by the gateway flow.
  */
@@ -53,10 +55,31 @@ interface KitConfig {
    * behavior when they render outside the provider's DOM subtree.
    */
   direction?: KitDirection;
+  /**
+   * Active BCP-47 locale tag (e.g. `"en"`, `"ar"`, `"fa"`, `"ar-EG"`). Forwarded by `KitProvider`
+   * from `i18n.locale` and stamped onto every kit scope as `data-stridge-locale="…"` so the host
+   * can target script-specific styling (typically the font stack) per locale — RTL alone isn't
+   * fine-grained enough (Arabic and Persian are both RTL but commonly want different faces).
+   */
+  locale?: string;
   /**
    * Destination token configuration.
    */
   target?: KitTarget;
+  /**
+   * Resolved state of the "Powered by Stridge" attribution row. `"visible"` (default) lets the
+   * gateway frame auto-mount the brand row at the bottom of every step; `"hidden"` suppresses
+   * the auto-mount for white-label installs. Explicit `<Stridge.PoweredBy />` compositions
+   * ignore this value and always render — the contract is "set `attribution=\"hidden\"` when
+   * composing the brand row manually".
+   */
+  attribution?: KitAttribution;
+  /**
+   * How gateway surfaces present themselves — `"auto"` (default) renders a centred dialog on wide
+   * containers and a bottom-sheet drawer below the breakpoint, `"dialog"` / `"drawer"` force one.
+   * Read by {@link AdaptiveSurface} as the global default; a per-surface `presentation` prop wins.
+   */
+  presentation?: Presentation;
 }
 /**
  * Reads the active {@link KitConfig} from the nearest provider. Returns `{}` when no provider is
@@ -64,4 +87,4 @@ interface KitConfig {
  */
 declare function useKitConfig(): KitConfig;
 //#endregion
-export { KitConfig, KitDirection, KitRadius, KitTarget, KitTheme, useKitConfig };
+export { KitAttribution, KitConfig, KitDirection, KitRadius, KitTarget, KitTheme, useKitConfig };

package/dist/scope/index.d.ts

@@ -1,3 +1,3 @@
-import { KitConfig, KitDirection, KitRadius, KitTarget, KitTheme, useKitConfig } from "./context.js";
+import { KitAttribution, KitConfig, KitDirection, KitRadius, KitTarget, KitTheme, useKitConfig } from "./context.js";
 import { KitPortalScope } from "./KitPortalScope.js";
 import { KitScope } from "./KitScope.js";

package/dist/shared/attribution/Attribution.js

@@ -0,0 +1 @@
+"use client";import{useLingui as e}from"../i18n/useLingui.js";import"../../i18n/index.js";import{joinClassNames as t}from"../utils/joinClassNames.js";import{LogoIcon as n}from"../icons/LogoIcon.js";import"../../icons/index.js";import{ATTRIBUTION_SLOTS as r}from"./Attribution.slots.js";import{elementStyles as i,styles as a}from"./Attribution.styles.js";import{Fragment as o,jsx as s,jsxs as c}from"react/jsx-runtime";import*as l from"@stylexjs/stylex";function u({href:u=`https://stridge.com`,target:d=`_blank`,rel:f=`noopener noreferrer`,asStatic:p,className:m,style:h}){let{_:g}=e(),_=l.props(a.root),v=l.props(a.link,!p&&a.anchor),y=l.props(i.prefix),b=l.props(i.mark),x=l.props(i.wordmark),S=t(_.className,m),C=_.style||h?{..._.style,...h}:void 0,w=c(o,{children:[s(`span`,{"data-stridge-slot":r.prefix,className:y.className,style:y.style,children:g({id:`g2UNkE`,message:`Powered by`})}),s(`span`,{"data-stridge-slot":r.mark,className:b.className,style:b.style,children:s(n,{"aria-hidden":!0,focusable:!1})}),s(`span`,{"data-stridge-slot":r.wordmark,className:x.className,style:x.style,children:`Stridge`})]});return s(`div`,{"data-stridge-slot":r.root,className:S,style:C,children:p?s(`span`,{className:v.className,style:v.style,children:w}):s(`a`,{href:u,target:d,rel:f,className:v.className,style:v.style,children:w})})}export{u as Attribution};

package/dist/shared/attribution/Attribution.slots.js

@@ -0,0 +1 @@
+const e={root:`attribution`,prefix:`attribution-prefix`,mark:`attribution-mark`,wordmark:`attribution-wordmark`};export{e as ATTRIBUTION_SLOTS};

package/dist/shared/attribution/Attribution.styles.js

@@ -0,0 +1 @@
+const e={root:{"Attribution__styles.root":`Attribution__styles.root`,"display-k1xSpc":`x78zum5`,"flexDirection-kXwgrk":`x1q0g3np`,"alignItems-kGNEyG":`x6s0dn4`,"justifyContent-kjj79g":`xl56j7k`,"paddingTop-kLKAdn":`x19ment4`,"paddingBottom-kGO01o":`xfvigk`,"paddingInline-kg3NbH":`x1ujb8i1`,$$css:`@stridge/kit:src/shared/attribution/Attribution.styles.ts:11`},link:{"Attribution__styles.link":`Attribution__styles.link`,"display-k1xSpc":`x3nfvp2`,"flexDirection-kXwgrk":`x1q0g3np`,"alignItems-kGNEyG":`x6s0dn4`,"gap-kOIVth":`x1a6yh9e`,"textDecoration-kybGjl":`x1hl2dhg`,"outline-kI3sdo":`x1a2a7pz`,"transitionProperty-k1ekBW":`xt3l3uh`,"transitionDuration-kIyJzY":`x1vhb3u9`,"transitionTimingFunction-kAMwcw":`x1xv5090`,$$css:`@stridge/kit:src/shared/attribution/Attribution.styles.ts:20`},anchor:{"Attribution__styles.anchor":`Attribution__styles.anchor`,":focus-visible_outline-k3Woio":`x1gvykhg`,":focus-visible_outlineOffset-kiEn40":`x7s97pk`,$$css:`@stridge/kit:src/shared/attribution/Attribution.styles.ts:35`}},t={prefix:{"Attribution__elementStyles.prefix":`Attribution__elementStyles.prefix`,"fontSize-kGuDYH":`x1oae1zf`,"fontWeight-k63SB2":`xxjjie5`,"lineHeight-kLWn49":`x1d3mw78`,"color-kMwMTN":`xd2gg92`,":is(a:hover, a:focus-visible) [data-stridge-slot~='attribution-prefix']_color-kKNNVu":`x1wa2jhk`,$$css:`@stridge/kit:src/shared/attribution/Attribution.styles.ts:51`},mark:{"Attribution__elementStyles.mark":`Attribution__elementStyles.mark`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"color-kMwMTN":`x9irweu`,":is(a:hover, a:focus-visible) [data-stridge-slot~='attribution-mark']_color-kEC4n1":`x1perupi`,$$css:`@stridge/kit:src/shared/attribution/Attribution.styles.ts:60`},wordmark:{"Attribution__elementStyles.wordmark":`Attribution__elementStyles.wordmark`,"fontSize-kGuDYH":`x1oae1zf`,"fontWeight-k63SB2":`x1qvi77d`,"letterSpacing-kb6lSQ":`x1ixy4ik`,"lineHeight-kLWn49":`x1d3mw78`,"color-kMwMTN":`x1nxg1fm`,":is(a:hover, a:focus-visible) [data-stridge-slot~='attribution-wordmark']_color-kKiZkk":`x19k0ldo`,":is(a:hover, a:focus-visible) [data-stridge-slot~='attribution-wordmark']_textDecoration-k7BEHM":`x1l0eogd`,":is(a:hover, a:focus-visible) [data-stridge-slot~='attribution-wordmark']_textUnderlineOffset-kHPfEo":`x1diuls0`,$$css:`@stridge/kit:src/shared/attribution/Attribution.styles.ts:68`}};export{t as elementStyles,e as styles};

package/dist/shared/attribution/index.js

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

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

@@ -1,40 +1,59 @@
 //#region src/shared/chains/index.d.ts
 /**
- * Chain catalog for `@stridge/kit`. Exports the `chains` namespace (EIP-155 chain ids keyed by
- * slug, suitable for IDE autocomplete) and a normalizer that converts any accepted form
- * (slug, EIP-155 number, Stridge networkId) into the wire-shape `network_id` string the gateway
- * expects.
+ * Chain-family types and recipient-address validators for `@stridge/kit`.
  *
- * @example
- * ```ts
- * import { chains } from "@stridge/kit";
+ * The kit does not ship a static chain catalog — the gateway is the single source of truth for
+ * which networks exist. Consumers pass the Stridge network id (read straight off
+ * `Gateway.assets()`) as `StridgeAsset.networkId`, and the kit forwards it to
+ * `gateway/start` verbatim. This module only carries the chain-*family* tag (`ChainType`) and
+ * the address-shape validators that depend on it.
+ */
+/**
+ * Chain family a network belongs to. The kit-internal, case-stable mirror of the gateway's
+ * `chain_type` wire tag (`SupportedAssetDto.chain_type`):
  *
- * <StridgeProvider asset={{ chain: chains.bsc, symbol: "USDC" }} ... />;
- * <StridgeProvider asset={{ chain: 56, symbol: "USDC" }} ... />;             // also valid
- * <StridgeProvider asset={{ chain: "bsc", symbol: "USDC" }} ... />;          // also valid
- * <StridgeProvider asset={{ chain: "9006", symbol: "USDC" }} ... />;         // also valid
- * ```
+ * - `"evm"` — every EIP-155 chain (Ethereum, BSC, Polygon, …); addresses are `0x` + 40 hex.
+ * - `"tron"` — Tron mainnet; addresses are base58check, 34 chars, leading `T`.
+ * - `"unknown"` — a family the kit predates. Address validation falls back to a permissive
+ *   shape check (see {@link isValidAddressForChainType}) so a chain the backend lists before
+ *   the kit ships explicit support is still usable rather than hard-blocked.
+ *
+ * Drivers are the source of truth: each one tags its payloads (`ReceiveChainPayload.chainType`,
+ * …) so widgets and headless consumers never re-derive the family from chain-id heuristics.
+ */
+type ChainType = "evm" | "tron" | "unknown";
+/**
+ * Normalize a raw gateway `chain_type` value (or a missing one) into a {@link ChainType}.
+ * Surrounding whitespace is trimmed and matching is case-insensitive; the gateway tags Tron as
+ * `"TVM"` (Tron Virtual Machine). Any value the kit doesn't recognize — including `undefined` —
+ * collapses to `"unknown"`, which keeps the address gate permissive instead of blocking the flow.
+ */
+declare function toChainType(raw: string | null | undefined): ChainType;
+/**
+ * Lightweight EVM-address validator. Matches `0x` followed by exactly 40 hex characters.
+ * Does NOT enforce the EIP-55 mixed-case checksum — the gateway lowercases before routing, and
+ * checksum validation would reject the all-lowercase forms wallets and explorers commonly emit.
+ * Input is trimmed before matching.
  */
+declare function isValidEvmAddress(value: string): boolean;
 /**
- * EIP-155 chain ids for the chains Stridge's gateway routes to. Keyed by lowercase slug for
- * IDE autocomplete; the value is a plain number so consumers can pass `chains.bsc` directly to
- * any prop that accepts a chain id.
+ * Lightweight Tron-address validator. Matches the base58check mainnet shape: a leading `T`
+ * followed by 33 base58 characters (34 total). Does NOT verify the trailing checksum bytes —
+ * that needs a base58check decode the kit deliberately keeps out of the bundle; the gateway
+ * performs the authoritative check. Input is trimmed before matching.
  */
-declare const chains: {
-  readonly ethereum: 1;
-  readonly bsc: 56;
-  readonly polygon: 137;
-  readonly arbitrum: 42161;
-  readonly base: 8453;
-};
-type ChainSlug = keyof typeof chains;
+declare function isValidTronAddress(value: string): boolean;
 /**
- * The accepted shape of a `chain` field on kit configuration props. Any of:
+ * Validate a recipient address against the chain family it's being sent to — the chain-type-aware
+ * gate the withdraw form and headless integrators share. Pass the `chainType` the driver tagged
+ * onto the receive-chain payload.
+ *
+ * - `"evm"` / `"tron"` — checked against the family's real address shape.
+ * - `"unknown"` — a family the kit predates: accepts any whitespace-free token of at least 8
+ *   characters, so a backend-listed chain still works before the kit ships a dedicated matcher.
  *
- * - `number` — EIP-155 chain id (`56`, `137`).
- * - `string` — chain slug (`"bsc"`), the matching EIP-155 id as text (`"56"`), or a Stridge
- *   `network_id` (`"9006"`). The kit normalizes via {@link normalizeChainToNetworkId}.
+ * Empty / whitespace-only input is always rejected. Trim is handled internally.
  */
-type ChainInput = string | number;
+declare function isValidAddressForChainType(value: string, chainType: ChainType): boolean;
 //#endregion
-export { ChainInput, ChainSlug, chains };
+export { ChainType, isValidAddressForChainType, isValidEvmAddress, isValidTronAddress, toChainType };

package/dist/shared/chains/index.js

@@ -1 +1 @@
-const e={ethereum:1,bsc:56,polygon:137,arbitrum:42161,base:8453},t={ethereum:`60`,bsc:`9006`,polygon:`966`,arbitrum:`9001`,base:`8453`},n={1:`60`,56:`9006`,137:`966`,42161:`9001`,8453:`8453`};function r(e){if(typeof e==`number`)return n[e]??String(e);let r=e.toLowerCase();return r in t?t[r]:/^\d+$/.test(e)?n[Number(e)]??e:e}export{e as chains,r as normalizeChainToNetworkId};
+function e(e){switch(e?.trim().toUpperCase()){case`EVM`:return`evm`;case`TVM`:return`tron`;default:return`unknown`}}const t=/^0x[0-9a-fA-F]{40}$/,n=/^T[1-9A-HJ-NP-Za-km-z]{33}$/;function r(e){return t.test(e.trim())}function i(e){return n.test(e.trim())}function a(e,r){let i=e.trim();if(i.length===0)return!1;switch(r){case`evm`:return t.test(i);case`tron`:return n.test(i);default:return/^\S{8,}$/.test(i)}}export{a as isValidAddressForChainType,r as isValidEvmAddress,i as isValidTronAddress,e as toChainType};

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

@@ -0,0 +1 @@
+const e={appId:`ii7w0vsj`};export{e as BRAND_INTERCOM};

package/dist/shared/cuer/Cuer.js

@@ -1 +1 @@
-import{create as e}from"./QrCode.js";import*as t from"react";import{Fragment as n,jsx as r,jsxs as i}from"react/jsx-runtime";function a(e){let{arena:t,...n}=e;return i(a.Root,{...n,children:[r(a.Finder,{}),r(a.Cells,{}),t&&r(a.Arena,{children:typeof t==`string`?r(`img`,{alt:`Arena`,src:t,style:{borderRadius:1,height:`100%`,objectFit:`cover`,width:`100%`}}):t})]})}(function(a){let o=a.Context=t.createContext(null);function s(n){let{children:a,size:s=`100%`,value:c,version:l,errorCorrection:u,...d}=n,f=t.useMemo(()=>(t.Children.map(a,e=>!t.isValidElement(e)||typeof e.type==`string`?null:`displayName`in e.type&&e.type.displayName===`Arena`?!0:null)??[]).some(Boolean),[a]),p=t.useMemo(()=>{let t=u;return f&&u===`low`&&(t=`medium`),e(c,{errorCorrection:t,version:l})},[c,f,u,l]),m=p.edgeLength*1,h=p.finderLength*1/2,g=f?Math.floor(m/4):0,_=t.useMemo(()=>({arenaSize:g,cellSize:1,edgeSize:m,qrcode:p,finderSize:h}),[g,m,p,h]);return r(o.Provider,{value:_,children:i(`svg`,{...d,width:s,height:s,viewBox:`0 0 ${m} ${m}`,xmlns:`http://www.w3.org/2000/svg`,children:[r(`title`,{children:`QR Code`}),a]})})}a.Root=s,(function(e){e.displayName=`Root`})(s||=a.Root||={});function c(e){let{className:a,fill:s,innerClassName:c,radius:l=.25}=e,{cellSize:u,edgeSize:d,finderSize:f}=t.useContext(o);function p({position:e}){let t=f-(f-u)-u/2;e===`top-right`&&(t=d-f-(f-u)-u/2);let o=f-(f-u)-u/2;e===`bottom-left`&&(o=d-f-(f-u)-u/2);let p=f-u*1.5;e===`top-right`&&(p=d-f-u*1.5);let m=f-u*1.5;return e===`bottom-left`&&(m=d-f-u*1.5),i(n,{children:[r(`rect`,{className:a,stroke:s??`currentColor`,fill:`transparent`,x:t,y:o,width:u+(f-u)*2,height:u+(f-u)*2,rx:2*l*(f-u),ry:2*l*(f-u),strokeWidth:u}),r(`rect`,{className:c,fill:s??`currentColor`,x:p,y:m,width:u*3,height:u*3,rx:2*l*u,ry:2*l*u})]})}return i(n,{children:[r(p,{position:`top-left`}),r(p,{position:`top-right`}),r(p,{position:`bottom-left`})]})}a.Finder=c,(function(e){e.displayName=`Finder`})(c||=a.Finder||={});function l(e){let{className:n,fill:i=`currentColor`,inset:a=!0,radius:s=1}=e,{arenaSize:c,cellSize:l,qrcode:u}=t.useContext(o),{edgeLength:d,finderLength:f}=u;return r(`path`,{className:n,d:t.useMemo(()=>{let e=``;for(let t=0;t<u.grid.length;t++){let n=u.grid[t];if(n)for(let r=0;r<n.length;r++){if(!n[r])continue;let i=d/2-c/2,o=i+c;if(t>=i&&t<=o&&r>=i&&r<=o)continue;let u=t<f&&r<f,p=t<f&&r>=d-f,m=t>=d-f&&r<f;if(u||p||m)continue;let h=(l-(a?l*.1:0)*2)/2,g=r*l+l/2,_=t*l+l/2,v=g-h,y=g+h,b=_-h,x=_+h,S=s*h;e+=[`M ${v+S},${b}`,`L ${y-S},${b}`,`A ${S},${S} 0 0,1 ${y},${b+S}`,`L ${y},${x-S}`,`A ${S},${S} 0 0,1 ${y-S},${x}`,`L ${v+S},${x}`,`A ${S},${S} 0 0,1 ${v},${x-S}`,`L ${v},${b+S}`,`A ${S},${S} 0 0,1 ${v+S},${b}`,`z`].join(` `)}}return e},[c,l,d,f,u.grid,a,s]),fill:i})}a.Cells=l,(function(e){e.displayName=`Cells`})(l||=a.Cells||={});function u(e){let{children:n}=e,{arenaSize:i,cellSize:a,edgeSize:s}=t.useContext(o),c=Math.ceil(s/2-i/2),l=i+i%2;return r(`foreignObject`,{x:c,y:c,width:l,height:l,children:r(`div`,{style:{alignItems:`center`,display:`flex`,fontSize:1,justifyContent:`center`,height:`100%`,overflow:`hidden`,width:`100%`,padding:a/2,boxSizing:`border-box`},children:n})})}a.Arena=u,(function(e){e.displayName=`Arena`})(u||=a.Arena||={})})(a||={});export{a as Cuer};
+import{create as e}from"./QrCode.js";import*as t from"react";import{Fragment as n,jsx as r,jsxs as i}from"react/jsx-runtime";const a=e=>Math.max(0,Math.min(1,e));function o(e){let{arena:t,...n}=e;return i(o.Root,{...n,children:[r(o.Finder,{}),r(o.Cells,{}),t&&r(o.Arena,{href:t})]})}(function(o){let s=o.Context=t.createContext(null);function c(n){let{children:a,size:o=`100%`,value:c,version:l,errorCorrection:u,...d}=n,f=t.useMemo(()=>(t.Children.map(a,e=>!t.isValidElement(e)||typeof e.type==`string`?null:`displayName`in e.type&&e.type.displayName===`Arena`?!0:null)??[]).some(Boolean),[a]),p=t.useMemo(()=>{let t=u;return f&&u===`low`&&(t=`medium`),e(c,{errorCorrection:t,version:l})},[c,f,u,l]),m=p.edgeLength*1,h=p.finderLength*1/2,g=f?Math.floor(m/4):0,_=(m-g)/2,v=t.useMemo(()=>({arenaSize:g,arenaStart:_,cellSize:1,edgeSize:m,qrcode:p,finderSize:h}),[g,_,m,p,h]);return r(s.Provider,{value:v,children:i(`svg`,{...d,width:o,height:o,viewBox:`0 0 ${m} ${m}`,xmlns:`http://www.w3.org/2000/svg`,children:[r(`title`,{children:`QR Code`}),a]})})}o.Root=c,(function(e){e.displayName=`Root`})(c||=o.Root||={});function l(e){let{className:o,fill:c,innerClassName:l,radius:u=.25,stroke:d}=e,{cellSize:f,edgeSize:p,finderSize:m}=t.useContext(s),h=a(u);function g({position:e}){let t=m-(m-f)-f/2;e===`top-right`&&(t=p-m-(m-f)-f/2);let a=m-(m-f)-f/2;e===`bottom-left`&&(a=p-m-(m-f)-f/2);let s=m-f*1.5;e===`top-right`&&(s=p-m-f*1.5);let u=m-f*1.5;return e===`bottom-left`&&(u=p-m-f*1.5),i(n,{children:[r(`rect`,{className:o,stroke:d??c??`currentColor`,fill:`transparent`,x:t,y:a,width:f+(m-f)*2,height:f+(m-f)*2,rx:2*h*(m-f),ry:2*h*(m-f),strokeWidth:f}),r(`rect`,{className:l,fill:c??`currentColor`,x:s,y:u,width:f*3,height:f*3,rx:2*h*f,ry:2*h*f})]})}return i(n,{children:[r(g,{position:`top-left`}),r(g,{position:`top-right`}),r(g,{position:`bottom-left`})]})}o.Finder=l,(function(e){e.displayName=`Finder`})(l||=o.Finder||={});function u(e){let{className:n,fill:i=`currentColor`,inset:o=!0,radius:c=1}=e,{arenaSize:l,arenaStart:u,cellSize:d,qrcode:f}=t.useContext(s),{edgeLength:p,finderLength:m}=f,h=a(c);return r(`path`,{className:n,d:t.useMemo(()=>{let e=``,t=u+l;for(let n=0;n<f.grid.length;n++){let r=f.grid[n];if(r)for(let i=0;i<r.length;i++){if(!r[i])continue;if(l>0){let e=(i+.5)*d,r=(n+.5)*d;if(e>=u&&e<=t&&r>=u&&r<=t)continue}let a=n<m&&i<m,s=n<m&&i>=p-m,c=n>=p-m&&i<m;if(a||s||c)continue;let f=(d-(o?d*.1:0)*2)/2,g=i*d+d/2,_=n*d+d/2,v=g-f,y=g+f,b=_-f,x=_+f,S=h*f;e+=[`M ${v+S},${b}`,`L ${y-S},${b}`,`A ${S},${S} 0 0,1 ${y},${b+S}`,`L ${y},${x-S}`,`A ${S},${S} 0 0,1 ${y-S},${x}`,`L ${v+S},${x}`,`A ${S},${S} 0 0,1 ${v},${x-S}`,`L ${v},${b+S}`,`A ${S},${S} 0 0,1 ${v+S},${b}`,`z`].join(` `)}}return e},[l,u,d,p,m,f.grid,o,h]),fill:i})}o.Cells=u,(function(e){e.displayName=`Cells`})(u||=o.Cells||={});function d(e){let{href:n,preserveAspectRatio:i=`xMidYMid meet`,...a}=e,{arenaSize:o,arenaStart:c,cellSize:l}=t.useContext(s),u=l/2,d=c+u,f=o-u*2;return r(`image`,{href:n,...a,x:d,y:d,width:f,height:f,preserveAspectRatio:i})}o.Arena=d,(function(e){e.displayName=`Arena`})(d||=o.Arena||={})})(o||={});export{o as Cuer};

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

@@ -1,3 +1,4 @@
+import { Presentation } from "../presentation/types.js";
 import { ReactElement, ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
@@ -22,18 +23,30 @@ interface DialogShellControls {
 }
 interface DialogShellProps extends DialogShellControls {
   /**
-   * Widget JSX rendered inside `Dialog.Content`. Each widget detects
-   * the dialog context and swaps to its bare frame, so the same
+   * Element the surface portals into. Defaults to `document.body`. Doubles as the measured
+   * containing block for `"auto"` presentation — the dialog-vs-drawer breakpoint is measured
+   * against this element's width when supplied, else the viewport.
+   */
+  container?: HTMLElement | null;
+  /**
+   * Surface override forwarded to {@link AdaptiveSurface}. Falls back to the provider's
+   * `appearance.presentation`, then `"auto"`. Omit to inherit the provider default.
+   */
+  presentation?: Presentation;
+  /**
+   * Widget JSX rendered inside the surface. Each widget detects the
+   * surface context and swaps to its bare frame, so the same
    * composition that works inline as `Card variant="frame"` paints
    * the same surface chrome here.
    */
   children?: ReactNode;
 }
 /**
- * Pre-composed dialog shell for a kit widget. Wraps `Dialog.Root` +
- * (optional) `Dialog.Trigger` + `Dialog.Content` so consumers don't
- * re-stitch those three primitives every time they want to open a
- * widget in a modal.
+ * Pre-composed dialog shell for a kit widget. Wraps {@link AdaptiveSurface}
+ * so consumers don't re-stitch the surface primitives every time they want
+ * to open a widget in a modal. The surface is responsive — a centred dialog
+ * on wide containers, a bottom-sheet drawer below the breakpoint — and the
+ * widget renders its bare frame inside either via the shared surface context.
  *
  * Each widget also exposes a typed `.Dialog` form (`Deposit.Dialog`,
  * `AssetPicker.Dialog`, …) that wraps this shell and forwards the
@@ -57,6 +70,8 @@ declare function DialogShell({
   defaultOpen,
   onOpenChange,
   trigger,
+  container,
+  presentation,
   children
 }: DialogShellProps): _$react_jsx_runtime0.JSX.Element;
 //#endregion

package/dist/shared/dialog/DialogShell.js

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

package/dist/shared/dialog/Frame.js

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

package/dist/shared/dialog/LoadingState.js

@@ -0,0 +1 @@
+"use client";import{useLingui as e}from"../i18n/useLingui.js";import"../../i18n/index.js";import{styles as t}from"./LoadingState.styles.js";import{jsx as n,jsxs as r}from"react/jsx-runtime";import*as i from"@stylexjs/stylex";function a({slot:a}){let{_:o}=e();return n(`div`,{role:`status`,"aria-label":o({id:`yQE2r9`,message:`Loading`}),"data-stridge-slot":`${a}-loading`,"data-testid":`${a}-loading`,...i.props(t.root),children:r(`span`,{"aria-hidden":!0,...i.props(t.dots),children:[n(`span`,{...i.props(t.dot,t.dotDelay1)}),n(`span`,{...i.props(t.dot,t.dotDelay2)}),n(`span`,{...i.props(t.dot,t.dotDelay3)})]})})}export{a as LoadingState};

package/dist/shared/dialog/LoadingState.styles.js

@@ -0,0 +1 @@
+const e={root:{"LoadingState__styles.root":`LoadingState__styles.root`,"display-k1xSpc":`x78zum5`,"flex-kUk6DE":`x12lumcd`,"flexDirection-kXwgrk":`xdt5ytf`,"alignItems-kGNEyG":`x6s0dn4`,"justifyContent-kjj79g":`xl56j7k`,"width-kzqmXN":`xh8yej3`,"minHeight-kAzted":`x1dby22o`,"animationName-kKVMdj":`x1tj11xs`,"animationDuration-k44tkh":`x1a78uxe x1s1fvk8`,"animationTimingFunction-kyAemX":`xrkt6z0`,"animationFillMode-kWV6AL":`x1u6ievf`,$$css:`@stridge/kit:src/shared/dialog/LoadingState.styles.ts:44`},dots:{"LoadingState__styles.dots":`LoadingState__styles.dots`,"display-k1xSpc":`x3nfvp2`,"alignItems-kGNEyG":`x6s0dn4`,"gap-kOIVth":`x1jnr06f`,"lineHeight-kLWn49":`x14ju556`,$$css:`@stridge/kit:src/shared/dialog/LoadingState.styles.ts:65`},dot:{"LoadingState__styles.dot":`LoadingState__styles.dot`,"display-k1xSpc":`x1rg5ohu`,"width-kzqmXN":`x1xc55vz`,"height-kZKoxP":`xdk7pt`,"borderRadius-kaIpWk":`x16rqkct`,"backgroundColor-kWkggS":`x1lbpfnh`,"animationName-kKVMdj":`x11qdjwd`,"animationDuration-k44tkh":`x1sbju2s x80wavc`,"animationIterationCount-ko0y90":`xa4qsjk`,"animationFillMode-kWV6AL":`x1u6ievf`,$$css:`@stridge/kit:src/shared/dialog/LoadingState.styles.ts:77`},dotDelay1:{"LoadingState__styles.dotDelay1":`LoadingState__styles.dotDelay1`,"animationDelay-kKxzle":`x1uzojwf`,$$css:`@stridge/kit:src/shared/dialog/LoadingState.styles.ts:96`},dotDelay2:{"LoadingState__styles.dotDelay2":`LoadingState__styles.dotDelay2`,"animationDelay-kKxzle":`x1t83zlg`,$$css:`@stridge/kit:src/shared/dialog/LoadingState.styles.ts:99`},dotDelay3:{"LoadingState__styles.dotDelay3":`LoadingState__styles.dotDelay3`,"animationDelay-kKxzle":`x1xwhvez`,$$css:`@stridge/kit:src/shared/dialog/LoadingState.styles.ts:102`}};export{e as styles};

package/dist/shared/dialog/StepTransition.js

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

package/dist/shared/dialog/useDirectionalChevronTransform.js

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

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

@@ -6,9 +6,10 @@
  * public `@stridge/kit/<flow>/driver` surface.
  */
 /**
- * On-chain transaction reference. Drivers return one of these from any imperative wallet action
- * (`submitDeposit`, `submitWithdrawal`); the orchestrator stamps it on the FSM's `tx` slot until
- * the matching settlement entity catches up and exposes a richer `txHash` / `txExplorerUrl` pair.
+ * On-chain transaction reference. The deposit driver returns one from `submitDeposit`; the
+ * withdraw flow's host-supplied `onSubmit` surfaces one via `actions.beginProcessing({ hash })`
+ * or `actions.setTxHash`. The orchestrator stamps it on the FSM's `tx` slot until the matching
+ * settlement entity catches up and exposes a richer `txHash` / `txExplorerUrl` pair.
  */
 interface TxRef {
   hash: string;

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

@@ -0,0 +1,25 @@
+import { I18n } from "@lingui/core";
+
+//#region src/shared/format/formatSmartRelative.d.ts
+/**
+ * Smart-relative date formatter. Renders a unix-millisecond timestamp as a locale-aware string,
+ * cascading through five buckets:
+ *
+ * - `< 1 min`: `"Just now"` — avoids a noisy `"0 minutes ago"` reading on
+ *   stale-while-revalidate refreshes that land microseconds after the wire stamp.
+ * - `< 1 hr`: `"5 minutes ago"` via `Intl.RelativeTimeFormat`.
+ * - `< 1 day`: `"3 hours ago"` via `Intl.RelativeTimeFormat`.
+ * - 1 day exact: `"Yesterday"`.
+ * - 2–6 days: `"3 days ago"` via `Intl.RelativeTimeFormat`.
+ * - `>= 7 days`: absolute date via {@link formatTimestamp}.
+ *
+ * `Intl.RelativeTimeFormat` produces locale-aware strings (e.g. `"hace 5 minutos"`,
+ * `"il y a 5 minutes"`, `"منذ ٥ دقائق"`) so plural-aware copy and RTL come for free.
+ *
+ * @param epochMs - The timestamp to render.
+ * @param now - The wall-clock anchor; pass `Date.now()` in components or a pinned value in tests.
+ * @param i18n - The active Lingui {@link I18n} instance — `i18n.locale` drives every formatter.
+ */
+declare function formatSmartRelative(epochMs: number, now: number, i18n: I18n): string;
+//#endregion
+export { formatSmartRelative };

package/dist/shared/format/formatSmartRelative.js

@@ -0,0 +1 @@
+import{formatTimestamp as e}from"./formatTimestamp.js";const t=6e4,n=36e5,r=864e5,i={id:`OSBXx5`,message:`Just now`},a={id:`y_0uwd`,message:`Yesterday`};function o(o,s,c){let l=s-o;if(l<t)return c._(i);let u=new Intl.RelativeTimeFormat(c.locale,{numeric:`auto`});if(l<n){let e=Math.floor(l/t);return u.format(-e,`minute`)}if(l<r){let e=Math.floor(l/n);return u.format(-e,`hour`)}let d=Math.floor(l/r);return d===1?c._(a):d<7?u.format(-d,`day`):e(o,c)}export{o as formatSmartRelative};

package/dist/shared/format/formatUsd.js

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

package/dist/shared/i18n/KitI18nProvider.d.ts

@@ -3,21 +3,24 @@ import { ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/shared/i18n/KitI18nProvider.d.ts
-interface Props extends KitI18nConfig {
-  children: ReactNode;
-}
 /**
  * Mounts a per-request Lingui `I18n` instance into React context. Re-creates the instance only
- * when `locale` or the identity of `catalogs` changes — same render-stable pattern as the kit's
- * other context providers, and the SSR-safe alternative to mutating a module-level singleton.
+ * when `locale` or the identity of `messages` changes — same render-stable pattern as the
+ * kit's other context providers, and the SSR-safe alternative to mutating a module-level
+ * singleton.
  *
  * Used internally by `KitProvider`. Hosts don't mount this directly; they pass a single
- * `i18n={{ locale, catalogs }}` prop on `<KitProvider>` and the kit handles the wiring.
+ * `i18n={{ locale, messages }}` prop on `<KitProvider>` and the kit handles the wiring.
  */
 declare function KitI18nProvider({
   locale,
-  catalogs,
+  messages,
   children
-}: Props): _$react_jsx_runtime0.JSX.Element;
+}: KitI18nProvider.Props): _$react_jsx_runtime0.JSX.Element;
+declare namespace KitI18nProvider {
+  interface Props extends KitI18nConfig {
+    children: ReactNode;
+  }
+}
 //#endregion
 export { KitI18nProvider };

package/dist/shared/i18n/KitI18nProvider.js

@@ -1 +1 @@
-"use client";import{createKitI18n as e}from"./createKitI18n.js";import{useMemo as t}from"react";import{jsx as n}from"react/jsx-runtime";import{I18nProvider as r}from"@lingui/react";function i({locale:i=`en`,catalogs:a,children:o}){return n(r,{i18n:t(()=>e({locale:i,catalogs:a}),[i,a]),children:o})}export{i as KitI18nProvider};
+"use client";import{createKitI18n as e}from"./createKitI18n.js";import{useMemo as t}from"react";import{jsx as n}from"react/jsx-runtime";import{I18nProvider as r}from"@lingui/react";function i({locale:i=`en`,messages:a,children:o}){return n(r,{i18n:t(()=>e({locale:i,messages:a}),[i,a]),children:o})}export{i as KitI18nProvider};

package/dist/shared/i18n/createKitI18n.d.ts

@@ -1,33 +1,96 @@
+import { SupportedLocale } from "./locales.js";
+import { KitTranslatableKey } from "../../i18n/locales/source-keys.js";
 import { I18n, Messages } from "@lingui/core";
 
 //#region src/shared/i18n/createKitI18n.d.ts
 /**
- * Map of locale codes to message catalogs. Keyed by the locale string the host activates
- * (`"en"`, `"es"`, etc.). Values are plain `{ [id]: translation }` maps; ICU placeholders and
- * plurals are compiled at runtime by {@link compileMessage}.
+ * Locale codes the kit's i18n surface accepts. Autocompletes on the locales the kit ships
+ * catalogs for ({@link SupportedLocale} — `"en"`, `"es"`, `"ar"`) while still accepting any
+ * other BCP-47 tag, so hosts who add their own catalogs via `defineMessages` aren't fenced
+ * out of the type.
+ *
+ * The `(string & {})` intersection is the standard escape hatch for "literal union + open
+ * string with autocomplete": without it, TypeScript collapses `Supported | string` to plain
+ * `string` and the editor loses the autocomplete suggestions for the named literals.
+ */
+type KitLocale = SupportedLocale | (string & {});
+/**
+ * Map of locale codes to compiled message catalogs. Values are lingui `Messages` —
+ * content-hash-keyed `{ [id]: translation }` maps where ICU placeholders and plurals are
+ * compiled at runtime by {@link compileMessage}.
+ *
+ * Shipped locales (`@stridge/kit/i18n/locales/<code>`) export `Messages` directly. For hosts
+ * authoring their own translations, the recommended path is {@link defineMessages}, which
+ * takes a plain English-keyed map and emits the same hash-keyed shape — so shipped and
+ * host-authored translations slot into the same prop without different shapes.
  */
-type KitCatalogs = Partial<Record<string, Messages>>;
+type KitMessages = Partial<Record<KitLocale, Messages>>;
+/**
+ * Hash a plain English-keyed translation map into the lingui `Messages` shape, ready to drop
+ * into `<KitProvider i18n={{ messages: { … } }}>`. Use this whenever you want to author
+ * translations by hand — adding a locale the kit doesn't ship, overriding a single key on a
+ * shipped locale, or tweaking the source English copy.
+ *
+ * Keys are constrained to {@link KitTranslatableKey} — the literal union of every English
+ * source the kit actually translates. Editors autocomplete on every valid key, and typos /
+ * stale keys fail at compile time via excess-property checks on the object literal. The union
+ * is codegened from `en.po` at `pnpm i18n:compile` time.
+ *
+ * Hashing runs once per call (typically at module load), not on every render. ICU placeholders
+ * (`{symbol}`) and plurals (`{count, plural, one {# item} other {# items}}`) are supported in
+ * both keys and values; the kit's runtime compiler handles ICU on access.
+ *
+ * @example
+ * ```tsx
+ * import { messages as es } from "@stridge/kit/i18n/locales/es";
+ * import { defineMessages } from "@stridge/kit/i18n";
+ *
+ * const fr = defineMessages({
+ *     Continue: "Suivant",
+ *     "Deposit {symbol}": "Dépôt de {symbol}",
+ *     "{count, plural, one {# item} other {# items}}":
+ *         "{count, plural, one {# article} other {# articles}}",
+ * });
+ *
+ * // Add a brand-new locale:
+ * <KitProvider i18n={{ locale: "fr", messages: { fr } }} />;
+ *
+ * // Override one key on a shipped locale (spread to preserve the rest):
+ * <KitProvider i18n={{ locale: "es", messages: { es: { ...es, ...defineMessages({ Continue: "Adelante" }) } } }} />;
+ *
+ * // Override source English:
+ * <KitProvider i18n={{ locale: "en", messages: { en: defineMessages({ Deposit: "Top up" }) } }} />;
+ * ```
+ */
+declare function defineMessages(translations: Partial<Record<KitTranslatableKey, string>>): Messages;
 /**
  * Public-facing i18n configuration. Pass the whole object to `<KitProvider i18n={…}>` —
- * `locale` selects the active locale, `catalogs` lists the catalogs the kit can resolve
- * against. Locales not present in `catalogs` fall back to the source English string per leaf.
+ * `locale` selects the active locale, `messages` lists the catalogs the kit can resolve
+ * against. Locales not present in `messages` fall back to the source English string per leaf.
  */
 interface KitI18nConfig {
-  /** Active locale code. Defaults to `"en"`. */
-  locale?: string;
   /**
-   * Locale catalogs the kit can resolve against. Deep-import the locales you ship from
-   * `@stridge/kit/i18n/locales/<code>` and pass them as a map (e.g. `{ es: esMessages }`).
-   * Tree-shaken: locales not referenced here aren't bundled.
+   * Active locale code. Defaults to `"en"`. Autocompletes on shipped locales (`"en"`, `"es"`,
+   * `"ar"`) but accepts any other BCP-47 tag for host-supplied catalogs.
+   */
+  locale?: KitLocale;
+  /**
+   * Locale catalogs the kit can resolve against. Each value is a hash-keyed lingui
+   * `Messages` map — either deep-imported from `@stridge/kit/i18n/locales/<code>` (shipped
+   * locales: `en`, `es`, `ar`) or produced by {@link defineMessages} from a plain
+   * English-keyed map (host-authored locales and per-key overrides). Same-locale entries
+   * merge per-key — spread a shipped catalog and overlay specific keys via `defineMessages`
+   * to override individual phrases without touching the rest.
    */
-  catalogs?: KitCatalogs;
+  messages?: KitMessages;
 }
 /**
  * Build a fresh {@link I18n} instance for one render tree (one `KitProvider` mount, one SSR
- * request). Loads `catalogs`, registers the runtime message compiler, and activates `locale`.
+ * request). Loads each entry of `messages`, registers the runtime message compiler, and
+ * activates `locale`.
  *
  * Per-request instances are the SSR-safe alternative to mutating a process-wide singleton. The
- * kit's {@link KitProvider} calls this on every render that changes `locale` or `catalogs`.
+ * kit's {@link KitProvider} calls this on every render that changes `locale` or `messages`.
  *
  * `setupI18n` ships its own no-op compiler in production builds; we override with the real
  * `compileMessage` so ICU placeholders (`{symbol}`) and plurals (`{count, plural, one {…}
@@ -35,7 +98,7 @@ interface KitI18nConfig {
  */
 declare function createKitI18n({
   locale,
-  catalogs
+  messages
 }?: KitI18nConfig): I18n;
 //#endregion
-export { KitCatalogs, KitI18nConfig, createKitI18n };
+export { KitI18nConfig, KitLocale, KitMessages, createKitI18n, defineMessages };

package/dist/shared/i18n/createKitI18n.js

@@ -1 +1 @@
-import{setupI18n as e}from"@lingui/core";import{compileMessage as t}from"@lingui/message-utils/compileMessage";function n({locale:n=`en`,catalogs:r}={}){let i=e();if(i.setMessagesCompiler(t),i.load(`en`,{}),r)for(let[e,t]of Object.entries(r))t&&i.load(e,t);return i.activate(n),i}export{n as createKitI18n};
+import{setupI18n as e}from"@lingui/core";import{compileMessage as t}from"@lingui/message-utils/compileMessage";import{generateMessageId as n}from"@lingui/message-utils/generateMessageId";function r(e){let t={};for(let[r,i]of Object.entries(e))!r||typeof i!=`string`||(t[n(r)]=i);return t}function i({locale:n=`en`,messages:r}={}){let i=e();if(i.setMessagesCompiler(t),i.load(`en`,{}),r)for(let[e,t]of Object.entries(r))t&&i.load(e,t);return i.activate(n),i}export{i as createKitI18n,r as defineMessages};

package/dist/shared/i18n/useLingui.d.ts

@@ -2,7 +2,15 @@ import { ComponentType } from "react";
 import { I18n } from "@lingui/core";
 
 //#region src/shared/i18n/useLingui.d.ts
-interface LinguiContextValue {
+/**
+ * Shape of the value returned by the kit's {@link useLingui}. Mirrors Lingui's own
+ * `LinguiContextValue` (`{ i18n, _, defaultComponent? }`) so the macro's rewrite of `` t`…` ``
+ * into `_({ id, message })` calls type-checks against this surface.
+ *
+ * Exported alongside {@link useLingui} so power users wrapping the hook can name the return
+ * type without reaching back into Lingui internals.
+ */
+interface KitLinguiContextValue {
   i18n: I18n;
   defaultComponent?: ComponentType<{
     id: string;
@@ -30,6 +38,6 @@ interface LinguiContextValue {
  * Callers shouldn't import this directly — they should write `import { useLingui } from
  * "@lingui/react/macro"` and let the build pipeline rewire the runtime target.
  */
-declare function useLingui(): LinguiContextValue;
+declare function useLingui(): KitLinguiContextValue;
 //#endregion
-export { useLingui };
+export { KitLinguiContextValue, useLingui };

package/dist/shared/icons/ActivityIcon.d.ts

@@ -0,0 +1,12 @@
+import { SVGProps } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/icons/ActivityIcon.d.ts
+/**
+ * Activity glyph — clock-arrow combo. Used as the header trigger on `<DepositDialog>`
+ * and `<WithdrawDialog>` to open the cross-flow activity surface. Matches the kit's icon
+ * convention (24×24 viewBox, `currentColor` stroke, 2px stroke width).
+ */
+declare function ActivityIcon(props: SVGProps<SVGSVGElement>): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ActivityIcon };

package/dist/shared/icons/ActivityIcon.js

@@ -0,0 +1 @@
+import{jsx as e,jsxs as t}from"react/jsx-runtime";function n(n){return t(`svg`,{fill:`none`,height:`24`,stroke:`currentColor`,strokeLinecap:`round`,strokeLinejoin:`round`,strokeWidth:`2`,viewBox:`0 0 24 24`,width:`24`,xmlns:`http://www.w3.org/2000/svg`,...n,children:[e(`path`,{d:`M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8`}),e(`path`,{d:`M3 3v5h5`}),e(`path`,{d:`M12 7v5l4 2`})]})}export{n as ActivityIcon};

package/dist/shared/icons/BitcoinIcon.d.ts

@@ -0,0 +1,14 @@
+import { SVGProps } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/icons/BitcoinIcon.d.ts
+/**
+ * Bitcoin coin glyph — a solid coin with the ₿ mark knocked out as negative space
+ * (`fillRule="evenodd"`). Used as the iconographic shorthand for the crypto payment rail in
+ * `Deposit.RailPicker`. Monochrome: the fill follows `currentColor`, so it tints with the
+ * surrounding text colour. The kit's only crypto-symbol icon; appropriate wherever a single glyph
+ * needs to represent "crypto" as a category (not a specific token — for that use a `TokenLogo`).
+ */
+declare function BitcoinIcon(props: SVGProps<SVGSVGElement>): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { BitcoinIcon };

package/dist/shared/icons/BitcoinIcon.js

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";function t(t){return e(`svg`,{xmlns:`http://www.w3.org/2000/svg`,width:24,height:24,viewBox:`0 0 500 500`,fill:`currentColor`,...t,children:e(`path`,{fillRule:`evenodd`,d:`M43.43,125.143c7.71-10.766,14.875-21.901,23.562-31.986c15.8-18.343,33.692-34.063,54.18-47.075c18.379-11.672,37.761-20.872,58.501-27.305c32.294-10.018,65.26-12.997,98.838-9.165c24.544,2.801,48.191,9.067,70.713,19.215c13.633,6.142,26.456,13.731,39.025,21.927c25.328,16.515,45.618,38.014,62.58,62.577c18.116,26.236,29.889,55.421,36.346,86.725c4.535,21.983,6.449,44.171,4.503,66.504c-2.399,27.536-8.514,54.086-19.938,79.604c-9.662,21.583-21.589,41.401-36.861,59.301c-14.94,17.511-31.788,32.831-51.149,45.461c-13.184,8.6-26.926,16.276-41.434,21.975c-24.274,9.537-49.447,15.986-75.787,17.115c-18.545,0.795-36.985,0.483-55.279-2.763c-15.713-2.788-31.049-6.858-46.063-12.496c-14.566-5.47-28.693-11.95-41.709-20.143c-18.766-11.812-35.683-26.147-50.737-42.663c-16.773-18.403-30.373-38.808-40.779-61.344c-14.7-31.835-21.929-65.401-22.359-100.425c-0.162-13.173,1.349-26.244,3.105-39.283c0.126-0.933-0.002-1.899-0.012-2.851c1.536-0.952,1.4-2.618,1.677-4.071c3.906-20.483,10.494-40.059,19.418-58.906C36.933,138.397,41.296,132.307,43.43,125.143z M325.157,254.513c6.537-3.474,12.749-5.465,17.658-9.85c18.918-16.899,23.96-56.673-6.747-75.833c-9.566-5.969-19.77-10.393-30.77-14.907c1.819-14.731,7.709-28.516,9.622-43.603c-9.076-2.249-17.578-5.234-26.425-6.193c-3.617,14.177-7.085,27.769-10.674,41.837c-6.78-2.076-13.761-1.879-20.142-5.473c2.302-14.39,7.773-27.872,9.268-42.314c-9.322-1.464-17.216-5.094-26.265-5.485c-3.563,14.209-7.011,27.958-10.586,42.215c-17.944-2.75-34.419-8.921-52.52-12.239c-3.977,8.91-5.738,18.311-7.334,28.313c5.896,1.392,11.022,2.623,16.158,3.811c12.965,2.998,16.517,10.086,13.439,21.424c-2.19,8.065-4.166,16.189-6.182,24.301c-7.245,29.16-14.432,58.333-21.72,87.482c-1.642,6.567-5.734,8.706-12.398,7.731c-6.563-0.96-12.757-3.907-19.99-3.693c-3.136,10.032-9.378,18.871-11.588,29.946c17.236,4.391,33.911,8.639,51.344,13.08c-1.312,15.208-7.614,29.125-9.476,44.441c8.739,2.095,16.965,4.066,25.544,6.123c5.653-14.044,6.957-28.803,12.226-43.33c6.351,3.265,13.397,2.317,19.612,6.427c-3.387,14.003-6.762,27.952-10.178,42.077c8.986,3.216,17.753,4.528,26.758,6.77c3.645-14.604,7.169-28.728,10.578-42.386c2.123-1.091,3.676-0.888,5.143-0.574c14.113,3.021,28.39,3.726,42.676,2.14c12.368-1.373,23.343-6.088,32.148-15.372c9.791-10.323,14.71-22.952,17.078-36.535c1.93-11.065,1.436-22.277-5.06-32.071C341.263,265.099,334.27,259.243,325.157,254.513z M223.128,312.17c17.411,4.325,34.803,8.95,53.02,5.624c9.715-1.774,17.037-6.73,19.985-16.503c2.78-9.218,1.164-17.593-5.673-24.879c-7.11-7.576-16.254-11.514-25.682-14.807c-11.264-3.934-22.683-7.508-34.99-8.48c-4.716,19.168-9.293,37.773-13.972,56.788C218.797,310.842,220.933,311.625,223.128,312.17z M284.628,231.846c9.628-1.368,17.612-7.738,19.958-16.393c2.869-10.583-0.337-19.865-8.902-26.178c-9.718-7.163-20.908-10.807-32.47-13.337c-4.307-0.943-8.544-3.454-13.756-1.759c-4.143,16.837-8.303,33.747-12.599,51.209C253.316,229.543,268.47,234.141,284.628,231.846z`})})}export{t as BitcoinIcon};

package/dist/shared/icons/CardIcon.d.ts

@@ -0,0 +1,16 @@
+import { SVGProps } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/icons/CardIcon.d.ts
+/**
+ * Generic credit-card outline. Used as the themed monochrome glyph for the
+ * onramp ("Cash") method in `Deposit.Method` and the onramp rail tab;
+ * brand-specific card art ships through the `DepositMethodInput.icon` override
+ * prop when the integrator has approval for the official mark.
+ *
+ * SVG path mirrors the `credit-card` icon from lucide (MIT) — inlined because
+ * `@stridge/kit` must not depend on `lucide-react`.
+ */
+declare function CardIcon(props: SVGProps<SVGSVGElement>): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { CardIcon };