@bpinternal/billing-ui 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -58,6 +58,8 @@ export declare type AddonsSummaryCardProps = {
     className?: string;
 };
 
+export declare const ArrowRightIcon: ({ size, ...props }: IconProps) => JSX.Element;
+
 export declare const Badge: ({ variant, children, className }: BadgeProps) => JSX.Element;
 
 export declare type BadgeProps = {
@@ -480,6 +482,44 @@ export declare const NANO_DOLLARS_PER_DOLLAR = 1000000000;
  */
 export declare const OutdatedBillingGate: () => JSX.Element;
 
+/**
+ * Free-plan upgrade modal — the proactive nudge shown when a Free workspace is
+ * about to run out of its one-time conversation allowance. Frames the upgrade
+ * (monthly allowance + packs + more channels) and offers the two self-serve
+ * paid tiers (Plus / Team) with the same plan-card language as the pricing
+ * table. Mount it once near the app root.
+ *
+ * Two modes:
+ * - **controlled** — pass `open` / `onOpenChange` and drive it yourself.
+ * - **auto** (omit `open`) — it opens itself when the workspace is on Free and
+ *   ≥75% through its conversations, at most once per day per workspace
+ *   (dismissed via localStorage, same as the usage banner). Returns the next day.
+ */
+export declare const OutgrowFreeDialog: ({ open, onOpenChange, onSelectPlan, recommendedPlanId, interval, planFeatures, featureDescriptions, period, }: OutgrowFreeDialogProps) => JSX.Element | null;
+
+export declare type OutgrowFreeDialogProps = {
+    /**
+     * Controlled visibility. Omit to let the dialog manage itself in `auto` mode:
+     * it opens on its own when the workspace is on the Free plan and has used
+     * ≥75% of its conversation allowance — at most once per day per workspace.
+     */
+    open?: boolean;
+    /** Required in controlled mode; also called when the dialog closes in auto mode. */
+    onOpenChange?: (open: boolean) => void;
+    /** Called when the user picks a plan — open your CheckoutDialog with these values. */
+    onSelectPlan: (planId: string, interval: BillingInterval) => void;
+    /** Plan kind (or exact id) to mark Recommended. Default 'team'. */
+    recommendedPlanId?: string;
+    /** Billing interval the prices are shown at. Default 'year' (annual). */
+    interval?: BillingInterval;
+    /** Per-kind marketing feature strings; defaults to DEFAULT_PLAN_FEATURES. */
+    planFeatures?: Partial<Record<PlanKind, string[]>>;
+    /** Feature label → tooltip description; merged over DEFAULT_FEATURE_DESCRIPTIONS. */
+    featureDescriptions?: Record<string, string>;
+    /** Period (any datetime in the billing month) to evaluate usage; defaults to current month. */
+    period?: string;
+};
+
 export declare const PaintIcon: ({ size, ...props }: IconProps) => JSX.Element;
 
 export declare type PaymentMethod = NonNullable<Awaited<ReturnType<BillingClient['getPaymentMethod']>>['paymentMethod']>;
@@ -723,7 +763,11 @@ export declare type UsageBannerProps = {
      * checkout so it works with zero host wiring.
      */
     onUpgrade?: () => void;
-    /** Show a dismiss (×) button. The banner reappears on remount. Default true. */
+    /**
+     * Show a dismiss (×) button. Dismissing hides the banner (for that metric) for
+     * the rest of the day via localStorage; it returns the next day or if a
+     * different metric crosses the threshold. Default true.
+     */
     dismissible?: boolean;
     /** CTA label. Default "Upgrade plan". */
     ctaLabel?: string;
@@ -777,7 +821,7 @@ export declare function usageItems(quotas: WorkspaceUsages | undefined): UsageIt
  * hover/focus after `delay`. Renders the children plainly on legacy billing
  * or when there's no usage to show (the popover just never opens).
  */
-export declare const UsagePopover: ({ children, delay, placement, period, className }: UsagePopoverProps) => JSX.Element;
+export declare const UsagePopover: ({ children, delay, placement, period, onUpgrade, block, className, }: UsagePopoverProps) => JSX.Element;
 
 export declare type UsagePopoverProps = {
     /** The trigger — hovering/focusing it reveals the usage popover. */
@@ -788,6 +832,14 @@ export declare type UsagePopoverProps = {
     placement?: 'top' | 'bottom';
     /** Period (any datetime in the billing month); defaults to current month. */
     period?: string;
+    /**
+     * Upgrade handler. When set, the popover shows a "Need more room?" nudge with a
+     * CTA on plans that can move up (e.g. Free). Wire it to your plan picker /
+     * billing route — same target as the widget's `onManage`.
+     */
+    onUpgrade?: () => void;
+    /** Stretch the trigger to fill its container (e.g. a full-width sidebar widget). */
+    block?: boolean;
     className?: string;
 };