@capxul/sdk-react 4.20.0-beta.4 → 4.20.0-beta.40

package/README.md

@@ -27,13 +27,16 @@ export function Providers({ children }: { children: React.ReactNode }) {
 - The provider restores Account readiness after a complete authenticated
   session. Account and Organization readiness transitions refresh active
   authenticated queries.
-- `CapxulAuthenticationController` and `CapxulOnboardingController` select
-  app-owned slots and render no SDK-owned DOM. The onboarding controller keeps
-  no Organization submission: after a reload the Core SDK reads the pending
-  Organization from the backend and attaches it, so the app re-submits nothing.
-  A claimed identity with no Organization and no app-held form step reports
-  `organizationProgress` with `{ at: "loading", orgId: null }` until that
-  attach lands.
+- CapxulAuthenticationController and CapxulOnboardingController select
+  app-owned slots and render no SDK-owned DOM. Organization create begins a
+  backend setup and returns its exact ID. The Core SDK actor subscribes to
+  that setup. Awaiting authorization, attention, and failure reach actionable
+  slots; processing and rechecking reach a finite progress slot.
+- CapxulDashboardAccess combines current setup with current org.me authority.
+  Initial and changed scopes wait for verified authority. Unchanged setup
+  snapshots reuse cached data. Background authority checks keep an already
+  verified ready dashboard mounted. Non-ready setup, sign-out, scope changes,
+  and authority errors close access. A revoked membership cannot keep a grant.
 - Rich-data hooks such as `useCapxulProfile`, `useCapxulOrgs`, members, roles,
   treasury, and money hooks remain TanStack Query projections. Personal
   holdings and activity reads start only after the Account is claimed.
@@ -56,6 +59,8 @@ export function Providers({ children }: { children: React.ReactNode }) {
   engine hook stays module-scoped. Both actor paths ship: a personal actor omits
   `.Source` and spends the personal Account; an organization actor holds the
   Budget the payment is drawn from and spends the treasury Account.
+  The submitted amount uses the selected registry AssetId and precision. This
+  includes 18-decimal WETH.
 - `CapxulContacts` is the compound address-book component. One root owns the
   book behaviour and draws nothing. The `.Summary`, `.List`, and `.Add` region
   parts each hand the screen one finished slice, and a `.List` row carries its
@@ -75,6 +80,9 @@ export function Providers({ children }: { children: React.ReactNode }) {
   and an amount the caller passed in `prefill` wins over it. Both engine hooks
   stay module-scoped.
 
+Activity groups use AssetId. The SDK resolves symbols and precision only for
+display and CSV output. Assets with the same peg remain separate.
+
 Payroll confirmation restores a saved run before enabling submission. An
 uncertain run keeps its period, amounts, recipients, and SDK request key across
 close/reopen and reload. Its fields remain fixed until Core confirms success or terminal closure.
@@ -98,6 +106,16 @@ The testing harness uses the real public provider and controllers and imports
 its client factory only through `@capxul/sdk/testing`; it owns no renderer or
 parallel identity state.
 
+## Activity documents
+
+`CapxulActivity.Detail` exposes `documents`, `selectedDocument`, and
+`selectDocument({ documentHash, contentHash })`. Selection defaults to the
+instruction, then the Movement Memo. `renderDocument()` returns safe semantic
+HTML. `downloadDocument()` returns exact bytes for a deliberate download.
+The host owns the panel and download action. Do not log these results.
+Account or Organization changes clear selection and cancel pending reads.
+These methods replace the receipt-only selector and action.
+
 ## Documentation
 
 - [Maintainer context](./CONTEXT.md)