@capxul/sdk-react 2.4.0 → 2.5.0

package/README.md

@@ -61,6 +61,14 @@ export function Providers({ children }: { children: React.ReactNode }) {
   actor paths ship: a personal actor reads the account book, and an
   organization actor reads the organization book. The `managePeople` capability
   gate stays in the app, on `CapxulOrgMember.Can`.
+- `CapxulPayroll` and `CapxulPayrollRun` are the two payroll compound
+  components. `CapxulPayroll` owns the payroll page's reads through its
+  `.Summary` and `.Groups` region parts; `CapxulPayrollRun` owns the run
+  composer through `.Recipients`, `.Amounts`, `.Asset`, `.Summary`, and
+  `.Actions`. A screen places any subset — the pay-now sheet places all five
+  run parts, the group sheet places two. `.Actions.blockedReason` names the
+  first false fact as a `CapxulPayrollRunBlockedReason` code, never a
+  sentence. Both engine hooks stay module-scoped.
 
 The packed npm package exposes `@capxul/sdk-react` and
 `@capxul/sdk-react/testing`. The workspace-only `@capxul/sdk-react/headless`

package/dist/{controllers-DLBe4-OP.mjs → controllers-BJ_uFXT3.mjs}

@@ -103,6 +103,20 @@ const capxulKeys = {
 		scope,
 		includeHidden ? "all" : "visible"
 	],
+	payrollRuns: (orgId) => [
+		"capxul",
+		"org",
+		orgId ?? "pending",
+		"payroll",
+		"runs"
+	],
+	payrollGroups: (orgId) => [
+		"capxul",
+		"org",
+		orgId ?? "pending",
+		"payroll",
+		"groups"
+	],
 	activity: ["capxul", "activity"],
 	activityDetail: (reference, actor = void 0) => [
 		"capxul",

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, RefCallback } from "react";
 import { QueryClient, UseMutationResult, UseQueryResult } from "@tanstack/react-query";
-import { Account, AccountRequirement, ActivityAnnotation, ActivityAnnotationInput, ActivityDetail, ActivityKind, ActivityListParams, ActivityPage, ActivityPhase, ActivityRange, ActivityReference, ActorReference, AddressBookEntry, CapxulClient, CapxulError, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentDirection, PaymentDocumentRef, PaymentDocumentRender, PaymentStatus, PaymentTiming, PaymentType, 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<{
@@ -604,13 +627,13 @@ interface CapxulContactsProps {
   readonly onFailed: (error: CapxulError) => void;
   readonly children: ReactNode;
 }
-declare function Root$4({
+declare function Root$6({
   actor,
   onAdded,
   onFailed,
   children
 }: CapxulContactsProps): import("react/jsx-runtime").JSX.Element;
-declare function Summary$1({
+declare function Summary$3({
   children
 }: {
   readonly children: (slice: ContactsSummarySlice) => ReactNode;
@@ -628,8 +651,8 @@ 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$4 & {
-  Summary: typeof Summary$1;
+declare const CapxulContacts: typeof Root$6 & {
+  Summary: typeof Summary$3;
   List: typeof List;
   Add: typeof Add;
 };
@@ -653,6 +676,7 @@ type ActivityRow = {
   readonly counterpartyLabel: string;
   readonly amountDisplay: string;
   readonly signedAmountDisplay: string;
+  readonly currency: string;
   readonly createdAt: number;
   readonly ledgerKind: "Payment" | "Payout" | "Deposit";
   readonly paymentType: PaymentType;
@@ -666,6 +690,7 @@ type ActivityRow = {
   readonly counterpartyLabel: string;
   readonly amountDisplay: string;
   readonly signedAmountDisplay: string;
+  readonly currency: string;
   readonly createdAt: number;
   readonly classification: "movement_only_outflow";
   readonly phase: ActivityPhase;
@@ -777,7 +802,7 @@ interface CapxulActivityProps {
   readonly pageSize?: number;
   readonly children: ReactNode;
 }
-declare function Root$3({
+declare function Root$5({
   actor,
   pageSize,
   children
@@ -788,7 +813,7 @@ declare function Root$3({
  * pre-fetched result cannot serve both. It still holds no logic and draws
  * nothing.
  */
-declare function Summary({
+declare function Summary$2({
   window,
   children
 }: {
@@ -828,8 +853,8 @@ declare function Export({
   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$3 & {
-  Summary: typeof Summary;
+declare const CapxulActivity: typeof Root$5 & {
+  Summary: typeof Summary$2;
   Filters: typeof Filters;
   Search: typeof Search;
   Rows: typeof Rows;
@@ -903,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;
@@ -924,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
@@ -961,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;
@@ -984,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;
 };
@@ -1009,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;
@@ -1035,13 +1060,204 @@ 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
+//#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"];
@@ -1061,6 +1277,8 @@ declare const capxulKeys: {
   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];
@@ -1069,4 +1287,4 @@ declare const capxulKeys: {
   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, 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 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 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 };
+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 };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { a as useCapxulAuth, c as useCapxulIdentityOrNull, d as capxulKeys, f as useCapxulClientOrNull, i as entered, l as useCapxulSend, n as CapxulOnboardingController, o as useCapxulDestination, p as useCapxul, r as CapxulProvider, s as useCapxulIdentity, t as CapxulAuthenticationController, u as useCapxulTransitions } from "./controllers-DLBe4-OP.mjs";
+import { a as useCapxulAuth, c as useCapxulIdentityOrNull, d as capxulKeys, f as useCapxulClientOrNull, i as entered, l as useCapxulSend, n as CapxulOnboardingController, o as useCapxulDestination, p as useCapxul, r as CapxulProvider, s as useCapxulIdentity, t as CapxulAuthenticationController, u as useCapxulTransitions } from "./controllers-BJ_uFXT3.mjs";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { CapxulError, Errors, PAYMENT_DIRECTIONS, PAYMENT_STATUSES, fingerprintPaymentIntent, formatMoney, isCapxulError, isClaimed, isClaimed as isClaimed$1, isMoneyParseError, isRestoring, isRestoring as isRestoring$1, parseMoney, paymentPhase, resolveIdentityDestination } from "@capxul/sdk";
@@ -1014,7 +1014,7 @@ function useContactsContext() {
 	if (engine === null) throw new Error("CapxulContacts parts must be used inside <CapxulContacts>");
 	return engine;
 }
-function Root$4({ actor, onAdded, onFailed, children }) {
+function Root$6({ actor, onAdded, onFailed, children }) {
 	const engine = useContacts({
 		actor,
 		onAdded,
@@ -1025,7 +1025,7 @@ function Root$4({ actor, onAdded, onFailed, children }) {
 		children
 	});
 }
-function Summary$1({ children }) {
+function Summary$3({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useContactsSummary(useContactsContext())) });
 }
 function List({ limit, show, children }) {
@@ -1038,8 +1038,8 @@ 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$4, {
-	Summary: Summary$1,
+const CapxulContacts = Object.assign(Root$6, {
+	Summary: Summary$3,
 	List,
 	Add
 });
@@ -1053,7 +1053,7 @@ const CapxulContacts = Object.assign(Root$4, {
 * the app an error VALUE carrying a code and the app writes the sentence
 * (ADR-0023).
 */
-function asCapxulError(error) {
+function asCapxulError$1(error) {
 	if (error === null) return null;
 	return isCapxulError(error) ? error : Errors.unknown(error);
 }
@@ -1163,7 +1163,7 @@ function useActivityDetail(reference, actor) {
 		saveMemo,
 		isSavingMemo: annotate.isPending,
 		isLoading: enabled && detail.isLoading,
-		error: asCapxulError(detail.error) ?? annotate.error ?? null
+		error: asCapxulError$1(detail.error) ?? annotate.error ?? null
 	};
 }
 //#endregion
@@ -1299,7 +1299,7 @@ function useActivitySummary(actor, window) {
 		pending: null,
 		count: summary.data?.count ?? 0,
 		isLoading,
-		error: asCapxulError(summary.error)
+		error: asCapxulError$1(summary.error)
 	};
 	const display = (raw) => formatMoney({
 		currency: bucket.currency,
@@ -1314,7 +1314,7 @@ function useActivitySummary(actor, window) {
 		pending: display(bucket.pendingIn),
 		count: summary.data?.count ?? 0,
 		isLoading,
-		error: asCapxulError(summary.error)
+		error: asCapxulError$1(summary.error)
 	};
 }
 //#endregion
@@ -1349,6 +1349,7 @@ function toActivityRow(item, actor) {
 		counterpartyLabel: item.counterpartyLabel,
 		amountDisplay,
 		signedAmountDisplay,
+		currency: item.amount.currency,
 		createdAt: item.createdAt,
 		classification: item.classification,
 		phase: MOVEMENT_PHASE,
@@ -1368,6 +1369,7 @@ function toActivityRow(item, actor) {
 		counterpartyLabel: item.counterpartyLabel,
 		amountDisplay,
 		signedAmountDisplay,
+		currency: item.amount.currency,
 		createdAt: item.createdAt,
 		ledgerKind: item.ledgerKind,
 		paymentType: item.paymentType,
@@ -1620,7 +1622,7 @@ function useActivity(input) {
 		rows: {
 			rows,
 			isLoading: query.isLoading,
-			error: asCapxulError(query.error),
+			error: asCapxulError$1(query.error),
 			retry,
 			observedAt: pages === void 0 ? null : pages[pages.length - 1]?.observedAt ?? null
 		},
@@ -1644,7 +1646,7 @@ function useActivityContext() {
 	if (engine === null) throw new Error("CapxulActivity parts must be used inside <CapxulActivity>");
 	return engine;
 }
-function Root$3({ actor, pageSize, children }) {
+function Root$5({ actor, pageSize, children }) {
 	const engine = useActivity({
 		...actor === void 0 ? {} : { actor },
 		...pageSize === void 0 ? {} : { pageSize }
@@ -1660,7 +1662,7 @@ function Root$3({ actor, pageSize, children }) {
 * pre-fetched result cannot serve both. It still holds no logic and draws
 * nothing.
 */
-function Summary({ window = "all", children }) {
+function Summary$2({ window = "all", children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useActivitySummary(useActivityContext().actor, window)) });
 }
 function Filters({ children }) {
@@ -1694,8 +1696,8 @@ 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$3, {
-	Summary,
+const CapxulActivity = Object.assign(Root$5, {
+	Summary: Summary$2,
 	Filters,
 	Search,
 	Rows,
@@ -1866,7 +1868,7 @@ function useSendMoneyContext() {
 	if (engine === null) throw new Error("CapxulSendMoney parts must be used inside <CapxulSendMoney>");
 	return engine;
 }
-function Root$2({ actor, onSent, onFailed, children }) {
+function Root$4({ actor, onSent, onFailed, children }) {
 	const engine = useSendMoney({
 		actor,
 		onSent,
@@ -1877,7 +1879,7 @@ function Root$2({ actor, onSent, onFailed, children }) {
 		children
 	});
 }
-function Asset({ children }) {
+function Asset$1({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().asset) });
 }
 function Amount({ children }) {
@@ -1886,15 +1888,15 @@ function Amount({ children }) {
 function Recipient({ children }) {
 	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().recipient) });
 }
-function Actions({ children }) {
+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$2, {
-	Asset,
+const CapxulSendMoney = Object.assign(Root$4, {
+	Asset: Asset$1,
 	Amount,
 	Recipient,
-	Actions
+	Actions: Actions$1
 });
 //#endregion
 //#region src/headless/access/org-member.tsx
@@ -2005,7 +2007,7 @@ function useOrgMemberContext() {
 	if (state === null) throw new Error("CapxulOrgMember parts must be used inside <CapxulOrgMember>");
 	return state;
 }
-function Root$1({ orgId, children }) {
+function Root$3({ orgId, children }) {
 	const state = useOrgMember(orgId);
 	return /* @__PURE__ */ jsx(OrgMemberContext.Provider, {
 		value: state,
@@ -2025,7 +2027,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$1, {
+const CapxulOrgMember = Object.assign(Root$3, {
 	Can,
 	Standing
 });
@@ -2172,7 +2174,7 @@ function usePart(phase) {
 	}, [placed, phase]);
 	return state.phase === phase ? state : null;
 }
-function Root({ scope, children }) {
+function Root$2({ scope, children }) {
 	const state = useDashboardAccess(scope);
 	const [placed] = useState(() => /* @__PURE__ */ new Set());
 	const value = useMemo(() => ({
@@ -2210,11 +2212,591 @@ 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, {
+const CapxulDashboardAccess = Object.assign(Root$2, {
 	Checking,
 	Error: DashboardError,
 	Redirect,
 	Granted
 });
 //#endregion
-export { CapxulActivity, CapxulAuthenticationController, CapxulContacts, CapxulDashboardAccess, CapxulOnboardingController, CapxulOrgMember, 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, 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/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.
+*
+* A group is a draft, so its amounts were never required to parse (backend
+* `payroll/groups.ts` validates the name and the recipients, never the money).
+* What cannot be read is skipped rather than poisoning the card's total, and
+* the widest fraction any member typed sets the scale so nothing rounds away.
+*/
+function sumTypedAmounts(amounts, currency) {
+	const parsed = amounts.map((amount) => TYPED_AMOUNT.exec(amount.trim().replaceAll(",", ""))).filter((match) => match !== null);
+	const decimals = parsed.reduce((widest, match) => Math.max(widest, (match[3] ?? "").length), 0);
+	return fromMinorUnits(parsed.reduce((sum, match) => {
+		const scaled = BigInt(`${match[2] ?? "0"}${(match[3] ?? "").padEnd(decimals, "0")}`);
+		return match[1] === "-" ? sum - scaled : sum + scaled;
+	}, 0n), {
+		currency,
+		decimals
+	});
+}
+/** The inverse, so a summed total can be formatted by the shipped `formatMoney`. */
+function fromMinorUnits(raw, asset) {
+	const negative = raw < 0n;
+	const digits = (negative ? -raw : raw).toString().padStart(asset.decimals + 1, "0");
+	const whole = digits.slice(0, digits.length - asset.decimals);
+	const fraction = asset.decimals === 0 ? "" : `.${digits.slice(digits.length - asset.decimals)}`;
+	return {
+		currency: asset.currency,
+		value: `${negative ? "-" : ""}${whole}${fraction}`,
+		decimals: asset.decimals
+	};
+}
+//#endregion
+//#region src/headless/payroll/reads.ts
+function toRecipientOption(entry) {
+	return {
+		id: entry.id,
+		name: entry.label,
+		email: entry.label.includes("@") ? entry.label : null
+	};
+}
+/**
+* The roster: active `employed` edges ∪ org members, deduped by party
+* (ruling Q1 = C).
+*
+* The organization address book computes exactly that union server-side —
+* members accumulate from `orgMembers`, employment is PROJECTED from open
+* `employed` edges, and both land in ONE map keyed by party
+* (`financialOps/addressBook.ts`). Contact edges live in the same book and are
+* not the roster, so the two relationships the roster is made of are the
+* filter.
+*/
+function useOrgRoster(orgId) {
+	const client = useCapxulClientOrNull();
+	const query = useQuery({
+		queryKey: capxulKeys.contactsList(orgId ?? "pending", false),
+		queryFn: async () => unwrapCapxulResult(await scopedClient(client, "org.addressBook.list", orgId).addressBook.list({ includeHidden: false })),
+		enabled: client !== null && orgId !== void 0
+	});
+	const entries = query.data;
+	return useMemo(() => {
+		const roster = (entries ?? []).filter((entry) => entry.relationship.includes("member") || entry.relationship.includes("employed"));
+		return {
+			options: roster.map(toRecipientOption),
+			refs: new Map(roster.map((entry) => [entry.id, entry.ref])),
+			isLoading: orgId !== void 0 && entries === void 0 && query.error === null,
+			error: query.error
+		};
+	}, [
+		entries,
+		orgId,
+		query.error
+	]);
+}
+function usePayrollGroups(orgId) {
+	const client = useCapxulClientOrNull();
+	return useQuery({
+		queryKey: capxulKeys.payrollGroups(orgId),
+		queryFn: async () => unwrapCapxulResult(await scopedClient(client, "org.payroll.groups.list", orgId).payroll.groups.list()),
+		enabled: client !== null && orgId !== void 0
+	});
+}
+function usePayrollRuns(orgId) {
+	const client = useCapxulClientOrNull();
+	return useQuery({
+		queryKey: capxulKeys.payrollRuns(orgId),
+		queryFn: async () => unwrapCapxulResult(await scopedClient(client, "org.payroll.runs", orgId).payroll.runs()),
+		enabled: client !== null && orgId !== void 0
+	});
+}
+function useOrgTreasury(orgId) {
+	const client = useCapxulClientOrNull();
+	return useQuery({
+		queryKey: capxulKeys.orgTreasury(orgId),
+		queryFn: async () => unwrapCapxulResult(await scopedClient(client, "org.treasury", orgId).treasury()),
+		enabled: client !== null && orgId !== void 0
+	});
+}
+/**
+* The caller's own standing, read for its Budgets alone (ruling Q2 grades
+* them). Keyed as `CapxulOrgMember` keys it, so a payroll screen inside a
+* `.Can` wrapper reads `org(id).me()` once.
+*/
+function useOrgMe(orgId) {
+	const client = useCapxulClientOrNull();
+	return useQuery({
+		queryKey: capxulKeys.orgMe(orgId),
+		queryFn: async () => unwrapCapxulResult(await scopedClient(client, "org.me", orgId).me()),
+		enabled: client !== null && orgId !== void 0
+	});
+}
+/**
+* The org-scoped bundle inside a query or mutation function. Every caller gates
+* on `orgId !== undefined`, so the second throw is only reachable from a
+* mutation fired while the provider is still bootstrapping.
+*/
+function scopedClient(client, method, orgId) {
+	const bootstrapped = requireBootstrappedClient(client, method);
+	if (orgId === void 0) throw Errors.invalidInput("orgId", `required for ${method}`);
+	return bootstrapped.org(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" };
+function toPayrollGroupRow(group) {
+	const currency = new Set(group.members.map((member) => member.currency)).size === 1 ? group.members[0]?.currency : void 0;
+	return {
+		id: group.id,
+		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),
+		members: group.members.map((member) => ({
+			recipientId: member.partyId,
+			amount: member.amount,
+			currency: member.currency
+		}))
+	};
+}
+/**
+* The validity `buildOrganizationPayrollGroupRecord` applied in the browser
+* (payroll groups hook `:57-82`) — a trimmed name, at least one deduped
+* recipient — checked here so an invalid group never costs a round trip. The
+* backend re-checks it; this is honest UX, not the authority.
+*
+* ADR-0023 R1: the refusal is a CODE, never a toast sentence.
+*/
+function invalidGroup(input) {
+	if (input.name.trim().length === 0) return Errors.invalidInput("name", "must not be empty");
+	const deduped = new Set(input.members.map((member) => member.partyId));
+	deduped.delete("");
+	return deduped.size === 0 ? Errors.invalidInput("members", "must not be empty") : null;
+}
+function usePayroll(orgId) {
+	const client = useCapxulClientOrNull();
+	const queryClient = useQueryClient();
+	const treasury = useOrgTreasury(orgId);
+	const runs = usePayrollRuns(orgId);
+	const groups = usePayrollGroups(orgId);
+	const write = useMutation({
+		mutationFn: async (command) => {
+			const payroll = scopedClient(client, `org.payroll.groups.${command.kind}`, orgId).payroll;
+			if (command.kind === "remove") {
+				unwrapCapxulResult(await payroll.groups.remove(command.id));
+				return null;
+			}
+			return unwrapCapxulResult(await payroll.groups.save(command.input));
+		},
+		onSettled: useCallback(() => queryClient.invalidateQueries({ queryKey: capxulKeys.payrollGroups(orgId) }), [orgId, queryClient])
+	});
+	const mutateAsync = write.mutateAsync;
+	const save = useCallback(async (input) => {
+		const refusal = invalidGroup(input);
+		if (refusal !== null) return {
+			ok: false,
+			error: refusal
+		};
+		try {
+			const saved = await mutateAsync({
+				kind: "save",
+				input
+			});
+			return saved === null ? {
+				ok: false,
+				error: Errors.unknown()
+			} : {
+				ok: true,
+				value: toPayrollGroupRow(saved)
+			};
+		} catch (cause) {
+			return {
+				ok: false,
+				error: asCapxulError(cause)
+			};
+		}
+	}, [mutateAsync]);
+	const remove = useCallback(async (id) => {
+		try {
+			await mutateAsync({
+				kind: "remove",
+				id
+			});
+			return {
+				ok: true,
+				value: void 0
+			};
+		} catch (cause) {
+			return {
+				ok: false,
+				error: asCapxulError(cause)
+			};
+		}
+	}, [mutateAsync]);
+	const rows = useMemo(() => (groups.data ?? []).map(toPayrollGroupRow), [groups.data]);
+	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),
+			isLoading: started && (treasury.data === void 0 && treasury.error === null || runs.data === void 0 && runs.error === null),
+			error: treasury.error ?? runs.error
+		},
+		groups: {
+			groups: rows,
+			save,
+			remove,
+			isSaving: write.isPending,
+			isLoading: started && groups.data === void 0 && groups.error === null,
+			error: groups.error
+		}
+	};
+}
+/**
+* React Query rejects with whatever the query function threw. Every throw on
+* this path is a `CapxulError` the SDK produced; anything else is a defect and
+* normalizes once, exactly as the facade boundary does.
+*/
+function asCapxulError(cause) {
+	return isCapxulError$1(cause) ? cause : Errors.unknown(cause);
+}
+function isCapxulError$1(cause) {
+	return typeof cause === "object" && cause !== null && "code" in cause;
+}
+//#endregion
+//#region src/headless/payroll/payroll.tsx
+const PayrollContext = createContext(null);
+function usePayrollContext() {
+	const engine = useContext(PayrollContext);
+	if (engine === null) throw new Error("CapxulPayroll parts must be used inside <CapxulPayroll>");
+	return engine;
+}
+function Root$1({ orgId, children }) {
+	const engine = usePayroll(orgId);
+	return /* @__PURE__ */ jsx(PayrollContext.Provider, {
+		value: engine,
+		children
+	});
+}
+function Summary$1({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollContext().summary) });
+}
+function Groups({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollContext().groups) });
+}
+/**
+* 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.
+*/
+const CapxulPayroll = Object.assign(Root$1, {
+	Summary: Summary$1,
+	Groups
+});
+//#endregion
+//#region src/headless/payroll/use-payroll-run.ts
+const GRAMMAR = { grammar: "code" };
+/**
+* The one place the composer states a currency it has not read yet. The token
+* dropdown holds exactly one option — the treasury's — so before that read
+* lands there is no currency to name, and naming a wrong one would be a fake
+* green on the money itself.
+*/
+const CURRENCY_UNREAD = "";
+/**
+* WHICH run the composer is composing, by MEANING rather than by object shape.
+*
+* `recipientIds` order is meaning — it is the order `.Amounts` rows appear in.
+* The `amounts` order is not, so the key reads the seed `initialAmounts` will
+* actually build rather than the array it was handed: one collapse rule, in one
+* place, so the two can never disagree about a repeated recipient. A parent
+* that rebuilds an equivalent `prefill` therefore keeps its key, and the
+* employer's in-progress edits with it. An absent `prefill` and one that seeds
+* nothing open the same empty composer, so they share a key on purpose.
+*/
+function composerIdentity(orgId, prefill) {
+	const seeds = Object.entries(initialAmounts(prefill)).map(([recipientId, draft]) => `${recipientId}=${draft.value}`).sort();
+	return [
+		orgId ?? "",
+		...prefill?.recipientIds ?? [],
+		"|",
+		...seeds
+	].join("\0");
+}
+/** Seeded from `prefill` on first render; the employer owns it after that. */
+function initialAmounts(prefill) {
+	const seeded = {};
+	for (const entry of prefill?.amounts ?? []) seeded[entry.recipientId] = {
+		value: entry.amount,
+		prefilled: true
+	};
+	return seeded;
+}
+function usePayrollRun(input) {
+	const { orgId, prefill, onRun, onFailed } = input;
+	const client = useCapxulClientOrNull();
+	const queryClient = useQueryClient();
+	const signerStatus = useSignerStatus(client);
+	const roster = useOrgRoster(orgId);
+	const groups = usePayrollGroups(orgId);
+	const treasury = useOrgTreasury(orgId);
+	const me = useOrgMe(orgId);
+	const [selected, setSelected] = useState(() => prefill?.recipientIds ?? []);
+	const [amounts, setAmounts] = useState(() => initialAmounts(prefill));
+	const composerKey = composerIdentity(orgId, prefill);
+	const [seededKey, setSeededKey] = useState(composerKey);
+	if (seededKey !== composerKey) {
+		setSeededKey(composerKey);
+		setSelected(prefill?.recipientIds ?? []);
+		setAmounts(initialAmounts(prefill));
+	}
+	const toggle = useCallback((id) => setSelected((current) => current.includes(id) ? current.filter((held) => held !== id) : [...current, id]), []);
+	const remove = useCallback((id) => setSelected((current) => current.filter((held) => held !== id)), []);
+	const change = useCallback((id, text) => {
+		setAmounts((current) => ({
+			...current,
+			[id]: {
+				value: text,
+				prefilled: false
+			}
+		}));
+	}, []);
+	const account = treasury.data ?? null;
+	const assetOptions = useMemo(() => account === null ? [] : [{
+		id: account.id,
+		symbol: account.available.currency,
+		availableDisplay: formatMoney(account.available, GRAMMAR)
+	}], [account]);
+	const [selectedAssetId, setSelectedAssetId] = useState(null);
+	useEffect(() => {
+		if (!assetOptions.some((option) => option.id === selectedAssetId)) setSelectedAssetId(assetOptions[0]?.id ?? null);
+	}, [assetOptions, selectedAssetId]);
+	const selectedAsset = assetOptions.find((option) => option.id === selectedAssetId) ?? null;
+	const selectAsset = useCallback((id) => {
+		setSelectedAssetId((current) => assetOptions.some((option) => option.id === id) ? id : current);
+	}, [assetOptions]);
+	const assetMoney = selectedAsset !== null && account !== null ? account.available : null;
+	const named = useMemo(() => new Map(roster.options.map((option) => [option.id, option])), [roster.options]);
+	const refs = roster.refs;
+	const payableRefs = useMemo(() => {
+		const resolved = [];
+		for (const recipientId of selected) {
+			const ref = refs.get(recipientId);
+			if (ref === void 0) return null;
+			resolved.push(ref);
+		}
+		return resolved;
+	}, [refs, selected]);
+	const entries = useMemo(() => selected.map((recipientId) => {
+		const draft = amounts[recipientId];
+		const value = draft?.value ?? "";
+		const parsed = assetMoney === null || value.trim() === "" ? null : parseMoney(value, assetMoney);
+		return {
+			recipientId,
+			name: named.get(recipientId)?.name ?? recipientId,
+			value,
+			change: (text) => change(recipientId, text),
+			error: parsed !== null && isMoneyParseError(parsed) ? parsed.reason : null,
+			prefilled: draft?.prefilled ?? false,
+			currency: assetMoney?.currency ?? CURRENCY_UNREAD
+		};
+	}), [
+		amounts,
+		assetMoney,
+		change,
+		named,
+		selected
+	]);
+	const parsedAmounts = useMemo(() => {
+		if (assetMoney === null || selected.length === 0) return null;
+		const money = [];
+		for (const recipientId of selected) {
+			const parsed = parseMoney(amounts[recipientId]?.value ?? "", assetMoney);
+			if (isMoneyParseError(parsed)) return null;
+			money.push(parsed);
+		}
+		return money;
+	}, [
+		amounts,
+		assetMoney,
+		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 funds = availableRaw === null || totalRaw === null ? "unknown" : totalRaw > availableRaw ? "insufficient" : "available";
+	const budgets = me.data?.budgets ?? [];
+	const blockedReason = firstFalseFact({
+		signerReady: signerStatus === "ready",
+		budgetCount: budgets.length,
+		hasAsset: selectedAsset !== null,
+		recipientCount: payableRefs === null ? 0 : selected.length,
+		amountsParse: total !== null,
+		funds
+	});
+	const authorize = useMutation({
+		mutationFn: async (command) => {
+			const runAt = Date.now();
+			return unwrapCapxulResult(await scopedClient(client, "org.payroll.authorizeRun", orgId).payroll.authorizeRun({
+				permissionId: command.permissionId,
+				period: {
+					start: runAt,
+					end: runAt
+				},
+				items: command.items
+			}));
+		},
+		onSettled: () => {
+			queryClient.invalidateQueries({ queryKey: capxulKeys.payrollRuns(orgId) });
+		}
+	});
+	const submitGate = useRef(false);
+	const totalDisplay = total === null ? null : formatMoney(total, GRAMMAR);
+	const authorizeMutate = authorize.mutate;
+	const submit = useCallback(() => {
+		const permissionId = budgets[0]?.id;
+		if (blockedReason !== null || submitGate.current) return;
+		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,
+				partyId: recipientId,
+				gross: raw,
+				net: raw,
+				adjustments: []
+			});
+		}
+		submitGate.current = true;
+		authorizeMutate({
+			permissionId,
+			items
+		}, {
+			onSuccess: (run) => onRun({
+				id: run.id,
+				totalDisplay,
+				recipientCount
+			}),
+			onError: onFailed,
+			onSettled: () => {
+				submitGate.current = false;
+			}
+		});
+	}, [
+		authorizeMutate,
+		blockedReason,
+		budgets,
+		onFailed,
+		onRun,
+		parsedAmounts,
+		payableRefs,
+		selected,
+		totalDisplay
+	]);
+	return {
+		recipients: {
+			options: roster.options,
+			groups: (groups.data ?? []).map((group) => ({
+				id: group.id,
+				label: group.name,
+				badgeLabel: String(group.members.length),
+				recipientIds: group.members.map((member) => member.partyId)
+			})),
+			selected,
+			toggle,
+			remove,
+			isLoading: roster.isLoading,
+			error: roster.error ?? groups.error
+		},
+		amounts: { entries },
+		asset: {
+			options: assetOptions,
+			selected: selectedAsset,
+			select: selectAsset,
+			error: treasury.error === null ? null : "read-failed"
+		},
+		summary: {
+			recipientCount: selected.length,
+			totalDisplay,
+			balanceAfterDisplay: totalRaw === null || availableRaw === null || assetMoney === null ? null : formatMoney(fromMinorUnits(availableRaw - totalRaw, assetMoney), GRAMMAR),
+			funds
+		},
+		actions: {
+			submit,
+			isSubmitting: authorize.isPending,
+			blocked: blockedReason !== null,
+			blockedReason
+		}
+	};
+}
+/**
+* The seven 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.
+*/
+function firstFalseFact(facts) {
+	if (!facts.signerReady) return "signer-not-ready";
+	if (facts.budgetCount === 0) return "no-source";
+	if (facts.budgetCount > 1) return "ambiguous-source";
+	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;
+}
+//#endregion
+//#region src/headless/payroll/payroll-run.tsx
+const PayrollRunContext = createContext(null);
+function usePayrollRunContext() {
+	const engine = useContext(PayrollRunContext);
+	if (engine === null) throw new Error("CapxulPayrollRun parts must be used inside <CapxulPayrollRun>");
+	return engine;
+}
+function Root({ orgId, prefill, onRun, onFailed, children }) {
+	const engine = usePayrollRun({
+		orgId,
+		prefill,
+		onRun,
+		onFailed
+	});
+	return /* @__PURE__ */ jsx(PayrollRunContext.Provider, {
+		value: engine,
+		children
+	});
+}
+function Recipients({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollRunContext().recipients) });
+}
+function Amounts({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollRunContext().amounts) });
+}
+function Asset({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollRunContext().asset) });
+}
+function Summary({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollRunContext().summary) });
+}
+function Actions({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(usePayrollRunContext().actions) });
+}
+/** The compound shape the app's own design system already uses (`StatusTabs`). */
+const CapxulPayrollRun = Object.assign(Root, {
+	Recipients,
+	Amounts,
+	Asset,
+	Summary,
+	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, 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 };

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-DLBe4-OP.mjs";
+import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-BJ_uFXT3.mjs";
 import "react";
 import { jsx } from "react/jsx-runtime";
 import { createCapxulTestClient } from "@capxul/sdk/testing";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "2.4.0"
+    "@capxul/sdk": "2.5.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",