@zuplo/zudoku-plugin-monetization 0.0.42 → 0.0.44

package/dist/pricing-ui.d.mts

@@ -142,6 +142,13 @@ declare const FeatureItem: ({
 }) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/pricing-ui/PlanEntitlements.d.ts
+/**
+ * A plan's entitlements, phase by phase. Multi-phase plans whose phases all
+ * resolve to the same entitlements collapse into a single list (the phases
+ * only differ in price, which the price schedule already tells); phases with
+ * genuinely different entitlements render as separate sections headed by the
+ * phase name, duration, and that phase's own price.
+ */
 declare const PlanEntitlements: ({
   phases,
   currency,
@@ -174,6 +181,52 @@ type PlanPriceLabel = {
  */
 declare const formatPlanPrice: (plan: Plan) => PlanPriceLabel;
 //#endregion
+//#region src/utils/getPlanPriceSchedule.d.ts
+type PlanPriceScheduleRow = {
+  /** Stable row key — the phase key, falling back to the phase index. */key: string; /** Left-column label, e.g. "First 3 months" / "Next 2 months" / "After that". */
+  label: string; /** The phase's own price, derived from its rate cards alone. */
+  price: PlanPriceLabel;
+};
+/**
+ * A stacked price schedule for a multi-phase plan: one row per phase, each
+ * priced from its own rate cards (e.g. "First 3 months — Free" then
+ * "After that — $750/month"). This is how an intro/ramp phase's price gets
+ * surfaced instead of only the steady-state price from {@link getPlanPrice}.
+ *
+ * Returns `undefined` when there is nothing to stack — fewer than two phases,
+ * or every phase resolving to the same price label (a free trial into a free
+ * plan, two identically-priced phases, …) — so callers fall back to the
+ * single-headline rendering.
+ */
+declare const getPlanPriceSchedule: (plan: Plan) => PlanPriceScheduleRow[] | undefined;
+//#endregion
+//#region src/pricing-ui/PlanPriceSchedule.d.ts
+/**
+ * Stacked per-phase price rows for a multi-phase plan, replacing the single
+ * headline price (which only reflects the steady-state phase): each row pairs
+ * a phase label ("First 3 months", "After that") with that phase's own price.
+ * Every row gets equal visual weight — the intro price is part of the plan's
+ * price, not a footnote.
+ *
+ * Callers derive the rows via {@link getPlanPriceSchedule} and fall back to
+ * the single-price rendering when it returns `undefined`. `size` picks the
+ * typographic treatment: `"lg"` for a card's headline area, `"sm"` for
+ * compact contexts (plan-change rows, summary cards).
+ */
+declare const PlanPriceSchedule: ({
+  schedule,
+  currency,
+  billingCadence,
+  size,
+  className
+}: {
+  schedule: PlanPriceScheduleRow[];
+  currency?: string; /** Render each priced row with the `/cadence` suffix (the plan's billing cadence). */
+  billingCadence?: string;
+  size?: "sm" | "lg";
+  className?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+//#endregion
 //#region src/pricing-ui/PlanPriceTag.d.ts
 /**
  * Headline price for a plan/subscription: `$X/cadence`, "Pay as you go", or
@@ -320,6 +373,19 @@ declare const formatTieredPriceBreakdown: (opts: {
   includedLabel: string;
 }) => string[] | undefined;
 //#endregion
+//#region src/utils/getPhasePriceLabel.d.ts
+/**
+ * Headline price for a SINGLE phase, derived only from that phase's own rate
+ * cards. Mirrors {@link formatPlanPrice}'s rules, but scoped to the phase:
+ * a positive recurring flat-fee total is `priced`; otherwise a priced
+ * `usage_based` card in this phase makes it `payg`; otherwise it's `free`.
+ *
+ * Like {@link getPlanPrice}, one-time fees (`flat_fee` with
+ * `billingCadence: null`) and `price: null` rate cards contribute nothing —
+ * an intro phase whose fees all have `price: null` derives as `free`.
+ */
+declare const getPhasePriceLabel: (phase: PlanPhase) => PlanPriceLabel;
+//#endregion
 //#region src/utils/getPlanPrice.d.ts
 /**
  * The plan's headline recurring price: the sum of every recurring `flat_fee`
@@ -346,4 +412,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 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 };
+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, PlanPriceSchedule, type PlanPriceScheduleRow, 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, getPhasePriceLabel, getPlanPrice, getPlanPriceSchedule, planHasDefaultTaxBehavior, subscriptionTaxLegendSentence, taxBehaviorLegendSentence };

package/dist/pricing-ui.mjs

@@ -1,2 +1,2 @@
-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 };
+import { C as formatStaticEntitlementConfig, D as formatDurationAdjective, E as formatDuration, O as formatDurationInterval, S as formatTieredPriceBreakdown, T as formatPrice, _ as formatPlanPrice, a as planHasDefaultTaxBehavior, c as getPlanPriceSchedule, d as PlanEntitlements, g as getPhasePriceLabel, h as FeatureItem, i as collectDefaultTaxBehaviors, l as PlanPriceTag, m as QuotaItem, n as PricingCard, o as subscriptionTaxLegendSentence, s as taxBehaviorLegendSentence, t as PricingTable, u as PlanPriceSchedule, v as getPlanPrice, w as formatMinorCurrencyAmount, x as categorizeRateCards } from "./PricingTable-WkG2n7V-.mjs";
+export { FeatureItem, PlanEntitlements, PlanPriceSchedule, PlanPriceTag, PricingCard, PricingTable, QuotaItem, categorizeRateCards, collectDefaultTaxBehaviors, formatDuration, formatDurationAdjective, formatDurationInterval, formatMinorCurrencyAmount, formatPlanPrice, formatPrice, formatStaticEntitlementConfig, formatTieredPriceBreakdown, getPhasePriceLabel, getPlanPrice, getPlanPriceSchedule, planHasDefaultTaxBehavior, subscriptionTaxLegendSentence, taxBehaviorLegendSentence };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuplo/zudoku-plugin-monetization",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "repository": {
     "type": "git",
     "url": "https://github.com/zuplo/zudoku",