@coinlist-co/react 0.12.1-rc.f2804ef → 0.12.1

package/dist/client/index.d.cts

@@ -3491,16 +3491,23 @@ declare function OfferSaleCard({ offer, onClick, className, containerClassName,
 
 type RequirementsChecklistUiState = {
     type: 'loading';
-} | {
-    type: 'not-authenticated';
+    title: string;
+    description: string;
 } | {
     type: 'error';
+    title: string;
 } | {
     type: 'content';
     title: string;
     description: string;
     items: RequirementsChecklistItemUi[];
     ineligible: boolean;
+    /**
+     * Unsupported jurisdiction, once the country is known. When set, the
+     * description, rows, and Continue are replaced by this neutral banner.
+     * Absent otherwise.
+     */
+    blockedMessage?: string;
     /** `null` when the host passed no `onContinue`, so no button is shown. */
     continueAction: {
         enabled: boolean;
@@ -3576,6 +3583,14 @@ type RequirementItemUi = {
     multiWallet: boolean;
     /** The user's connected wallets. Single-slot requirements have at most one. */
     connectedWallets: ConnectedWalletUi[];
+    /** Absent means the shared verification sentences. */
+    statusMessages?: {
+        /** Absent for tax documentation: `in_progress` stays a required step. */
+        pending?: string;
+        completed: string;
+        /** Full sentence. "Contact support" inside it is the support link. */
+        rejected: string;
+    };
 };
 declare const RequirementItemUi: {
     fromDomain(req: Requirement, statusInfo: RequirementStatusInfo | undefined, label: string, description: string, addresses?: OfferOptionAddress[]): RequirementItemUi;
@@ -3728,13 +3743,19 @@ interface RequirementItemProps {
      */
     walletsStatus?: WalletsStatus;
     onContactSupport?: (() => void) | null;
+    /**
+     * 16px under the open section, so its button does not sit on the next row's
+     * divider. The last row omits this: the checklist's own gap is the space
+     * before the footer.
+     */
+    spaceBeforeNextRow?: boolean;
 }
 /**
  * A single requirement row (label, status, expandable action zone). Self-scoped:
  * renders fully styled on its own, with no `CoinListStyleScope` needed. Also composed
  * by {@link RequirementsChecklist}.
  */
-declare function RequirementItem({ ui, expanded, onToggle, className, onAction, onRemoveWallet, walletsStatus, onContactSupport, }: RequirementItemProps): react.JSX.Element;
+declare function RequirementItem({ ui, expanded, onToggle, className, onAction, onRemoveWallet, walletsStatus, onContactSupport, spaceBeforeNextRow, }: RequirementItemProps): react.JSX.Element;
 
 type LoadRequirementsReason = 'not-authenticated' | 'generic-error';
 type LoadRequirementsState = {
@@ -3830,12 +3851,8 @@ interface RequirementsChecklistContainerProps {
     /** Optional loading slot. */
     loading?: ReactNode;
     /**
-     * Rendered when the user is not authenticated. Defaults to
-     * {@link CoinListSignInCardContainer}, which prompts the user to sign in and starts
-     * the CoinList OAuth flow. Pass `null` to render nothing.
+     * Replaces the error banner under the title. The title still renders.
      */
-    unauthenticatedState?: ReactNode;
-    /** Optional error slot. */
     error?: ReactNode;
     className?: string;
     /**
@@ -3874,9 +3891,8 @@ interface RequirementsChecklistContainerProps {
  * initial client-side fetch. Pass `enabled={false}` to skip fetches when the
  * container is mounted but the checklist is not needed yet.
  *
- * When the user is not authenticated, renders a sign-in card instead of the
- * checklist - without fetching. Pass `unauthenticatedState` to customize that
- * state, or `null` to render nothing.
+ * A logged-out session renders the error state and does not fetch. The host
+ * should not mount the checklist when it already knows the user is logged out.
  *
  * By default, clicking a requirement's action button opens the corresponding
  * CoinList page in a new tab via {@link CoinListClient#requirements.handle}. It
@@ -3886,26 +3902,21 @@ interface RequirementsChecklistContainerProps {
  *
  * Self-scoped: renders fully styled on its own, with no `CoinListStyleScope` needed.
  */
-declare function RequirementsChecklistContainer({ loading, error, unauthenticatedState, className, enabled, ...options }: RequirementsChecklistContainerProps): ReactNode;
+declare function RequirementsChecklistContainer({ loading, error, className, enabled, ...options }: RequirementsChecklistContainerProps): ReactNode;
 
 interface RequirementsChecklistViewProps {
     state: RequirementsChecklistUiState;
     onEvent: (event: RequirementsChecklistUiEvent) => void;
     /** Optional loading slot. */
     loading?: ReactNode;
-    /** Optional error slot. */
+    /** Replaces the error banner under the title. The title still renders. */
     error?: ReactNode;
-    /**
-     * Rendered when the user is not authenticated. Nothing is rendered when
-     * omitted; `RequirementsChecklistContainer` passes a connected sign-in card.
-     */
-    unauthenticatedState?: ReactNode;
     className?: string;
 }
 /**
- * Renders the requirements checklist: its header, one row per requirement, the
- * eligibility banner and the continue action. Pure: the rows arrive already
- * shaped in `state`, and every interaction leaves through `onEvent`.
+ * Renders the requirements checklist: its header, one row per requirement, and
+ * the continue row. Pure: the rows arrive already shaped in `state`, and every
+ * interaction leaves through `onEvent`.
  *
  * The flows the checklist can open (tax document, wallet connect, identity
  * verification) are composed by `RequirementsChecklistContainer`, which owns

package/dist/client/index.d.ts

@@ -3491,16 +3491,23 @@ declare function OfferSaleCard({ offer, onClick, className, containerClassName,
 
 type RequirementsChecklistUiState = {
     type: 'loading';
-} | {
-    type: 'not-authenticated';
+    title: string;
+    description: string;
 } | {
     type: 'error';
+    title: string;
 } | {
     type: 'content';
     title: string;
     description: string;
     items: RequirementsChecklistItemUi[];
     ineligible: boolean;
+    /**
+     * Unsupported jurisdiction, once the country is known. When set, the
+     * description, rows, and Continue are replaced by this neutral banner.
+     * Absent otherwise.
+     */
+    blockedMessage?: string;
     /** `null` when the host passed no `onContinue`, so no button is shown. */
     continueAction: {
         enabled: boolean;
@@ -3576,6 +3583,14 @@ type RequirementItemUi = {
     multiWallet: boolean;
     /** The user's connected wallets. Single-slot requirements have at most one. */
     connectedWallets: ConnectedWalletUi[];
+    /** Absent means the shared verification sentences. */
+    statusMessages?: {
+        /** Absent for tax documentation: `in_progress` stays a required step. */
+        pending?: string;
+        completed: string;
+        /** Full sentence. "Contact support" inside it is the support link. */
+        rejected: string;
+    };
 };
 declare const RequirementItemUi: {
     fromDomain(req: Requirement, statusInfo: RequirementStatusInfo | undefined, label: string, description: string, addresses?: OfferOptionAddress[]): RequirementItemUi;
@@ -3728,13 +3743,19 @@ interface RequirementItemProps {
      */
     walletsStatus?: WalletsStatus;
     onContactSupport?: (() => void) | null;
+    /**
+     * 16px under the open section, so its button does not sit on the next row's
+     * divider. The last row omits this: the checklist's own gap is the space
+     * before the footer.
+     */
+    spaceBeforeNextRow?: boolean;
 }
 /**
  * A single requirement row (label, status, expandable action zone). Self-scoped:
  * renders fully styled on its own, with no `CoinListStyleScope` needed. Also composed
  * by {@link RequirementsChecklist}.
  */
-declare function RequirementItem({ ui, expanded, onToggle, className, onAction, onRemoveWallet, walletsStatus, onContactSupport, }: RequirementItemProps): react.JSX.Element;
+declare function RequirementItem({ ui, expanded, onToggle, className, onAction, onRemoveWallet, walletsStatus, onContactSupport, spaceBeforeNextRow, }: RequirementItemProps): react.JSX.Element;
 
 type LoadRequirementsReason = 'not-authenticated' | 'generic-error';
 type LoadRequirementsState = {
@@ -3830,12 +3851,8 @@ interface RequirementsChecklistContainerProps {
     /** Optional loading slot. */
     loading?: ReactNode;
     /**
-     * Rendered when the user is not authenticated. Defaults to
-     * {@link CoinListSignInCardContainer}, which prompts the user to sign in and starts
-     * the CoinList OAuth flow. Pass `null` to render nothing.
+     * Replaces the error banner under the title. The title still renders.
      */
-    unauthenticatedState?: ReactNode;
-    /** Optional error slot. */
     error?: ReactNode;
     className?: string;
     /**
@@ -3874,9 +3891,8 @@ interface RequirementsChecklistContainerProps {
  * initial client-side fetch. Pass `enabled={false}` to skip fetches when the
  * container is mounted but the checklist is not needed yet.
  *
- * When the user is not authenticated, renders a sign-in card instead of the
- * checklist - without fetching. Pass `unauthenticatedState` to customize that
- * state, or `null` to render nothing.
+ * A logged-out session renders the error state and does not fetch. The host
+ * should not mount the checklist when it already knows the user is logged out.
  *
  * By default, clicking a requirement's action button opens the corresponding
  * CoinList page in a new tab via {@link CoinListClient#requirements.handle}. It
@@ -3886,26 +3902,21 @@ interface RequirementsChecklistContainerProps {
  *
  * Self-scoped: renders fully styled on its own, with no `CoinListStyleScope` needed.
  */
-declare function RequirementsChecklistContainer({ loading, error, unauthenticatedState, className, enabled, ...options }: RequirementsChecklistContainerProps): ReactNode;
+declare function RequirementsChecklistContainer({ loading, error, className, enabled, ...options }: RequirementsChecklistContainerProps): ReactNode;
 
 interface RequirementsChecklistViewProps {
     state: RequirementsChecklistUiState;
     onEvent: (event: RequirementsChecklistUiEvent) => void;
     /** Optional loading slot. */
     loading?: ReactNode;
-    /** Optional error slot. */
+    /** Replaces the error banner under the title. The title still renders. */
     error?: ReactNode;
-    /**
-     * Rendered when the user is not authenticated. Nothing is rendered when
-     * omitted; `RequirementsChecklistContainer` passes a connected sign-in card.
-     */
-    unauthenticatedState?: ReactNode;
     className?: string;
 }
 /**
- * Renders the requirements checklist: its header, one row per requirement, the
- * eligibility banner and the continue action. Pure: the rows arrive already
- * shaped in `state`, and every interaction leaves through `onEvent`.
+ * Renders the requirements checklist: its header, one row per requirement, and
+ * the continue row. Pure: the rows arrive already shaped in `state`, and every
+ * interaction leaves through `onEvent`.
  *
  * The flows the checklist can open (tax document, wallet connect, identity
  * verification) are composed by `RequirementsChecklistContainer`, which owns