@capxul/sdk-react 2.3.2 → 2.5.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { A as useCapxulAuth, C as CreateOrganizationSubmission, D as ProfileDetails, E as OrganizationDetails, M as useCapxulIdentity, N as useCapxulSend, O as SendResult, P as useCapxulTransitions, S as CapxulSend, T as InvocationOptions, _ as ReadyDestination, a as AuthenticationSlots, b as Slot, c as ControllerAction, d as OnboardingControllerProps, f as OrgFailure, g as ProfileSlotProps, h as PendingAuthState, i as AuthenticatedState, j as useCapxulDestination, k as entered, l as FaultedState, m as OtpPendingState, n as AccountProgress, o as CapxulAuthenticationController, p as OrgProgress, r as ActionResult, s as CapxulOnboardingController, t as AccountFailure, u as NavigationAction, v as RetryAction, w as Destination, x as CapxulAuth, y as SignedOutState } from "./controllers-BT4YzBr9.mjs";
-import { ReactNode } from "react";
+import { ReactNode, RefCallback } from "react";
 import { QueryClient, UseMutationResult, UseQueryResult } from "@tanstack/react-query";
-import { Account, AccountRequirement, ActivityAnnotationInput, ActivityDetail, ActivityListParams, ActivityPage, ActivityReference, AddressBookEntry, CapxulClient, CapxulError, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, MovementAnnotation, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentTiming, PaymentsPayInput, Permission, PermissionReadResult, Profile, RoleView, isClaimed, isRestoring } from "@capxul/sdk";
+import { Account, AccountRequirement, ActivityAnnotation, ActivityAnnotationInput, ActivityDetail, ActivityKind, ActivityListParams, ActivityPage, ActivityPhase, ActivityRange, ActivityReference, ActorReference, AddressBookEntry, CapxulClient, CapxulError, CapxulResult, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentDirection, PaymentDocumentRef, PaymentDocumentRender, PaymentStatus, PaymentTiming, PaymentType, PaymentsPayInput, PayrollGroupId, PayrollGroupInput, PayrollRunId, PayrollRunStatus, Permission, PermissionReadResult, Profile, RoleView, isClaimed, isRestoring } from "@capxul/sdk";
 
 //#region src/provider.d.ts
 type CapxulProviderSharedProps = {
@@ -113,9 +113,32 @@ type PermissionId = Brand<string, "PermissionId">;
 type PermissionAssignmentId = Brand<string, "PermissionAssignmentId">;
 type PaymentCommandId = Brand<string, "PaymentCommandId">;
 type OrgId$1 = Brand<string, "OrgId">;
+type CurrencyCode = Brand<SupportedCurrencyCode, "CurrencyCode">;
 type WeiAmount = Brand<string, "WeiAmount">;
 type RoleKey = Brand<string, "RoleKey">;
 type AllowanceKey = Brand<string, "AllowanceKey">;
+declare const SUPPORTED_CURRENCIES: readonly [{
+  readonly code: "USD";
+  readonly symbol: "$";
+  readonly name: "US Dollar";
+}, {
+  readonly code: "NGN";
+  readonly symbol: "NGN";
+  readonly name: "Nigerian Naira";
+}, {
+  readonly code: "GHS";
+  readonly symbol: "GHS";
+  readonly name: "Ghanaian Cedi";
+}, {
+  readonly code: "KES";
+  readonly symbol: "KSh";
+  readonly name: "Kenyan Shilling";
+}, {
+  readonly code: "UGX";
+  readonly symbol: "USh";
+  readonly name: "Ugandan Shilling";
+}];
+type SupportedCurrencyCode = (typeof SUPPORTED_CURRENCIES)[number]["code"];
 //#endregion
 //#region src/hooks/use-capxul-permissions.d.ts
 declare const useCapxulPermissionCreate: (orgId: OrgId) => UseMutationResult<{
@@ -315,11 +338,15 @@ declare function useCapxulPermission(orgId: OrgId, permissionId: string | undefi
 //#endregion
 //#region src/hooks/use-capxul-activity.d.ts
 declare function useCapxulActivity(params?: ActivityListParams): UseQueryResult<ActivityPage, CapxulError>;
-declare function useCapxulActivityDetail(reference: ActivityReference | undefined): UseQueryResult<ActivityDetail | null, CapxulError>;
-declare function useCapxulAnnotateMovement(): UseMutationResult<MovementAnnotation, CapxulError, ActivityAnnotationInput>;
+declare function useCapxulActivityDetail(reference: ActivityReference | undefined, actor?: ActorReference): UseQueryResult<ActivityDetail | null, CapxulError>;
+declare function useCapxulAnnotateMovement(): UseMutationResult<ActivityAnnotation, CapxulError, ActivityAnnotationInput>;
 //#endregion
 //#region src/hooks/use-capxul-holdings.d.ts
-declare function useCapxulHoldings(): UseQueryResult<CurrentHoldings, CapxulError>;
+interface UseCapxulHoldingsParams {
+  /** Omitted = the signed-in person. SDK core already accepts one. */
+  readonly actor?: ActorReference;
+}
+declare function useCapxulHoldings(params?: UseCapxulHoldingsParams): UseQueryResult<CurrentHoldings, CapxulError>;
 //#endregion
 //#region src/hooks/use-capxul-orgs.d.ts
 /**
@@ -600,13 +627,13 @@ interface CapxulContactsProps {
   readonly onFailed: (error: CapxulError) => void;
   readonly children: ReactNode;
 }
-declare function Root$3({
+declare function Root$6({
   actor,
   onAdded,
   onFailed,
   children
 }: CapxulContactsProps): import("react/jsx-runtime").JSX.Element;
-declare function Summary({
+declare function Summary$3({
   children
 }: {
   readonly children: (slice: ContactsSummarySlice) => ReactNode;
@@ -624,12 +651,218 @@ declare function Add({
   readonly children: (slice: ContactsAddSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulContacts: typeof Root$3 & {
-  Summary: typeof Summary;
+declare const CapxulContacts: typeof Root$6 & {
+  Summary: typeof Summary$3;
   List: typeof List;
   Add: typeof Add;
 };
 //#endregion
+//#region src/headless/activity/types.d.ts
+/** The settled transfer a row was built from. The app builds the explorer URL. */
+interface ActivityReceipt {
+  readonly chainId: number;
+  readonly transactionHash: string;
+}
+/**
+ * One finished row. A DISCRIMINATED UNION on `kind`, because a Movement has no
+ * payment status: one flat shape carrying `status` for both kinds cannot
+ * compile. The two branches match the two branches every app mapper already
+ * writes.
+ */
+type ActivityRow = {
+  readonly kind: "payment";
+  readonly reference: ActivityReference;
+  readonly direction: PaymentDirection;
+  readonly counterpartyLabel: string;
+  readonly amountDisplay: string;
+  readonly signedAmountDisplay: string;
+  readonly currency: string;
+  readonly createdAt: number;
+  readonly ledgerKind: "Payment" | "Payout" | "Deposit";
+  readonly paymentType: PaymentType;
+  readonly status: PaymentStatus;
+  readonly phase: ActivityPhase;
+  readonly receipt: ActivityReceipt | null;
+} | {
+  readonly kind: "movement";
+  readonly reference: ActivityReference;
+  readonly direction: PaymentDirection;
+  readonly counterpartyLabel: string;
+  readonly amountDisplay: string;
+  readonly signedAmountDisplay: string;
+  readonly currency: string;
+  readonly createdAt: number;
+  readonly classification: "movement_only_outflow";
+  readonly phase: ActivityPhase;
+  readonly receipt: ActivityReceipt;
+};
+/**
+ * `"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 every render.
+ */
+type SummaryWindow = "all" | "last30days" | ActivityRange;
+/**
+ * Finished money strings for ONE currency bucket, so no consumer indexes an
+ * array of per-currency totals. All four strings are `null` and `count` is `0`
+ * when the window holds no activity — we say there is nothing, the app says it
+ * in its own words.
+ */
+interface ActivitySummarySlice {
+  readonly currency: string | null;
+  readonly moneyIn: string | null;
+  readonly moneyOut: string | null;
+  readonly net: string | null;
+  readonly pending: string | null;
+  /** A count is not money, so it is not formatted. */
+  readonly count: number;
+  readonly isLoading: boolean;
+  readonly error: CapxulError | null;
+}
+interface ActivityFilterValues {
+  readonly kind?: ActivityKind;
+  readonly direction?: PaymentDirection;
+  readonly status?: readonly PaymentStatus[];
+}
+interface ActivityFiltersSlice {
+  readonly values: ActivityFilterValues;
+  readonly set: {
+    readonly kind: (value?: ActivityKind) => void;
+    readonly direction: (value?: PaymentDirection) => void; /** REPLACES the array; it does not toggle one value. */
+    readonly status: (value: readonly PaymentStatus[]) => void;
+    readonly clear: () => void;
+  };
+  /** CODES, never labels. There is no `{value, label}` pair in this seam. */
+  readonly options: {
+    readonly kind: readonly ActivityKind[];
+    readonly direction: readonly PaymentDirection[];
+    readonly status: readonly PaymentStatus[];
+  };
+}
+interface ActivitySearchSlice {
+  readonly value: string;
+  readonly change: (text: string) => void;
+}
+interface ActivityRowsSlice {
+  /** Already filtered and already searched. */
+  readonly rows: readonly ActivityRow[];
+  readonly isLoading: boolean;
+  readonly error: CapxulError | null;
+  readonly retry: () => void;
+  /** Server read time of the newest page, so the app can say which read is older. */
+  readonly observedAt: number | null;
+}
+interface ActivityLoadMoreSlice {
+  readonly hasMore: boolean;
+  readonly loadMore: () => void;
+  readonly isLoadingMore: boolean;
+  /**
+   * Attach to whatever the screen renders at the bottom of the list. Where
+   * `IntersectionObserver` is undefined — server rendering, and the jsdom test
+   * environment — attaching is a no-op and `loadMore()` stays callable.
+   *
+   * A CALLBACK ref, not the wider `Ref<HTMLElement>`: `RefObject` is invariant,
+   * so `Ref<HTMLElement>` refuses to attach to a `<div>`, which is exactly what
+   * a screen renders at the bottom of its list.
+   */
+  readonly sentinelRef: RefCallback<HTMLElement>;
+}
+interface ActivityDetailSlice {
+  /** ONE finished document, never the array, so no consumer writes `documents[0]`. */
+  readonly receiptDocument: PaymentDocumentRef | null;
+  readonly openReceiptDocument: () => Promise<PaymentDocumentRender>;
+  readonly isOpeningDocument: boolean;
+  readonly memo: string;
+  readonly setMemo: (text: string) => void;
+  readonly saveMemo: () => void;
+  readonly isSavingMemo: boolean;
+  readonly isLoading: boolean;
+  readonly error: CapxulError | null;
+}
+interface CsvExport {
+  readonly text: string;
+  readonly rowCount: number;
+  /** The 5,000-row ceiling was reached and rows were left unread. */
+  readonly truncated: boolean;
+}
+interface ActivityExportSlice {
+  readonly toCsv: () => Promise<CsvExport>;
+  readonly isExporting: boolean;
+}
+//#endregion
+//#region src/headless/activity/activity.d.ts
+interface CapxulActivityProps {
+  /** Omitted = the signed-in person. */
+  readonly actor?: ActorReference;
+  /**
+   * 1..100, default 25. The root CLAMPS an out-of-range value into that band
+   * and warns once in development; it never throws, because a bad prop must not
+   * blank a screen. The band is the backend's own.
+   */
+  readonly pageSize?: number;
+  readonly children: ReactNode;
+}
+declare function Root$5({
+  actor,
+  pageSize,
+  children
+}: CapxulActivityProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * The one part that holds a query rather than reading the engine's: it takes a
+ * `window` prop, and two placements can ask for different windows, so a single
+ * pre-fetched result cannot serve both. It still holds no logic and draws
+ * nothing.
+ */
+declare function Summary$2({
+  window,
+  children
+}: {
+  readonly window?: SummaryWindow;
+  readonly children: (slice: ActivitySummarySlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Filters({
+  children
+}: {
+  readonly children: (slice: ActivityFiltersSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Search({
+  children
+}: {
+  readonly children: (slice: ActivitySearchSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Rows({
+  children
+}: {
+  readonly children: (slice: ActivityRowsSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function LoadMore({
+  children
+}: {
+  readonly children: (slice: ActivityLoadMoreSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Detail({
+  reference,
+  children
+}: {
+  readonly reference?: ActivityReference;
+  readonly children: (slice: ActivityDetailSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Export({
+  children
+}: {
+  readonly children: (slice: ActivityExportSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** The compound shape the app's own design system already uses (`StatusTabs`). */
+declare const CapxulActivity: typeof Root$5 & {
+  Summary: typeof Summary$2;
+  Filters: typeof Filters;
+  Search: typeof Search;
+  Rows: typeof Rows;
+  LoadMore: typeof LoadMore;
+  Detail: typeof Detail;
+  Export: typeof Export;
+};
+//#endregion
 //#region src/headless/send-money/use-recipient-resolution.d.ts
 type SendMoneyRecipientMethod = "username" | "email-address";
 type SendMoneyRecipientStatus = "empty" | "checking" | "found" | "not-found" | "failed";
@@ -695,13 +928,13 @@ interface CapxulSendMoneyProps {
   readonly onFailed: (error: CapxulError) => void;
   readonly children: ReactNode;
 }
-declare function Root$2({
+declare function Root$4({
   actor,
   onSent,
   onFailed,
   children
 }: CapxulSendMoneyProps): import("react/jsx-runtime").JSX.Element;
-declare function Asset({
+declare function Asset$1({
   children
 }: {
   readonly children: (slice: SendMoneyAssetSlice) => ReactNode;
@@ -716,17 +949,17 @@ declare function Recipient({
 }: {
   readonly children: (slice: SendMoneyRecipientSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-declare function Actions({
+declare function Actions$1({
   children
 }: {
   readonly children: (slice: SendMoneyActionsSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulSendMoney: typeof Root$2 & {
-  Asset: typeof Asset;
+declare const CapxulSendMoney: typeof Root$4 & {
+  Asset: typeof Asset$1;
   Amount: typeof Amount;
   Recipient: typeof Recipient;
-  Actions: typeof Actions;
+  Actions: typeof Actions$1;
 };
 //#endregion
 //#region src/headless/access/org-member.d.ts
@@ -753,7 +986,7 @@ interface CapxulOrgMemberProps {
   readonly orgId: OrgId | string | undefined;
   readonly children: ReactNode;
 }
-declare function Root$1({
+declare function Root$3({
   orgId,
   children
 }: CapxulOrgMemberProps): import("react/jsx-runtime").JSX.Element;
@@ -776,7 +1009,7 @@ declare function Standing({
   readonly children: (slice: OrgMemberStandingSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulOrgMember: typeof Root$1 & {
+declare const CapxulOrgMember: typeof Root$3 & {
   Can: typeof Can;
   Standing: typeof Standing;
 };
@@ -801,7 +1034,7 @@ interface CapxulDashboardAccessProps {
   readonly scope: DashboardScope;
   readonly children: ReactNode;
 }
-declare function Root({
+declare function Root$2({
   scope,
   children
 }: CapxulDashboardAccessProps): import("react/jsx-runtime").JSX.Element;
@@ -827,11 +1060,231 @@ declare function Granted({
   readonly children?: ReactNode;
 }): import("react/jsx-runtime").JSX.Element | null;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulDashboardAccess: typeof Root & {
+declare const CapxulDashboardAccess: typeof Root$2 & {
   Checking: typeof Checking;
   Error: typeof DashboardError;
   Redirect: typeof Redirect;
   Granted: typeof Granted;
 };
 //#endregion
-export { type AccountFailure, type AccountProgress, type ActionResult, type AuthenticatedState, type AuthenticationSlots, type CanReason, type CapxulAuth, CapxulAuthenticationController, type CapxulBootstrapState, type CapxulBootstrapStatus, CapxulContacts, type CapxulContactsProps, CapxulDashboardAccess, type CapxulDashboardAccessProps, CapxulOnboardingController, CapxulOrgMember, type CapxulOrgMemberProps, CapxulProvider, type CapxulProviderProps, type CapxulSend, CapxulSendMoney, type CapxulSendMoneyBlockedReason, type CapxulSendMoneyProps, type Contact, type ContactRelationship, type ContactRow, type ContactsActor, type ContactsAddBlockedReason, type ContactsAddError, type ContactsAddSlice, type ContactsListOptions, type ContactsListSlice, type ContactsRefusal, type ContactsSummarySlice, type ControllerAction, type CreateOrganizationSubmission, type DashboardAccessErrorSlice, type DashboardAccessPhase, type DashboardAccessRedirectSlice, type DashboardScope, type Destination, type FaultedState, type ImageUploadInput, type ImageUploadTarget, type InvocationOptions, type NavigationAction, type OnboardingControllerProps, type OnboardingIntent, type OnboardingJourney, type OnboardingJourneyPosition, type OnboardingOrigin, type OnboardingStep, type OrgFailure, type OrgMemberAction, type OrgMemberCanSlice, type OrgMemberStanding, type OrgMemberStandingSlice, type OrgProgress, type OrganizationDetails, type OrganizationDraft, type OtpPendingState, type PayoutDraftChain, type PayoutDraftEntry, type PendingAuthState, type ProfileDetails, type ProfileDraft, type ProfileSlotProps, type ReadyDestination, type RetryAction, type SendActor, type SendMoneyActionsSlice, type SendMoneyAmountSlice, type SendMoneyAssetError, type SendMoneyAssetOption, type SendMoneyAssetSlice, type SendMoneyRecipientMethod, type SendMoneyRecipientSlice, type SendMoneyRecipientStatus, type SendResult, type SentPayment, type SignedOutState, type Slot, type UseCapxulAccountBalanceOptions, type UseCapxulAccountBalanceReturn, type UseCapxulAccountFundReturn, type UseCapxulCreateCommitmentReturn, type UseCapxulCreateOrgReturn, type UseCapxulImageUploadReturn, type UseCapxulInviteMemberReturn, type UseCapxulOrgMembersOptions, type UseCapxulOrgMembersReturn, type UseCapxulOrgRolesOptions, type UseCapxulOrgRolesReturn, type UseCapxulOrgTreasuryOptions, type UseCapxulOrgTreasuryReturn, type UseCapxulOrgsReturn, type UseCapxulPayReturn, type UseCapxulPaymentReturn, type UseCapxulPaymentsReturn, type UseCapxulProfileReturn, type UseCapxulRedirectPaymentReturn, type UseCapxulUsernameAvailabilityReturn, type UsernameAvailability, acknowledgeOnboardingDestination, activeOnboardingRecovery, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, isClaimed, isRestoring, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUsernameAvailability };
+//#region src/headless/payroll/use-payroll.d.ts
+interface PayrollGroupRow {
+  readonly id: PayrollGroupId;
+  readonly name: string;
+  /** A stored display preference; the app narrows it to its own DS union. */
+  readonly tone: string;
+  readonly memberCount: number;
+  /** `formatMoney` over the amounts the employer typed on this group. */
+  readonly totalDisplay: string;
+  readonly members: readonly {
+    /** The `partyId` — the stable id (ruling Q1), never an email. */readonly recipientId: string;
+    readonly amount: string;
+    readonly currency: CurrencyCode;
+  }[];
+}
+interface PayrollSummarySlice {
+  readonly walletBalanceDisplay: string | null;
+  readonly paidThisMonthDisplay: string | null;
+  readonly isLoading: boolean;
+  readonly error: CapxulError | null;
+}
+interface PayrollGroupsSlice {
+  readonly groups: readonly PayrollGroupRow[];
+  readonly save: (input: PayrollGroupInput) => Promise<CapxulResult<PayrollGroupRow>>;
+  readonly remove: (id: PayrollGroupId) => Promise<CapxulResult<void>>;
+  readonly isSaving: boolean;
+  readonly isLoading: boolean;
+  readonly error: CapxulError | null;
+}
+//#endregion
+//#region src/headless/payroll/payroll.d.ts
+interface CapxulPayrollProps {
+  readonly orgId: OrgId | undefined;
+  readonly children: ReactNode;
+}
+declare function Root$1({
+  orgId,
+  children
+}: CapxulPayrollProps): import("react/jsx-runtime").JSX.Element;
+declare function Summary$1({
+  children
+}: {
+  readonly children: (slice: PayrollSummarySlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Groups({
+  children
+}: {
+  readonly children: (slice: PayrollGroupsSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * The compound shape the app's own design system already uses (`StatusTabs`).
+ * 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.
+ */
+declare const CapxulPayroll: typeof Root$1 & {
+  Summary: typeof Summary$1;
+  Groups: typeof Groups;
+};
+//#endregion
+//#region src/headless/payroll/reads.d.ts
+/**
+ * One payable person, as the run composer and the group sheet see them.
+ *
+ * `id` is the `PartyId` — the stable key ADR-0022 R1 exists to provide, and the
+ * end of the email-keyed recipient ids the deleted app hook minted.
+ */
+interface PayrollRecipientOption {
+  readonly id: string;
+  /** The party's real display name, never an email local-part. */
+  readonly name: string;
+  readonly email: string | null;
+}
+//#endregion
+//#region src/headless/payroll/use-payroll-run.d.ts
+/**
+ * Refusal CODES, never sentences (ADR-0023 R1). `blockedReason` names the FIRST
+ * false fact in the fixed order of the contract's seven-row table, so the same
+ * composer state always yields the same code.
+ */
+type CapxulPayrollRunBlockedReason = "signer-not-ready" | "no-source" | "ambiguous-source" | "no-asset" | "no-recipients" | "amount-invalid" | "insufficient-funds";
+interface PayrollRunGroupOption {
+  readonly id: PayrollGroupId;
+  readonly label: string;
+  /** The member count as text — the app supplies any word beside it. */
+  readonly badgeLabel: string;
+  readonly recipientIds: readonly string[];
+}
+interface PayrollRunRecipientsSlice {
+  readonly options: readonly PayrollRecipientOption[];
+  readonly groups: readonly PayrollRunGroupOption[];
+  readonly selected: readonly string[];
+  readonly toggle: (id: string) => void;
+  readonly remove: (id: string) => void;
+  readonly isLoading: boolean;
+  readonly error: CapxulError | null;
+}
+interface PayrollRunAmountEntry {
+  readonly recipientId: string;
+  readonly name: string;
+  readonly value: string;
+  readonly change: (text: string) => void;
+  /** The `parseMoney` verdict as a closed code; the app maps it to copy. */
+  readonly error: MoneyParseErrorReason | null;
+  /** True while the value is one we seeded and the employer has not edited. */
+  readonly prefilled: boolean;
+  /** The treasury asset's currency — the one-option dropdown stays. */
+  readonly currency: CurrencyCode;
+}
+interface PayrollRunAmountsSlice {
+  readonly entries: readonly PayrollRunAmountEntry[];
+}
+/** The SAME slice shape as `CapxulSendMoney.Asset` — the cross-item rule. */
+type PayrollRunAssetSlice = SendMoneyAssetSlice;
+interface PayrollRunSummarySlice {
+  readonly recipientCount: number;
+  /** Null until every selected amount parses. */
+  readonly totalDisplay: string | null;
+  readonly balanceAfterDisplay: string | null;
+  readonly funds: "available" | "insufficient" | "unknown";
+}
+interface PayrollRunActionsSlice {
+  readonly submit: () => void;
+  readonly isSubmitting: boolean;
+  readonly blocked: boolean;
+  readonly blockedReason: CapxulPayrollRunBlockedReason | null;
+}
+interface PayrollRunPrefill {
+  /** `partyId`s — how a group card opens pay-now pre-filled. */
+  readonly recipientIds: readonly string[];
+  readonly amounts?: readonly {
+    readonly recipientId: string;
+    readonly amount: string;
+  }[];
+}
+interface SentPayrollRun {
+  readonly id: PayrollRunId;
+  readonly totalDisplay: string;
+  readonly recipientCount: number;
+}
+//#endregion
+//#region src/headless/payroll/payroll-run.d.ts
+interface CapxulPayrollRunProps {
+  readonly orgId: OrgId | undefined;
+  /** How a group card opens pay-now pre-filled — today's group-context merge. */
+  readonly prefill?: PayrollRunPrefill;
+  readonly onRun: (run: SentPayrollRun) => void;
+  /** ADR-0023 R1: the app maps `error.code` to its own copy; no SDK sentence. */
+  readonly onFailed: (error: CapxulError) => void;
+  readonly children: ReactNode;
+}
+declare function Root({
+  orgId,
+  prefill,
+  onRun,
+  onFailed,
+  children
+}: CapxulPayrollRunProps): import("react/jsx-runtime").JSX.Element;
+declare function Recipients({
+  children
+}: {
+  readonly children: (slice: PayrollRunRecipientsSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Amounts({
+  children
+}: {
+  readonly children: (slice: PayrollRunAmountsSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Asset({
+  children
+}: {
+  readonly children: (slice: PayrollRunAssetSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Summary({
+  children
+}: {
+  readonly children: (slice: PayrollRunSummarySlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Actions({
+  children
+}: {
+  readonly children: (slice: PayrollRunActionsSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** The compound shape the app's own design system already uses (`StatusTabs`). */
+declare const CapxulPayrollRun: typeof Root & {
+  Recipients: typeof Recipients;
+  Amounts: typeof Amounts;
+  Asset: typeof Asset;
+  Summary: typeof Summary;
+  Actions: typeof Actions;
+};
+//#endregion
+//#region src/internal/reactivity-keys.d.ts
+declare const capxulKeys: {
+  root: readonly ["capxul"];
+  profile: readonly ["capxul", "profile"];
+  usernameAvailability: (username: string) => readonly ["capxul", "profile", "username-availability", string];
+  account: readonly ["capxul", "account"];
+  provisioning: readonly ["capxul", "provisioning"];
+  binding: readonly ["capxul", "binding"];
+  accountBalance: readonly ["capxul", "accountBalance"];
+  orgs: readonly ["capxul", "orgs"];
+  org: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId];
+  orgMembers: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "members"];
+  orgRoles: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "roles"];
+  orgTreasury: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "treasury"];
+  orgPermissions: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "permissions"];
+  orgMe: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "me"];
+  orgLifecycle: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "lifecycle"];
+  contacts: (scope: string) => readonly ["capxul", "contacts", string];
+  contactsList: (scope: string, includeHidden: boolean) => readonly ["capxul", "contacts", string, "all" | "visible"];
+  payrollRuns: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "payroll", "runs"];
+  payrollGroups: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "payroll", "groups"];
+  activity: readonly ["capxul", "activity"];
+  activityDetail: (reference: ActivityReference | undefined, actor?: ActorReference | undefined) => readonly ["capxul", "activity", "self" | ActorReference, "pending" | ActivityReference];
+  activitySummary: (actor?: ActorReference, window?: ActivityRange) => readonly ["capxul", "activity", "summary", "self" | ActorReference, "all" | ActivityRange];
+  holdings: (actor?: ActorReference) => readonly ["capxul", "holdings", "self" | ActorReference];
+  payments: readonly ["capxul", "payments"];
+  payment: (paymentId: string | undefined) => readonly ["capxul", "payments", string];
+};
+//#endregion
+export { type AccountFailure, type AccountProgress, type ActionResult, type ActivityDetailSlice, type ActivityExportSlice, type ActivityFilterValues, type ActivityFiltersSlice, type ActivityLoadMoreSlice, type ActivityReceipt, type ActivityRow, type ActivityRowsSlice, type ActivitySearchSlice, type ActivitySummarySlice, type AuthenticatedState, type AuthenticationSlots, type CanReason, CapxulActivity, type CapxulActivityProps, type CapxulAuth, CapxulAuthenticationController, type CapxulBootstrapState, type CapxulBootstrapStatus, CapxulContacts, type CapxulContactsProps, CapxulDashboardAccess, type CapxulDashboardAccessProps, CapxulOnboardingController, CapxulOrgMember, type CapxulOrgMemberProps, CapxulPayroll, type CapxulPayrollProps, CapxulPayrollRun, type CapxulPayrollRunBlockedReason, type CapxulPayrollRunProps, CapxulProvider, type CapxulProviderProps, type CapxulSend, CapxulSendMoney, type CapxulSendMoneyBlockedReason, type CapxulSendMoneyProps, type Contact, type ContactRelationship, type ContactRow, type ContactsActor, type ContactsAddBlockedReason, type ContactsAddError, type ContactsAddSlice, type ContactsListOptions, type ContactsListSlice, type ContactsRefusal, type ContactsSummarySlice, type ControllerAction, type CreateOrganizationSubmission, type CsvExport, type DashboardAccessErrorSlice, type DashboardAccessPhase, type DashboardAccessRedirectSlice, type DashboardScope, type Destination, type FaultedState, type ImageUploadInput, type ImageUploadTarget, type InvocationOptions, type NavigationAction, type OnboardingControllerProps, type OnboardingIntent, type OnboardingJourney, type OnboardingJourneyPosition, type OnboardingOrigin, type OnboardingStep, type OrgFailure, type OrgMemberAction, type OrgMemberCanSlice, type OrgMemberStanding, type OrgMemberStandingSlice, type OrgProgress, type OrganizationDetails, type OrganizationDraft, type OtpPendingState, type PayoutDraftChain, type PayoutDraftEntry, type PayrollGroupRow, type PayrollGroupsSlice, type PayrollRecipientOption, type PayrollRunActionsSlice, type PayrollRunAmountEntry, type PayrollRunAmountsSlice, type PayrollRunAssetSlice, type PayrollRunGroupOption, type PayrollRunPrefill, type PayrollRunRecipientsSlice, type PayrollRunStatus, type PayrollRunSummarySlice, type PayrollSummarySlice, type PendingAuthState, type ProfileDetails, type ProfileDraft, type ProfileSlotProps, type ReadyDestination, type RetryAction, type SendActor, type SendMoneyActionsSlice, type SendMoneyAmountSlice, type SendMoneyAssetError, type SendMoneyAssetOption, type SendMoneyAssetSlice, type SendMoneyRecipientMethod, type SendMoneyRecipientSlice, type SendMoneyRecipientStatus, type SendResult, type SentPayment, type SentPayrollRun, type SignedOutState, type Slot, type SummaryWindow, type UseCapxulAccountBalanceOptions, type UseCapxulAccountBalanceReturn, type UseCapxulAccountFundReturn, type UseCapxulCreateCommitmentReturn, type UseCapxulCreateOrgReturn, type UseCapxulImageUploadReturn, type UseCapxulInviteMemberReturn, type UseCapxulOrgMembersOptions, type UseCapxulOrgMembersReturn, type UseCapxulOrgRolesOptions, type UseCapxulOrgRolesReturn, type UseCapxulOrgTreasuryOptions, type UseCapxulOrgTreasuryReturn, type UseCapxulOrgsReturn, type UseCapxulPayReturn, type UseCapxulPaymentReturn, type UseCapxulPaymentsReturn, type UseCapxulProfileReturn, type UseCapxulRedirectPaymentReturn, type UseCapxulUsernameAvailabilityReturn, type UsernameAvailability, 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, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUsernameAvailability };