@stridge/kit 0.1.0-alpha.3 → 0.1.0-alpha.30

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
+ * `Uda.supportedAssets()`) 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

@@ -0,0 +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";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/cuer/QrCode.js

@@ -0,0 +1 @@
+import{encodeQR as e}from"qr";function t(t,n={}){let{errorCorrection:r,version:i}=n,a=e(t,`raw`,{border:1,ecc:r,scale:1,version:i}).slice(1,-1).map(e=>e.slice(1,-1));return{edgeLength:a.length,finderLength:7,grid:a,value:t}}export{t as create};

package/dist/shared/cuer/index.js

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

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/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=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||document.visibilityState===`hidden`)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(()=>{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/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/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/LogoIcon.d.ts

@@ -0,0 +1,13 @@
+import { SVGProps } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/shared/icons/LogoIcon.d.ts
+/**
+ * Stridge brand mark. Path is the optimized 18×18 variant used in social cards, scaled to
+ * whatever `width`/`height` the caller passes (defaults to 14×14 for inline use). Decorative
+ * when paired with the "Stridge" wordmark — mark it `aria-hidden` in those compositions so
+ * screen readers announce the wordmark only once.
+ */
+declare function LogoIcon(props: SVGProps<SVGSVGElement>): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { LogoIcon };

package/dist/shared/icons/LogoIcon.js

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";function t(t){return e(`svg`,{fill:`currentColor`,height:`14`,viewBox:`0 0 18 18`,width:`14`,xmlns:`http://www.w3.org/2000/svg`,...t,children:e(`path`,{clipRule:`evenodd`,d:`M0 9a9 9 0 0 0 9 9A9 9 0 1 0 9 0a9 9 0 0 0-9 9Zm11.675 1.953a.88.88 0 0 0-.742.198 5.311 5.311 0 0 1-3.998 1.807C-.985 12.958.955 1.742 9 1.742a7.24 7.24 0 0 1 5.374 2.379 7.042 7.042 0 0 0-3.309-.82A7.048 7.048 0 0 0 5.76 5.697.879.879 0 0 0 7.068 6.85a5.31 5.31 0 0 1 3.998-1.807c7.92 0 5.98 11.216-2.066 11.216a7.237 7.237 0 0 1-5.373-2.379 7.035 7.035 0 0 0 3.308.821 7.044 7.044 0 0 0 5.306-2.398.878.878 0 0 0-.566-1.349Z`,fillRule:`evenodd`})})}export{t as LogoIcon};

package/dist/shared/orchestrator/useSettlementWatcher.js

@@ -1 +1 @@
-import{useEffect as e}from"react";function t(t,n){let r=n?.hash;e(()=>{if(!n)return;let e=new AbortController;return t.watchSettlement({tx:n},()=>void 0,e.signal),()=>e.abort()},[r,t])}export{t as useSettlementWatcher};
+import{useEffect as e,useRef as t}from"react";function n(n,r,i){let a=t(r);a.current=r,e(()=>{let e=a.current;if(e==null)return;let t=new AbortController;return n.watchSettlement(e,()=>void 0,t.signal),()=>t.abort()},[n,i])}export{n as useSettlementWatcher};

package/dist/shared/primitives/TxHashValue/TxHashValue.js

@@ -1 +1 @@
-"use client";import{ExternalLinkIcon as e}from"../../icons/ExternalLinkIcon.js";import"../../../icons/index.js";import{toSafeHref as t}from"../../ui/ExternalLink/toSafeHref.js";import{ExternalLink as n}from"../../ui/ExternalLink/ExternalLink.js";import"../../ui/ExternalLink/index.js";import{LtrAtom as r}from"../../ui/LtrAtom/LtrAtom.js";import"../../ui/LtrAtom/index.js";import{text as i}from"../../ui/Text/Text.js";import"../../ui/Text/index.js";import{TX_HASH_VALUE_SLOTS as a}from"./TxHashValue.slots.js";import{styles as o}from"./TxHashValue.styles.js";import{jsx as s}from"react/jsx-runtime";import*as c from"@stylexjs/stylex";function l({hash:l,explorerUrl:u,linkColor:d=`var(--stridge-kit-primary)`}){let f=t(u),p=c.props(o.root),m=s(i.span,{size:`meta`,fontWeight:`medium`,leading:`tight`,tracking:`normal`,font:`mono`,color:`inherit`,children:s(r,{children:l})});return f?s(n,{dir:`ltr`,href:f,suffix:s(e,{"aria-hidden":!0}),"data-stridge-slot":a.root,className:p.className,style:{...p.style,color:d},children:m}):s(`span`,{dir:`ltr`,"data-stridge-slot":a.root,className:p.className,style:p.style,children:m})}export{l as TxHashValue};
+"use client";import{toSafeHref as e}from"../../ui/ExternalLink/toSafeHref.js";import{ExternalLink as t}from"../../ui/ExternalLink/ExternalLink.js";import"../../ui/ExternalLink/index.js";import{ExternalLinkIcon as n}from"../../icons/ExternalLinkIcon.js";import"../../../icons/index.js";import{LtrAtom as r}from"../../ui/LtrAtom/LtrAtom.js";import"../../ui/LtrAtom/index.js";import{text as i}from"../../ui/Text/Text.js";import"../../ui/Text/index.js";import{TX_HASH_VALUE_SLOTS as a}from"./TxHashValue.slots.js";import{styles as o}from"./TxHashValue.styles.js";import{jsx as s}from"react/jsx-runtime";import*as c from"@stylexjs/stylex";function l({hash:l,explorerUrl:u,linkColor:d=`var(--stridge-kit-primary)`}){let f=e(u),p=c.props(o.root),m=s(i.span,{size:`xs`,fontWeight:`medium`,leading:`tight`,tracking:`normal`,font:`mono`,color:`inherit`,children:s(r,{children:l})});return f?s(t,{dir:`ltr`,href:f,suffix:s(n,{"aria-hidden":!0}),"data-stridge-slot":a.root,className:p.className,style:{...p.style,color:d},children:m}):s(`span`,{dir:`ltr`,"data-stridge-slot":a.root,className:p.className,style:p.style,children:m})}export{l as TxHashValue};

package/dist/shared/support/SupportButton.d.ts

@@ -0,0 +1 @@
+import { ComponentProps, ReactNode } from "react";

package/dist/shared/support/SupportButton.js

@@ -0,0 +1 @@
+"use client";import{styles as e}from"../ui/ExternalLink/ExternalLink.styles.js";import{joinClassNames as t}from"../utils/joinClassNames.js";import{cloneElement as n,isValidElement as r}from"react";import{jsx as i,jsxs as a}from"react/jsx-runtime";import*as o from"@stylexjs/stylex";function s({children:n,suffix:r,className:s,style:d,...f}){let p=r!=null&&r!==!1,m=o.props(e.root,l.button),h=t(m.className,s),g=o.props(e.iconSlot,e.suffixSpacing);return a(`button`,{"data-stridge-slot":u.root,type:`button`,...f,className:h,style:{...m.style,...d},children:[n,p?i(`span`,{"data-icon":`inline-end`,...g,children:c(r)}):null]})}function c(t){if(!r(t))return t;let i=o.props(e.iconSvg);return n(t,{className:[t.props.className,i.className].filter(Boolean).join(` `),style:{...t.props.style,...i.style}})}const l={button:{"SupportButton__supportButtonStyles.button":`SupportButton__supportButtonStyles.button`,"appearance-kysU6D":`xjyslct`,"padding-kmVPX3":`x1717udv`,"font-kVVagm":`xln7xf2`,"color-kMwMTN":`x1heor9g`,"cursor-kkrTdU":`x1ypdohk`,"textAlign-k9WMMc":`x16tdsg8`,$$css:`@stridge/kit:src/shared/support/SupportButton.tsx:52`}},u={root:`support-button`};export{s as SupportButton};

package/dist/shared/support/SupportConfigContext.d.ts

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

package/dist/shared/support/SupportConfigContext.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t}from"react";const n=e({config:void 0,merchantContext:null});n.displayName=`SupportConfigContext`;function r(){return t(n)}export{n as SupportConfigContext,r as useSupportConfig};

package/dist/shared/support/SupportLink.d.ts

@@ -0,0 +1 @@
+import { CSSProperties, MouseEventHandler, ReactNode } from "react";

package/dist/shared/support/SupportLink.js

@@ -0,0 +1 @@
+"use client";import{useSupportConfig as e}from"./SupportConfigContext.js";import{resolveSupport as t}from"./resolveSupport.js";import{SupportButton as n}from"./SupportButton.js";import{BRAND_LINKS as r}from"../constants/brand-links.js";import{ExternalLink as i}from"../ui/ExternalLink/ExternalLink.js";import"../ui/ExternalLink/index.js";import{SupportSpinner as a}from"./SupportSpinner.js";import{useSupportTrigger as o}from"./useSupportTrigger.js";import{useCallback as s}from"react";import{jsx as c}from"react/jsx-runtime";const l={cursor:`not-allowed`,opacity:.6,pointerEvents:`none`};function u(n){let{config:r,merchantContext:i}=e(),a=t(r);return a.kind===`stridge`?c(d,{...n}):a.kind===`url`?c(f,{...n,url:a.url}):c(p,{...n,url:a.url,onOpen:a.onOpen,merchantContext:i})}function d({children:e,suffix:t,onClick:n,style:u,...d}){let f=o(),p=f.status===`loading`,m=s(e=>{n?.(e),!e.defaultPrevented&&e.button===0&&(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||(e.preventDefault(),f.open()))},[f,n]),h=p?{...u,...l}:u;return c(i,{...d,href:r.support,suffix:p?c(a,{}):t,onClick:m,"aria-busy":p||void 0,"aria-disabled":p||void 0,style:h,children:e})}function f({url:e,children:t,...n}){return c(i,{...n,href:e,children:t})}function p({url:e,onOpen:t,merchantContext:r,children:a,suffix:o,onClick:l,...u}){let d=s(e=>{l?.(e),!e.defaultPrevented&&e.button===0&&(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||(e.preventDefault(),t({event:e,...m(r)})))},[l,t,r]),f=s(e=>{l?.(e),!e.defaultPrevented&&t({event:e,...m(r)})},[l,t,r]);return e?c(i,{...u,href:e,suffix:o,onClick:d,children:a}):c(n,{...u,suffix:o,onClick:f,children:a})}function m(e){return e??{gatewayKey:``,environment:``,assetChain:``,assetSymbol:``}}export{u as SupportLink};

package/dist/shared/support/SupportSpinner.d.ts

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

package/dist/shared/support/SupportSpinner.js

@@ -0,0 +1 @@
+import{LoaderIcon as e}from"../icons/LoaderIcon.js";import"../../icons/index.js";import{jsx as t}from"react/jsx-runtime";function n(){return t(e,{"aria-hidden":!0,role:`img`,"aria-label":`Loading`,className:`SupportSpinner__styles.spinning x1aerksh xof6966 x1esw782 xa4qsjk x1g0ag68 x1764fhq`,"data-style-src":`@stridge/kit:src/shared/support/SupportSpinner.tsx:12`})}export{n as SupportSpinner};

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

@@ -0,0 +1,2 @@
+import { IntercomMerchantContext } from "./useIntercomMerchantContext.js";
+import { SupportConfig, SupportOpenContext } from "./types.js";

package/dist/shared/support/index.js

@@ -0,0 +1 @@
+import"./SupportConfigContext.js";import"./intercom-loader.js";import"./resolveSupport.js";import"./SupportButton.js";import"./SupportSpinner.js";import"./useSupportTrigger.js";import"./SupportLink.js";import"./useIntercomMerchantContext.js";import"./useIntercomShutdownOnUnmount.js";import"./useMerchantContext.js";

package/dist/shared/support/intercom-loader.d.ts

@@ -0,0 +1,17 @@
+//#region src/shared/support/intercom-loader.d.ts
+/**
+ * Messenger command dispatcher exposed at `window.Intercom`. The vendor accepts arbitrary
+ * command tuples (`["boot", settings]`, `["onShow", callback]`, `["show"]`, …); our calls
+ * are funneled through {@link openIntercom} / {@link shutdownIntercom}.
+ */
+type IntercomFn = (...args: unknown[]) => void;
+declare global {
+  interface Window {
+    Intercom?: IntercomFn;
+    intercomSettings?: Record<string, unknown>;
+  }
+}
+/**
+ * Returns `true` when the vendor's real dispatcher is mounted on `window.Intercom`. Used by
+ * {@link useSupportTrigger} as a hint for whether a subsequent click can skip the spinner.
+ */

package/dist/shared/support/intercom-loader.js

@@ -0,0 +1 @@
+import{BRAND_INTERCOM as e}from"../constants/brand-intercom.js";const t=`__stridgeKitShim__`;let n=null,r=!1;function i(e){return e[t]===!0}function a(){if(typeof window>`u`)return!1;let t=window.intercomSettings?.app_id,n=!1;if(typeof t==`string`&&t!==e.appId)n=!0;else{let e=window.Intercom;typeof e==`function`&&!i(e)&&t===void 0&&(n=!0)}return n&&o(),n}function o(){r||process.env.NODE_ENV!==`production`&&(r=!0,console.warn("[@stridge/kit] Detected a foreign Intercom workspace already mounted on this page. The kit's support link will fall back to opening the static support URL in a new tab. Configure `<StridgeProvider support={{ url: '...' }} />` or `<StridgeProvider support={{ onOpen: ... }} />` to silence this warning and customize the behavior."))}function s(){let e=window;if(typeof e.Intercom==`function`)return e.Intercom;let n=[],r=Object.assign((...e)=>{n.push(e)},{q:n,c:e=>{n.push(e)},[t]:!0});return e.Intercom=r,r}function c(){return n||(typeof document>`u`?Promise.reject(Error(`Intercom can only load in a browser`)):(n=new Promise((t,r)=>{let a=document.createElement(`script`);a.type=`text/javascript`,a.async=!0,a.src=`https://widget.intercom.io/widget/${e.appId}`,a.dataset.stridgeIntercom=`true`,a.addEventListener(`load`,()=>t()),a.addEventListener(`error`,()=>{n=null,a.remove(),typeof window<`u`&&window.Intercom&&i(window.Intercom)&&delete window.Intercom,r(Error(`Failed to load Intercom widget script`))}),document.head.appendChild(a)}),n))}function l(){if(typeof window>`u`)return!1;let e=window.Intercom;return typeof e==`function`&&!i(e)}function u(){return typeof window>`u`?Promise.reject(Error(`Intercom can only load in a browser`)):a()?Promise.reject(Error(`Another Intercom workspace is already mounted; falling back to web link`)):new Promise((t,n)=>{let r=window;r.intercomSettings={...r.intercomSettings,app_id:e.appId,hide_default_launcher:!0};let i=s(),a=!1,o,l=e=>{a||(a=!0,o!==void 0&&clearTimeout(o),e())};i(`boot`,{...r.intercomSettings,app_id:e.appId,hide_default_launcher:!0}),i(`onShow`,()=>{l(()=>t())}),i(`onHide`,()=>{d()}),i(`show`),o=setTimeout(()=>{l(()=>n(Error(`Intercom messenger did not display within timeout`)))},1e4),c().catch(e=>{l(()=>n(e))})})}function d(){if(typeof window>`u`)return;let e=window.Intercom;if(typeof e==`function`&&!i(e))try{e(`shutdown`)}catch{}}export{l as isIntercomReady,u as openIntercom,d as shutdownIntercom};

package/dist/shared/support/resolveSupport.d.ts

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

package/dist/shared/support/resolveSupport.js

@@ -0,0 +1 @@
+function e(e){return e?.onOpen?e.url?{kind:`custom`,onOpen:e.onOpen,url:e.url}:{kind:`custom`,onOpen:e.onOpen}:e?.url?{kind:`url`,url:e.url}:{kind:`stridge`}}export{e as resolveSupport};

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

@@ -0,0 +1,43 @@
+import { IntercomMerchantContext } from "./useIntercomMerchantContext.js";
+import { MouseEvent } from "react";
+
+//#region src/shared/support/types.d.ts
+/**
+ * Configures the kit's in-dialog "Get help" entry point.
+ *
+ * Omit `support` to boot Stridge's hosted messenger on plain left-click and fall back to
+ * {@link https://stridge.com/contact-us | the support URL}. Provide `url`, `onOpen`, or both
+ * to use merchant-owned support; either field opts out of Stridge messenger globals. Empty
+ * values (`{}` or `{ url: "" }`) fall back to the Stridge default.
+ *
+ * Treated as static across the kit's lifetime. Switching the mode after mount (e.g. from
+ * Stridge to merchant-owned support) is not supported — the kit will not shut down an
+ * already-booted Stridge messenger or clear `window.intercomSettings` on the transition.
+ * Resolve support configuration before the first render of `<StridgeProvider>`.
+ */
+interface SupportConfig {
+  /**
+   * URL used as the "Get help" anchor `href`.
+   *
+   * Empty string is treated as if the field were omitted.
+   */
+  url?: string;
+  /**
+   * Custom click handler invoked instead of the default Stridge messenger.
+   *
+   * Fires on plain left-click with the click event and the merchant/user triage metadata.
+   * Modified clicks keep anchor navigation when `url` is set.
+   */
+  onOpen?: (ctx: SupportOpenContext) => void;
+}
+/**
+ * Represents the argument passed to {@link SupportConfig.onOpen}.
+ *
+ * Combines the click event with the same triage metadata used by the Stridge messenger.
+ */
+interface SupportOpenContext extends IntercomMerchantContext {
+  /** React synthetic event for the click that triggered support. */
+  event: MouseEvent<HTMLElement>;
+}
+//#endregion
+export { SupportConfig, SupportOpenContext };

package/dist/shared/support/useIntercomMerchantContext.d.ts

@@ -0,0 +1,27 @@
+//#region src/shared/support/useIntercomMerchantContext.d.ts
+/**
+ * Merchant, asset, and end-user triage metadata the kit attaches to support requests.
+ *
+ * Stridge's hosted messenger reads these fields via `window.intercomSettings` so support
+ * agents can route an incoming conversation without asking the user for context. Merchant-
+ * owned support entry points receive the same shape via
+ * {@link SupportOpenContext}, so triage data carries through verbatim into custom handlers.
+ */
+interface IntercomMerchantContext {
+  /** Stridge gateway key — primary key uniquely identifying which integrating business the user is coming through. */
+  gatewayKey: string;
+  /** Stridge API environment the kit is talking to. Goes alongside the gateway key for support triage. */
+  environment: string;
+  /** Stridge `network_id` of the settlement asset (e.g. `"60"`, `"9006"`). */
+  assetChain: string;
+  /** Settlement asset symbol (e.g. `"USDC"`). */
+  assetSymbol: string;
+  /** Connected wallet address — best-effort end-user identifier in a web3 context. */
+  userAddress?: string;
+  /** Merchant display name resolved from `gateway/start.metadata.brand_name`. Async; undefined pre-bootstrap. */
+  brandName?: string;
+  /** Optional secondary line from `gateway/start.metadata.checkout_item_title`. */
+  checkoutItemTitle?: string;
+}
+//#endregion
+export { IntercomMerchantContext };

package/dist/shared/support/useIntercomMerchantContext.js

@@ -0,0 +1 @@
+"use client";import{BRAND_INTERCOM as e}from"../constants/brand-intercom.js";import{useEffect as t}from"react";function n(n){let r=n?.gatewayKey,i=n?.environment,a=n?.assetChain,o=n?.assetSymbol,s=n?.userAddress,c=n?.brandName,l=n?.checkoutItemTitle;t(()=>{if(!r||!i||!a||!o||typeof window>`u`)return;let t=window.intercomSettings?.app_id;if(typeof t==`string`&&t!==e.appId)return;let n={company_id:r,environment:i,asset_chain:a,asset_symbol:o};c&&(n.name=c),l&&(n.checkout_item_title=l);let u={...window.intercomSettings,app_id:e.appId,hide_default_launcher:!0,company:n};if(s&&(u.user_id=s,u.wallet_address=s),window.intercomSettings=u,typeof window.Intercom==`function`)try{window.Intercom(`update`,u)}catch{}},[r,i,a,o,s,c,l])}export{n as useIntercomMerchantContext};

package/dist/shared/support/useIntercomShutdownOnUnmount.js

@@ -0,0 +1 @@
+"use client";import{shutdownIntercom as e}from"./intercom-loader.js";import{useEffect as t}from"react";function n(){t(()=>()=>{e()},[])}export{n as useIntercomShutdownOnUnmount};

package/dist/shared/support/useMerchantContext.d.ts

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

package/dist/shared/support/useMerchantContext.js

@@ -0,0 +1 @@
+"use client";import{useSyncExternalStore as e}from"react";function t({gatewayKey:t,environment:n,assetChain:r,assetSymbol:i,userAddress:a,depositDriver:o}){let s=e(e=>o?.subscribe(e)??(()=>{}),()=>{if(!o)return;let e=o.getSnapshot();if(e.brand.status===`ready`||e.brand.status===`stale`)return e.brand.payload.name},()=>void 0),c=e(e=>o?.subscribe(e)??(()=>{}),()=>{if(!o)return;let e=o.getSnapshot();if(e.brand.status===`ready`||e.brand.status===`stale`)return e.brand.payload.checkoutItemTitle},()=>void 0);return{gatewayKey:t,environment:n,assetChain:r,assetSymbol:i,...a?{userAddress:a}:{},...s?{brandName:s}:{},...c?{checkoutItemTitle:c}:{}}}export{t as useMerchantContext};

package/dist/shared/support/useSupportTrigger.js

@@ -0,0 +1 @@
+"use client";import{isIntercomReady as e,openIntercom as t}from"./intercom-loader.js";import{BRAND_LINKS as n}from"../constants/brand-links.js";import{useCallback as r,useRef as i,useState as a}from"react";function o(){let[n,o]=a(()=>e()?`ready`:`idle`),c=i(!1);return{status:n,open:r(()=>{c.current||(c.current=!0,o(`loading`),t().then(()=>{c.current=!1,o(`ready`)},()=>{c.current=!1,s(),o(`error`)}))},[])}}function s(){typeof window>`u`||window.open(n.support,`_blank`,`noopener,noreferrer`)}export{o as useSupportTrigger};

package/dist/shared/terms/TermsButton.d.ts

@@ -0,0 +1 @@
+import { ComponentProps, ReactNode } from "react";

package/dist/shared/terms/TermsButton.js

@@ -0,0 +1 @@
+"use client";import{styles as e}from"../ui/ExternalLink/ExternalLink.styles.js";import{joinClassNames as t}from"../utils/joinClassNames.js";import{jsx as n}from"react/jsx-runtime";import*as r from"@stylexjs/stylex";function i({children:i,className:s,style:c,...l}){let u=r.props(e.root,a.button),d=t(u.className,s);return n(`button`,{"data-stridge-slot":o.root,type:`button`,...l,className:d,style:{...u.style,...c},children:i})}const a={button:{"TermsButton__termsButtonStyles.button":`TermsButton__termsButtonStyles.button`,"appearance-kysU6D":`xjyslct`,"padding-kmVPX3":`x1717udv`,"font-kVVagm":`xln7xf2`,"color-kMwMTN":`x1heor9g`,"cursor-kkrTdU":`x1ypdohk`,"textAlign-k9WMMc":`x16tdsg8`,$$css:`@stridge/kit:src/shared/terms/TermsButton.tsx:28`}},o={root:`terms-button`};export{i as TermsButton};

package/dist/shared/terms/TermsConfigContext.d.ts

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

package/dist/shared/terms/TermsConfigContext.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t}from"react";const n=e({config:void 0});n.displayName=`TermsConfigContext`;function r(){return t(n)}export{n as TermsConfigContext,r as useTermsConfig};

package/dist/shared/terms/TermsLink.d.ts

@@ -0,0 +1 @@
+import { CSSProperties, MouseEventHandler, ReactNode } from "react";

package/dist/shared/terms/TermsLink.js

@@ -0,0 +1 @@
+"use client";import{useTermsConfig as e}from"./TermsConfigContext.js";import{BRAND_LINKS as t}from"../constants/brand-links.js";import{ExternalLink as n}from"../ui/ExternalLink/ExternalLink.js";import"../ui/ExternalLink/index.js";import{resolveTerms as r}from"./resolveTerms.js";import{TermsButton as i}from"./TermsButton.js";import{useCallback as a}from"react";import{jsx as o}from"react/jsx-runtime";function s(t){let{config:n}=e(),i=r(n);return i.kind===`stridge`?o(c,{...t}):i.kind===`url`?o(l,{...t,url:i.url}):o(u,{...t,url:i.url,onSelect:i.onSelect})}function c(e){return o(n,{...e,href:t.terms})}function l({url:e,...t}){return o(n,{...t,href:e})}function u({url:e,onSelect:t,children:r,onClick:s,...c}){let l=a(e=>{s?.(e),!e.defaultPrevented&&e.button===0&&(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||(e.preventDefault(),t({event:e})))},[s,t]),u=a(e=>{s?.(e),!e.defaultPrevented&&t({event:e})},[s,t]);return e?o(n,{...c,href:e,onClick:l,children:r}):o(i,{...c,onClick:u,children:r})}export{s as TermsLink};

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

@@ -0,0 +1 @@
+import { TermsConfig, TermsSelectContext } from "./types.js";

package/dist/shared/terms/index.js

@@ -0,0 +1 @@
+import"./TermsConfigContext.js";import"./resolveTerms.js";import"./TermsButton.js";import"./TermsLink.js";

package/dist/shared/terms/resolveTerms.d.ts

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

package/dist/shared/terms/resolveTerms.js

@@ -0,0 +1 @@
+function e(e){return e?.onSelect?e.url?{kind:`custom`,onSelect:e.onSelect,url:e.url}:{kind:`custom`,onSelect:e.onSelect}:e?.url?{kind:`url`,url:e.url}:{kind:`stridge`}}export{e as resolveTerms};