@solvapay/react 1.0.8-preview.9 → 1.0.9

package/dist/primitives/index.d.cts

@@ -1,10 +1,10 @@
 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-CieT9swn.cjs';
-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-CieT9swn.cjs';
+import { b as Plan, w as Product, q as UseTopupAmountSelectorReturn, v as PurchaseInfo, T as TopupFormProps, t as PaywallStructuredContent } from '../index-WBjulQHf.cjs';
+import { U as UsageSnapshot } from '../useUsage-BmOYXxgG.cjs';
+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-BmOYXxgG.cjs';
 import { PaymentElement } from '@stripe/react-stripe-js';
 import { Stripe, StripeElements } from '@stripe/stripe-js';
-import '@solvapay/server';
 import '../adapters/auth.cjs';
 
 interface SlotProps extends React.HTMLAttributes<HTMLElement> {
@@ -141,6 +141,11 @@ type PlanSelectorContextValue = {
     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;
@@ -248,15 +253,36 @@ declare function usePlanSelector(): PlanSelectorContextValue;
 
 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;
@@ -277,6 +303,20 @@ declare const AmountPicker: {
         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;
@@ -328,7 +368,7 @@ declare const CancelledPlanNoticeRoot: React.ForwardRefExoticComponent<{
     onError?: (error: Error) => void;
     asChild?: boolean;
     children?: React.ReactNode;
-} & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React.RefAttributes<HTMLDivElement>>;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "onError" | "children"> & React.RefAttributes<HTMLDivElement>>;
 declare const CancelledPlanNoticeHeading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
     asChild?: boolean;
 } & React.RefAttributes<HTMLParagraphElement>>;
@@ -356,7 +396,7 @@ declare const CancelledPlanNotice: {
         onError?: (error: Error) => void;
         asChild?: boolean;
         children?: React.ReactNode;
-    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React.RefAttributes<HTMLDivElement>>;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "onError" | "children"> & React.RefAttributes<HTMLDivElement>>;
     readonly Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
         asChild?: boolean;
     } & React.RefAttributes<HTMLParagraphElement>>;
@@ -456,20 +496,6 @@ declare const CreditGate: {
 };
 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;
@@ -513,6 +539,8 @@ declare const TopupForm: {
         currency: string;
         minAmount?: number;
         maxAmount?: number;
+        emit?: "major" | "minor";
+        selector?: UseTopupAmountSelectorReturn;
         onChange?: (amount: number | null) => void;
         asChild?: boolean;
         children?: React.ReactNode;
@@ -530,4 +558,164 @@ declare const TopupForm: {
 };
 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 };
+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 };

package/dist/primitives/index.d.ts

@@ -1,10 +1,10 @@
 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 { 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 '@solvapay/server';
 import '../adapters/auth.js';
 
 interface SlotProps extends React.HTMLAttributes<HTMLElement> {
@@ -141,6 +141,11 @@ type PlanSelectorContextValue = {
     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;
@@ -248,15 +253,36 @@ declare function usePlanSelector(): PlanSelectorContextValue;
 
 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;
@@ -277,6 +303,20 @@ declare const AmountPicker: {
         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;
@@ -328,7 +368,7 @@ declare const CancelledPlanNoticeRoot: React.ForwardRefExoticComponent<{
     onError?: (error: Error) => void;
     asChild?: boolean;
     children?: React.ReactNode;
-} & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React.RefAttributes<HTMLDivElement>>;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, "onError" | "children"> & React.RefAttributes<HTMLDivElement>>;
 declare const CancelledPlanNoticeHeading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
     asChild?: boolean;
 } & React.RefAttributes<HTMLParagraphElement>>;
@@ -356,7 +396,7 @@ declare const CancelledPlanNotice: {
         onError?: (error: Error) => void;
         asChild?: boolean;
         children?: React.ReactNode;
-    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onError"> & React.RefAttributes<HTMLDivElement>>;
+    } & Omit<React.HTMLAttributes<HTMLDivElement>, "onError" | "children"> & React.RefAttributes<HTMLDivElement>>;
     readonly Heading: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
         asChild?: boolean;
     } & React.RefAttributes<HTMLParagraphElement>>;
@@ -456,20 +496,6 @@ declare const CreditGate: {
 };
 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;
@@ -513,6 +539,8 @@ declare const TopupForm: {
         currency: string;
         minAmount?: number;
         maxAmount?: number;
+        emit?: "major" | "minor";
+        selector?: UseTopupAmountSelectorReturn;
         onChange?: (amount: number | null) => void;
         asChild?: boolean;
         children?: React.ReactNode;
@@ -530,4 +558,164 @@ declare const TopupForm: {
 };
 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 };
+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 };