@solvapay/react 1.0.9-preview.1 → 1.0.9

package/dist/primitives/index.d.ts

@@ -0,0 +1,721 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { Ref } from 'react';
+import { b as Plan, w as Product, q as UseTopupAmountSelectorReturn, v as PurchaseInfo, T as TopupFormProps, t as PaywallStructuredContent } from '../index-onWNU7iT.js';
+import { U as UsageSnapshot } from '../useUsage-nD7zwSbG.js';
+export { r as ActivationFlow, s as ActivationFlowActivateButton, t as ActivationFlowActivated, v as ActivationFlowAmountPicker, w as ActivationFlowContinueButton, x as ActivationFlowError, y as ActivationFlowLoading, z as ActivationFlowRetrying, D as ActivationFlowRoot, A as ActivationFlowStep, E as ActivationFlowSummary, B as BalanceBadge, i as CancelPlanButton, M as MandateText, l as MandateTextProps, F as PaymentForm, c as PaymentFormCardElement, a as PaymentFormCustomerFields, h as PaymentFormError, g as PaymentFormLoading, d as PaymentFormMandateText, b as PaymentFormPaymentElement, G as PaymentFormRoot, f as PaymentFormSubmitButton, P as PaymentFormSummary, e as PaymentFormTermsCheckbox, m as PlanBadge, n as ProductBadge, o as PurchaseGate, H as PurchaseGateAllowed, I as PurchaseGateBlocked, J as PurchaseGateError, K as PurchaseGateLoading, L as PurchaseGateRoot, N as useActivationFlow, O as usePurchaseGate } from '../useUsage-nD7zwSbG.js';
+import { PaymentElement } from '@stripe/react-stripe-js';
+import { Stripe, StripeElements } from '@stripe/stripe-js';
+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;
+    /**
+     * Clear the current selection so no plan is selected. Pins
+     * `userHasSelected` true so auto-selection doesn't reassert.
+     */
+    clearSelection: () => 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;
+    emit: 'major' | 'minor';
+    creditsPerMinorUnit: number | null;
+    displayExchangeRate: number | null;
+    estimatedCredits: number | null;
+    isApproximate: boolean;
+    /**
+     * `resolvedAmount` expressed in minor units (e.g. cents). Respects
+     * zero-decimal currencies: for JPY this equals `resolvedAmount`; for USD
+     * it equals `resolvedAmount * 100`. `null` when no valid amount is set.
+     */
+    resolvedAmountMinor: number | null;
+};
+declare const AmountPickerRoot: React.ForwardRefExoticComponent<{
+    currency: string;
+    minAmount?: number;
+    maxAmount?: number;
+    /**
+     * Whether `onChange` and `Confirm.onConfirm` deliver the amount in major
+     * units (e.g. dollars, `19.99`) or minor units (e.g. cents, `1999`).
+     * Defaults to `'major'` for back-compat. Respects zero-decimal currencies
+     * (JPY → integer yen in either mode).
+     */
+    emit?: "major" | "minor";
+    /**
+     * Externally-owned selector. When provided, `Root` uses this instance
+     * instead of calling `useTopupAmountSelector` internally. Lets parent
+     * flows (e.g. `ActivationFlow.AmountPicker`) share state with the inner
+     * picker so selections feed back into retry logic.
+     */
+    selector?: UseTopupAmountSelectorReturn;
+    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;
+        /**
+         * Whether `onChange` and `Confirm.onConfirm` deliver the amount in major
+         * units (e.g. dollars, `19.99`) or minor units (e.g. cents, `1999`).
+         * Defaults to `'major'` for back-compat. Respects zero-decimal currencies
+         * (JPY → integer yen in either mode).
+         */
+        emit?: "major" | "minor";
+        /**
+         * Externally-owned selector. When provided, `Root` uses this instance
+         * instead of calling `useTopupAmountSelector` internally. Lets parent
+         * flows (e.g. `ActivationFlow.AmountPicker`) share state with the inner
+         * picker so selections feed back into retry logic.
+         */
+        selector?: UseTopupAmountSelectorReturn;
+        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>, "onError" | "children"> & 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>, "onError" | "children"> & 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;
+
+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;
+        emit?: "major" | "minor";
+        selector?: UseTopupAmountSelectorReturn;
+        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;
+
+interface PaywallNoticeClassNames {
+    root?: string;
+    heading?: string;
+    message?: string;
+    productContext?: string;
+    balance?: string;
+    plans?: string;
+    hostedLink?: string;
+    embeddedCheckout?: string;
+    retryButton?: string;
+}
+interface PaywallNoticeContextValue {
+    content: PaywallStructuredContent;
+    resolved: boolean;
+    refetch: () => Promise<void>;
+    onResolved?: () => void;
+    classNames: PaywallNoticeClassNames;
+}
+interface PaywallNoticeRootProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'content'> {
+    content: PaywallStructuredContent;
+    /**
+     * Called once the paywall requirement is met (purchase created or plan
+     * activated). Consumers typically use this to dismiss the notice and
+     * retry the original tool call.
+     */
+    onResolved?: () => void;
+    classNames?: PaywallNoticeClassNames;
+    asChild?: boolean;
+}
+declare const Root$1: React.ForwardRefExoticComponent<PaywallNoticeRootProps & React.RefAttributes<HTMLDivElement>>;
+declare const Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLHeadingElement>>;
+declare const Message: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLParagraphElement>>;
+declare const ProductContext: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const Balance: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+interface PlansProps {
+    /** Custom className forwarded to the underlying `<PlanSelector.Root>`. */
+    className?: string;
+    children?: React.ReactNode;
+}
+declare function Plans({ className, children }: PlansProps): react_jsx_runtime.JSX.Element | null;
+declare const HostedCheckoutLink: React.ForwardRefExoticComponent<React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLAnchorElement>>;
+interface EmbeddedCheckoutProps {
+    /**
+     * Return URL forwarded to `<PaymentForm.Root>` for Stripe's
+     * confirmPayment step.
+     */
+    returnUrl: string;
+    className?: string;
+    children?: React.ReactNode;
+}
+declare function EmbeddedCheckout({ returnUrl, className, children, }: EmbeddedCheckoutProps): react_jsx_runtime.JSX.Element | null;
+declare const Retry: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const PaywallNotice: React.ForwardRefExoticComponent<PaywallNoticeRootProps & React.RefAttributes<HTMLDivElement>> & {
+    Root: React.ForwardRefExoticComponent<PaywallNoticeRootProps & React.RefAttributes<HTMLDivElement>>;
+    Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLHeadingElement>>;
+    Message: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLParagraphElement>>;
+    ProductContext: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+    Plans: typeof Plans;
+    Balance: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+    HostedCheckoutLink: React.ForwardRefExoticComponent<React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLAnchorElement>>;
+    EmbeddedCheckout: typeof EmbeddedCheckout;
+    Retry: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLButtonElement>>;
+};
+
+declare function usePaywallNotice(): PaywallNoticeContextValue;
+
+/**
+ * `<UsageMeter>` compound primitive — renders the authenticated customer's
+ * usage against their plan quota.
+ *
+ * Composes `useUsage()` internally so integrators only render the leaf
+ * primitives they care about. Leaves render `null` when the active plan
+ * isn't usage-based, so dropping the compound into any account page is
+ * safe.
+ *
+ * State:
+ *  - root / bar `data-state="safe" | "warning" | "critical" | "loading"`
+ *  - root `data-solvapay-usage-meter`
+ *  - bar  `data-solvapay-usage-meter-bar`
+ */
+
+type UsageMeterState = 'safe' | 'warning' | 'critical' | 'loading';
+interface UsageMeterContextValue {
+    usage: UsageSnapshot | null;
+    loading: boolean;
+    error: Error | null;
+    percentUsed: number | null;
+    isApproachingLimit: boolean;
+    isAtLimit: boolean;
+    isUnlimited: boolean;
+    state: UsageMeterState;
+    warningAt: number;
+    criticalAt: number;
+}
+interface UsageMeterClassNames {
+    root?: string;
+    bar?: string;
+    label?: string;
+    percentage?: string;
+    resetsIn?: string;
+    loading?: string;
+    empty?: string;
+    error?: string;
+}
+interface UsageMeterRootProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Percent at which the bar flips to `data-state="warning"`. Default 75. */
+    warningAt?: number;
+    /** Percent at which the bar flips to `data-state="critical"`. Default 90. */
+    criticalAt?: number;
+    classNames?: UsageMeterClassNames;
+    asChild?: boolean;
+    /**
+     * Override the usage snapshot rather than reading from `useUsage`.
+     * Mostly useful for tests / Storybook demos.
+     */
+    usageOverride?: UsageSnapshot | null;
+}
+declare const Root: React.ForwardRefExoticComponent<UsageMeterRootProps & React.RefAttributes<HTMLDivElement>>;
+declare const Bar: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const Label: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+declare const Percentage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+declare const ResetsIn: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+declare const Loading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const Empty: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const UsageMeter: React.ForwardRefExoticComponent<UsageMeterRootProps & React.RefAttributes<HTMLDivElement>> & {
+    Root: React.ForwardRefExoticComponent<UsageMeterRootProps & React.RefAttributes<HTMLDivElement>>;
+    Bar: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    Label: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+    Percentage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+    ResetsIn: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+    Loading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    Empty: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+};
+
+declare function useUsageMeter(): UsageMeterContextValue;
+
+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, PaywallNotice, Balance as PaywallNoticeBalance, type PaywallNoticeClassNames, EmbeddedCheckout as PaywallNoticeEmbeddedCheckout, Heading as PaywallNoticeHeading, HostedCheckoutLink as PaywallNoticeHostedCheckoutLink, Message as PaywallNoticeMessage, Plans as PaywallNoticePlans, ProductContext as PaywallNoticeProductContext, Retry as PaywallNoticeRetry, Root$1 as PaywallNoticeRoot, type PaywallNoticeRootProps, PlanSelector, PlanSelectorCard, PlanSelectorCardBadge, PlanSelectorCardInterval, PlanSelectorCardName, PlanSelectorCardPrice, PlanSelectorError, PlanSelectorGrid, PlanSelectorHeading, PlanSelectorLoading, PlanSelectorRoot, Slot, Slottable, TopupForm, TopupFormError, TopupFormLoading, TopupFormPaymentElement, TopupFormRoot, TopupFormSubmitButton, UsageMeter, Bar as UsageMeterBar, type UsageMeterClassNames, Empty as UsageMeterEmpty, Label as UsageMeterLabel, Loading as UsageMeterLoading, Percentage as UsageMeterPercentage, ResetsIn as UsageMeterResetsIn, Root as UsageMeterRoot, type UsageMeterRootProps, composeEventHandlers, composeRefs, setRef, useAmountPicker, useAmountPickerCopy, useCancelledPlanNotice, useCheckoutSummary, useCreditGate, usePaywallNotice, usePlanSelector, useTopupForm, useUsageMeter };