@kerne/react 1.2.0 → 1.3.0

package/dist/ui/index.d.cts

@@ -1,50 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { PublicPlan, PublicPriceLabel, PublicPlanPrice, SubscriptionWithPlan } from '@kerne/types';
-import { K as KerneLocalization } from '../i18n-CXEhPK58.cjs';
-export { d as defaultLocalization, u as useLocalization } from '../i18n-CXEhPK58.cjs';
-
-/**
- * Per-instance overrides of the same custom properties the stylesheet reads,
- * applied as inline style so they win over the class defaults without
- * specificity tricks.
- */
-interface KerneAppearance {
-    /**
-     * `light` (default), `dark`, or `system` to follow the visitor's OS. Not
-     * defaulted to `system`: a light-only host would silently render a dark form
-     * for half its users.
-     */
-    theme?: 'light' | 'dark' | 'system';
-    /**
-     * The brand colour. Drives the primary button, and - unless overridden below -
-     * its label, its hover, and the accent used for focus rings and links.
-     */
-    primaryColor?: string;
-    /** Label on the primary button. Derived from `primaryColor` when omitted. */
-    primaryTextColor?: string;
-    /** Focus rings and links. Falls back to `primaryColor`. */
-    accentColor?: string;
-    textColor?: string;
-    borderColor?: string;
-    /** Background of error/info panels. */
-    panelColor?: string;
-    /**
-     * The ground the component sits on. Leave unset when embedding (the host's
-     * page shows through); set it when the component owns the viewport, so its
-     * text can never resolve against a background it doesn't know about.
-     */
-    background?: string;
-    /** Opaque ground for the card variant, the account dropdown, a pressed segment. */
-    surfaceColor?: string;
-    /** `card` wraps the screen in a bordered, raised container. Defaults to `none`. */
-    surface?: 'none' | 'card';
-    fontFamily?: string;
-    /** Corner radius on inputs and buttons, e.g. `"0px"` for square. */
-    radius?: string;
-    /** Height of inputs and buttons. Defaults to `"44px"`. */
-    controlHeight?: string;
-}
+import { a as KerneAppearance, K as KerneLocalization } from '../fr-E5mmylSH.cjs';
+export { d as defaultLocalization, b as defaultTokens, f as fr, m as mergeLocalization, u as useLocalization } from '../fr-E5mmylSH.cjs';
+import { PublicPlan, PublicPriceLabel, PublicPlanPrice, DriverSelection, SubscriptionWithPlan } from '@kerne/types';
 
 interface KerneUIProps {
     appearance?: KerneAppearance;
@@ -64,15 +22,11 @@ interface AuthFlowProps extends KerneUIProps {
     onSuccess?: () => void;
     /** Hand the session to another origin (the hosted portal's job). */
     redirectUrl?: string;
-    /** Where emailed links should land. Defaults to the tenant's configured callbacks. */
-    magicLinkCallbackUrl?: string;
-    resetPasswordCallbackUrl?: string;
-    verificationCallbackUrl?: string;
     /** Skip sign-up entirely, even on an OPEN tenant (e.g. an internal tool). */
     allowSignUp?: boolean;
     legal?: React.ReactNode;
 }
-declare function AuthFlow({ initialStep, step: controlledStep, onStepChange, onSuccess, redirectUrl, magicLinkCallbackUrl, resetPasswordCallbackUrl, verificationCallbackUrl, allowSignUp, legal, appearance, logo, className, }: AuthFlowProps): react_jsx_runtime.JSX.Element;
+declare function AuthFlow({ initialStep, step: controlledStep, onStepChange, onSuccess, redirectUrl, allowSignUp, legal, appearance, logo, className, }: AuthFlowProps): react_jsx_runtime.JSX.Element;
 
 interface LoginFormProps extends KerneUIProps {
     /** Called after a successful password sign-in. */
@@ -82,8 +36,6 @@ interface LoginFormProps extends KerneUIProps {
      * job - see `redirectWithSession`). Takes precedence over `onSuccess`.
      */
     redirectUrl?: string;
-    /** Where the emailed sign-in link should land. Defaults to the tenant's configured callback. */
-    magicLinkCallbackUrl?: string;
     signUpUrl?: string;
     onSignUpClick?: () => void;
     forgotPasswordUrl?: string;
@@ -95,14 +47,12 @@ interface LoginFormProps extends KerneUIProps {
     /** Small print under the form, e.g. terms and privacy links. */
     legal?: React.ReactNode;
 }
-declare function LoginForm({ onSuccess, redirectUrl, magicLinkCallbackUrl, signUpUrl, onSignUpClick, forgotPasswordUrl, onForgotPasswordClick, onOAuthSelect, title, subtitle, legal, appearance, logo, className, }: LoginFormProps): react_jsx_runtime.JSX.Element;
+declare function LoginForm({ onSuccess, redirectUrl, signUpUrl, onSignUpClick, forgotPasswordUrl, onForgotPasswordClick, onOAuthSelect, title, subtitle, legal, appearance, logo, className, }: LoginFormProps): react_jsx_runtime.JSX.Element;
 
 interface RegisterFormProps extends KerneUIProps {
     onSuccess?: () => void;
     /** Hand the session to another origin after sign-up (hosted portal). */
     redirectUrl?: string;
-    /** Where the emailed sign-up link should land. Defaults to the tenant's configured callback. */
-    magicLinkCallbackUrl?: string;
     /**
      * Invitation token. Read from `?token=` in the URL when omitted, so an
      * emailed invitation link works with no wiring on the host's side.
@@ -117,7 +67,7 @@ interface RegisterFormProps extends KerneUIProps {
     /** Collect a display name alongside the credentials. */
     collectName?: boolean;
 }
-declare function RegisterForm({ onSuccess, redirectUrl, magicLinkCallbackUrl, invitationToken: invitationTokenProp, signInUrl, onSignInClick, onOAuthSelect, title, subtitle, legal, collectName, appearance, logo, className, }: RegisterFormProps): react_jsx_runtime.JSX.Element;
+declare function RegisterForm({ onSuccess, redirectUrl, invitationToken: invitationTokenProp, signInUrl, onSignInClick, onOAuthSelect, title, subtitle, legal, collectName, appearance, logo, className, }: RegisterFormProps): react_jsx_runtime.JSX.Element;
 
 interface MagicLinkCallbackProps extends KerneUIProps {
     /** Overrides the `?token=` query param - for hosts that parse routes themselves. */
@@ -131,15 +81,13 @@ interface MagicLinkCallbackProps extends KerneUIProps {
 declare function MagicLinkCallback({ token: tokenProp, onSuccess, redirectUrl, signInUrl, onSignInClick, appearance, logo, className, }: MagicLinkCallbackProps): react_jsx_runtime.JSX.Element;
 
 interface ForgotPasswordFormProps extends KerneUIProps {
-    /** Where the emailed reset link should land. Defaults to the tenant's configured callback. */
-    callbackUrl?: string;
     signInUrl?: string;
     onSignInClick?: () => void;
     onSent?: (email: string) => void;
     title?: string;
     subtitle?: React.ReactNode;
 }
-declare function ForgotPasswordForm({ callbackUrl, signInUrl, onSignInClick, onSent, title, subtitle, appearance, logo, className, }: ForgotPasswordFormProps): react_jsx_runtime.JSX.Element;
+declare function ForgotPasswordForm({ signInUrl, onSignInClick, onSent, title, subtitle, appearance, logo, className, }: ForgotPasswordFormProps): react_jsx_runtime.JSX.Element;
 
 interface ResetPasswordFormProps extends KerneUIProps {
     /** Overrides the `?token=` query param. */
@@ -155,13 +103,11 @@ declare function ResetPasswordForm({ token: tokenProp, signInUrl, onSignInClick,
 interface VerifyEmailFormProps extends KerneUIProps {
     /** Overrides the `?token=` query param. */
     token?: string;
-    /** Where a resent verification link should land. */
-    callbackUrl?: string;
     onVerified?: () => void;
     title?: string;
     subtitle?: React.ReactNode;
 }
-declare function VerifyEmailForm({ token: tokenProp, callbackUrl, onVerified, title, subtitle, appearance, logo, className, }: VerifyEmailFormProps): react_jsx_runtime.JSX.Element;
+declare function VerifyEmailForm({ token: tokenProp, onVerified, title, subtitle, appearance, logo, className, }: VerifyEmailFormProps): react_jsx_runtime.JSX.Element;
 
 interface ActivateAccountFormProps extends KerneUIProps {
     /** Overrides the `?token=` query param. */
@@ -248,16 +194,12 @@ interface UserProfileProps extends Omit<KerneUIProps, 'logo'> {
     onDeleted?: () => void;
     productSlug?: string;
     pricingProductIdOrSlug?: string;
-    portalReturnUrl?: string;
-    checkoutSuccessUrl?: string;
-    checkoutCancelUrl?: string;
     showPlanSwitcher?: boolean;
     showUsage?: boolean;
     usageFeatureKeys?: string[];
     usageLabels?: Record<string, string>;
-    verificationCallbackUrl?: string;
 }
-declare function UserProfile({ tabs, extraTabs, defaultTab, activeTab: controlledTab, onTabChange, showDeleteAccount, onSaved, onDeleted, productSlug, pricingProductIdOrSlug, portalReturnUrl, checkoutSuccessUrl, checkoutCancelUrl, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, verificationCallbackUrl, appearance, className, }: UserProfileProps): react_jsx_runtime.JSX.Element;
+declare function UserProfile({ tabs, extraTabs, defaultTab, activeTab: controlledTab, onTabChange, showDeleteAccount, onSaved, onDeleted, productSlug, pricingProductIdOrSlug, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, appearance, className, }: UserProfileProps): react_jsx_runtime.JSX.Element;
 
 /**
  * "Profile" pane: who the user is, and the address they sign in with.
@@ -268,11 +210,9 @@ declare function UserProfile({ tabs, extraTabs, defaultTab, activeTab: controlle
  * fails on save.
  */
 interface ProfileSectionProps {
-    /** Where a resent verification link should land. */
-    verificationCallbackUrl?: string;
     onSaved?: () => void;
 }
-declare function ProfileSection({ verificationCallbackUrl, onSaved }: ProfileSectionProps): react_jsx_runtime.JSX.Element;
+declare function ProfileSection({ onSaved }: ProfileSectionProps): react_jsx_runtime.JSX.Element;
 
 /**
  * "Security" pane: password, and leaving.
@@ -296,38 +236,33 @@ declare function SecuritySection({ showDeleteAccount, onDeleted }: SecuritySecti
  * "Billing" pane: the active plan, what it has been used for, and how to move
  * to another one.
  *
- * The plan switcher is a settings control, not the marketing pricing page: it
- * lists what this scope can move to and starts a checkout, and deliberately
- * does not sell. `<PricingTable>` is the surface that sells.
- *
- * Interval handling is the honest minimum until PriceLabel exists here too:
- * prices are grouped by `interval`, and the segmented control only renders
- * when a plan genuinely has more than one. A
- * plan carrying a third price (early-bird, non-profit) still has no way to be
- * described here - which is exactly the gap PriceLabel closes.
+ * The plan switcher used to be a bespoke, minimal list - deliberately not
+ * `<PricingTable>`, on the theory that a settings control shouldn't "sell" to
+ * someone who is already a customer. In practice that meant two independent
+ * implementations of "list plans, handle the switch" drifting apart (this one
+ * grouped prices by raw `interval` and had no path to a plan carrying a third
+ * price - early-bird, non-profit - where `<PricingTable>` already understood
+ * `PriceLabel`), and every fix to one never reached the other. This pane now
+ * composes the same `<PricingTable>` the marketing pricing page uses: one
+ * surface to keep polished instead of two to keep in sync.
  */
 interface BillingSectionProps {
     productSlug?: string;
     /** Product the plan list is read from. Defaults to the tenant's default product. */
     pricingProductIdOrSlug?: string;
-    portalReturnUrl?: string;
-    checkoutSuccessUrl?: string;
-    checkoutCancelUrl?: string;
     /** Hide the plan switcher, e.g. when plan changes go through sales. */
     showPlanSwitcher?: boolean;
     showUsage?: boolean;
     usageFeatureKeys?: string[];
     usageLabels?: Record<string, string>;
 }
-declare function BillingSection({ productSlug, pricingProductIdOrSlug, portalReturnUrl, checkoutSuccessUrl, checkoutCancelUrl, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, }: BillingSectionProps): react_jsx_runtime.JSX.Element;
+declare function BillingSection({ productSlug, pricingProductIdOrSlug, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, }: BillingSectionProps): react_jsx_runtime.JSX.Element;
 
 interface SubscriptionCardProps extends Omit<KerneUIProps, 'logo'> {
     /** Restrict to one product, when the tenant sells several. */
     productSlug?: string;
     /** Heading above the details. Omit for the localized default, `null` for none. */
     title?: string | null;
-    /** Where the provider portal should return to. */
-    portalReturnUrl?: string;
     /** Shown when there is no active subscription - your pricing page. */
     upgradeUrl?: string;
     onUpgradeClick?: () => void;
@@ -336,7 +271,7 @@ interface SubscriptionCardProps extends Omit<KerneUIProps, 'logo'> {
     /** Hide the "Cancel subscription" button, e.g. when cancellation goes through sales/support. */
     hideCancelButton?: boolean;
 }
-declare function SubscriptionCard({ productSlug, title, portalReturnUrl, upgradeUrl, onUpgradeClick, hidePortalButton, hideCancelButton, appearance, className, }: SubscriptionCardProps): react_jsx_runtime.JSX.Element;
+declare function SubscriptionCard({ productSlug, title, upgradeUrl, onUpgradeClick, hidePortalButton, hideCancelButton, appearance, className, }: SubscriptionCardProps): react_jsx_runtime.JSX.Element;
 
 interface UsageMetersProps extends Omit<KerneUIProps, 'logo'> {
     /** Heading above the meters. Omit for the localized default, `null` for none. */
@@ -365,7 +300,7 @@ declare function UsageMeters({ title, featureKeys, showUnlimited, limit: maxRows
  * (see EntitlementSummary), while the subscription payload does carry names -
  * so components cross-reference the subscription first and only fall back
  * here for a scope on a default pack, which has no subscription to read names
- * from. Turning `api_calls` into "Api calls" is not as good as the real name;
+ * from. Turning `api_calls` into "API calls" is not as good as the real name;
  * it is only better than showing a raw key to an end user.
  */
 declare function humanizeFeatureKey(key: string): string;
@@ -435,8 +370,10 @@ interface PricingTableContextValue {
     setSelectedLabelSlug: (slug: string) => void;
     savings: LabelSavings | null;
     currentPlanId: string | null;
+    /** The currency the subject is already billed in, or null with no subscription - see `Plan`'s currency-mismatch guard. */
+    currentPriceCurrency: string | null;
     busyPriceId: string | null;
-    onSelectPlan: (plan: PublicPlan) => void;
+    onSelectPlan: (plan: PublicPlan, drivers?: DriverSelection[]) => void;
 }
 /**
  * Headless access to the same state `<PricingTable.LabelSwitch>`/`<PricingTable.Plan>`
@@ -449,11 +386,12 @@ interface PricingTableProps extends Omit<KerneUIProps, 'logo'> {
     product?: string;
     /** Label slug selected on first render. Defaults to the first label by PriceLabel.sort_order once the catalog loads. */
     defaultLabel?: string;
-    /** Where the provider checkout should return to. */
-    checkoutSuccessUrl?: string;
-    checkoutCancelUrl?: string;
-    /** Overrides the built-in checkout - e.g. a marketing site that wants its own confirmation step first. */
-    onSelectPlan?: (plan: PublicPlan, price: PublicPlanPrice) => void;
+    /**
+     * Overrides the built-in checkout - e.g. a marketing site that wants its own confirmation step
+     * first. `drivers` carries what the buyer sized on the prepaid rails, and must be forwarded to
+     * `checkout()` or the sizing is lost.
+     */
+    onSelectPlan?: (plan: PublicPlan, price: PublicPlanPrice, drivers?: DriverSelection[]) => void;
     children: React.ReactNode;
 }
 /**
@@ -462,8 +400,9 @@ interface PricingTableProps extends Omit<KerneUIProps, 'logo'> {
  * once real data exists - they never have to handle a "plan not loaded yet"
  * state of their own.
  */
-declare function PricingTable({ product, defaultLabel, checkoutSuccessUrl, checkoutCancelUrl, onSelectPlan, appearance, className, children, }: PricingTableProps): react_jsx_runtime.JSX.Element;
+declare function PricingTable({ product, defaultLabel, onSelectPlan, appearance, className, children, }: PricingTableProps): react_jsx_runtime.JSX.Element;
 declare namespace PricingTable {
+    var Header: ({ eyebrow, headline, lede }: PricingTableHeaderProps) => react_jsx_runtime.JSX.Element;
     var LabelSwitch: () => react_jsx_runtime.JSX.Element | null;
     var Plan: ({ slug, featured, badge, maxFeatures }: PricingTablePlanProps) => react_jsx_runtime.JSX.Element | null;
     var Plans: ({ featuredSlug, featuredBadge, maxFeatures }: PricingTablePlansProps) => react_jsx_runtime.JSX.Element;
@@ -485,6 +424,13 @@ interface PricingTablePlansProps {
     featuredBadge?: string;
     maxFeatures?: number;
 }
+interface PricingTableHeaderProps {
+    /** Small tracked line above the headline - a product name, a version, a category. */
+    eyebrow?: string;
+    headline: string;
+    /** One sentence under it. Say how billing works, not how great the product is. */
+    lede?: string;
+}
 
 interface CheckoutResultProps extends KerneUIProps {
     /** `cancel` renders the abandoned-checkout copy and skips polling entirely. */
@@ -523,4 +469,4 @@ interface UpgradePromptProps extends Omit<KerneUIProps, 'logo'> {
 }
 declare function UpgradePrompt({ featureKey, requested, featureName, children, upgradeUrl, onUpgradeClick, upgradeLabel, title, description, hideWhileLoading, appearance, className, }: UpgradePromptProps): react_jsx_runtime.JSX.Element | null;
 
-export { ActivateAccountForm, type ActivateAccountFormProps, AuthFlow, type AuthFlowProps, type AuthFlowStep, BillingSection, type BillingSectionProps, ChangePasswordForm, type ChangePasswordFormProps, CheckoutResult, type CheckoutResultProps, ForgotPasswordForm, type ForgotPasswordFormProps, type KerneAppearance, KerneLocalization, type LabelSavings, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, type PriceDisplay, PricingTable, type PricingTablePlanProps, type PricingTablePlansProps, type PricingTableProps, ProfileSection, type ProfileSectionProps, RegisterForm, type RegisterFormProps, ResetPasswordForm, type ResetPasswordFormProps, SecuritySection, type SecuritySectionProps, SignOutButton, type SignOutButtonProps, SubscriptionCard, type SubscriptionCardProps, UpgradePrompt, type UpgradePromptProps, UsageMeters, type UsageMetersProps, UserButton, type UserButtonMenuItem, type UserButtonProps, UserProfile, type UserProfileExtraTab, type UserProfileProps, type UserProfileTab, VerifyEmailForm, type VerifyEmailFormProps, WaitlistForm, type WaitlistFormProps, collectPriceLabels, formatDate, formatInterval, formatMoney, formatNumber, humanizeFeatureKey, resolveLabelSavings, resolvePriceDisplay, usePricingTable };
+export { ActivateAccountForm, type ActivateAccountFormProps, AuthFlow, type AuthFlowProps, type AuthFlowStep, BillingSection, type BillingSectionProps, ChangePasswordForm, type ChangePasswordFormProps, CheckoutResult, type CheckoutResultProps, ForgotPasswordForm, type ForgotPasswordFormProps, KerneAppearance, KerneLocalization, type LabelSavings, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, type PriceDisplay, PricingTable, type PricingTableHeaderProps, type PricingTablePlanProps, type PricingTablePlansProps, type PricingTableProps, ProfileSection, type ProfileSectionProps, RegisterForm, type RegisterFormProps, ResetPasswordForm, type ResetPasswordFormProps, SecuritySection, type SecuritySectionProps, SignOutButton, type SignOutButtonProps, SubscriptionCard, type SubscriptionCardProps, UpgradePrompt, type UpgradePromptProps, UsageMeters, type UsageMetersProps, UserButton, type UserButtonMenuItem, type UserButtonProps, UserProfile, type UserProfileExtraTab, type UserProfileProps, type UserProfileTab, VerifyEmailForm, type VerifyEmailFormProps, WaitlistForm, type WaitlistFormProps, collectPriceLabels, formatDate, formatInterval, formatMoney, formatNumber, humanizeFeatureKey, resolveLabelSavings, resolvePriceDisplay, usePricingTable };

package/dist/ui/index.d.ts

@@ -1,50 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { PublicPlan, PublicPriceLabel, PublicPlanPrice, SubscriptionWithPlan } from '@kerne/types';
-import { K as KerneLocalization } from '../i18n-CXEhPK58.js';
-export { d as defaultLocalization, u as useLocalization } from '../i18n-CXEhPK58.js';
-
-/**
- * Per-instance overrides of the same custom properties the stylesheet reads,
- * applied as inline style so they win over the class defaults without
- * specificity tricks.
- */
-interface KerneAppearance {
-    /**
-     * `light` (default), `dark`, or `system` to follow the visitor's OS. Not
-     * defaulted to `system`: a light-only host would silently render a dark form
-     * for half its users.
-     */
-    theme?: 'light' | 'dark' | 'system';
-    /**
-     * The brand colour. Drives the primary button, and - unless overridden below -
-     * its label, its hover, and the accent used for focus rings and links.
-     */
-    primaryColor?: string;
-    /** Label on the primary button. Derived from `primaryColor` when omitted. */
-    primaryTextColor?: string;
-    /** Focus rings and links. Falls back to `primaryColor`. */
-    accentColor?: string;
-    textColor?: string;
-    borderColor?: string;
-    /** Background of error/info panels. */
-    panelColor?: string;
-    /**
-     * The ground the component sits on. Leave unset when embedding (the host's
-     * page shows through); set it when the component owns the viewport, so its
-     * text can never resolve against a background it doesn't know about.
-     */
-    background?: string;
-    /** Opaque ground for the card variant, the account dropdown, a pressed segment. */
-    surfaceColor?: string;
-    /** `card` wraps the screen in a bordered, raised container. Defaults to `none`. */
-    surface?: 'none' | 'card';
-    fontFamily?: string;
-    /** Corner radius on inputs and buttons, e.g. `"0px"` for square. */
-    radius?: string;
-    /** Height of inputs and buttons. Defaults to `"44px"`. */
-    controlHeight?: string;
-}
+import { a as KerneAppearance, K as KerneLocalization } from '../fr-E5mmylSH.js';
+export { d as defaultLocalization, b as defaultTokens, f as fr, m as mergeLocalization, u as useLocalization } from '../fr-E5mmylSH.js';
+import { PublicPlan, PublicPriceLabel, PublicPlanPrice, DriverSelection, SubscriptionWithPlan } from '@kerne/types';
 
 interface KerneUIProps {
     appearance?: KerneAppearance;
@@ -64,15 +22,11 @@ interface AuthFlowProps extends KerneUIProps {
     onSuccess?: () => void;
     /** Hand the session to another origin (the hosted portal's job). */
     redirectUrl?: string;
-    /** Where emailed links should land. Defaults to the tenant's configured callbacks. */
-    magicLinkCallbackUrl?: string;
-    resetPasswordCallbackUrl?: string;
-    verificationCallbackUrl?: string;
     /** Skip sign-up entirely, even on an OPEN tenant (e.g. an internal tool). */
     allowSignUp?: boolean;
     legal?: React.ReactNode;
 }
-declare function AuthFlow({ initialStep, step: controlledStep, onStepChange, onSuccess, redirectUrl, magicLinkCallbackUrl, resetPasswordCallbackUrl, verificationCallbackUrl, allowSignUp, legal, appearance, logo, className, }: AuthFlowProps): react_jsx_runtime.JSX.Element;
+declare function AuthFlow({ initialStep, step: controlledStep, onStepChange, onSuccess, redirectUrl, allowSignUp, legal, appearance, logo, className, }: AuthFlowProps): react_jsx_runtime.JSX.Element;
 
 interface LoginFormProps extends KerneUIProps {
     /** Called after a successful password sign-in. */
@@ -82,8 +36,6 @@ interface LoginFormProps extends KerneUIProps {
      * job - see `redirectWithSession`). Takes precedence over `onSuccess`.
      */
     redirectUrl?: string;
-    /** Where the emailed sign-in link should land. Defaults to the tenant's configured callback. */
-    magicLinkCallbackUrl?: string;
     signUpUrl?: string;
     onSignUpClick?: () => void;
     forgotPasswordUrl?: string;
@@ -95,14 +47,12 @@ interface LoginFormProps extends KerneUIProps {
     /** Small print under the form, e.g. terms and privacy links. */
     legal?: React.ReactNode;
 }
-declare function LoginForm({ onSuccess, redirectUrl, magicLinkCallbackUrl, signUpUrl, onSignUpClick, forgotPasswordUrl, onForgotPasswordClick, onOAuthSelect, title, subtitle, legal, appearance, logo, className, }: LoginFormProps): react_jsx_runtime.JSX.Element;
+declare function LoginForm({ onSuccess, redirectUrl, signUpUrl, onSignUpClick, forgotPasswordUrl, onForgotPasswordClick, onOAuthSelect, title, subtitle, legal, appearance, logo, className, }: LoginFormProps): react_jsx_runtime.JSX.Element;
 
 interface RegisterFormProps extends KerneUIProps {
     onSuccess?: () => void;
     /** Hand the session to another origin after sign-up (hosted portal). */
     redirectUrl?: string;
-    /** Where the emailed sign-up link should land. Defaults to the tenant's configured callback. */
-    magicLinkCallbackUrl?: string;
     /**
      * Invitation token. Read from `?token=` in the URL when omitted, so an
      * emailed invitation link works with no wiring on the host's side.
@@ -117,7 +67,7 @@ interface RegisterFormProps extends KerneUIProps {
     /** Collect a display name alongside the credentials. */
     collectName?: boolean;
 }
-declare function RegisterForm({ onSuccess, redirectUrl, magicLinkCallbackUrl, invitationToken: invitationTokenProp, signInUrl, onSignInClick, onOAuthSelect, title, subtitle, legal, collectName, appearance, logo, className, }: RegisterFormProps): react_jsx_runtime.JSX.Element;
+declare function RegisterForm({ onSuccess, redirectUrl, invitationToken: invitationTokenProp, signInUrl, onSignInClick, onOAuthSelect, title, subtitle, legal, collectName, appearance, logo, className, }: RegisterFormProps): react_jsx_runtime.JSX.Element;
 
 interface MagicLinkCallbackProps extends KerneUIProps {
     /** Overrides the `?token=` query param - for hosts that parse routes themselves. */
@@ -131,15 +81,13 @@ interface MagicLinkCallbackProps extends KerneUIProps {
 declare function MagicLinkCallback({ token: tokenProp, onSuccess, redirectUrl, signInUrl, onSignInClick, appearance, logo, className, }: MagicLinkCallbackProps): react_jsx_runtime.JSX.Element;
 
 interface ForgotPasswordFormProps extends KerneUIProps {
-    /** Where the emailed reset link should land. Defaults to the tenant's configured callback. */
-    callbackUrl?: string;
     signInUrl?: string;
     onSignInClick?: () => void;
     onSent?: (email: string) => void;
     title?: string;
     subtitle?: React.ReactNode;
 }
-declare function ForgotPasswordForm({ callbackUrl, signInUrl, onSignInClick, onSent, title, subtitle, appearance, logo, className, }: ForgotPasswordFormProps): react_jsx_runtime.JSX.Element;
+declare function ForgotPasswordForm({ signInUrl, onSignInClick, onSent, title, subtitle, appearance, logo, className, }: ForgotPasswordFormProps): react_jsx_runtime.JSX.Element;
 
 interface ResetPasswordFormProps extends KerneUIProps {
     /** Overrides the `?token=` query param. */
@@ -155,13 +103,11 @@ declare function ResetPasswordForm({ token: tokenProp, signInUrl, onSignInClick,
 interface VerifyEmailFormProps extends KerneUIProps {
     /** Overrides the `?token=` query param. */
     token?: string;
-    /** Where a resent verification link should land. */
-    callbackUrl?: string;
     onVerified?: () => void;
     title?: string;
     subtitle?: React.ReactNode;
 }
-declare function VerifyEmailForm({ token: tokenProp, callbackUrl, onVerified, title, subtitle, appearance, logo, className, }: VerifyEmailFormProps): react_jsx_runtime.JSX.Element;
+declare function VerifyEmailForm({ token: tokenProp, onVerified, title, subtitle, appearance, logo, className, }: VerifyEmailFormProps): react_jsx_runtime.JSX.Element;
 
 interface ActivateAccountFormProps extends KerneUIProps {
     /** Overrides the `?token=` query param. */
@@ -248,16 +194,12 @@ interface UserProfileProps extends Omit<KerneUIProps, 'logo'> {
     onDeleted?: () => void;
     productSlug?: string;
     pricingProductIdOrSlug?: string;
-    portalReturnUrl?: string;
-    checkoutSuccessUrl?: string;
-    checkoutCancelUrl?: string;
     showPlanSwitcher?: boolean;
     showUsage?: boolean;
     usageFeatureKeys?: string[];
     usageLabels?: Record<string, string>;
-    verificationCallbackUrl?: string;
 }
-declare function UserProfile({ tabs, extraTabs, defaultTab, activeTab: controlledTab, onTabChange, showDeleteAccount, onSaved, onDeleted, productSlug, pricingProductIdOrSlug, portalReturnUrl, checkoutSuccessUrl, checkoutCancelUrl, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, verificationCallbackUrl, appearance, className, }: UserProfileProps): react_jsx_runtime.JSX.Element;
+declare function UserProfile({ tabs, extraTabs, defaultTab, activeTab: controlledTab, onTabChange, showDeleteAccount, onSaved, onDeleted, productSlug, pricingProductIdOrSlug, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, appearance, className, }: UserProfileProps): react_jsx_runtime.JSX.Element;
 
 /**
  * "Profile" pane: who the user is, and the address they sign in with.
@@ -268,11 +210,9 @@ declare function UserProfile({ tabs, extraTabs, defaultTab, activeTab: controlle
  * fails on save.
  */
 interface ProfileSectionProps {
-    /** Where a resent verification link should land. */
-    verificationCallbackUrl?: string;
     onSaved?: () => void;
 }
-declare function ProfileSection({ verificationCallbackUrl, onSaved }: ProfileSectionProps): react_jsx_runtime.JSX.Element;
+declare function ProfileSection({ onSaved }: ProfileSectionProps): react_jsx_runtime.JSX.Element;
 
 /**
  * "Security" pane: password, and leaving.
@@ -296,38 +236,33 @@ declare function SecuritySection({ showDeleteAccount, onDeleted }: SecuritySecti
  * "Billing" pane: the active plan, what it has been used for, and how to move
  * to another one.
  *
- * The plan switcher is a settings control, not the marketing pricing page: it
- * lists what this scope can move to and starts a checkout, and deliberately
- * does not sell. `<PricingTable>` is the surface that sells.
- *
- * Interval handling is the honest minimum until PriceLabel exists here too:
- * prices are grouped by `interval`, and the segmented control only renders
- * when a plan genuinely has more than one. A
- * plan carrying a third price (early-bird, non-profit) still has no way to be
- * described here - which is exactly the gap PriceLabel closes.
+ * The plan switcher used to be a bespoke, minimal list - deliberately not
+ * `<PricingTable>`, on the theory that a settings control shouldn't "sell" to
+ * someone who is already a customer. In practice that meant two independent
+ * implementations of "list plans, handle the switch" drifting apart (this one
+ * grouped prices by raw `interval` and had no path to a plan carrying a third
+ * price - early-bird, non-profit - where `<PricingTable>` already understood
+ * `PriceLabel`), and every fix to one never reached the other. This pane now
+ * composes the same `<PricingTable>` the marketing pricing page uses: one
+ * surface to keep polished instead of two to keep in sync.
  */
 interface BillingSectionProps {
     productSlug?: string;
     /** Product the plan list is read from. Defaults to the tenant's default product. */
     pricingProductIdOrSlug?: string;
-    portalReturnUrl?: string;
-    checkoutSuccessUrl?: string;
-    checkoutCancelUrl?: string;
     /** Hide the plan switcher, e.g. when plan changes go through sales. */
     showPlanSwitcher?: boolean;
     showUsage?: boolean;
     usageFeatureKeys?: string[];
     usageLabels?: Record<string, string>;
 }
-declare function BillingSection({ productSlug, pricingProductIdOrSlug, portalReturnUrl, checkoutSuccessUrl, checkoutCancelUrl, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, }: BillingSectionProps): react_jsx_runtime.JSX.Element;
+declare function BillingSection({ productSlug, pricingProductIdOrSlug, showPlanSwitcher, showUsage, usageFeatureKeys, usageLabels, }: BillingSectionProps): react_jsx_runtime.JSX.Element;
 
 interface SubscriptionCardProps extends Omit<KerneUIProps, 'logo'> {
     /** Restrict to one product, when the tenant sells several. */
     productSlug?: string;
     /** Heading above the details. Omit for the localized default, `null` for none. */
     title?: string | null;
-    /** Where the provider portal should return to. */
-    portalReturnUrl?: string;
     /** Shown when there is no active subscription - your pricing page. */
     upgradeUrl?: string;
     onUpgradeClick?: () => void;
@@ -336,7 +271,7 @@ interface SubscriptionCardProps extends Omit<KerneUIProps, 'logo'> {
     /** Hide the "Cancel subscription" button, e.g. when cancellation goes through sales/support. */
     hideCancelButton?: boolean;
 }
-declare function SubscriptionCard({ productSlug, title, portalReturnUrl, upgradeUrl, onUpgradeClick, hidePortalButton, hideCancelButton, appearance, className, }: SubscriptionCardProps): react_jsx_runtime.JSX.Element;
+declare function SubscriptionCard({ productSlug, title, upgradeUrl, onUpgradeClick, hidePortalButton, hideCancelButton, appearance, className, }: SubscriptionCardProps): react_jsx_runtime.JSX.Element;
 
 interface UsageMetersProps extends Omit<KerneUIProps, 'logo'> {
     /** Heading above the meters. Omit for the localized default, `null` for none. */
@@ -365,7 +300,7 @@ declare function UsageMeters({ title, featureKeys, showUnlimited, limit: maxRows
  * (see EntitlementSummary), while the subscription payload does carry names -
  * so components cross-reference the subscription first and only fall back
  * here for a scope on a default pack, which has no subscription to read names
- * from. Turning `api_calls` into "Api calls" is not as good as the real name;
+ * from. Turning `api_calls` into "API calls" is not as good as the real name;
  * it is only better than showing a raw key to an end user.
  */
 declare function humanizeFeatureKey(key: string): string;
@@ -435,8 +370,10 @@ interface PricingTableContextValue {
     setSelectedLabelSlug: (slug: string) => void;
     savings: LabelSavings | null;
     currentPlanId: string | null;
+    /** The currency the subject is already billed in, or null with no subscription - see `Plan`'s currency-mismatch guard. */
+    currentPriceCurrency: string | null;
     busyPriceId: string | null;
-    onSelectPlan: (plan: PublicPlan) => void;
+    onSelectPlan: (plan: PublicPlan, drivers?: DriverSelection[]) => void;
 }
 /**
  * Headless access to the same state `<PricingTable.LabelSwitch>`/`<PricingTable.Plan>`
@@ -449,11 +386,12 @@ interface PricingTableProps extends Omit<KerneUIProps, 'logo'> {
     product?: string;
     /** Label slug selected on first render. Defaults to the first label by PriceLabel.sort_order once the catalog loads. */
     defaultLabel?: string;
-    /** Where the provider checkout should return to. */
-    checkoutSuccessUrl?: string;
-    checkoutCancelUrl?: string;
-    /** Overrides the built-in checkout - e.g. a marketing site that wants its own confirmation step first. */
-    onSelectPlan?: (plan: PublicPlan, price: PublicPlanPrice) => void;
+    /**
+     * Overrides the built-in checkout - e.g. a marketing site that wants its own confirmation step
+     * first. `drivers` carries what the buyer sized on the prepaid rails, and must be forwarded to
+     * `checkout()` or the sizing is lost.
+     */
+    onSelectPlan?: (plan: PublicPlan, price: PublicPlanPrice, drivers?: DriverSelection[]) => void;
     children: React.ReactNode;
 }
 /**
@@ -462,8 +400,9 @@ interface PricingTableProps extends Omit<KerneUIProps, 'logo'> {
  * once real data exists - they never have to handle a "plan not loaded yet"
  * state of their own.
  */
-declare function PricingTable({ product, defaultLabel, checkoutSuccessUrl, checkoutCancelUrl, onSelectPlan, appearance, className, children, }: PricingTableProps): react_jsx_runtime.JSX.Element;
+declare function PricingTable({ product, defaultLabel, onSelectPlan, appearance, className, children, }: PricingTableProps): react_jsx_runtime.JSX.Element;
 declare namespace PricingTable {
+    var Header: ({ eyebrow, headline, lede }: PricingTableHeaderProps) => react_jsx_runtime.JSX.Element;
     var LabelSwitch: () => react_jsx_runtime.JSX.Element | null;
     var Plan: ({ slug, featured, badge, maxFeatures }: PricingTablePlanProps) => react_jsx_runtime.JSX.Element | null;
     var Plans: ({ featuredSlug, featuredBadge, maxFeatures }: PricingTablePlansProps) => react_jsx_runtime.JSX.Element;
@@ -485,6 +424,13 @@ interface PricingTablePlansProps {
     featuredBadge?: string;
     maxFeatures?: number;
 }
+interface PricingTableHeaderProps {
+    /** Small tracked line above the headline - a product name, a version, a category. */
+    eyebrow?: string;
+    headline: string;
+    /** One sentence under it. Say how billing works, not how great the product is. */
+    lede?: string;
+}
 
 interface CheckoutResultProps extends KerneUIProps {
     /** `cancel` renders the abandoned-checkout copy and skips polling entirely. */
@@ -523,4 +469,4 @@ interface UpgradePromptProps extends Omit<KerneUIProps, 'logo'> {
 }
 declare function UpgradePrompt({ featureKey, requested, featureName, children, upgradeUrl, onUpgradeClick, upgradeLabel, title, description, hideWhileLoading, appearance, className, }: UpgradePromptProps): react_jsx_runtime.JSX.Element | null;
 
-export { ActivateAccountForm, type ActivateAccountFormProps, AuthFlow, type AuthFlowProps, type AuthFlowStep, BillingSection, type BillingSectionProps, ChangePasswordForm, type ChangePasswordFormProps, CheckoutResult, type CheckoutResultProps, ForgotPasswordForm, type ForgotPasswordFormProps, type KerneAppearance, KerneLocalization, type LabelSavings, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, type PriceDisplay, PricingTable, type PricingTablePlanProps, type PricingTablePlansProps, type PricingTableProps, ProfileSection, type ProfileSectionProps, RegisterForm, type RegisterFormProps, ResetPasswordForm, type ResetPasswordFormProps, SecuritySection, type SecuritySectionProps, SignOutButton, type SignOutButtonProps, SubscriptionCard, type SubscriptionCardProps, UpgradePrompt, type UpgradePromptProps, UsageMeters, type UsageMetersProps, UserButton, type UserButtonMenuItem, type UserButtonProps, UserProfile, type UserProfileExtraTab, type UserProfileProps, type UserProfileTab, VerifyEmailForm, type VerifyEmailFormProps, WaitlistForm, type WaitlistFormProps, collectPriceLabels, formatDate, formatInterval, formatMoney, formatNumber, humanizeFeatureKey, resolveLabelSavings, resolvePriceDisplay, usePricingTable };
+export { ActivateAccountForm, type ActivateAccountFormProps, AuthFlow, type AuthFlowProps, type AuthFlowStep, BillingSection, type BillingSectionProps, ChangePasswordForm, type ChangePasswordFormProps, CheckoutResult, type CheckoutResultProps, ForgotPasswordForm, type ForgotPasswordFormProps, KerneAppearance, KerneLocalization, type LabelSavings, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, type PriceDisplay, PricingTable, type PricingTableHeaderProps, type PricingTablePlanProps, type PricingTablePlansProps, type PricingTableProps, ProfileSection, type ProfileSectionProps, RegisterForm, type RegisterFormProps, ResetPasswordForm, type ResetPasswordFormProps, SecuritySection, type SecuritySectionProps, SignOutButton, type SignOutButtonProps, SubscriptionCard, type SubscriptionCardProps, UpgradePrompt, type UpgradePromptProps, UsageMeters, type UsageMetersProps, UserButton, type UserButtonMenuItem, type UserButtonProps, UserProfile, type UserProfileExtraTab, type UserProfileProps, type UserProfileTab, VerifyEmailForm, type VerifyEmailFormProps, WaitlistForm, type WaitlistFormProps, collectPriceLabels, formatDate, formatInterval, formatMoney, formatNumber, humanizeFeatureKey, resolveLabelSavings, resolvePriceDisplay, usePricingTable };