@capxul/sdk-react 4.20.0-beta.1 → 4.20.0-beta.10

package/dist/index.mjs

@@ -1,8 +1,8 @@
 "use client";
-import { _ as useCapxul, a as useCapxulAuth, c as useCapxulIdentityOrNull, d as toInvocationControls, f as toInvocationOptions, g as useCapxulClientOrNull, h as capxulKeys, i as entered, l as useCapxulSend, m as actingAccount, n as CapxulOnboardingController, o as useCapxulDestination, p as accountKey, r as CapxulProvider, s as useCapxulIdentity, t as CapxulAuthenticationController, u as useCapxulTransitions } from "./controllers-DXmEHrnw.mjs";
+import { _ as useCapxul, a as useCapxulAuth, c as useCapxulIdentityOrNull, d as toInvocationControls, f as toInvocationOptions, g as useCapxulClientOrNull, h as capxulKeys, i as entered, l as useCapxulSend, m as actingAccount, n as CapxulOnboardingController, o as useCapxulDestination, p as accountKey, r as CapxulProvider, s as useCapxulIdentity, t as CapxulAuthenticationController, u as useCapxulTransitions } from "./controllers-L1UqwWS1.mjs";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
-import { CAPXUL_OPERATIONS, CapxulError, EVM_ADDRESS_RE, Errors, HANDLE_RE, PAYMENT_DIRECTIONS, PAYMENT_STATUSES, fingerprintPaymentIntent, formatMoney, isCapxulError, isClaimed, isClaimed as isClaimed$1, isMoneyParseError, isRestoring, isRestoring as isRestoring$1, parseMoney, paymentPhase, resolveIdentityDestination, toEvmAddress, toPartyId } from "@capxul/sdk";
+import { CAPXUL_OPERATIONS, CapxulError, EVM_ADDRESS_RE, Errors, HANDLE_RE, PAYMENT_DIRECTIONS, PAYMENT_STATUSES, assetSymbolFor, fingerprintPaymentIntent, formatAssetAmount, formatMoney, isCapxulError, isClaimed, isClaimed as isClaimed$1, isMoneyParseError, isRestoring, isRestoring as isRestoring$1, parseAssetAmount, parseMoney, paymentPhase, requireAsset, resolveIdentityDestination, toEvmAddress, toPartyId, toRaw, valueActivitySummary } from "@capxul/sdk";
 import { Fragment, jsx } from "react/jsx-runtime";
 //#region src/internal/require-bootstrapped-client.ts
 /**
@@ -546,22 +546,6 @@ function useCapxulCreateOrg() {
 	});
 }
 //#endregion
-//#region src/hooks/use-capxul-invite-member.ts
-function useCapxulInviteMember(orgId) {
-	const client = useCapxulClientOrNull();
-	const queryClient = useQueryClient();
-	return useMutation({
-		mutationFn: async ({ options, ...input }) => {
-			if (orgId === void 0) throw Errors.invalidInput("orgId", "required for useCapxulInviteMember");
-			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.org.invite).org(orgId).invite(input, toInvocationControls(options)));
-		},
-		onSuccess: async () => {
-			if (orgId === void 0) return;
-			await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });
-		}
-	});
-}
-//#endregion
 //#region src/headless/journey/journey-state.ts
 const JOURNEY_KEY = "capxul.onboarding.journey.v1";
 const VALIDATED_OWNER_KEY = "capxul.onboarding.validated-owner.v1";
@@ -1079,7 +1063,7 @@ function useContactsContext() {
 	if (engine === null) throw new Error("CapxulContacts parts must be used inside <CapxulContacts>");
 	return engine;
 }
-function Root$6({ actor, onAdded, onFailed, children }) {
+function Root$7({ actor, onAdded, onFailed, children }) {
 	const engine = useContacts({
 		actor,
 		onAdded,
@@ -1103,7 +1087,7 @@ function Add({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useContactsContext().add) });
 }
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-const CapxulContacts = Object.assign(Root$6, {
+const CapxulContacts = Object.assign(Root$7, {
 	Summary: Summary$3,
 	List,
 	Add
@@ -1141,15 +1125,8 @@ function useActivityEnabled() {
 }
 //#endregion
 //#region src/headless/activity/detail.ts
-/**
-* ONE finished document, never the array, so no consumer writes `documents[0]`:
-* the payslip, else the receipt, else nothing. Those two kinds are the ones the
-* Download receipt button is for. A Movement detail carries no documents.
-*/
-function pickReceiptDocument(detail) {
-	if (detail === null || detail.kind !== "payment") return null;
-	const documents = detail.payment.documents;
-	return documents.find((document) => document.kind === "payslip") ?? documents.find((document) => document.kind === "receipt") ?? null;
+function detailDocuments(detail) {
+	return detail === null ? [] : detail.kind === "payment" ? detail.payment.documents : detail.documents;
 }
 /**
 * The root actor and the whole reference are included. A payment reference can
@@ -1184,27 +1161,76 @@ function useActivityDetail(reference, actor) {
 	const enabled = useActivityEnabled() && reference !== void 0;
 	const detail = useQuery({
 		queryKey: accountKey(capxulKeys.activityDetail(reference, actor), identity),
-		queryFn: async () => {
+		queryFn: async ({ signal }) => {
 			if (reference === void 0) throw Errors.invalidInput("reference", "required for activity.get");
-			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.activity.get).activity.get(reference, actor === void 0 ? void 0 : { actor }));
+			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.activity.get).activity.get(reference, {
+				...actor === void 0 ? {} : { actor },
+				signal
+			}));
 		},
 		enabled
 	});
-	const receiptDocument = pickReceiptDocument(detail.data ?? null);
+	const documents = detailDocuments(detail.data ?? null);
+	const [selected, setSelected] = useState(null);
+	const selectedDocument = (selected === null ? void 0 : documents.find((doc) => doc.documentHash === selected.documentHash && doc.contentHash === selected.contentHash)) ?? documents.find((doc) => doc.role === "instruction") ?? documents.find((doc) => doc.role === "movement") ?? documents[0] ?? null;
+	const pending = useRef(/* @__PURE__ */ new Set());
+	const mounted = useRef(true);
+	useEffect(() => {
+		mounted.current = true;
+		const reads = pending.current;
+		return () => {
+			mounted.current = false;
+			for (const read of reads) read.abort();
+			reads.clear();
+		};
+	}, []);
+	const selectDocument = useCallback((ref) => {
+		if (!documents.some((doc) => doc.documentHash === ref.documentHash && doc.contentHash === ref.contentHash)) throw Errors.invalidInput("documentHash", "document not found");
+		for (const read of pending.current) read.abort();
+		pending.current.clear();
+		setIsOpeningDocument(false);
+		setSelected({
+			documentHash: ref.documentHash,
+			contentHash: ref.contentHash
+		});
+	}, [documents]);
 	const [isOpeningDocument, setIsOpeningDocument] = useState(false);
-	const openReceiptDocument = useCallback(async () => {
-		if (reference === void 0 || receiptDocument === null) throw Errors.invalidInput("receiptDocument", "no renderable document on this row");
+	const readDocument = useCallback(async (download) => {
+		const operation = download ? CAPXUL_OPERATIONS.paymentDocuments.get : CAPXUL_OPERATIONS.paymentDocuments.render;
+		if (!mounted.current) throw Errors.cancelled({ operation });
+		if (reference === void 0 || selectedDocument === null) throw Errors.invalidInput("documentHash", "no document on this row");
+		const controller = new AbortController();
+		pending.current.add(controller);
 		setIsOpeningDocument(true);
 		try {
-			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.paymentDocuments.render).paymentDocuments.render(receiptDocument.documentHash));
+			const bootstrapped = requireBootstrappedClient(client, download ? CAPXUL_OPERATIONS.paymentDocuments.get : CAPXUL_OPERATIONS.paymentDocuments.render);
+			const pair = {
+				documentHash: selectedDocument.documentHash,
+				contentHash: selectedDocument.contentHash
+			};
+			const options = { signal: controller.signal };
+			const result = download ? await bootstrapped.paymentDocuments.get(pair, options) : await bootstrapped.paymentDocuments.render(pair, options);
+			if (controller.signal.aborted) throw Errors.cancelled({ operation });
+			return unwrapCapxulResult(result);
 		} finally {
-			setIsOpeningDocument(false);
+			pending.current.delete(controller);
+			if (!controller.signal.aborted) setIsOpeningDocument(pending.current.size > 0);
 		}
 	}, [
 		client,
-		receiptDocument,
+		selectedDocument,
 		reference
 	]);
+	const renderDocument = useCallback(async () => {
+		const result = await readDocument(false);
+		if (!("html" in result)) throw Errors.invalidInput("documentHash", "invalid document render");
+		return result;
+	}, [readDocument]);
+	const downloadDocument = useCallback(async () => {
+		const result = await readDocument(true);
+		if (!("bytesBase64" in result)) throw Errors.invalidInput("documentHash", "invalid document download");
+		return result;
+	}, [readDocument]);
 	const [typed, setTyped] = useState(null);
 	const annotate = useCapxulAnnotateMovement();
 	const saveMemo = useCallback(async () => {
@@ -1229,8 +1255,15 @@ function useActivityDetail(reference, actor) {
 		typed
 	]);
 	return {
-		receiptDocument,
-		openReceiptDocument,
+		...detail.data?.kind === "payment" ? { payment: {
+			status: detail.data.payment.status,
+			...detail.data.payment.execution === void 0 ? {} : { execution: detail.data.payment.execution }
+		} } : {},
+		documents,
+		selectedDocument,
+		selectDocument,
+		renderDocument,
+		downloadDocument,
 		isOpeningDocument,
 		memo: typed ?? detail.data?.annotation?.memo ?? "",
 		setMemo: setTyped,
@@ -1243,6 +1276,7 @@ function useActivityDetail(reference, actor) {
 //#endregion
 //#region src/headless/activity/summary.ts
 const DAY_MS = 864e5;
+const display = (money) => money === null ? null : formatMoney(money);
 /**
 * `"last30days"` is the last 30 whole UTC days including today. Quantizing to
 * the UTC day keeps the cache key stable for a whole day instead of changing on
@@ -1253,57 +1287,6 @@ function resolveWindow(window, now) {
 	if (window === "last30days") return { from: Math.floor(now / DAY_MS) * DAY_MS - 29 * DAY_MS };
 	return window;
 }
-/** An integer raw-unit string lifted into a major-unit decimal string. */
-function majorUnits(raw, decimals) {
-	const negative = raw.startsWith("-");
-	const digits = negative ? raw.slice(1) : raw;
-	const sign = negative ? "-" : "";
-	if (decimals === 0) return `${sign}${digits}`;
-	const padded = digits.padStart(decimals + 1, "0");
-	const cut = padded.length - decimals;
-	return `${sign}${padded.slice(0, cut)}.${padded.slice(cut)}`;
-}
-function absoluteNet(total) {
-	const net = BigInt(total.net);
-	return net < 0n ? -net : net;
-}
-/**
-* Buckets carry different `decimals`, so their raw integers are not comparable.
-* Both are scaled to the wider precision before the magnitudes are ordered.
-*/
-function compareNet(left, right) {
-	const width = Math.max(left.decimals, right.decimals);
-	const scaledLeft = absoluteNet(left) * 10n ** BigInt(width - left.decimals);
-	const scaledRight = absoluteNet(right) * 10n ** BigInt(width - right.decimals);
-	if (scaledLeft === scaledRight) return 0;
-	return scaledLeft < scaledRight ? -1 : 1;
-}
-/**
-* Which currency `.Summary` shows: the bucket matching the primary holding's
-* currency, else the bucket with the largest absolute `net`, breaking a tie on
-* currency code ascending so the choice is stable across reloads.
-*
-* The primary holding is matched on `available.currency` — the consumer
-* `CurrencyCode` — and NOT on `Holding.symbol`, which is the raw token ticker
-* ("USDX") and can never equal a bucket's currency ("USD"). See the contract
-* correction on #1449.
-*/
-function pickBucket(totals, primaryCurrency) {
-	if (primaryCurrency !== null) {
-		const matched = totals.find((total) => total.currency === primaryCurrency);
-		if (matched !== void 0) return matched;
-	}
-	let best = null;
-	for (const total of totals) {
-		if (best === null) {
-			best = total;
-			continue;
-		}
-		const order = compareNet(total, best);
-		if (order > 0 || order === 0 && total.currency < best.currency) best = total;
-	}
-	return best;
-}
 /**
 * The current UTC day number, which advances ON ITS OWN at UTC midnight.
 *
@@ -1347,47 +1330,36 @@ function useActivitySummary(actor, window) {
 			const params = {};
 			if (actor !== void 0) params.actor = actor;
 			if (range !== void 0) params.window = range;
-			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.activity.summary).activity.summary(params));
-		},
-		enabled
-	});
-	const primary = useQuery({
-		queryKey: accountKey([...capxulKeys.holdings(actor), "primary"], identity),
-		queryFn: async () => {
-			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.holdings.primary).holdings.primary(actor === void 0 ? void 0 : { actor }));
+			const result = unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.activity.summary).activity.summary(params));
+			return {
+				...result,
+				valuation: valueActivitySummary(result.totals)
+			};
 		},
 		enabled
 	});
 	const totals = summary.data?.totals;
-	const primaryCurrency = primary.data?.available.currency ?? null;
-	const isLoading = summary.isLoading || primary.isLoading;
-	const bucket = useMemo(() => totals === void 0 || isLoading ? null : pickBucket(totals, primaryCurrency), [
-		isLoading,
-		primaryCurrency,
-		totals
-	]);
-	if (bucket === null) return {
+	const isLoading = summary.isLoading;
+	if (summary.data === void 0 || totals === void 0 || totals.length === 0 || isLoading) return {
 		currency: null,
 		moneyIn: null,
 		moneyOut: null,
 		net: null,
 		pending: null,
+		unrated: [],
 		count: summary.data?.count ?? 0,
 		isLoading,
 		error: asCapxulError$1(summary.error),
 		...summary.data?.readWarning === void 0 ? {} : { readWarning: summary.data.readWarning }
 	};
-	const display = (raw) => formatMoney({
-		currency: bucket.currency,
-		value: majorUnits(raw, bucket.decimals),
-		decimals: bucket.decimals
-	});
+	const valuation = summary.data.valuation;
 	return {
-		currency: bucket.currency,
-		moneyIn: display(bucket.in),
-		moneyOut: display(bucket.out),
-		net: display(bucket.net),
-		pending: display(bucket.pendingIn),
+		currency: valuation.moneyIn?.currency ?? null,
+		moneyIn: display(valuation.moneyIn),
+		moneyOut: display(valuation.moneyOut),
+		net: display(valuation.net),
+		pending: display(valuation.pending),
+		unrated: valuation.unrated,
 		count: summary.data?.count ?? 0,
 		isLoading,
 		error: asCapxulError$1(summary.error),
@@ -1414,7 +1386,7 @@ const SIGN = Object.freeze({
 	self: ""
 });
 function toActivityRow(item, actor) {
-	const amountDisplay = formatMoney(item.amount);
+	const amountDisplay = formatAssetAmount(item.amount);
 	const signedAmountDisplay = `${SIGN[item.direction]}${amountDisplay}`;
 	if (item.kind === "movement") return {
 		kind: "movement",
@@ -1426,32 +1398,37 @@ function toActivityRow(item, actor) {
 		counterpartyLabel: item.counterpartyLabel,
 		amountDisplay,
 		signedAmountDisplay,
-		currency: item.amount.currency,
+		currency: assetSymbolFor(item.amount.asset),
 		createdAt: item.createdAt,
 		classification: item.classification,
 		phase: MOVEMENT_PHASE,
 		receipt: item.receipt
 	};
+	const reference = actor === void 0 ? {
+		kind: "payment",
+		id: item.id
+	} : {
+		kind: "payment",
+		id: item.id,
+		actor
+	};
 	return {
 		kind: "payment",
-		reference: actor === void 0 ? {
-			kind: "payment",
-			id: item.id
-		} : {
-			kind: "payment",
-			id: item.id,
-			actor
-		},
+		...item.execution === void 0 ? {} : { execution: item.execution },
+		reference,
 		direction: item.direction,
 		counterpartyLabel: item.counterpartyLabel,
 		amountDisplay,
 		signedAmountDisplay,
-		currency: item.amount.currency,
+		currency: assetSymbolFor(item.amount.asset),
 		createdAt: item.createdAt,
 		ledgerKind: item.ledgerKind,
 		paymentType: item.paymentType,
 		status: item.status,
-		phase: paymentPhase(item.status),
+		phase: item.execution?.notSent ? {
+			...paymentPhase(item.status),
+			needsAction: item.direction !== "in"
+		} : paymentPhase(item.status),
 		receipt: item.receipt
 	};
 }
@@ -1524,8 +1501,8 @@ function buildCsv(items, actor, search) {
 			row.counterpartyLabel,
 			row.direction,
 			item.amount.value,
-			item.amount.currency,
-			row.kind === "payment" ? row.status : "",
+			assetSymbolFor(item.amount.asset),
+			row.kind === "payment" ? row.execution?.notSent ? "not_sent" : row.execution?.status === "unresolved" ? "verifying" : row.status : "",
 			row.reference.id,
 			row.receipt?.transactionHash ?? ""
 		]));
@@ -1642,6 +1619,16 @@ function useActivity(input) {
 		searchText
 	]);
 	const { fetchNextPage, hasNextPage, isFetchingNextPage, refetch } = query;
+	const emptyContinuation = pages?.at(-1)?.items.length === 0 && hasNextPage && query.error === null;
+	useEffect(() => {
+		if (enabled && emptyContinuation && !isFetchingNextPage) fetchNextPage();
+	}, [
+		enabled,
+		emptyContinuation,
+		fetchNextPage,
+		isFetchingNextPage,
+		pages
+	]);
 	const pagingRef = useRef({
 		fetchNextPage,
 		hasNextPage,
@@ -1744,7 +1731,7 @@ function useActivity(input) {
 		},
 		rows: {
 			rows,
-			isLoading: query.isLoading,
+			isLoading: query.isLoading || rows.length === 0 && emptyContinuation,
 			error: asCapxulError$1(query.error),
 			retry,
 			observedAt: pages === void 0 ? null : pages[pages.length - 1]?.observedAt ?? null,
@@ -1770,7 +1757,7 @@ function useActivityContext() {
 	if (engine === null) throw new Error("CapxulActivity parts must be used inside <CapxulActivity>");
 	return engine;
 }
-function Root$5({ actor, pageSize, children }) {
+function Root$6({ actor, pageSize, children }) {
 	const engine = useActivity({
 		...actor === void 0 ? {} : { actor },
 		...pageSize === void 0 ? {} : { pageSize }
@@ -1821,7 +1808,7 @@ function Export({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useActivityContext().csv) });
 }
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-const CapxulActivity = Object.assign(Root$5, {
+const CapxulActivity = Object.assign(Root$6, {
 	Summary: Summary$2,
 	Filters,
 	Search,
@@ -1862,6 +1849,26 @@ function useOrgMeReading(orgId) {
 	]);
 }
 //#endregion
+//#region src/internal/write-names-asset.ts
+/**
+* Identity law: "A payment names an asset or inherits it from an authorized
+* fact. Missing asset refuses." The rule was recorded in the retired
+* treasury-cut handoff (removed from the current tree by the exact-asset
+* contraction; its record survives in Git history).
+*
+* A Capxul payment writer takes `PaymentMoney` — a peg currency, a value and
+* `decimals` — and settles one fixed legacy token. No `AssetId` crosses that
+* seam, so a payment composed from a named position cannot name the asset it
+* moves: a position selected as USDT authorizes a different token.
+*
+* `false` until the writer takes the command's asset. The Send and Payroll
+* composers read this to refuse a submission rather than authorize a token the
+* person did not pick.
+*/
+function writeNamesAsset() {
+	return false;
+}
+//#endregion
 //#region src/headless/send-money/signer-status.ts
 const NO_SUBSCRIPTION = () => () => {};
 function useSignerStatus(client) {
@@ -2011,6 +2018,37 @@ function useSelectedOption(options) {
 	}, [options]);
 	return [options.find((option) => option.id === selectedId) ?? null, select];
 }
+/**
+* One Send `.Asset` option per position the Account holds, taken from
+* `account.balances` — never from `account.available`, which is the Account's
+* fiat VALUATION of those positions (ADR-0028 R5/R6). Labelling the valuation
+* was the false identity this cut removes, and it collapsed USDC+USDT into one
+* "USD" row.
+*
+* The option is keyed on the ASSET id, never the symbol and never the account:
+* several positions share one account id, and a symbol is display only
+* (ADR-0028 R3). Every row is listed, so a real multi-position Account still
+* offers its holdings.
+*/
+function assetSelectionsFromAccount$1(account) {
+	if (account === null) return [];
+	return account.balances.map((position) => {
+		return {
+			option: {
+				id: position.asset,
+				symbol: position.symbol,
+				availableDisplay: formatAssetAmount({
+					asset: position.asset,
+					value: position.available
+				})
+			},
+			money: {
+				asset: position.asset,
+				value: position.available
+			}
+		};
+	});
+}
 function useSendMoney(input) {
 	const { actor, onSent, onFailed } = input;
 	const client = useCapxulClientOrNull();
@@ -2023,15 +2061,12 @@ function useSendMoney(input) {
 	const treasury = useCapxulOrgTreasury(orgId, { enabled: actor.kind === "organization" });
 	const accountQuery = actor.kind === "personal" ? balance : treasury;
 	const account = accountQuery.data ?? null;
-	const assetOptions = useMemo(() => account === null ? [] : [{
-		id: account.id,
-		symbol: account.available.currency,
-		availableDisplay: formatMoney(account.available, { grammar: "code" })
-	}], [account]);
+	const assetSelections = useMemo(() => assetSelectionsFromAccount$1(account), [account]);
+	const assetOptions = useMemo(() => assetSelections.map((selection) => selection.option), [assetSelections]);
 	const [selectedAssetOption, selectAsset] = useSelectedOption(assetOptions);
-	const selectedAssetMoney = selectedAssetOption !== null && account !== null ? account.available : null;
+	const selectedAssetMoney = useMemo(() => assetSelections.find((selection) => selection.option.id === selectedAssetOption?.id)?.money ?? null, [assetSelections, selectedAssetOption]);
 	const [amountText, setAmountText] = useState("");
-	const parsed = useMemo(() => selectedAssetMoney === null || amountText.trim() === "" ? null : parseMoney(amountText, selectedAssetMoney), [amountText, selectedAssetMoney]);
+	const parsed = useMemo(() => selectedAssetMoney === null || amountText.trim() === "" ? null : parseAssetAmount(amountText, requireAsset(selectedAssetMoney.asset)), [amountText, selectedAssetMoney]);
 	const parsedMoney = parsed !== null && !isMoneyParseError(parsed) ? parsed : null;
 	const amountError = parsed !== null && isMoneyParseError(parsed) ? parsed.reason : null;
 	const recipient = useRecipientResolution(client, JSON.stringify([
@@ -2043,7 +2078,7 @@ function useSendMoney(input) {
 	const personalPay = useCapxulPay();
 	const organizationPay = useCapxulOrganizationPay(orgId);
 	const pay = actor.kind === "personal" ? personalPay : organizationPay;
-	const blockedReason = signerStatus !== "ready" ? "signer-not-ready" : actor.kind === "organization" && selectedSource === null ? "no-source" : selectedAssetOption === null ? "no-asset" : parsedMoney === null ? "amount-invalid" : resolvedReference === null ? "recipient-unresolved" : null;
+	const blockedReason = signerStatus !== "ready" ? "signer-not-ready" : actor.kind === "organization" && selectedSource === null ? "no-source" : selectedAssetOption === null ? "no-asset" : parsedMoney === null ? "amount-invalid" : resolvedReference === null ? "recipient-unresolved" : writeNamesAsset() ? null : "asset-unnamed";
 	const submitGate = useRef(false);
 	const submit = useCallback(() => {
 		if (blockedReason !== null || submitGate.current) return;
@@ -2130,7 +2165,7 @@ function useSendMoneyContext() {
 	if (engine === null) throw new Error("CapxulSendMoney parts must be used inside <CapxulSendMoney>");
 	return engine;
 }
-function Root$4({ actor, onSent, onFailed, children }) {
+function Root$5({ actor, onSent, onFailed, children }) {
 	const engine = useSendMoney({
 		actor,
 		onSent,
@@ -2157,7 +2192,7 @@ function Actions$1({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().actions) });
 }
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-const CapxulSendMoney = Object.assign(Root$4, {
+const CapxulSendMoney = Object.assign(Root$5, {
 	Source,
 	Asset: Asset$1,
 	Amount,
@@ -2247,7 +2282,7 @@ function useOrgMemberContext() {
 	if (state === null) throw new Error("CapxulOrgMember parts must be used inside <CapxulOrgMember>");
 	return state;
 }
-function Root$3({ orgId, children }) {
+function Root$4({ orgId, children }) {
 	const state = useOrgMember(orgId);
 	return /* @__PURE__ */ jsx(OrgMemberContext.Provider, {
 		value: state,
@@ -2267,7 +2302,7 @@ function Standing({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useOrgMemberContext().standing) });
 }
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-const CapxulOrgMember = Object.assign(Root$3, {
+const CapxulOrgMember = Object.assign(Root$4, {
 	Can,
 	Standing
 });
@@ -2427,7 +2462,7 @@ function usePart(phase) {
 	}, [placed, phase]);
 	return state.phase === phase ? state : null;
 }
-function Root$2({ scope, children }) {
+function Root$3({ scope, children }) {
 	const state = useDashboardAccess(scope);
 	const [placed] = useState(() => /* @__PURE__ */ new Set());
 	const value = useMemo(() => ({
@@ -2445,7 +2480,7 @@ function Root$2({ scope, children }) {
 	});
 }
 /** Hands nothing — today's app renders `null` here, exactly as it does now. */
-function Checking({ children }) {
+function Checking$1({ children }) {
 	return usePart("checking") === null ? null : /* @__PURE__ */ jsx(Fragment, { children });
 }
 function DashboardError({ children }) {
@@ -2472,19 +2507,14 @@ function Granted({ children }) {
 	return usePart("granted") === null ? null : /* @__PURE__ */ jsx(Fragment, { children });
 }
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-const CapxulDashboardAccess = Object.assign(Root$2, {
-	Checking,
+const CapxulDashboardAccess = Object.assign(Root$3, {
+	Checking: Checking$1,
 	Error: DashboardError,
 	Redirect,
 	Granted
 });
 //#endregion
 //#region src/headless/payroll/money.ts
-/** `{ value: "12.34", decimals: 6 }` → `12340000n`. */
-function toMinorUnits(money) {
-	const [whole = "0", fraction = ""] = money.value.split(".");
-	return BigInt(`${whole}${fraction.padEnd(money.decimals, "0")}`);
-}
 const TYPED_AMOUNT = /^(-?)(\d+)(?:\.(\d+))?$/;
 /**
 * Σ of the employer's TYPED amounts on a saved group — a DISPLAY total.
@@ -2517,6 +2547,17 @@ function fromMinorUnits(raw, asset) {
 		decimals: asset.decimals
 	};
 }
+/** Convert exact raw units to one asset quantity without a fiat denomination. */
+function assetFromMinorUnits(raw, asset) {
+	const money = fromMinorUnits(raw, {
+		currency: "USD",
+		decimals: asset.decimals
+	});
+	return {
+		asset: asset.asset,
+		value: money.value
+	};
+}
 //#endregion
 //#region src/headless/payroll/reads.ts
 function toRecipientOption(entry) {
@@ -2633,7 +2674,7 @@ function scopedClient(client, method, orgId) {
 //#endregion
 //#region src/headless/payroll/use-payroll.ts
 /** Money reads the same way everywhere on this screen: amount then code. */
-const GRAMMAR$1 = { grammar: "code" };
+const GRAMMAR = { grammar: "code" };
 /**
 * One captured snapshot, or nothing — never a fabricated empty options object,
 * and never a DOM event a screen wired straight to `onClick`.
@@ -2649,7 +2690,7 @@ function toPayrollGroupRow(group) {
 		name: group.name,
 		tone: group.tone,
 		memberCount: group.members.length,
-		totalDisplay: currency === void 0 ? "" : formatMoney(sumTypedAmounts(group.members.map((member) => member.amount), currency), GRAMMAR$1),
+		totalDisplay: currency === void 0 ? "" : formatMoney(sumTypedAmounts(group.members.map((member) => member.amount), currency), GRAMMAR),
 		members: group.members.map((member) => ({
 			recipientId: member.partyId,
 			amount: member.amount,
@@ -2739,8 +2780,8 @@ function usePayroll(orgId) {
 	const started = orgId !== void 0;
 	return {
 		summary: {
-			walletBalanceDisplay: treasury.data === void 0 ? null : formatMoney(treasury.data.available, GRAMMAR$1),
-			paidThisMonthDisplay: runs.data === void 0 ? null : formatMoney(runs.data.settledThisMonth, GRAMMAR$1),
+			walletBalanceDisplay: treasury.data?.available === void 0 || treasury.data.available === null ? null : formatMoney(treasury.data.available, GRAMMAR),
+			paidThisMonthDisplay: runs.data === void 0 ? null : runs.data.settledThisMonth.map(formatAssetAmount).join(", "),
 			isLoading: started && (treasury.data === void 0 && treasury.error === null || runs.data === void 0 && runs.error === null),
 			error: treasury.error ?? runs.error
 		},
@@ -2773,7 +2814,7 @@ function usePayrollContext() {
 	if (engine === null) throw new Error("CapxulPayroll parts must be used inside <CapxulPayroll>");
 	return engine;
 }
-function Root$1({ orgId, children }) {
+function Root$2({ orgId, children }) {
 	const engine = usePayroll(orgId);
 	return /* @__PURE__ */ jsx(PayrollContext.Provider, {
 		value: engine,
@@ -2791,7 +2832,7 @@ function Groups({ children }) {
 * There is NO `.Runs` part (ruling Q6): no shipped region has the right shape
 * for a run list, and a part without a production caller may not ship.
 */
-const CapxulPayroll = Object.assign(Root$1, {
+const CapxulPayroll = Object.assign(Root$2, {
 	Summary: Summary$1,
 	Groups
 });
@@ -2801,8 +2842,14 @@ function record(value) {
 	if (typeof value !== "object" || value === null || Array.isArray(value)) throw Errors.invalidInput("payrollDraft", "Invalid run draft");
 	return value;
 }
+/**
+* A draft-scoped opaque key. `/` is in the class so `asset.id` can be the
+* canonical CAIP-19 `AssetId` (`eip155:<chainId>/erc20:<address>`): the draft
+* records WHICH asset was authorized, and a symbol is not an identity
+* (ADR-0028 R3). The field never reaches the backend — only `input` is sent.
+*/
 function identifier(value) {
-	if (typeof value !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u.test(value)) throw Errors.invalidInput("payrollDraft", "Invalid draft identifier");
+	if (typeof value !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/u.test(value)) throw Errors.invalidInput("payrollDraft", "Invalid draft identifier");
 	return value;
 }
 function minorAmount(value) {
@@ -2818,8 +2865,9 @@ function decodeDraft(value, scope) {
 	const items = input.items.map((raw) => {
 		const item = record(raw);
 		const to = record(item.to);
+		const amount = record(item.amount);
 		const partyId = toPartyId(identifier(item.partyId));
-		if (to.kind !== "party" || to.partyId !== partyId || item.gross !== item.net || !Array.isArray(item.adjustments) || item.adjustments.length !== 0) throw Errors.invalidInput("payrollDraft", "Invalid draft recipient");
+		if (to.kind !== "party" || to.partyId !== partyId || item.gross !== item.net || typeof amount.asset !== "string" || typeof amount.value !== "string" || typeof item.currency !== "string" || typeof item.decimals !== "number" || !Number.isInteger(item.decimals) || !Array.isArray(item.adjustments) || item.adjustments.length !== 0) throw Errors.invalidInput("payrollDraft", "Invalid draft recipient");
 		const net = minorAmount(item.net);
 		return {
 			to: {
@@ -2827,12 +2875,20 @@ function decodeDraft(value, scope) {
 				partyId
 			},
 			partyId,
+			amount: {
+				asset: requireAsset(amount.asset).assetId,
+				value: amount.value
+			},
 			gross: net,
 			net,
+			currency: item.currency,
+			decimals: item.decimals,
 			adjustments: []
 		};
 	});
 	if (new Set(items.map((item) => item.partyId)).size !== items.length) throw Errors.invalidInput("payrollDraft", "Duplicate draft recipient");
+	const exactAsset = requireAsset(identifier(asset.id));
+	if (items.some((item) => item.amount.asset !== exactAsset.assetId)) throw Errors.invalidInput("payrollDraft", "Draft item asset does not match the run asset");
 	return {
 		version: 1,
 		scope,
@@ -2843,6 +2899,7 @@ function decodeDraft(value, scope) {
 		},
 		input: {
 			permissionId: identifier(input.permissionId),
+			asset: exactAsset.assetId,
 			period: {
 				start: period.start,
 				end: period.start
@@ -3046,7 +3103,6 @@ function termsSeeds(terms, asset, period) {
 }
 //#endregion
 //#region src/headless/payroll/use-payroll-run.ts
-const GRAMMAR = { grammar: "code" };
 /**
 * The period this composer composes: an INSTANT run (ruling Q3). `authorizeRun`
 * stamps `start === end === runAt` at submit, and the payslip's period renders
@@ -3070,6 +3126,32 @@ const INSTANT_RUN_PERIOD = {
 function amountText(amounts, seeds, recipientId) {
 	return amounts[recipientId]?.value ?? seeds.get(recipientId) ?? "";
 }
+function freshRunItems(input) {
+	const items = [];
+	for (const [index, recipientId] of input.selected.entries()) {
+		const to = input.payableRefs[index];
+		const amount = input.amounts[index];
+		const terms = input.compensationTerms.get(recipientId);
+		if (to === void 0 || amount === void 0 || terms === void 0) throw Errors.unknown();
+		items.push({
+			to: {
+				kind: "party",
+				partyId: toPartyId(recipientId)
+			},
+			partyId: recipientId,
+			amount,
+			gross: terms.rate,
+			net: terms.rate,
+			currency: terms.currency,
+			decimals: terms.decimals,
+			adjustments: []
+		});
+	}
+	return items;
+}
+function hasRequiredCompensation(frozen, writerNamesSelectedAsset, selected, terms) {
+	return frozen || !writerNamesSelectedAsset || selected.every((recipientId) => terms.has(recipientId));
+}
 /**
 * WHICH run the composer is composing, by MEANING rather than by object shape.
 *
@@ -3101,6 +3183,33 @@ function initialAmounts(prefill) {
 	};
 	return seeded;
 }
+/**
+* One `.Asset` option per position the treasury Account holds, taken from
+* `account.balances` — never from `account.available`, which is the Account's
+* fiat VALUATION of those positions (ADR-0028 R5/R6). The option is keyed on
+* the ASSET id: several positions share one account id, and a symbol is display
+* only (ADR-0028 R3). Every row is listed, so a real multi-position treasury
+* still offers its holdings.
+*/
+function assetSelectionsFromAccount(account) {
+	if (account === null) return [];
+	return account.balances.map((position) => {
+		return {
+			option: {
+				id: position.asset,
+				symbol: position.symbol,
+				availableDisplay: formatAssetAmount({
+					asset: position.asset,
+					value: position.available
+				})
+			},
+			money: {
+				asset: position.asset,
+				value: position.available
+			}
+		};
+	});
+}
 function usePayrollRun(input) {
 	const { orgId, prefill, onRun, onFailed } = input;
 	const client = useCapxulClientOrNull();
@@ -3114,17 +3223,13 @@ function usePayrollRun(input) {
 	const terms = useOrgTerms(orgId);
 	const [selected, setSelected] = useState(() => prefill?.recipientIds ?? []);
 	const [amounts, setAmounts] = useState(() => initialAmounts(prefill));
-	const restoreCurrency = treasury.data?.available.currency;
 	const { draftScope, currentScope, draft, draftError, restorationPending, activateDraft, restoreDraft, setDraft, recovery, draftBlocked } = useRunDraft(client, orgId, useCallback((restored) => {
 		setSelected(restored.input.items.map((item) => item.partyId));
-		if (restoreCurrency !== void 0 && restoreCurrency === restored.asset.currency) setAmounts(Object.fromEntries(restored.input.items.map((item) => [item.partyId, {
-			value: fromMinorUnits(BigInt(item.net), {
-				currency: restoreCurrency,
-				decimals: restored.asset.decimals
-			}).value,
+		if (requireAsset(restored.input.asset).assetId === restored.input.asset) setAmounts(Object.fromEntries(restored.input.items.map((item) => [item.partyId, {
+			value: item.amount.value,
 			prefilled: false
 		}])));
-	}, [restoreCurrency]));
+	}, []));
 	const frozen = draft !== null;
 	const composerKey = composerIdentity(orgId, prefill, draftScope, frozen);
 	const [seededKey, setSeededKey] = useState(composerKey);
@@ -3164,11 +3269,8 @@ function usePayrollRun(input) {
 		draftError
 	]);
 	const account = treasury.data ?? null;
-	const assetOptions = useMemo(() => account === null ? [] : [{
-		id: account.id,
-		symbol: account.available.currency,
-		availableDisplay: formatMoney(account.available, GRAMMAR)
-	}], [account]);
+	const assetSelections = useMemo(() => assetSelectionsFromAccount(account), [account]);
+	const assetOptions = useMemo(() => assetSelections.map((selection) => selection.option), [assetSelections]);
 	const [selectedAssetId, setSelectedAssetId] = useState(null);
 	useEffect(() => {
 		if (!assetOptions.some((option) => option.id === selectedAssetId)) setSelectedAssetId(assetOptions[0]?.id ?? null);
@@ -3177,7 +3279,7 @@ function usePayrollRun(input) {
 	const selectAsset = useCallback((id) => {
 		if (!submitGate.current && !frozen) setSelectedAssetId((current) => assetOptions.some((option) => option.id === id) ? id : current);
 	}, [assetOptions, frozen]);
-	const assetMoney = selectedAsset !== null && account !== null ? account.available : null;
+	const assetMoney = assetSelections.find((selection) => selection.option.id === selectedAsset?.id)?.money ?? null;
 	const named = useMemo(() => new Map(roster.options.map((option) => [option.id, option])), [roster.options]);
 	const refs = roster.refs;
 	const payableRefs = useMemo(() => {
@@ -3189,12 +3291,19 @@ function usePayrollRun(input) {
 		}
 		return resolved;
 	}, [refs, selected]);
-	const seeds = useMemo(() => termsSeeds(terms.data ?? [], assetMoney, INSTANT_RUN_PERIOD), [assetMoney, terms.data]);
+	const seeds = useMemo(() => {
+		if (assetMoney === null) return /* @__PURE__ */ new Map();
+		const metadata = requireAsset(assetMoney.asset);
+		return termsSeeds(terms.data ?? [], metadata.peg === null ? null : {
+			currency: metadata.peg,
+			decimals: metadata.decimals
+		}, INSTANT_RUN_PERIOD);
+	}, [assetMoney, terms.data]);
 	const entries = useMemo(() => {
 		if (assetMoney === null) return [];
 		return selected.map((recipientId) => {
 			const value = amountText(amounts, seeds, recipientId);
-			const parsed = value.trim() === "" ? null : parseMoney(value, assetMoney);
+			const parsed = value.trim() === "" ? null : parseAssetAmount(value, requireAsset(assetMoney.asset));
 			return {
 				recipientId,
 				name: named.get(recipientId)?.name ?? recipientId,
@@ -3202,7 +3311,7 @@ function usePayrollRun(input) {
 				change: (text) => change(recipientId, text),
 				error: parsed !== null && isMoneyParseError(parsed) ? parsed.reason : null,
 				prefilled: amounts[recipientId]?.prefilled ?? seeds.has(recipientId),
-				currency: assetMoney.currency
+				currency: requireAsset(assetMoney.asset).symbol
 			};
 		});
 	}, [
@@ -3217,7 +3326,7 @@ function usePayrollRun(input) {
 		if (assetMoney === null || selected.length === 0) return null;
 		const money = [];
 		for (const recipientId of selected) {
-			const parsed = parseMoney(amountText(amounts, seeds, recipientId), assetMoney);
+			const parsed = parseAssetAmount(amountText(amounts, seeds, recipientId), requireAsset(assetMoney.asset));
 			if (isMoneyParseError(parsed)) return null;
 			money.push(parsed);
 		}
@@ -3228,16 +3337,25 @@ function usePayrollRun(input) {
 		seeds,
 		selected
 	]);
-	const total = useMemo(() => parsedAmounts === null || assetMoney === null ? null : fromMinorUnits(parsedAmounts.reduce((sum, money) => sum + toMinorUnits(money), 0n), assetMoney), [assetMoney, parsedAmounts]);
-	const availableRaw = assetMoney === null ? null : toMinorUnits(assetMoney);
-	const totalRaw = total === null ? null : toMinorUnits(total);
+	const total = useMemo(() => parsedAmounts === null || assetMoney === null ? null : {
+		asset: assetMoney.asset,
+		value: assetFromMinorUnits(parsedAmounts.reduce((sum, amount) => sum + toRaw(amount, requireAsset(amount.asset)), 0n), {
+			asset: assetMoney.asset,
+			decimals: requireAsset(assetMoney.asset).decimals
+		}).value
+	}, [assetMoney, parsedAmounts]);
+	const availableRaw = assetMoney === null ? null : toRaw(assetMoney, requireAsset(assetMoney.asset));
+	const totalRaw = total === null ? null : toRaw(total, requireAsset(total.asset));
 	const funds = availableRaw === null || totalRaw === null ? "unknown" : totalRaw > availableRaw ? "insufficient" : "available";
 	const budgets = me.data?.budgets ?? [];
+	const compensationTerms = useMemo(() => new Map((terms.data ?? []).filter((row) => row.unit === "paycheck" && /^[1-9][0-9]*$/u.test(row.rate)).map((row) => [row.partyId, row])), [terms.data]);
+	const writerNamesSelectedAsset = writeNamesAsset();
 	const blockedReason = firstFalseFact({
 		signerReady: signerStatus === "ready",
 		...runAuthorityFacts(draft, budgets, selectedAsset, assetMoney, funds),
 		recipientCount: payableRefs === null ? 0 : selected.length,
-		amountsParse: total !== null
+		amountsParse: total !== null && hasRequiredCompensation(frozen, writerNamesSelectedAsset, selected, compensationTerms),
+		writeNamesAsset: writerNamesSelectedAsset
 	});
 	const authorize = useMutation({
 		mutationFn: async ({ candidate, options }) => {
@@ -3259,7 +3377,7 @@ function usePayrollRun(input) {
 			if (candidate.scope === currentScope.current) restoreDraft(candidate.scope);
 		}
 	});
-	const totalDisplay = total === null ? null : formatMoney(total, GRAMMAR);
+	const totalDisplay = total === null ? null : formatAssetAmount(total);
 	const authorizeMutate = authorize.mutate;
 	const submit = useCallback((options) => {
 		const attempt = toInvocationOptions(options);
@@ -3268,41 +3386,35 @@ function usePayrollRun(input) {
 		if (permissionId === void 0 || totalDisplay === null || parsedAmounts === null) return;
 		if (payableRefs === null) return;
 		const recipientCount = selected.length;
-		const items = [];
-		for (const [index, recipientId] of selected.entries()) {
-			const to = payableRefs[index];
-			const parsed = parsedAmounts[index];
-			if (to === void 0 || parsed === void 0) return;
-			const raw = toMinorUnits(parsed).toString();
-			items.push({
-				to: {
-					kind: "party",
-					partyId: toPartyId(recipientId)
-				},
-				partyId: recipientId,
-				gross: raw,
-				net: raw,
-				adjustments: []
+		let candidate;
+		if (frozen) candidate = draft;
+		else {
+			const items = freshRunItems({
+				selected,
+				payableRefs,
+				amounts: parsedAmounts,
+				compensationTerms
 			});
-		}
-		const runAt = Date.now();
-		const candidate = frozen ? draft : {
-			version: 1,
-			scope: draftScope,
-			asset: {
-				id: selectedAsset.id,
-				currency: assetMoney.currency,
-				decimals: assetMoney.decimals
-			},
-			input: {
-				permissionId,
-				period: {
-					start: runAt,
-					end: runAt
+			const runAt = Date.now();
+			candidate = {
+				version: 1,
+				scope: draftScope,
+				asset: {
+					id: selectedAsset.id,
+					currency: requireAsset(assetMoney.asset).symbol,
+					decimals: requireAsset(assetMoney.asset).decimals
 				},
-				items
-			}
-		};
+				input: {
+					permissionId,
+					asset: selectedAsset.id,
+					period: {
+						start: runAt,
+						end: runAt
+					},
+					items
+				}
+			};
+		}
 		submitGate.current = true;
 		authorizeMutate({
 			candidate,
@@ -3334,6 +3446,7 @@ function usePayrollRun(input) {
 		selectedAsset,
 		blockedReason,
 		budgets,
+		compensationTerms,
 		onFailed,
 		onRun,
 		parsedAmounts,
@@ -3382,18 +3495,25 @@ function usePayrollRun(input) {
 	};
 }
 function remainingBalanceDisplay(available, total, asset) {
-	return available === null || total === null || asset === null ? null : formatMoney(fromMinorUnits(available - total, asset), GRAMMAR);
+	if (available === null || total === null || asset === null) return null;
+	const remaining = available - total;
+	const magnitude = remaining < 0n ? -remaining : remaining;
+	const formatted = formatAssetAmount(assetFromMinorUnits(magnitude, {
+		asset: asset.asset,
+		decimals: requireAsset(asset.asset).decimals
+	}));
+	return remaining < 0n ? `-${formatted}` : formatted;
 }
 /** Persisted replay keeps its authorized Budget and asset; a prior debit cannot block its own recovery. */
 function runAuthorityFacts(draft, budgets, asset, money, funds) {
 	return {
 		budgetCount: draft !== null && !budgets.some((budget) => budget.id === draft.input.permissionId) ? 0 : budgets.length,
-		hasAsset: asset !== null && (draft === null || draft.asset.id === asset.id && draft.asset.currency === money?.currency && draft.asset.decimals === money?.decimals),
+		hasAsset: asset !== null && (draft === null || draft.asset.id === asset.id && draft.input.asset === money?.asset),
 		funds: draft?.input.requestKey === void 0 ? funds : "available"
 	};
 }
 /**
-* The seven facts, in the ONE order the contract fixes. Exactly one code comes
+* The facts, in the ONE order the contract fixes. Exactly one code comes
 * out, and it is always the first thing that is false — so two problems never
 * race to name the button.
 */
@@ -3404,7 +3524,8 @@ function firstFalseFact(facts) {
 	if (!facts.hasAsset) return "no-asset";
 	if (facts.recipientCount === 0) return "no-recipients";
 	if (!facts.amountsParse) return "amount-invalid";
-	return facts.funds === "insufficient" ? "insufficient-funds" : null;
+	if (facts.funds === "insufficient") return "insufficient-funds";
+	return facts.writeNamesAsset ? null : "asset-unnamed";
 }
 //#endregion
 //#region src/headless/payroll/payroll-run.tsx
@@ -3414,7 +3535,7 @@ function usePayrollRunContext() {
 	if (engine === null) throw new Error("CapxulPayrollRun parts must be used inside <CapxulPayrollRun>");
 	return engine;
 }
-function Root({ orgId, prefill, onRun, onFailed, children }) {
+function Root$1({ orgId, prefill, onRun, onFailed, children }) {
 	const engine = usePayrollRun({
 		orgId,
 		prefill,
@@ -3444,7 +3565,7 @@ function Actions({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(engine.actions) });
 }
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-const CapxulPayrollRun = Object.assign(Root, {
+const CapxulPayrollRun = Object.assign(Root$1, {
 	Recipients,
 	Amounts,
 	Asset,
@@ -3452,4 +3573,230 @@ const CapxulPayrollRun = Object.assign(Root, {
 	Actions
 });
 //#endregion
-export { CapxulActivity, CapxulAuthenticationController, CapxulContacts, CapxulDashboardAccess, CapxulOnboardingController, CapxulOrgMember, CapxulPayroll, CapxulPayrollRun, CapxulProvider, CapxulSendMoney, acknowledgeOnboardingDestination, activeOnboardingRecovery, capxulKeys, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, isClaimed, isRestoring, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHandleAvailability, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUploadImage };
+//#region src/headless/client-connection/use-client-connection.ts
+function useClientConnection(input) {
+	const [view, setView] = useState(null);
+	const [pending, setPending] = useState(false);
+	const [error, setError] = useState(null);
+	const [resendReady, setResendReady] = useState(false);
+	const identityRef = useRef({
+		client: input.client,
+		requestId: input.requestId
+	});
+	identityRef.current = {
+		client: input.client,
+		requestId: input.requestId
+	};
+	const belongsHere = useCallback((client, requestId) => identityRef.current.client === client && identityRef.current.requestId === requestId, []);
+	const refresh = useCallback(async (signal) => {
+		const { client, requestId } = identityRef.current;
+		const result = await client.auth.clientRequests.read({ requestId }, signal === void 0 ? void 0 : { signal });
+		if (signal?.aborted || !belongsHere(client, requestId)) return;
+		if (result.ok) {
+			setView(result.value);
+			setError(null);
+			return;
+		}
+		setError(result.error);
+	}, [belongsHere]);
+	useEffect(() => {
+		setView(null);
+		setError(null);
+		setPending(false);
+		setResendReady(false);
+		const controller = new AbortController();
+		refresh(controller.signal);
+		return () => {
+			controller.abort();
+		};
+	}, [
+		input.client,
+		input.requestId,
+		refresh
+	]);
+	useEffect(() => {
+		if (view?.phase !== "otp_required") {
+			setResendReady(false);
+			return;
+		}
+		const remaining = view.resendAt - Date.now();
+		if (remaining <= 0) {
+			setResendReady(true);
+			return;
+		}
+		setResendReady(false);
+		const timer = setTimeout(() => setResendReady(true), remaining);
+		return () => clearTimeout(timer);
+	}, [view]);
+	const run = useCallback(async (work) => {
+		const { client, requestId } = identityRef.current;
+		setPending(true);
+		try {
+			const result = await work();
+			if (!belongsHere(client, requestId)) return;
+			if (!result.ok) {
+				setError(result.error);
+				return;
+			}
+			await refresh();
+		} finally {
+			if (belongsHere(client, requestId)) setPending(false);
+		}
+	}, [belongsHere, refresh]);
+	return useMemo(() => {
+		if (error !== null && (view === null || view.phase !== "refused")) return {
+			phase: "failure",
+			otp: null,
+			consent: null,
+			complete: null,
+			failure: {
+				code: error.code,
+				retry: () => refresh(),
+				cancel: async () => {
+					if (view === null) return;
+					const { client, requestId } = identityRef.current;
+					await run(() => client.auth.clientRequests.cancel({
+						requestId,
+						revision: view.revision
+					}));
+				}
+			}
+		};
+		if (view === null) return {
+			phase: "checking",
+			otp: null,
+			consent: null,
+			complete: null,
+			failure: null
+		};
+		if (view.phase === "otp_required") return {
+			phase: view.phase,
+			otp: {
+				email: view.email,
+				pending,
+				canResend: resendReady,
+				verifyCode: async (code) => {
+					const { client, requestId } = identityRef.current;
+					await run(() => client.auth.clientRequests.verifyOtp({
+						requestId,
+						code
+					}));
+				},
+				resend: async () => {
+					const { client, requestId } = identityRef.current;
+					await run(() => client.auth.clientRequests.sendOtp({ requestId }));
+				}
+			},
+			consent: null,
+			complete: null,
+			failure: null
+		};
+		if (view.phase === "review") return {
+			phase: view.phase,
+			otp: null,
+			consent: {
+				verifiedEmail: view.email,
+				clientLabel: view.clientLabel,
+				scopeCodes: view.scopes,
+				purpose: view.intent.mode,
+				setupState: view.setupState,
+				pending,
+				accept: async () => {
+					const { client, requestId } = identityRef.current;
+					await run(() => client.auth.clientRequests.accept({
+						requestId,
+						revision: view.revision
+					}));
+				},
+				cancel: async () => {
+					const { client, requestId } = identityRef.current;
+					await run(() => client.auth.clientRequests.cancel({
+						requestId,
+						revision: view.revision
+					}));
+				}
+			},
+			complete: null,
+			failure: null
+		};
+		if (view.phase === "connected") return {
+			phase: view.phase,
+			otp: null,
+			consent: null,
+			complete: { outcome: "connected" },
+			failure: null
+		};
+		if (view.phase === "refused") return {
+			phase: view.phase,
+			otp: null,
+			consent: null,
+			complete: null,
+			failure: {
+				code: view.code,
+				...view.field === void 0 ? {} : { field: view.field },
+				retry: () => refresh(),
+				cancel: async () => void 0
+			}
+		};
+		return {
+			phase: view.phase,
+			otp: null,
+			consent: null,
+			complete: null,
+			failure: null
+		};
+	}, [
+		error,
+		pending,
+		refresh,
+		resendReady,
+		run,
+		view
+	]);
+}
+//#endregion
+//#region src/headless/client-connection/client-connection.tsx
+const ConnectionContext = createContext(null);
+function useConnection() {
+	const engine = useContext(ConnectionContext);
+	if (engine === null) throw new Error("CapxulClientConnection parts must be used inside <CapxulClientConnection>");
+	return engine;
+}
+function Root({ client, requestId, children }) {
+	const engine = useClientConnection({
+		client,
+		requestId
+	});
+	return /* @__PURE__ */ jsx(ConnectionContext.Provider, {
+		value: engine,
+		children
+	});
+}
+function Checking({ children }) {
+	return useConnection().phase === "checking" ? /* @__PURE__ */ jsx(Fragment, { children }) : null;
+}
+function Otp({ children }) {
+	const otp = useConnection().otp;
+	return otp === null ? null : /* @__PURE__ */ jsx(Fragment, { children: children(otp) });
+}
+function Consent({ children }) {
+	const consent = useConnection().consent;
+	return consent === null ? null : /* @__PURE__ */ jsx(Fragment, { children: children(consent) });
+}
+function Complete({ children }) {
+	const complete = useConnection().complete;
+	return complete === null ? null : /* @__PURE__ */ jsx(Fragment, { children: children(complete) });
+}
+function Failure({ children }) {
+	const failure = useConnection().failure;
+	return failure === null ? null : /* @__PURE__ */ jsx(Fragment, { children: children(failure) });
+}
+const CapxulClientConnection = Object.assign(Root, {
+	Checking,
+	Otp,
+	Consent,
+	Complete,
+	Failure
+});
+//#endregion
+export { CapxulActivity, CapxulAuthenticationController, CapxulClientConnection, CapxulContacts, CapxulDashboardAccess, CapxulOnboardingController, CapxulOrgMember, CapxulPayroll, CapxulPayrollRun, CapxulProvider, CapxulSendMoney, acknowledgeOnboardingDestination, activeOnboardingRecovery, capxulKeys, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, isClaimed, isRestoring, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHandleAvailability, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUploadImage };