@kerne/react 0.1.2 → 1.0.0

package/dist/ui/index.d.cts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { SubscriptionWithPlan } from '@kerne/types';
-export { K as KerneLocalization, d as defaultLocalization, u as useLocalization } from '../i18n-Qketn1RF.cjs';
+import { PublicPlan, PublicPlanPrice, PublicPriceLabel, SubscriptionWithPlan } from '@kerne/types';
+export { K as KerneLocalization, d as defaultLocalization, u as useLocalization } from '../i18n-Di5qlnL1.cjs';
 
 /**
  * Per-instance overrides of the same custom properties the stylesheet reads,
@@ -332,8 +332,10 @@ interface SubscriptionCardProps extends Omit<KerneUIProps, 'logo'> {
     onUpgradeClick?: () => void;
     /** Hide the "Manage billing" button (e.g. when the page has its own). */
     hidePortalButton?: boolean;
+    /** Hide the "Cancel subscription" button, e.g. when cancellation goes through sales/support. */
+    hideCancelButton?: boolean;
 }
-declare function SubscriptionCard({ productSlug, title, portalReturnUrl, upgradeUrl, onUpgradeClick, hidePortalButton, appearance, className, }: SubscriptionCardProps): react_jsx_runtime.JSX.Element;
+declare function SubscriptionCard({ productSlug, title, portalReturnUrl, 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. */
@@ -351,6 +353,67 @@ interface UsageMetersProps extends Omit<KerneUIProps, 'logo'> {
 }
 declare function UsageMeters({ title, featureKeys, showUnlimited, limit: maxRows, labels, emptyState, appearance, className, }: UsageMetersProps): react_jsx_runtime.JSX.Element;
 
+interface PricingTableContextValue {
+    plans: PublicPlan[];
+    labels: PublicPriceLabel[];
+    selectedLabelSlug: string | null;
+    setSelectedLabelSlug: (slug: string) => void;
+    savings: {
+        labelSlug: string;
+        percent: number;
+    } | null;
+    currentPlanId: string | null;
+    busyPriceId: string | null;
+    onSelectPlan: (plan: PublicPlan) => void;
+}
+/**
+ * Headless access to the same state `<PricingTable.LabelSwitch>`/`<PricingTable.Plan>`
+ * read - for a host building a fully custom layout around the data instead of
+ * the provided subcomponents. Must be called under `<PricingTable>`.
+ */
+declare function usePricingTable(): PricingTableContextValue;
+interface PricingTableProps extends Omit<KerneUIProps, 'logo'> {
+    /** Product the plans are read from. Omit for the tenant's default product. */
+    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;
+    children: React.ReactNode;
+}
+/**
+ * Provider + layout root. Renders a skeleton while the catalog loads and an
+ * error panel if it fails, so `<PricingTable.Plan>` children only ever mount
+ * 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 namespace PricingTable {
+    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;
+}
+interface PricingTablePlanProps {
+    /** The plan to render - matched against `Plan.slug`. */
+    slug: string;
+    /** Visually distinguished (stronger border, soft elevation) - a host decision, never inferred from `is_default` (the free-tier fallback, not a "recommended" signal). */
+    featured?: boolean;
+    /** Eyebrow shown above the plan name, e.g. "Most popular". Only rendered when passed - no badge is invented from data. */
+    badge?: string;
+    /** Cap how many entitlements render before "+N more". Omit to show all. */
+    maxFeatures?: number;
+}
+interface PricingTablePlansProps {
+    /** Slug of the plan to visually feature - a host decision, see PricingTablePlanProps.featured. */
+    featuredSlug?: string;
+    /** Eyebrow on the featured plan, e.g. "Most popular". */
+    featuredBadge?: string;
+    maxFeatures?: number;
+}
+
 interface CheckoutResultProps extends KerneUIProps {
     /** `cancel` renders the abandoned-checkout copy and skips polling entirely. */
     outcome?: 'success' | 'cancel';
@@ -388,4 +451,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, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, 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 };
+export { ActivateAccountForm, type ActivateAccountFormProps, AuthFlow, type AuthFlowProps, type AuthFlowStep, BillingSection, type BillingSectionProps, ChangePasswordForm, type ChangePasswordFormProps, CheckoutResult, type CheckoutResultProps, ForgotPasswordForm, type ForgotPasswordFormProps, type KerneAppearance, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, 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, usePricingTable };

package/dist/ui/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { SubscriptionWithPlan } from '@kerne/types';
-export { K as KerneLocalization, d as defaultLocalization, u as useLocalization } from '../i18n-Qketn1RF.js';
+import { PublicPlan, PublicPlanPrice, PublicPriceLabel, SubscriptionWithPlan } from '@kerne/types';
+export { K as KerneLocalization, d as defaultLocalization, u as useLocalization } from '../i18n-Di5qlnL1.js';
 
 /**
  * Per-instance overrides of the same custom properties the stylesheet reads,
@@ -332,8 +332,10 @@ interface SubscriptionCardProps extends Omit<KerneUIProps, 'logo'> {
     onUpgradeClick?: () => void;
     /** Hide the "Manage billing" button (e.g. when the page has its own). */
     hidePortalButton?: boolean;
+    /** Hide the "Cancel subscription" button, e.g. when cancellation goes through sales/support. */
+    hideCancelButton?: boolean;
 }
-declare function SubscriptionCard({ productSlug, title, portalReturnUrl, upgradeUrl, onUpgradeClick, hidePortalButton, appearance, className, }: SubscriptionCardProps): react_jsx_runtime.JSX.Element;
+declare function SubscriptionCard({ productSlug, title, portalReturnUrl, 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. */
@@ -351,6 +353,67 @@ interface UsageMetersProps extends Omit<KerneUIProps, 'logo'> {
 }
 declare function UsageMeters({ title, featureKeys, showUnlimited, limit: maxRows, labels, emptyState, appearance, className, }: UsageMetersProps): react_jsx_runtime.JSX.Element;
 
+interface PricingTableContextValue {
+    plans: PublicPlan[];
+    labels: PublicPriceLabel[];
+    selectedLabelSlug: string | null;
+    setSelectedLabelSlug: (slug: string) => void;
+    savings: {
+        labelSlug: string;
+        percent: number;
+    } | null;
+    currentPlanId: string | null;
+    busyPriceId: string | null;
+    onSelectPlan: (plan: PublicPlan) => void;
+}
+/**
+ * Headless access to the same state `<PricingTable.LabelSwitch>`/`<PricingTable.Plan>`
+ * read - for a host building a fully custom layout around the data instead of
+ * the provided subcomponents. Must be called under `<PricingTable>`.
+ */
+declare function usePricingTable(): PricingTableContextValue;
+interface PricingTableProps extends Omit<KerneUIProps, 'logo'> {
+    /** Product the plans are read from. Omit for the tenant's default product. */
+    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;
+    children: React.ReactNode;
+}
+/**
+ * Provider + layout root. Renders a skeleton while the catalog loads and an
+ * error panel if it fails, so `<PricingTable.Plan>` children only ever mount
+ * 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 namespace PricingTable {
+    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;
+}
+interface PricingTablePlanProps {
+    /** The plan to render - matched against `Plan.slug`. */
+    slug: string;
+    /** Visually distinguished (stronger border, soft elevation) - a host decision, never inferred from `is_default` (the free-tier fallback, not a "recommended" signal). */
+    featured?: boolean;
+    /** Eyebrow shown above the plan name, e.g. "Most popular". Only rendered when passed - no badge is invented from data. */
+    badge?: string;
+    /** Cap how many entitlements render before "+N more". Omit to show all. */
+    maxFeatures?: number;
+}
+interface PricingTablePlansProps {
+    /** Slug of the plan to visually feature - a host decision, see PricingTablePlanProps.featured. */
+    featuredSlug?: string;
+    /** Eyebrow on the featured plan, e.g. "Most popular". */
+    featuredBadge?: string;
+    maxFeatures?: number;
+}
+
 interface CheckoutResultProps extends KerneUIProps {
     /** `cancel` renders the abandoned-checkout copy and skips polling entirely. */
     outcome?: 'success' | 'cancel';
@@ -388,4 +451,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, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, 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 };
+export { ActivateAccountForm, type ActivateAccountFormProps, AuthFlow, type AuthFlowProps, type AuthFlowStep, BillingSection, type BillingSectionProps, ChangePasswordForm, type ChangePasswordFormProps, CheckoutResult, type CheckoutResultProps, ForgotPasswordForm, type ForgotPasswordFormProps, type KerneAppearance, LoginForm, type LoginFormProps, MagicLinkCallback, type MagicLinkCallbackProps, 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, usePricingTable };