@ikas/bp-storefront 1.4.0-beta.132 → 1.4.0-beta.134

package/dist/functions/models/product/variant/index.d.ts

@@ -724,9 +724,17 @@ export declare function getProductVariantCampaignOffersDiscountPercentage(varian
  * A tiered discount defines multiple quantity tiers (`campaign.tieredDiscount.rules`), each with its own
  * amount and quantity range. This resolves every tier against the variant's price and returns the
  * per-tier sell/final prices (both raw numbers and formatted strings), matching the storefront runtime.
+ * The raw rules are `IkasProductTieredDiscountRule` (ranges may be null); this function returns the
+ * resolved `IkasTieredDiscountProduct` with normalized `{ min, max }` — use the resolved shape, not the raw rule.
+ *
+ * `sellPrice`/`finalPrice` (and their `formatted*` variants) are PER UNIT; the `*WithQuantity` fields are the
+ * tier total for buying the minimum quantity. A `"FIXED_AMOUNT"` discount is applied only to that total, so
+ * per-unit `finalPrice` equals `sellPrice` and the saving shows only in `finalPriceWithQuantity`.
  *
  * The discount `amount` is interpreted by `campaign.type`: `"RATIO"` treats it as a percentage,
- * `"FIXED_AMOUNT"` as an absolute money amount subtracted from the tier total.
+ * `"FIXED_AMOUNT"` as an absolute money amount subtracted from the tier total. `amount`/`type` are
+ * informational — the discount is already applied in the resolved `*Price` fields, so prefer those over
+ * recomputing it yourself.
  *
  * `lineItemQuantityRange.min`/`max` are normalized numbers where `0` means "unbounded". In particular
  * `max === 0` marks an open-ended top tier (e.g. "6+" with no upper limit) — render it as "min+" rather

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikas/bp-storefront",
-  "version": "1.4.0-beta.132",
+  "version": "1.4.0-beta.134",
   "description": "A framework for the ikas blueprint storefronts.",
   "author": "ikas",
   "license": "ISC",