| plans | Array<PricingPlan> | defaultPlans (3 plans: Free, Monthly, Lifetime) | Array of pricing plan objects. Each plan includes id, name, description, price (monthly/yearly), period, features (string or {text, bold}), badge, featured, colors, and cta ({label, href, variant, onClick}). |
| interval | "monthly" | "yearly" | undefined (controlled externally) | Controlled billing interval. When provided, the component becomes controlled and onIntervalChange must handle updates. |
| defaultInterval | "monthly" | "yearly" | "yearly" | Initial billing interval when interval is not controlled. |
| onIntervalChange | (interval: "monthly" | "yearly") => void | undefined | Callback fired when the billing interval changes via the toggle. |
| onSelectPlan | (plan: PricingPlan, interval: "monthly" | "yearly") => void | undefined | Callback fired when a plan CTA is clicked. Receives the plan and current interval. |
| showToggle | boolean | true | Show or hide the monthly/yearly billing toggle. |
| labels | Partial<PricingLabels> | DEFAULT_LABELS | Custom labels for ariaLabel, billingLabel, monthly, yearly, save, perMonth, billedYearly, billedMonthly. |
| currency | string | "$" | Currency symbol prefix for prices. |
| locale | string | "en-US" | Locale used for number formatting in prices. |
| colors | Partial<PricingColors> | defaultColors | Complete color customization object. Overrides any of the 30+ color tokens for text, backgrounds, borders, buttons, badges, checkmarks, focus rings, and more. |
| animated | boolean | true | Enable Framer Motion animations for price transitions, card entrance, and interactions. |
| linkComponent | React.ElementType | "a" | Component used for plan CTAs when they have an href. Defaults to anchor tag. |
| className | string | "" | Additional class name applied to the root section. |
| style | React.CSSProperties | undefined | Inline styles applied to the root section. |
| classNames | Partial<Record<"toggle" | "grid" | "card" | "cta", string>> | {} | Optional class names for the toggle, grid, card, and CTA elements. |