@solvapay/react 1.0.6 → 1.0.8-preview.1

package/dist/primitives/index.d.ts

@@ -0,0 +1,533 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { Ref } from 'react';
+import { k as Plan, F as Product, y as UseTopupAmountSelectorReturn, D as PurchaseInfo, T as TopupFormProps } from '../CancelPlanButton-f56UlQN-.js';
+export { a4 as ActivationFlow, a5 as ActivationFlowActivateButton, a6 as ActivationFlowActivated, a7 as ActivationFlowAmountPicker, a8 as ActivationFlowContinueButton, a9 as ActivationFlowError, aa as ActivationFlowLoading, ab as ActivationFlowRetrying, ac as ActivationFlowRoot, G as ActivationFlowStep, ad as ActivationFlowSummary, H as BalanceBadge, I as CancelPlanButton, O as MandateText, Q as MandateTextProps, ae as PaymentForm, e as PaymentFormCardElement, c as PaymentFormCustomerFields, j as PaymentFormError, i as PaymentFormLoading, f as PaymentFormMandateText, d as PaymentFormPaymentElement, af as PaymentFormRoot, h as PaymentFormSubmitButton, b as PaymentFormSummary, g as PaymentFormTermsCheckbox, Z as PlanBadge, _ as ProductBadge, $ as PurchaseGate, ag as PurchaseGateAllowed, ah as PurchaseGateBlocked, ai as PurchaseGateError, aj as PurchaseGateLoading, ak as PurchaseGateRoot, al as useActivationFlow, am as usePurchaseGate } from '../CancelPlanButton-f56UlQN-.js';
+import { PaymentElement } from '@stripe/react-stripe-js';
+import { Stripe, StripeElements } from '@stripe/stripe-js';
+import '@solvapay/server';
+import '../adapters/auth.js';
+
+interface SlotProps extends React.HTMLAttributes<HTMLElement> {
+    children?: React.ReactNode;
+}
+declare const Slot: React.ForwardRefExoticComponent<SlotProps & React.RefAttributes<HTMLElement>>;
+declare const Slottable: ({ children }: {
+    children: React.ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+
+type PossibleRef<T> = Ref<T> | null | undefined;
+/**
+ * Assign a value to a single ref, whether it's a function ref, object ref,
+ * or null/undefined. Mirrors the Radix UI helper so primitives can cleanly
+ * forward refs when composed via `asChild`.
+ */
+declare function setRef<T>(ref: PossibleRef<T>, value: T | null): void;
+/**
+ * Compose multiple refs into a single callback ref. Forwards the node
+ * (or null on unmount) to every provided ref. Null/undefined refs are ignored.
+ */
+declare function composeRefs<T>(...refs: Array<PossibleRef<T>>): (node: T | null) => void;
+
+/**
+ * Compose a consumer-provided event handler with an internal handler.
+ * The consumer handler runs first; the internal handler is skipped when
+ * the consumer calls `event.preventDefault()` (unless opted out).
+ *
+ * Mirrors the Radix UI helper so primitive leaves can safely chain
+ * user handlers with their own state updates.
+ */
+declare function composeEventHandlers<E extends {
+    defaultPrevented: boolean;
+}>(originalEventHandler?: ((event: E) => void) | undefined, ourEventHandler?: ((event: E) => void) | undefined, { checkForDefaultPrevented }?: {
+    checkForDefaultPrevented?: boolean;
+}): (event: E) => void;
+
+/**
+ * CheckoutSummary compound primitive.
+ *
+ * Unstyled, accessible building blocks for rendering a checkout-time summary
+ * of the selected plan + product. Consumers compose subcomponents; the
+ * top-level `@solvapay/react` package ships a thin default-tree shim in
+ * `src/components/CheckoutSummary.tsx`.
+ *
+ * Every leaf subcomponent accepts `asChild` for Slot-style composition with
+ * consumer elements (shadcn/ui, Tailwind, plain HTML). State comes from
+ * `usePlan` + `useProduct` with optional fallback through
+ * `PlanSelectionContext`.
+ */
+
+type CheckoutSummaryContextValue = {
+    plan: Plan | null;
+    product: Product | null;
+    priceFormatted: string;
+    trialBanner: string | null;
+    loading: boolean;
+};
+declare const CheckoutSummaryRoot: React.ForwardRefExoticComponent<{
+    planRef?: string;
+    productRef?: string;
+    asChild?: boolean;
+    children?: React.ReactNode;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & React.RefAttributes<HTMLDivElement>>;
+declare const CheckoutSummaryProduct: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const CheckoutSummaryPlan: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const CheckoutSummaryPrice: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const CheckoutSummaryTrial: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const CheckoutSummaryTaxNote: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const CheckoutSummary: {
+    readonly Root: React.ForwardRefExoticComponent<{
+        planRef?: string;
+        productRef?: string;
+        asChild?: boolean;
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & React.RefAttributes<HTMLDivElement>>;
+    readonly Product: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly Plan: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly Price: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly Trial: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly TaxNote: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+};
+/**
+ * Hook for consumers who need the resolved plan/product/price state directly
+ * (for example, to gate sibling UI outside the primitive tree).
+ *
+ * Must be called inside `<CheckoutSummary.Root>`.
+ */
+declare function useCheckoutSummary(): CheckoutSummaryContextValue;
+
+/**
+ * PlanSelector compound primitive.
+ *
+ * Unstyled, accessible building blocks for fetching a product's active plans
+ * and letting users pick one. Consumers compose subcomponents; the top-level
+ * `@solvapay/react` package ships a thin default-tree shim in
+ * `src/components/PlanSelector.tsx`.
+ *
+ * State machine lives in the existing `usePlans` hook and
+ * `PlanSelectionContext`. Each `Card` emits `data-state=idle|selected|current|disabled`
+ * and optional `data-free`, `data-popular`, `data-trial` flags for CSS
+ * targeting without inline styles.
+ */
+
+type PlanSelectorContextValue = {
+    plans: Plan[];
+    loading: boolean;
+    error: Error | null;
+    selectedPlan: Plan | null;
+    selectedPlanRef: string | null;
+    popularPlanRef: string | undefined;
+    currentPlanRef: string | null;
+    isCurrent: (ref: string) => boolean;
+    isFree: (ref: string) => boolean;
+    isPopular: (ref: string) => boolean;
+    select: (ref: string) => void;
+};
+declare const PlanSelectorRoot: React.ForwardRefExoticComponent<{
+    productRef?: string;
+    fetcher?: (productRef: string) => Promise<Plan[]>;
+    filter?: (plan: Plan, index: number) => boolean;
+    sortBy?: (a: Plan, b: Plan) => number;
+    autoSelectFirstPaid?: boolean;
+    initialPlanRef?: string;
+    currentPlanRef?: string | null;
+    popularPlanRef?: string;
+    onSelect?: (planRef: string, plan: Plan) => void;
+    children?: React.ReactNode;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onSelect"> & React.RefAttributes<HTMLDivElement>>;
+declare const PlanSelectorHeading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLHeadingElement>>;
+declare const PlanSelectorGrid: React.ForwardRefExoticComponent<{
+    children?: React.ReactNode;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & React.RefAttributes<HTMLDivElement>>;
+declare const PlanSelectorCard: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const PlanSelectorCardName: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const PlanSelectorCardPrice: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const PlanSelectorCardInterval: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const PlanSelectorCardBadge: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    asChild?: boolean;
+} & {
+    'data-variant'?: "current" | "popular";
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const PlanSelectorLoading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const PlanSelectorError: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const PlanSelector: {
+    readonly Root: React.ForwardRefExoticComponent<{
+        productRef?: string;
+        fetcher?: (productRef: string) => Promise<Plan[]>;
+        filter?: (plan: Plan, index: number) => boolean;
+        sortBy?: (a: Plan, b: Plan) => number;
+        autoSelectFirstPaid?: boolean;
+        initialPlanRef?: string;
+        currentPlanRef?: string | null;
+        popularPlanRef?: string;
+        onSelect?: (planRef: string, plan: Plan) => void;
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onSelect"> & React.RefAttributes<HTMLDivElement>>;
+    readonly Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLHeadingElement>>;
+    readonly Grid: React.ForwardRefExoticComponent<{
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & React.RefAttributes<HTMLDivElement>>;
+    readonly Card: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLButtonElement>>;
+    readonly CardName: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly CardPrice: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly CardInterval: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly CardBadge: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+        asChild?: boolean;
+    } & {
+        'data-variant'?: "current" | "popular";
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly Loading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+    readonly Error: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+};
+/**
+ * Hook for reading the shared PlanSelector state inside the primitive tree.
+ * Must be called under `<PlanSelector.Root>`.
+ */
+declare function usePlanSelector(): PlanSelectorContextValue;
+
+/**
+ * AmountPicker compound primitive.
+ *
+ * Unstyled building blocks for the top-up amount selector: quick-pick pills
+ * (`Option`), a custom input (`Custom`), and a `Confirm` button that runs
+ * the hook's `validate()` before proceeding. State comes from
+ * `useTopupAmountSelector` via `Root` and is exposed through
+ * `useAmountPicker()` for fully custom layouts.
+ *
+ * `Option` emits `data-state=idle|selected|disabled` and a numeric
+ * `data-amount` attribute; `Custom` emits `data-state=active|dormant`
+ * based on whether the custom input holds the active resolved amount.
+ */
+
+type AmountPickerContextValue = UseTopupAmountSelectorReturn & {
+    currency: string;
+    creditsPerMinorUnit: number | null;
+    displayExchangeRate: number | null;
+    estimatedCredits: number | null;
+    isApproximate: boolean;
+};
+declare const AmountPickerRoot: React.ForwardRefExoticComponent<{
+    currency: string;
+    minAmount?: number;
+    maxAmount?: number;
+    onChange?: (amount: number | null) => void;
+    asChild?: boolean;
+    children?: React.ReactNode;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onChange"> & React.RefAttributes<HTMLDivElement>>;
+declare const AmountPickerOption: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+    amount: number;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const AmountPickerCustom: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLInputElement>>;
+declare const AmountPickerConfirm: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+    onConfirm?: (amount: number) => void;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const AmountPicker: {
+    readonly Root: React.ForwardRefExoticComponent<{
+        currency: string;
+        minAmount?: number;
+        maxAmount?: number;
+        onChange?: (amount: number | null) => void;
+        asChild?: boolean;
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onChange"> & React.RefAttributes<HTMLDivElement>>;
+    readonly Option: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean;
+        amount: number;
+    } & React.RefAttributes<HTMLButtonElement>>;
+    readonly Custom: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLInputElement>>;
+    readonly Confirm: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean;
+        onConfirm?: (amount: number) => void;
+    } & React.RefAttributes<HTMLButtonElement>>;
+};
+declare function useAmountPicker(): AmountPickerContextValue;
+/** Helper for copy consumers composing the default-tree shim. */
+declare function useAmountPickerCopy(): {
+    selectAmountLabel: string;
+    customAmountLabel: string;
+    creditEstimate: (credits: number) => string;
+};
+
+/**
+ * CancelledPlanNotice compound primitive.
+ *
+ * Banner surfaced when the customer has a cancelled-but-still-active
+ * purchase. `Root` renders `null` when no cancelled purchase exists;
+ * otherwise it emits `data-state=active|expired` and `data-has-reason`,
+ * and all leaves render only their respective slice of the cancellation
+ * data (Expires, DaysRemaining, AccessUntil, CancelledOn, Reason).
+ * `ReactivateButton` wires up `usePurchaseActions().reactivateRenewal`
+ * with `data-state=idle|reactivating`.
+ */
+
+type NoticeState = 'active' | 'expired';
+type CancelledPlanNoticeContextValue = {
+    purchase: PurchaseInfo;
+    state: NoticeState;
+    daysRemaining: number | null;
+    hasReason: boolean;
+    formatDate: (date?: string) => string | null;
+    reactivate: () => Promise<void>;
+    isReactivating: boolean;
+};
+declare const CancelledPlanNoticeRoot: React.ForwardRefExoticComponent<{
+    onReactivated?: () => void;
+    onError?: (error: Error) => void;
+    asChild?: boolean;
+    children?: React.ReactNode;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React.RefAttributes<HTMLDivElement>>;
+declare const CancelledPlanNoticeHeading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const CancelledPlanNoticeExpires: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const CancelledPlanNoticeDaysRemaining: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const CancelledPlanNoticeAccessUntil: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const CancelledPlanNoticeCancelledOn: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const CancelledPlanNoticeReason: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+declare const CancelledPlanNoticeReactivateButton: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const CancelledPlanNotice: {
+    readonly Root: React.ForwardRefExoticComponent<{
+        onReactivated?: () => void;
+        onError?: (error: Error) => void;
+        asChild?: boolean;
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React.RefAttributes<HTMLDivElement>>;
+    readonly Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    readonly Expires: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    readonly DaysRemaining: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    readonly AccessUntil: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    readonly CancelledOn: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    readonly Reason: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLSpanElement>>;
+    readonly ReactivateButton: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLButtonElement>>;
+};
+declare function useCancelledPlanNotice(): CancelledPlanNoticeContextValue;
+
+/**
+ * CreditGate compound primitive.
+ *
+ * Companion to `<PurchaseGate>` for usage-based flows. `Root` compares the
+ * customer's credit balance against a threshold and drives
+ * `data-state=allowed|blocked|loading`. Subcomponents render only in their
+ * matching state:
+ *  - `Heading`, `Subheading`, `Topup` — `blocked`
+ *  - `Loading` — `loading`
+ *  - `Error` — when `useBalance()` reports a fetch error
+ *
+ * Consumer-rendered "allowed" content is gated via the `useCreditGate()`
+ * hook or by conditionally mounting children.
+ */
+
+type GateState = 'allowed' | 'blocked' | 'loading';
+type CreditGateContextValue = {
+    state: GateState;
+    loading: boolean;
+    hasCredits: boolean;
+    balance: number | null;
+    productName: string | null;
+    topupAmount: number;
+    topupCurrency: string;
+};
+type TopupProps = {
+    amount?: number;
+    currency?: string;
+};
+declare const CreditGateRoot: React.ForwardRefExoticComponent<{
+    minCredits?: number;
+    productRef?: string;
+    topupAmount?: number;
+    topupCurrency?: string;
+    asChild?: boolean;
+    children?: React.ReactNode;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & React.RefAttributes<HTMLDivElement>>;
+declare const CreditGateHeading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLHeadingElement>>;
+declare const CreditGateSubheading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const CreditGateTopup: React.FC<TopupProps>;
+declare const CreditGateLoading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const CreditGateError: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const CreditGate: {
+    readonly Root: React.ForwardRefExoticComponent<{
+        minCredits?: number;
+        productRef?: string;
+        topupAmount?: number;
+        topupCurrency?: string;
+        asChild?: boolean;
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & React.RefAttributes<HTMLDivElement>>;
+    readonly Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLHeadingElement>>;
+    readonly Subheading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    readonly Topup: React.FC<TopupProps>;
+    readonly Loading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+    readonly Error: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+};
+declare function useCreditGate(): CreditGateContextValue;
+
+/**
+ * TopupForm compound primitive.
+ *
+ * Wraps `useTopup` + Stripe Elements to run a one-shot credit top-up.
+ * Unlike `PaymentForm`, no backend reconciliation is needed — credits land
+ * via the webhook handler, so `onSuccess` fires immediately after Stripe
+ * confirmation.
+ *
+ * `TopupForm.AmountPicker` is re-exported from the `AmountPicker` primitive
+ * so consumers can compose an in-place amount picker without importing from
+ * two modules. The amount flows into the form either via the `amount` prop
+ * on `Root` or via a sibling `AmountPicker` with matching state.
+ */
+
+type TopupFormState = 'loading' | 'ready' | 'error';
+type TopupFormContextValue = {
+    amount: number;
+    currency?: string;
+    state: TopupFormState;
+    clientSecret: string | null;
+    stripe: Stripe | null;
+    elements: StripeElements | null;
+    isReady: boolean;
+    isProcessing: boolean;
+    paymentInputComplete: boolean;
+    canSubmit: boolean;
+    error: string | null;
+    returnUrl: string;
+    setPaymentInputComplete: (complete: boolean) => void;
+    submit: () => Promise<void>;
+};
+type PaymentElementProps = {
+    options?: React.ComponentProps<typeof PaymentElement>['options'];
+};
+declare const TopupFormRoot: React.ForwardRefExoticComponent<TopupFormProps & {
+    asChild?: boolean;
+    children?: React.ReactNode;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const TopupFormPaymentElement: React.FC<PaymentElementProps>;
+declare const TopupFormSubmitButton: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const TopupFormLoading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const TopupFormError: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const TopupForm: {
+    readonly Root: React.ForwardRefExoticComponent<TopupFormProps & {
+        asChild?: boolean;
+        children?: React.ReactNode;
+    } & React.RefAttributes<HTMLDivElement>>;
+    readonly AmountPicker: React.ForwardRefExoticComponent<{
+        currency: string;
+        minAmount?: number;
+        maxAmount?: number;
+        onChange?: (amount: number | null) => void;
+        asChild?: boolean;
+        children?: React.ReactNode;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onChange"> & React.RefAttributes<HTMLDivElement>>;
+    readonly PaymentElement: React.FC<PaymentElementProps>;
+    readonly SubmitButton: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLButtonElement>>;
+    readonly Loading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+    readonly Error: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+};
+declare function useTopupForm(): TopupFormContextValue;
+
+export { AmountPicker, AmountPickerConfirm, AmountPickerCustom, AmountPickerOption, AmountPickerRoot, CancelledPlanNotice, CancelledPlanNoticeAccessUntil, CancelledPlanNoticeCancelledOn, CancelledPlanNoticeDaysRemaining, CancelledPlanNoticeExpires, CancelledPlanNoticeHeading, CancelledPlanNoticeReactivateButton, CancelledPlanNoticeReason, CancelledPlanNoticeRoot, CheckoutSummary, CheckoutSummaryPlan, CheckoutSummaryPrice, CheckoutSummaryProduct, CheckoutSummaryRoot, CheckoutSummaryTaxNote, CheckoutSummaryTrial, CreditGate, CreditGateError, CreditGateHeading, CreditGateLoading, CreditGateRoot, CreditGateSubheading, CreditGateTopup, PlanSelector, PlanSelectorCard, PlanSelectorCardBadge, PlanSelectorCardInterval, PlanSelectorCardName, PlanSelectorCardPrice, PlanSelectorError, PlanSelectorGrid, PlanSelectorHeading, PlanSelectorLoading, PlanSelectorRoot, Slot, Slottable, TopupForm, TopupFormError, TopupFormLoading, TopupFormPaymentElement, TopupFormRoot, TopupFormSubmitButton, composeEventHandlers, composeRefs, setRef, useAmountPicker, useAmountPickerCopy, useCancelledPlanNotice, useCheckoutSummary, useCreditGate, usePlanSelector, useTopupForm };