@rebuy/rebuy 3.18.0 → 3.20.0-rc.1

package/dist/index.cjs

@@ -54,6 +54,7 @@ __export(src_exports, {
   CABProductsSection: () => CABProductsSection,
   CABProgressBarSection: () => CABProgressBarSection,
   CABProgressTier: () => CABProgressTier,
+  CABProgressTierExclusion: () => CABProgressTierExclusion,
   CABQuantitySection: () => CABQuantitySection,
   CABResultCountTrigger: () => CABResultCountTrigger,
   CABResultTagTrigger: () => CABResultTagTrigger,
@@ -127,6 +128,7 @@ __export(src_exports, {
   ProductInformationBlock: () => ProductInformationBlock,
   ProductType: () => ProductType,
   ProgressBar: () => ProgressBar,
+  ProgressTierExclusionType: () => ProgressTierExclusionType,
   ProgressTierType: () => ProgressTierType,
   ProgressTierUnit: () => ProgressTierUnit,
   QuantityInput: () => QuantityInput,
@@ -156,6 +158,7 @@ __export(src_exports, {
   SmartCartComponent: () => SmartCartComponent,
   SmartCartConfig: () => SmartCartConfig,
   SmartCartTier: () => SmartCartTier,
+  SmartCartTierExclusion: () => SmartCartTierExclusion,
   SmartCartTierProduct: () => SmartCartTierProduct,
   Spacing: () => Spacing,
   TextAlignment: () => TextAlignment,
@@ -248,6 +251,7 @@ __export(src_exports, {
   popoverPositions: () => popoverPositions,
   productImageObject: () => productImageObject,
   productTypes: () => productTypes,
+  progressTierExclusionTypes: () => progressTierExclusionTypes,
   progressTierTypes: () => progressTierTypes,
   progressTierUnits: () => progressTierUnits,
   quantityInputs: () => quantityInputs,
@@ -1025,6 +1029,12 @@ var SmartCartTierProduct = import_zod.z.looseObject({
   title: import_zod.z.string().optional(),
   variantIds: import_zod.z.array(import_zod.z.coerce.number()).optional()
 });
+var SmartCartTierExclusion = import_zod.z.looseObject({
+  collectionIds: import_zod.z.array(import_zod.z.coerce.number()).optional().catch(void 0),
+  productIds: import_zod.z.array(import_zod.z.coerce.number()).optional().catch(void 0),
+  tags: import_zod.z.array(import_zod.z.string()).optional().catch(void 0),
+  type: import_zod.z.string().optional().catch(void 0)
+});
 var SmartCartTier = import_zod.z.looseObject({
   allProducts: import_zod.z.array(SmartCartTierProduct).optional(),
   /** Merchant-set tier label (e.g. "Free gift", "$100 reward"), shown on the step row when enabled. */
@@ -1041,6 +1051,19 @@ var SmartCartTier = import_zod.z.looseObject({
   discountAmountRemainingLabel: import_zod.z.boolean().optional(),
   discountAmountRemainingLabelText: import_zod.z.string().optional(),
   discountType: import_zod.z.string().optional(),
+  /**
+   * onsite `exclusions` + `exclusions_enabled` (REB-22305): per-tier rules the converter carries onto
+   * `CABProgressTier.exclusions`. `.catch(undefined)` for the same blast-radius reason as `productTierImage`:
+   * one drifted value must degrade to "no tier exclusions", never drop every progress bar for the shop.
+   *
+   * `exclusionsEnabled` is a STRICT boolean on purpose, even though failing open here changes the tier's math
+   * (a non-boolean reads as disabled) rather than just an icon. onsite reads its sibling tier flags strictly —
+   * `shouldFilterOutOfStockVariantsFromTier` is `tier?.filter_oos_variants === true`, and its `progressBar.ts`
+   * types every tier flag as `boolean` — so a stored `1` / `"1"` / `"true"` is "disabled" on the onsite bar too.
+   * A truthiness preprocess would make CAB exclude where onsite does not: the opposite parity break.
+   */
+  exclusions: import_zod.z.array(SmartCartTierExclusion).optional().catch(void 0),
+  exclusionsEnabled: import_zod.z.boolean().optional().catch(void 0),
   filterOosVariants: import_zod.z.boolean().optional(),
   id: import_zod.z.string().optional(),
   /**
@@ -1750,6 +1773,8 @@ var progressTierTypes = ["decorative", "discount", "product", "shipping"];
 var ProgressTierType = freezeEnum(progressTierTypes);
 var progressTierUnits = ["currency", "item"];
 var ProgressTierUnit = freezeEnum(progressTierUnits);
+var progressTierExclusionTypes = ["collections", "products", "tags"];
+var ProgressTierExclusionType = freezeEnum(progressTierExclusionTypes);
 var quantityInputs = ["select", "number"];
 var QuantityInput = freezeEnum(quantityInputs);
 var resultCountOperators = ["equals", "greater_than", "less_than"];
@@ -2721,6 +2746,12 @@ var GIFT_LABELS = {
 };
 
 // src/schema/widgets/checkout-and-beyond/progressBar.ts
+var CABProgressTierExclusion = import_zod24.z.object({
+  collectionIds: import_zod24.z.array(import_zod24.z.number().int().positive()).default(() => []),
+  productIds: import_zod24.z.array(import_zod24.z.number().int().positive()).default(() => []),
+  tags: import_zod24.z.array(import_zod24.z.string().min(1)).default(() => []),
+  type: import_zod24.z.enum(progressTierExclusionTypes)
+});
 var CABProgressTier = import_zod24.z.object({
   /**
    * Order-discount tiers only (onsite `discount`): the reward the order-discount Function applies at
@@ -2729,6 +2760,13 @@ var CABProgressTier = import_zod24.z.object({
    * `percentage`: the whole-percent number rendered raw (`{n}%`). Absent on non-discount tiers.
    */
   discount: import_zod24.z.object({ amount: import_zod24.z.number().nonnegative(), type: import_zod24.z.enum(["fixedAmount", "percentage"]) }).optional(),
+  /**
+   * Per-tier exclusion rules (onsite `exclusions` when `exclusions_enabled`): lines they match don't count
+   * toward this tier. Empty (the default, and the converter's output for a disabled or ruleless tier) means
+   * the tier measures the plain bar-level adjusted progress. Consumers read ONLY the list named by the rule's
+   * `type` — the converter leaves the other two at `[]`, so a populated off-type list never reaches the tree.
+   */
+  exclusions: import_zod24.z.array(CABProgressTierExclusion).default(() => []),
   /**
    * Smart-cart product (gift) tiers only (onsite `filter_oos_variants`): when set, the client drops this
    * tier entirely once its gift has NO in-stock eligible variant — the milestone, fill slot and gift
@@ -3077,6 +3115,8 @@ var UI_LABELS = {
   guest: { en: "guest" },
   loadingOptions: { en: "Loading subscription options" },
   nextPage: { en: "Next" },
+  /** The paged offers list's region name — what a screen reader hears when a page turns (Allyant #140, REB-23881). */
+  offerCarousel: { en: "Offer Carousel" },
   offerDialog: { en: "Offer" },
   page: { en: "Page {{page}}" },
   previousPage: { en: "Previous" },
@@ -3092,6 +3132,7 @@ var CABUILabels = import_zod30.z.object({
   guest: localized(UI_LABELS.guest),
   loadingOptions: localized(UI_LABELS.loadingOptions),
   nextPage: localized(UI_LABELS.nextPage),
+  offerCarousel: localized(UI_LABELS.offerCarousel),
   offerDialog: localized(UI_LABELS.offerDialog),
   page: localized(UI_LABELS.page),
   previousPage: localized(UI_LABELS.previousPage),
@@ -3103,6 +3144,7 @@ var CABUILabels = import_zod30.z.object({
   guest: { ...UI_LABELS.guest },
   loadingOptions: { ...UI_LABELS.loadingOptions },
   nextPage: { ...UI_LABELS.nextPage },
+  offerCarousel: { ...UI_LABELS.offerCarousel },
   offerDialog: { ...UI_LABELS.offerDialog },
   page: { ...UI_LABELS.page },
   previousPage: { ...UI_LABELS.previousPage },

package/dist/index.mjs

@@ -739,6 +739,12 @@ var SmartCartTierProduct = z.looseObject({
   title: z.string().optional(),
   variantIds: z.array(z.coerce.number()).optional()
 });
+var SmartCartTierExclusion = z.looseObject({
+  collectionIds: z.array(z.coerce.number()).optional().catch(void 0),
+  productIds: z.array(z.coerce.number()).optional().catch(void 0),
+  tags: z.array(z.string()).optional().catch(void 0),
+  type: z.string().optional().catch(void 0)
+});
 var SmartCartTier = z.looseObject({
   allProducts: z.array(SmartCartTierProduct).optional(),
   /** Merchant-set tier label (e.g. "Free gift", "$100 reward"), shown on the step row when enabled. */
@@ -755,6 +761,19 @@ var SmartCartTier = z.looseObject({
   discountAmountRemainingLabel: z.boolean().optional(),
   discountAmountRemainingLabelText: z.string().optional(),
   discountType: z.string().optional(),
+  /**
+   * onsite `exclusions` + `exclusions_enabled` (REB-22305): per-tier rules the converter carries onto
+   * `CABProgressTier.exclusions`. `.catch(undefined)` for the same blast-radius reason as `productTierImage`:
+   * one drifted value must degrade to "no tier exclusions", never drop every progress bar for the shop.
+   *
+   * `exclusionsEnabled` is a STRICT boolean on purpose, even though failing open here changes the tier's math
+   * (a non-boolean reads as disabled) rather than just an icon. onsite reads its sibling tier flags strictly —
+   * `shouldFilterOutOfStockVariantsFromTier` is `tier?.filter_oos_variants === true`, and its `progressBar.ts`
+   * types every tier flag as `boolean` — so a stored `1` / `"1"` / `"true"` is "disabled" on the onsite bar too.
+   * A truthiness preprocess would make CAB exclude where onsite does not: the opposite parity break.
+   */
+  exclusions: z.array(SmartCartTierExclusion).optional().catch(void 0),
+  exclusionsEnabled: z.boolean().optional().catch(void 0),
   filterOosVariants: z.boolean().optional(),
   id: z.string().optional(),
   /**
@@ -1464,6 +1483,8 @@ var progressTierTypes = ["decorative", "discount", "product", "shipping"];
 var ProgressTierType = freezeEnum(progressTierTypes);
 var progressTierUnits = ["currency", "item"];
 var ProgressTierUnit = freezeEnum(progressTierUnits);
+var progressTierExclusionTypes = ["collections", "products", "tags"];
+var ProgressTierExclusionType = freezeEnum(progressTierExclusionTypes);
 var quantityInputs = ["select", "number"];
 var QuantityInput = freezeEnum(quantityInputs);
 var resultCountOperators = ["equals", "greater_than", "less_than"];
@@ -2435,6 +2456,12 @@ var GIFT_LABELS = {
 };
 
 // src/schema/widgets/checkout-and-beyond/progressBar.ts
+var CABProgressTierExclusion = z24.object({
+  collectionIds: z24.array(z24.number().int().positive()).default(() => []),
+  productIds: z24.array(z24.number().int().positive()).default(() => []),
+  tags: z24.array(z24.string().min(1)).default(() => []),
+  type: z24.enum(progressTierExclusionTypes)
+});
 var CABProgressTier = z24.object({
   /**
    * Order-discount tiers only (onsite `discount`): the reward the order-discount Function applies at
@@ -2443,6 +2470,13 @@ var CABProgressTier = z24.object({
    * `percentage`: the whole-percent number rendered raw (`{n}%`). Absent on non-discount tiers.
    */
   discount: z24.object({ amount: z24.number().nonnegative(), type: z24.enum(["fixedAmount", "percentage"]) }).optional(),
+  /**
+   * Per-tier exclusion rules (onsite `exclusions` when `exclusions_enabled`): lines they match don't count
+   * toward this tier. Empty (the default, and the converter's output for a disabled or ruleless tier) means
+   * the tier measures the plain bar-level adjusted progress. Consumers read ONLY the list named by the rule's
+   * `type` — the converter leaves the other two at `[]`, so a populated off-type list never reaches the tree.
+   */
+  exclusions: z24.array(CABProgressTierExclusion).default(() => []),
   /**
    * Smart-cart product (gift) tiers only (onsite `filter_oos_variants`): when set, the client drops this
    * tier entirely once its gift has NO in-stock eligible variant — the milestone, fill slot and gift
@@ -2791,6 +2825,8 @@ var UI_LABELS = {
   guest: { en: "guest" },
   loadingOptions: { en: "Loading subscription options" },
   nextPage: { en: "Next" },
+  /** The paged offers list's region name — what a screen reader hears when a page turns (Allyant #140, REB-23881). */
+  offerCarousel: { en: "Offer Carousel" },
   offerDialog: { en: "Offer" },
   page: { en: "Page {{page}}" },
   previousPage: { en: "Previous" },
@@ -2806,6 +2842,7 @@ var CABUILabels = z30.object({
   guest: localized(UI_LABELS.guest),
   loadingOptions: localized(UI_LABELS.loadingOptions),
   nextPage: localized(UI_LABELS.nextPage),
+  offerCarousel: localized(UI_LABELS.offerCarousel),
   offerDialog: localized(UI_LABELS.offerDialog),
   page: localized(UI_LABELS.page),
   previousPage: localized(UI_LABELS.previousPage),
@@ -2817,6 +2854,7 @@ var CABUILabels = z30.object({
   guest: { ...UI_LABELS.guest },
   loadingOptions: { ...UI_LABELS.loadingOptions },
   nextPage: { ...UI_LABELS.nextPage },
+  offerCarousel: { ...UI_LABELS.offerCarousel },
   offerDialog: { ...UI_LABELS.offerDialog },
   page: { ...UI_LABELS.page },
   previousPage: { ...UI_LABELS.previousPage },
@@ -4701,6 +4739,7 @@ export {
   CABProductsSection,
   CABProgressBarSection,
   CABProgressTier,
+  CABProgressTierExclusion,
   CABQuantitySection,
   CABResultCountTrigger,
   CABResultTagTrigger,
@@ -4774,6 +4813,7 @@ export {
   ProductInformationBlock,
   ProductType,
   ProgressBar,
+  ProgressTierExclusionType,
   ProgressTierType,
   ProgressTierUnit,
   QuantityInput,
@@ -4803,6 +4843,7 @@ export {
   SmartCartComponent,
   SmartCartConfig,
   SmartCartTier,
+  SmartCartTierExclusion,
   SmartCartTierProduct,
   Spacing,
   TextAlignment,
@@ -4895,6 +4936,7 @@ export {
   popoverPositions,
   productImageObject,
   productTypes,
+  progressTierExclusionTypes,
   progressTierTypes,
   progressTierUnits,
   quantityInputs,

package/dist/schema/cabShopConfig.d.ts

@@ -131,6 +131,13 @@ export declare const CabUserConfig: z.ZodObject<{
                         discountAmountRemainingLabel: z.ZodOptional<z.ZodBoolean>;
                         discountAmountRemainingLabelText: z.ZodOptional<z.ZodString>;
                         discountType: z.ZodOptional<z.ZodString>;
+                        exclusions: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                            productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                            tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+                            type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+                        }, z.core.$loose>>>>;
+                        exclusionsEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
                         filterOosVariants: z.ZodOptional<z.ZodBoolean>;
                         id: z.ZodOptional<z.ZodString>;
                         minimum: z.ZodPreprocess<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;

package/dist/schema/checkout-and-beyond/constants.cjs

@@ -39,6 +39,7 @@ __export(common_exports, {
   OffersDirection: () => OffersDirection,
   PopoverPosition: () => PopoverPosition,
   ProductType: () => ProductType,
+  ProgressTierExclusionType: () => ProgressTierExclusionType,
   ProgressTierType: () => ProgressTierType,
   ProgressTierUnit: () => ProgressTierUnit,
   QuantityInput: () => QuantityInput,
@@ -77,6 +78,7 @@ __export(common_exports, {
   popoverPositionMap: () => popoverPositionMap,
   popoverPositions: () => popoverPositions,
   productTypes: () => productTypes,
+  progressTierExclusionTypes: () => progressTierExclusionTypes,
   progressTierTypes: () => progressTierTypes,
   progressTierUnits: () => progressTierUnits,
   quantityInputs: () => quantityInputs,
@@ -218,6 +220,8 @@ var progressTierTypes = ["decorative", "discount", "product", "shipping"];
 var ProgressTierType = freezeEnum(progressTierTypes);
 var progressTierUnits = ["currency", "item"];
 var ProgressTierUnit = freezeEnum(progressTierUnits);
+var progressTierExclusionTypes = ["collections", "products", "tags"];
+var ProgressTierExclusionType = freezeEnum(progressTierExclusionTypes);
 var quantityInputs = ["select", "number"];
 var QuantityInput = freezeEnum(quantityInputs);
 var resultCountOperators = ["equals", "greater_than", "less_than"];

package/dist/schema/checkout-and-beyond/constants.mjs

@@ -121,6 +121,8 @@ var progressTierTypes = ["decorative", "discount", "product", "shipping"];
 var ProgressTierType = freezeEnum(progressTierTypes);
 var progressTierUnits = ["currency", "item"];
 var ProgressTierUnit = freezeEnum(progressTierUnits);
+var progressTierExclusionTypes = ["collections", "products", "tags"];
+var ProgressTierExclusionType = freezeEnum(progressTierExclusionTypes);
 var quantityInputs = ["select", "number"];
 var QuantityInput = freezeEnum(quantityInputs);
 var resultCountOperators = ["equals", "greater_than", "less_than"];
@@ -216,6 +218,7 @@ export {
   OffersDirection,
   PopoverPosition,
   ProductType,
+  ProgressTierExclusionType,
   ProgressTierType,
   ProgressTierUnit,
   QuantityInput,
@@ -254,6 +257,7 @@ export {
   popoverPositionMap,
   popoverPositions,
   productTypes,
+  progressTierExclusionTypes,
   progressTierTypes,
   progressTierUnits,
   quantityInputs,

package/dist/schema/checkout-and-beyond/index.cjs

@@ -51,6 +51,7 @@ __export(checkout_and_beyond_exports, {
   CABProductsSection: () => CABProductsSection,
   CABProgressBarSection: () => CABProgressBarSection,
   CABProgressTier: () => CABProgressTier,
+  CABProgressTierExclusion: () => CABProgressTierExclusion,
   CABQuantitySection: () => CABQuantitySection,
   CABResultCountTrigger: () => CABResultCountTrigger,
   CABResultTagTrigger: () => CABResultTagTrigger,
@@ -97,6 +98,7 @@ __export(checkout_and_beyond_exports, {
   OffersDirection: () => OffersDirection,
   PopoverPosition: () => PopoverPosition,
   ProductType: () => ProductType,
+  ProgressTierExclusionType: () => ProgressTierExclusionType,
   ProgressTierType: () => ProgressTierType,
   ProgressTierUnit: () => ProgressTierUnit,
   QuantityInput: () => QuantityInput,
@@ -172,6 +174,7 @@ __export(checkout_and_beyond_exports, {
   popoverPositionMap: () => popoverPositionMap,
   popoverPositions: () => popoverPositions,
   productTypes: () => productTypes,
+  progressTierExclusionTypes: () => progressTierExclusionTypes,
   progressTierTypes: () => progressTierTypes,
   progressTierUnits: () => progressTierUnits,
   quantityInputs: () => quantityInputs,
@@ -321,6 +324,8 @@ var progressTierTypes = ["decorative", "discount", "product", "shipping"];
 var ProgressTierType = freezeEnum(progressTierTypes);
 var progressTierUnits = ["currency", "item"];
 var ProgressTierUnit = freezeEnum(progressTierUnits);
+var progressTierExclusionTypes = ["collections", "products", "tags"];
+var ProgressTierExclusionType = freezeEnum(progressTierExclusionTypes);
 var quantityInputs = ["select", "number"];
 var QuantityInput = freezeEnum(quantityInputs);
 var resultCountOperators = ["equals", "greater_than", "less_than"];
@@ -1254,6 +1259,12 @@ var GIFT_LABELS = {
 };
 
 // src/schema/widgets/checkout-and-beyond/progressBar.ts
+var CABProgressTierExclusion = import_zod14.z.object({
+  collectionIds: import_zod14.z.array(import_zod14.z.number().int().positive()).default(() => []),
+  productIds: import_zod14.z.array(import_zod14.z.number().int().positive()).default(() => []),
+  tags: import_zod14.z.array(import_zod14.z.string().min(1)).default(() => []),
+  type: import_zod14.z.enum(progressTierExclusionTypes)
+});
 var CABProgressTier = import_zod14.z.object({
   /**
    * Order-discount tiers only (onsite `discount`): the reward the order-discount Function applies at
@@ -1262,6 +1273,13 @@ var CABProgressTier = import_zod14.z.object({
    * `percentage`: the whole-percent number rendered raw (`{n}%`). Absent on non-discount tiers.
    */
   discount: import_zod14.z.object({ amount: import_zod14.z.number().nonnegative(), type: import_zod14.z.enum(["fixedAmount", "percentage"]) }).optional(),
+  /**
+   * Per-tier exclusion rules (onsite `exclusions` when `exclusions_enabled`): lines they match don't count
+   * toward this tier. Empty (the default, and the converter's output for a disabled or ruleless tier) means
+   * the tier measures the plain bar-level adjusted progress. Consumers read ONLY the list named by the rule's
+   * `type` — the converter leaves the other two at `[]`, so a populated off-type list never reaches the tree.
+   */
+  exclusions: import_zod14.z.array(CABProgressTierExclusion).default(() => []),
   /**
    * Smart-cart product (gift) tiers only (onsite `filter_oos_variants`): when set, the client drops this
    * tier entirely once its gift has NO in-stock eligible variant — the milestone, fill slot and gift
@@ -1839,6 +1857,8 @@ var UI_LABELS = {
   guest: { en: "guest" },
   loadingOptions: { en: "Loading subscription options" },
   nextPage: { en: "Next" },
+  /** The paged offers list's region name — what a screen reader hears when a page turns (Allyant #140, REB-23881). */
+  offerCarousel: { en: "Offer Carousel" },
   offerDialog: { en: "Offer" },
   page: { en: "Page {{page}}" },
   previousPage: { en: "Previous" },
@@ -1854,6 +1874,7 @@ var CABUILabels = import_zod21.z.object({
   guest: localized(UI_LABELS.guest),
   loadingOptions: localized(UI_LABELS.loadingOptions),
   nextPage: localized(UI_LABELS.nextPage),
+  offerCarousel: localized(UI_LABELS.offerCarousel),
   offerDialog: localized(UI_LABELS.offerDialog),
   page: localized(UI_LABELS.page),
   previousPage: localized(UI_LABELS.previousPage),
@@ -1865,6 +1886,7 @@ var CABUILabels = import_zod21.z.object({
   guest: { ...UI_LABELS.guest },
   loadingOptions: { ...UI_LABELS.loadingOptions },
   nextPage: { ...UI_LABELS.nextPage },
+  offerCarousel: { ...UI_LABELS.offerCarousel },
   offerDialog: { ...UI_LABELS.offerDialog },
   page: { ...UI_LABELS.page },
   previousPage: { ...UI_LABELS.previousPage },

package/dist/schema/checkout-and-beyond/index.mjs

@@ -124,6 +124,8 @@ var progressTierTypes = ["decorative", "discount", "product", "shipping"];
 var ProgressTierType = freezeEnum(progressTierTypes);
 var progressTierUnits = ["currency", "item"];
 var ProgressTierUnit = freezeEnum(progressTierUnits);
+var progressTierExclusionTypes = ["collections", "products", "tags"];
+var ProgressTierExclusionType = freezeEnum(progressTierExclusionTypes);
 var quantityInputs = ["select", "number"];
 var QuantityInput = freezeEnum(quantityInputs);
 var resultCountOperators = ["equals", "greater_than", "less_than"];
@@ -1057,6 +1059,12 @@ var GIFT_LABELS = {
 };
 
 // src/schema/widgets/checkout-and-beyond/progressBar.ts
+var CABProgressTierExclusion = z14.object({
+  collectionIds: z14.array(z14.number().int().positive()).default(() => []),
+  productIds: z14.array(z14.number().int().positive()).default(() => []),
+  tags: z14.array(z14.string().min(1)).default(() => []),
+  type: z14.enum(progressTierExclusionTypes)
+});
 var CABProgressTier = z14.object({
   /**
    * Order-discount tiers only (onsite `discount`): the reward the order-discount Function applies at
@@ -1065,6 +1073,13 @@ var CABProgressTier = z14.object({
    * `percentage`: the whole-percent number rendered raw (`{n}%`). Absent on non-discount tiers.
    */
   discount: z14.object({ amount: z14.number().nonnegative(), type: z14.enum(["fixedAmount", "percentage"]) }).optional(),
+  /**
+   * Per-tier exclusion rules (onsite `exclusions` when `exclusions_enabled`): lines they match don't count
+   * toward this tier. Empty (the default, and the converter's output for a disabled or ruleless tier) means
+   * the tier measures the plain bar-level adjusted progress. Consumers read ONLY the list named by the rule's
+   * `type` — the converter leaves the other two at `[]`, so a populated off-type list never reaches the tree.
+   */
+  exclusions: z14.array(CABProgressTierExclusion).default(() => []),
   /**
    * Smart-cart product (gift) tiers only (onsite `filter_oos_variants`): when set, the client drops this
    * tier entirely once its gift has NO in-stock eligible variant — the milestone, fill slot and gift
@@ -1642,6 +1657,8 @@ var UI_LABELS = {
   guest: { en: "guest" },
   loadingOptions: { en: "Loading subscription options" },
   nextPage: { en: "Next" },
+  /** The paged offers list's region name — what a screen reader hears when a page turns (Allyant #140, REB-23881). */
+  offerCarousel: { en: "Offer Carousel" },
   offerDialog: { en: "Offer" },
   page: { en: "Page {{page}}" },
   previousPage: { en: "Previous" },
@@ -1657,6 +1674,7 @@ var CABUILabels = z21.object({
   guest: localized(UI_LABELS.guest),
   loadingOptions: localized(UI_LABELS.loadingOptions),
   nextPage: localized(UI_LABELS.nextPage),
+  offerCarousel: localized(UI_LABELS.offerCarousel),
   offerDialog: localized(UI_LABELS.offerDialog),
   page: localized(UI_LABELS.page),
   previousPage: localized(UI_LABELS.previousPage),
@@ -1668,6 +1686,7 @@ var CABUILabels = z21.object({
   guest: { ...UI_LABELS.guest },
   loadingOptions: { ...UI_LABELS.loadingOptions },
   nextPage: { ...UI_LABELS.nextPage },
+  offerCarousel: { ...UI_LABELS.offerCarousel },
   offerDialog: { ...UI_LABELS.offerDialog },
   page: { ...UI_LABELS.page },
   previousPage: { ...UI_LABELS.previousPage },
@@ -1855,6 +1874,7 @@ export {
   CABProductsSection,
   CABProgressBarSection,
   CABProgressTier,
+  CABProgressTierExclusion,
   CABQuantitySection,
   CABResultCountTrigger,
   CABResultTagTrigger,
@@ -1901,6 +1921,7 @@ export {
   OffersDirection,
   PopoverPosition,
   ProductType,
+  ProgressTierExclusionType,
   ProgressTierType,
   ProgressTierUnit,
   QuantityInput,
@@ -1976,6 +1997,7 @@ export {
   popoverPositionMap,
   popoverPositions,
   productTypes,
+  progressTierExclusionTypes,
   progressTierTypes,
   progressTierUnits,
   quantityInputs,

package/dist/schema/smartCart.d.ts

@@ -10,6 +10,23 @@ export declare const SmartCartTierProduct: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     variantIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
 }, z.core.$loose>;
+/**
+ * onsite `exclusions[]` entry on a tier (REB-22305): products, collections or tags whose cart lines do NOT count
+ * toward that tier's progress. Loose and coerced like the rest of the config; the converter validates `type`
+ * and drops junk ids, so a malformed rule degrades to "matches nothing" rather than failing the tier.
+ *
+ * `.catch(undefined)` sits on EACH field, not on the rule or the array: `SmartCartTier.exclusions` catches at
+ * the array level, so without these a single drifted field (a bare `tags: 'sale'`, a `gid://` collection id
+ * that coerces to `NaN`) would fail its element, fail the array, and silently drop every rule on the tier.
+ * Per-field, the bad list reads as absent, the converter drops just that rule (empty matching list), and the
+ * tier's other rules still apply.
+ */
+export declare const SmartCartTierExclusion: z.ZodObject<{
+    collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+    productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+    tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>;
 /**
  * One reward tier on a smart-cart tiered progress bar. `type` is `product` (gift), `shipping`,
  * `discount` (order discount applied by the order-discount Function, keyed by `_barId`) or
@@ -42,6 +59,13 @@ export declare const SmartCartTier: z.ZodObject<{
     discountAmountRemainingLabel: z.ZodOptional<z.ZodBoolean>;
     discountAmountRemainingLabelText: z.ZodOptional<z.ZodString>;
     discountType: z.ZodOptional<z.ZodString>;
+    exclusions: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+        productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+        tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    }, z.core.$loose>>>>;
+    exclusionsEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
     filterOosVariants: z.ZodOptional<z.ZodBoolean>;
     id: z.ZodOptional<z.ZodString>;
     minimum: z.ZodPreprocess<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -104,6 +128,13 @@ export declare const SmartCartBar: z.ZodObject<{
         discountAmountRemainingLabel: z.ZodOptional<z.ZodBoolean>;
         discountAmountRemainingLabelText: z.ZodOptional<z.ZodString>;
         discountType: z.ZodOptional<z.ZodString>;
+        exclusions: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+            productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+            tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        }, z.core.$loose>>>>;
+        exclusionsEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
         filterOosVariants: z.ZodOptional<z.ZodBoolean>;
         id: z.ZodOptional<z.ZodString>;
         minimum: z.ZodPreprocess<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -165,6 +196,13 @@ export declare const SmartCartComponent: z.ZodObject<{
                 discountAmountRemainingLabel: z.ZodOptional<z.ZodBoolean>;
                 discountAmountRemainingLabelText: z.ZodOptional<z.ZodString>;
                 discountType: z.ZodOptional<z.ZodString>;
+                exclusions: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                    productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                    tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+                    type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+                }, z.core.$loose>>>>;
+                exclusionsEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
                 filterOosVariants: z.ZodOptional<z.ZodBoolean>;
                 id: z.ZodOptional<z.ZodString>;
                 minimum: z.ZodPreprocess<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -237,6 +275,13 @@ export declare const SmartCartConfig: z.ZodObject<{
                     discountAmountRemainingLabel: z.ZodOptional<z.ZodBoolean>;
                     discountAmountRemainingLabelText: z.ZodOptional<z.ZodString>;
                     discountType: z.ZodOptional<z.ZodString>;
+                    exclusions: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                        productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                        tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+                        type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$loose>>>>;
+                    exclusionsEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
                     filterOosVariants: z.ZodOptional<z.ZodBoolean>;
                     id: z.ZodOptional<z.ZodString>;
                     minimum: z.ZodPreprocess<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;

package/dist/schema/user-config.cjs

@@ -118,6 +118,12 @@ var SmartCartTierProduct = import_zod2.z.looseObject({
   title: import_zod2.z.string().optional(),
   variantIds: import_zod2.z.array(import_zod2.z.coerce.number()).optional()
 });
+var SmartCartTierExclusion = import_zod2.z.looseObject({
+  collectionIds: import_zod2.z.array(import_zod2.z.coerce.number()).optional().catch(void 0),
+  productIds: import_zod2.z.array(import_zod2.z.coerce.number()).optional().catch(void 0),
+  tags: import_zod2.z.array(import_zod2.z.string()).optional().catch(void 0),
+  type: import_zod2.z.string().optional().catch(void 0)
+});
 var SmartCartTier = import_zod2.z.looseObject({
   allProducts: import_zod2.z.array(SmartCartTierProduct).optional(),
   /** Merchant-set tier label (e.g. "Free gift", "$100 reward"), shown on the step row when enabled. */
@@ -134,6 +140,19 @@ var SmartCartTier = import_zod2.z.looseObject({
   discountAmountRemainingLabel: import_zod2.z.boolean().optional(),
   discountAmountRemainingLabelText: import_zod2.z.string().optional(),
   discountType: import_zod2.z.string().optional(),
+  /**
+   * onsite `exclusions` + `exclusions_enabled` (REB-22305): per-tier rules the converter carries onto
+   * `CABProgressTier.exclusions`. `.catch(undefined)` for the same blast-radius reason as `productTierImage`:
+   * one drifted value must degrade to "no tier exclusions", never drop every progress bar for the shop.
+   *
+   * `exclusionsEnabled` is a STRICT boolean on purpose, even though failing open here changes the tier's math
+   * (a non-boolean reads as disabled) rather than just an icon. onsite reads its sibling tier flags strictly —
+   * `shouldFilterOutOfStockVariantsFromTier` is `tier?.filter_oos_variants === true`, and its `progressBar.ts`
+   * types every tier flag as `boolean` — so a stored `1` / `"1"` / `"true"` is "disabled" on the onsite bar too.
+   * A truthiness preprocess would make CAB exclude where onsite does not: the opposite parity break.
+   */
+  exclusions: import_zod2.z.array(SmartCartTierExclusion).optional().catch(void 0),
+  exclusionsEnabled: import_zod2.z.boolean().optional().catch(void 0),
   filterOosVariants: import_zod2.z.boolean().optional(),
   id: import_zod2.z.string().optional(),
   /**

package/dist/schema/user-config.mjs

@@ -94,6 +94,12 @@ var SmartCartTierProduct = z2.looseObject({
   title: z2.string().optional(),
   variantIds: z2.array(z2.coerce.number()).optional()
 });
+var SmartCartTierExclusion = z2.looseObject({
+  collectionIds: z2.array(z2.coerce.number()).optional().catch(void 0),
+  productIds: z2.array(z2.coerce.number()).optional().catch(void 0),
+  tags: z2.array(z2.string()).optional().catch(void 0),
+  type: z2.string().optional().catch(void 0)
+});
 var SmartCartTier = z2.looseObject({
   allProducts: z2.array(SmartCartTierProduct).optional(),
   /** Merchant-set tier label (e.g. "Free gift", "$100 reward"), shown on the step row when enabled. */
@@ -110,6 +116,19 @@ var SmartCartTier = z2.looseObject({
   discountAmountRemainingLabel: z2.boolean().optional(),
   discountAmountRemainingLabelText: z2.string().optional(),
   discountType: z2.string().optional(),
+  /**
+   * onsite `exclusions` + `exclusions_enabled` (REB-22305): per-tier rules the converter carries onto
+   * `CABProgressTier.exclusions`. `.catch(undefined)` for the same blast-radius reason as `productTierImage`:
+   * one drifted value must degrade to "no tier exclusions", never drop every progress bar for the shop.
+   *
+   * `exclusionsEnabled` is a STRICT boolean on purpose, even though failing open here changes the tier's math
+   * (a non-boolean reads as disabled) rather than just an icon. onsite reads its sibling tier flags strictly —
+   * `shouldFilterOutOfStockVariantsFromTier` is `tier?.filter_oos_variants === true`, and its `progressBar.ts`
+   * types every tier flag as `boolean` — so a stored `1` / `"1"` / `"true"` is "disabled" on the onsite bar too.
+   * A truthiness preprocess would make CAB exclude where onsite does not: the opposite parity break.
+   */
+  exclusions: z2.array(SmartCartTierExclusion).optional().catch(void 0),
+  exclusionsEnabled: z2.boolean().optional().catch(void 0),
   filterOosVariants: z2.boolean().optional(),
   id: z2.string().optional(),
   /**

package/dist/schema/userConfig.d.ts

@@ -116,6 +116,13 @@ export declare const UserConfig: z.ZodObject<{
                         discountAmountRemainingLabel: z.ZodOptional<z.ZodBoolean>;
                         discountAmountRemainingLabelText: z.ZodOptional<z.ZodString>;
                         discountType: z.ZodOptional<z.ZodString>;
+                        exclusions: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            collectionIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                            productIds: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>>;
+                            tags: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+                            type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+                        }, z.core.$loose>>>>;
+                        exclusionsEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
                         filterOosVariants: z.ZodOptional<z.ZodBoolean>;
                         id: z.ZodOptional<z.ZodString>;
                         minimum: z.ZodPreprocess<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;