@zuplo/zudoku-plugin-monetization 0.0.40 → 0.0.42

package/dist/pricing-ui.d.mts

@@ -98,7 +98,7 @@ interface Alignment {
 }
 interface ProRatingConfig {
   enabled: boolean;
-  mode: "prorate_prices" | "prorate_quantities";
+  mode: "max_consumption_based";
 }
 interface ValidationError {
   message: string;
@@ -130,8 +130,6 @@ interface Plan {
   updatedAt?: string;
   deletedAt?: string;
   phases: PlanPhase[];
-  monthlyPrice: string | null;
-  yearlyPrice: string | null;
 }
 //#endregion
 //#region src/pricing-ui/FeatureItem.d.ts
@@ -158,11 +156,56 @@ declare const PlanEntitlements: ({
   itemClassName?: string;
 }) => import("react/jsx-runtime").JSX.Element;
 //#endregion
+//#region src/utils/formatPlanPrice.d.ts
+type PlanPriceLabel = {
+  type: "free";
+} | {
+  type: "payg";
+  main: "Pay as you go";
+  sub: "Usage-based pricing";
+} | {
+  type: "priced";
+  amount: number;
+};
+/**
+ * Headline pricing for plan cards. Centralizes the "Pay as you go" detection:
+ * plans whose flat-fee total is zero but that bill on usage shouldn't render
+ * as "Free" - they're charged per-unit.
+ */
+declare const formatPlanPrice: (plan: Plan) => PlanPriceLabel;
+//#endregion
+//#region src/pricing-ui/PlanPriceTag.d.ts
+/**
+ * Headline price for a plan/subscription: `$X/cadence`, "Pay as you go", or
+ * "Free", from a {@link PlanPriceLabel}. Shared by the subscription details
+ * page, the Switch Plan baseline, each plan-change card, and the checkout /
+ * plan-change summary cards so they all render the price identically.
+ *
+ * `size` selects the typographic treatment:
+ *   - `"inline"` (default): compact, primary-colored text for use beside a name.
+ *   - `"lg"`: a large foreground headline for a summary card's price column.
+ *
+ * Pass `description` to surface the "Usage-based pricing" subline under the
+ * "Pay as you go" headline (used where there's room for it).
+ */
+declare const PlanPriceTag: ({
+  label,
+  currency,
+  billingCadence,
+  description,
+  size
+}: {
+  label: PlanPriceLabel;
+  currency?: string; /** Render the `/cadence` suffix (omit for prices shown without a cadence). */
+  billingCadence?: string;
+  description?: boolean;
+  size?: "inline" | "lg";
+}) => import("react/jsx-runtime").JSX.Element;
+//#endregion
 //#region src/pricing-ui/PricingCard.d.ts
 type PricingCardProps = {
   plan: Plan;
   isPopular?: boolean;
-  showYearlyPrice?: boolean;
   units?: Record<string, string>; /** CTA element rendered at the bottom of the card (e.g. a Subscribe button). */
   action?: ReactNode;
   className?: string;
@@ -170,7 +213,6 @@ type PricingCardProps = {
 declare const PricingCard: ({
   plan,
   isPopular,
-  showYearlyPrice,
   units,
   action,
   className
@@ -179,7 +221,6 @@ declare const PricingCard: ({
 //#region src/pricing-ui/PricingTable.d.ts
 type PricingTableProps = {
   plans: Plan[];
-  showYearlyPrice?: boolean;
   units?: Record<string, string>;
   /**
    * Render the CTA (e.g. Subscribe / Contact Sales button) for each plan.
@@ -217,7 +258,6 @@ type PricingTableProps = {
 };
 declare const PricingTable: ({
   plans,
-  showYearlyPrice,
   units,
   renderAction,
   renderCard,
@@ -280,35 +320,24 @@ declare const formatTieredPriceBreakdown: (opts: {
   includedLabel: string;
 }) => string[] | undefined;
 //#endregion
-//#region src/utils/getPriceFromPlan.d.ts
+//#region src/utils/getPlanPrice.d.ts
 /**
- * Derive a (monthly, yearly) headline price from a plan's last phase by
- * summing all `flat_fee` rate-card amounts and converting from the plan's
- * `billingCadence` to a monthly equivalent.
+ * The plan's headline recurring price: the sum of every recurring `flat_fee`
+ * rate-card amount on the plan's steady-state (last) phase, expressed in the
+ * plan's own `billingCadence`. One-time fees (`flat_fee` with
+ * `billingCadence: null`, e.g. a setup fee) are excluded.
  *
- * Returns `null` for either field when no value can be derived (no
- * phases, or an unparseable / sub-day cadence). A flat-fee sum of 0
- * returns `{ monthly: 0, yearly: 0 }` (Free).
+ * This is derived entirely from the plan's rate cards. It deliberately does
+ * NOT read any server-provided `monthlyPrice` / `yearlyPrice` and performs no
+ * cadence conversion, so it stays correct for any billing cadence — hourly
+ * (`PT1H`), weekly, monthly, yearly, etc. Callers pair the returned amount
+ * with `formatDuration(plan.billingCadence)` to render e.g. `$2.99/hour`.
  *
- * Useful for consumers whose source data doesn't already include
- * pre-computed `monthlyPrice` / `yearlyPrice` — pass the result through
- * (or rely on `getPriceFromPlan`'s built-in fallback).
+ * Returns `0` when there are no phases or no recurring flat fee, which callers
+ * render as "Free" (or "Pay as you go" when the plan bills on usage — see
+ * {@link formatPlanPrice}).
  */
-declare const derivePriceFromPlan: (plan: Plan) => {
-  monthly: number | null;
-  yearly: number | null;
-};
-/**
- * Returns the monthly and yearly headline price for a plan. Prefers the
- * server-provided `monthlyPrice` / `yearlyPrice` strings when present;
- * otherwise falls back to {@link derivePriceFromPlan}. Values that can't
- * be resolved are reported as `0`, which the pricing card renders as
- * "Free".
- */
-declare const getPriceFromPlan: (plan: Plan) => {
-  monthly: number;
-  yearly: number;
-};
+declare const getPlanPrice: (plan: Plan) => number;
 //#endregion
 //#region src/utils/pricingTaxLegend.d.ts
 type CanonicalTaxBehavior = "exclusive" | "inclusive" | "unspecified";
@@ -317,4 +346,4 @@ declare const collectDefaultTaxBehaviors: (plan: Plan) => CanonicalTaxBehavior;
 declare const taxBehaviorLegendSentence: (behavior: string) => string | undefined;
 declare const subscriptionTaxLegendSentence: (behavior: string) => string | undefined;
 //#endregion
-export { type Alignment, type BooleanEntitlementTemplate, type DynamicPrice, type EntitlementTemplate, type Feature, FeatureItem, type FlatFeeRateCard, type FlatPrice, type MeteredEntitlementTemplate, type PackagePrice, type Plan, type PlanDefaultTaxConfig, PlanEntitlements, type PlanPhase, type Price, type PriceTier, PricingCard, type PricingCardProps, PricingTable, type PricingTableProps, type ProRatingConfig, type Quota, QuotaItem, type RateCard, type StaticEntitlementTemplate, type TieredPrice, type TieredPriceBreakdownTier, type UnitPrice, type UsageBasedRateCard, type ValidationError, categorizeRateCards, collectDefaultTaxBehaviors, derivePriceFromPlan, formatDuration, formatDurationAdjective, formatDurationInterval, formatMinorCurrencyAmount, formatPrice, formatStaticEntitlementConfig, formatTieredPriceBreakdown, getPriceFromPlan, planHasDefaultTaxBehavior, subscriptionTaxLegendSentence, taxBehaviorLegendSentence };
+export { type Alignment, type BooleanEntitlementTemplate, type DynamicPrice, type EntitlementTemplate, type Feature, FeatureItem, type FlatFeeRateCard, type FlatPrice, type MeteredEntitlementTemplate, type PackagePrice, type Plan, type PlanDefaultTaxConfig, PlanEntitlements, type PlanPhase, type PlanPriceLabel, PlanPriceTag, type Price, type PriceTier, PricingCard, type PricingCardProps, PricingTable, type PricingTableProps, type ProRatingConfig, type Quota, QuotaItem, type RateCard, type StaticEntitlementTemplate, type TieredPrice, type TieredPriceBreakdownTier, type UnitPrice, type UsageBasedRateCard, type ValidationError, categorizeRateCards, collectDefaultTaxBehaviors, formatDuration, formatDurationAdjective, formatDurationInterval, formatMinorCurrencyAmount, formatPlanPrice, formatPrice, formatStaticEntitlementConfig, formatTieredPriceBreakdown, getPlanPrice, planHasDefaultTaxBehavior, subscriptionTaxLegendSentence, taxBehaviorLegendSentence };

package/dist/pricing-ui.mjs

@@ -1,2 +1,2 @@
-import { _ as formatDuration, a as subscriptionTaxLegendSentence, c as getPriceFromPlan, d as FeatureItem, f as categorizeRateCards, g as formatPrice, h as formatMinorCurrencyAmount, i as planHasDefaultTaxBehavior, l as PlanEntitlements, m as formatStaticEntitlementConfig, n as PricingCard, o as taxBehaviorLegendSentence, p as formatTieredPriceBreakdown, r as collectDefaultTaxBehaviors, s as derivePriceFromPlan, t as PricingTable, u as QuotaItem, v as formatDurationAdjective, y as formatDurationInterval } from "./PricingTable-DNop2iX9.mjs";
-export { FeatureItem, PlanEntitlements, PricingCard, PricingTable, QuotaItem, categorizeRateCards, collectDefaultTaxBehaviors, derivePriceFromPlan, formatDuration, formatDurationAdjective, formatDurationInterval, formatMinorCurrencyAmount, formatPrice, formatStaticEntitlementConfig, formatTieredPriceBreakdown, getPriceFromPlan, planHasDefaultTaxBehavior, subscriptionTaxLegendSentence, taxBehaviorLegendSentence };
+import { S as formatDurationInterval, _ as formatStaticEntitlementConfig, a as planHasDefaultTaxBehavior, b as formatDuration, c as formatPlanPrice, d as PlanEntitlements, g as formatTieredPriceBreakdown, h as categorizeRateCards, i as collectDefaultTaxBehaviors, l as getPlanPrice, m as FeatureItem, n as PricingCard, o as subscriptionTaxLegendSentence, p as QuotaItem, s as taxBehaviorLegendSentence, t as PricingTable, u as PlanPriceTag, v as formatMinorCurrencyAmount, x as formatDurationAdjective, y as formatPrice } from "./PricingTable-BlcXx4-5.mjs";
+export { FeatureItem, PlanEntitlements, PlanPriceTag, PricingCard, PricingTable, QuotaItem, categorizeRateCards, collectDefaultTaxBehaviors, formatDuration, formatDurationAdjective, formatDurationInterval, formatMinorCurrencyAmount, formatPlanPrice, formatPrice, formatStaticEntitlementConfig, formatTieredPriceBreakdown, getPlanPrice, planHasDefaultTaxBehavior, subscriptionTaxLegendSentence, taxBehaviorLegendSentence };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuplo/zudoku-plugin-monetization",
-  "version": "0.0.40",
+  "version": "0.0.42",
   "repository": {
     "type": "git",
     "url": "https://github.com/zuplo/zudoku",
@@ -37,7 +37,7 @@
     "react": "19.2.5",
     "react-dom": "19.2.5",
     "tsdown": "0.22.0",
-    "zudoku": "0.79.0"
+    "zudoku": "0.79.1"
   },
   "peerDependencies": {
     "react": ">=19.2.0",