@rebuy/rebuy 3.45.0 → 3.47.0

package/dist/index.cjs

@@ -3704,6 +3704,13 @@ var CABButtonSection = import_zod52.z.object({
     width: 300
   }),
   disableDowngrade: import_zod52.z.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: import_zod52.z.enum(["planName", "template"]).optional().catch(void 0),
   name: import_zod52.z.string().optional(),
   optionId: import_zod52.z.number().optional(),
   popover: import_zod52.z.object({
@@ -4343,6 +4350,20 @@ var import_zod65 = require("zod");
 var CABVariantsSection = import_zod65.z.object({
   ...CABVariableFields,
   hideOutOfStockVariants: import_zod65.z.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: import_zod65.z.record(import_zod65.z.string(), import_zod65.z.string()).transform((label) => {
+    const filled = (0, import_compat5.pickBy)(label, (value) => value.trim() !== "");
+    return (0, import_compat5.isEmpty)(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: import_zod65.z.string().optional(),
   sectionId: import_zod65.z.uuid().default(() => (0, import_uuid14.v7)()),
   sectionType: import_zod65.z.literal(SectionType.variants).default(SectionType.variants),
@@ -6220,6 +6241,7 @@ var subscriptionToggle = (productType, labels = {}) => {
       buttonStyle: "plain",
       /** A `subscription` widget offers no one-time purchase; suppress the downgrade so the buyer can't switch to one-time. */
       ...productType === "subscription" && { disableDowngrade: true },
+      ...labels.frequencyLabel && { frequencyLabel: labels.frequencyLabel },
       sections: [
         slot("subscriptionOption", void 0),
         slot("switchToOneTimePurchase", labels.oneTime),

package/dist/index.mjs

@@ -3233,6 +3233,13 @@ var CABButtonSection = z52.object({
     width: 300
   }),
   disableDowngrade: z52.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: z52.enum(["planName", "template"]).optional().catch(void 0),
   name: z52.string().optional(),
   optionId: z52.number().optional(),
   popover: z52.object({
@@ -3866,12 +3873,26 @@ var CABSeparatorSection = z64.object({
 });
 
 // src/schema/widgets/checkout-and-beyond/variants.ts
-import { slice } from "es-toolkit/compat";
+import { isEmpty, pickBy, slice } from "es-toolkit/compat";
 import { v7 as uuidv712 } from "uuid";
 import { z as z65 } from "zod";
 var CABVariantsSection = z65.object({
   ...CABVariableFields,
   hideOutOfStockVariants: z65.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: z65.record(z65.string(), z65.string()).transform((label) => {
+    const filled = pickBy(label, (value) => value.trim() !== "");
+    return isEmpty(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: z65.string().optional(),
   sectionId: z65.uuid().default(() => uuidv712()),
   sectionType: z65.literal(SectionType.variants).default(SectionType.variants),
@@ -5749,6 +5770,7 @@ var subscriptionToggle = (productType, labels = {}) => {
       buttonStyle: "plain",
       /** A `subscription` widget offers no one-time purchase; suppress the downgrade so the buyer can't switch to one-time. */
       ...productType === "subscription" && { disableDowngrade: true },
+      ...labels.frequencyLabel && { frequencyLabel: labels.frequencyLabel },
       sections: [
         slot("subscriptionOption", void 0),
         slot("switchToOneTimePurchase", labels.oneTime),

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

@@ -926,6 +926,13 @@ var CABButtonSection = import_zod6.z.object({
     width: 300
   }),
   disableDowngrade: import_zod6.z.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: import_zod6.z.enum(["planName", "template"]).optional().catch(void 0),
   name: import_zod6.z.string().optional(),
   optionId: import_zod6.z.number().optional(),
   popover: import_zod6.z.object({
@@ -1618,6 +1625,20 @@ var import_zod19 = require("zod");
 var CABVariantsSection = import_zod19.z.object({
   ...CABVariableFields,
   hideOutOfStockVariants: import_zod19.z.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: import_zod19.z.record(import_zod19.z.string(), import_zod19.z.string()).transform((label) => {
+    const filled = (0, import_compat3.pickBy)(label, (value) => value.trim() !== "");
+    return (0, import_compat3.isEmpty)(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: import_zod19.z.string().optional(),
   sectionId: import_zod19.z.uuid().default(() => (0, import_uuid12.v7)()),
   sectionType: import_zod19.z.literal(SectionType.variants).default(SectionType.variants),

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

@@ -712,6 +712,13 @@ var CABButtonSection = z6.object({
     width: 300
   }),
   disableDowngrade: z6.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: z6.enum(["planName", "template"]).optional().catch(void 0),
   name: z6.string().optional(),
   optionId: z6.number().optional(),
   popover: z6.object({
@@ -1398,12 +1405,26 @@ var CABSeparatorSection = z18.object({
 });
 
 // src/schema/widgets/checkout-and-beyond/variants.ts
-import { slice } from "es-toolkit/compat";
+import { isEmpty, pickBy, slice } from "es-toolkit/compat";
 import { v7 as uuidv712 } from "uuid";
 import { z as z19 } from "zod";
 var CABVariantsSection = z19.object({
   ...CABVariableFields,
   hideOutOfStockVariants: z19.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: z19.record(z19.string(), z19.string()).transform((label) => {
+    const filled = pickBy(label, (value) => value.trim() !== "");
+    return isEmpty(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: z19.string().optional(),
   sectionId: z19.uuid().default(() => uuidv712()),
   sectionType: z19.literal(SectionType.variants).default(SectionType.variants),

package/dist/schema/widget-data.cjs

@@ -802,6 +802,13 @@ var CABButtonSection = import_zod9.z.object({
     width: 300
   }),
   disableDowngrade: import_zod9.z.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: import_zod9.z.enum(["planName", "template"]).optional().catch(void 0),
   name: import_zod9.z.string().optional(),
   optionId: import_zod9.z.number().optional(),
   popover: import_zod9.z.object({
@@ -1441,6 +1448,20 @@ var import_zod22 = require("zod");
 var CABVariantsSection = import_zod22.z.object({
   ...CABVariableFields,
   hideOutOfStockVariants: import_zod22.z.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: import_zod22.z.record(import_zod22.z.string(), import_zod22.z.string()).transform((label) => {
+    const filled = (0, import_compat3.pickBy)(label, (value) => value.trim() !== "");
+    return (0, import_compat3.isEmpty)(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: import_zod22.z.string().optional(),
   sectionId: import_zod22.z.uuid().default(() => (0, import_uuid12.v7)()),
   sectionType: import_zod22.z.literal(SectionType.variants).default(SectionType.variants),

package/dist/schema/widget-data.mjs

@@ -777,6 +777,13 @@ var CABButtonSection = z9.object({
     width: 300
   }),
   disableDowngrade: z9.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: z9.enum(["planName", "template"]).optional().catch(void 0),
   name: z9.string().optional(),
   optionId: z9.number().optional(),
   popover: z9.object({
@@ -1410,12 +1417,26 @@ var CABSeparatorSection = z21.object({
 });
 
 // src/schema/widgets/checkout-and-beyond/variants.ts
-import { slice } from "es-toolkit/compat";
+import { isEmpty, pickBy, slice } from "es-toolkit/compat";
 import { v7 as uuidv712 } from "uuid";
 import { z as z22 } from "zod";
 var CABVariantsSection = z22.object({
   ...CABVariableFields,
   hideOutOfStockVariants: z22.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: z22.record(z22.string(), z22.string()).transform((label) => {
+    const filled = pickBy(label, (value) => value.trim() !== "");
+    return isEmpty(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: z22.string().optional(),
   sectionId: z22.uuid().default(() => uuidv712()),
   sectionType: z22.literal(SectionType.variants).default(SectionType.variants),

package/dist/schema/widgets/checkout-and-beyond/button.d.ts

@@ -36,6 +36,10 @@ export declare const CABButtonSection: z.ZodObject<{
         width: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     disableDowngrade: z.ZodDefault<z.ZodBoolean>;
+    frequencyLabel: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        planName: "planName";
+        template: "template";
+    }>>>;
     name: z.ZodOptional<z.ZodString>;
     optionId: z.ZodOptional<z.ZodNumber>;
     popover: z.ZodDefault<z.ZodOptional<z.ZodObject<{

package/dist/schema/widgets/checkout-and-beyond/variants.d.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { type SectionDetails } from './shared';
 export declare const CABVariantsSection: z.ZodObject<{
     hideOutOfStockVariants: z.ZodDefault<z.ZodBoolean>;
+    label: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodString>, z.ZodTransform<Record<string, string> | undefined, Record<string, string>>>>>;
     name: z.ZodOptional<z.ZodString>;
     sectionId: z.ZodDefault<z.ZodUUID>;
     sectionType: z.ZodDefault<z.ZodLiteral<"variants">>;

package/dist/server/composeOffer.d.ts

@@ -5,7 +5,7 @@ import { type MonetizeInput } from '../server/shared';
  * Compose one ads-engine offer into a renderable CAB card: a bordered `layout` whose `viewUrl` is the
  * impression pixel, holding the header chrome, the copy (headline + HTML body, pre-converted to a
  * small-sized Tiptap doc by {@link smallText}) beside the optional image (75%/fill — the React desktop split),
- * the two CTAs in a 50/50 row, and the right-aligned Privacy Policy footer. `acceptOffer` links out
+ * the two CTAs in a 50/50 row, the paging dots, and the right-aligned Privacy Policy footer. `acceptOffer` links out
  * to the advertiser (`destinationUrl` = `click_url`, which self-tracks); `declineOffer` fires the
  * decline pixel (`trackingUrl`) and advances. Parsing through the schema fills defaults and validates
  * the shape.

package/dist/server/index.cjs

@@ -1392,6 +1392,13 @@ var CABButtonSection = import_zod13.z.object({
     width: 300
   }),
   disableDowngrade: import_zod13.z.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: import_zod13.z.enum(["planName", "template"]).optional().catch(void 0),
   name: import_zod13.z.string().optional(),
   optionId: import_zod13.z.number().optional(),
   popover: import_zod13.z.object({
@@ -2084,6 +2091,20 @@ var import_zod26 = require("zod");
 var CABVariantsSection = import_zod26.z.object({
   ...CABVariableFields,
   hideOutOfStockVariants: import_zod26.z.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: import_zod26.z.record(import_zod26.z.string(), import_zod26.z.string()).transform((label2) => {
+    const filled = (0, import_compat3.pickBy)(label2, (value) => value.trim() !== "");
+    return (0, import_compat3.isEmpty)(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: import_zod26.z.string().optional(),
   sectionId: import_zod26.z.uuid().default(() => (0, import_uuid12.v7)()),
   sectionType: import_zod26.z.literal(SectionType.variants).default(SectionType.variants),
@@ -3363,6 +3384,7 @@ var subscriptionToggle = (productType, labels = {}) => {
       buttonStyle: "plain",
       /** A `subscription` widget offers no one-time purchase; suppress the downgrade so the buyer can't switch to one-time. */
       ...productType === "subscription" && { disableDowngrade: true },
+      ...labels.frequencyLabel && { frequencyLabel: labels.frequencyLabel },
       sections: [
         slot("subscriptionOption", void 0),
         slot("switchToOneTimePurchase", labels.oneTime),
@@ -4287,13 +4309,16 @@ var convertPayButtonBlock = (raw, report) => {
 };
 
 // src/transforms/postPurchase/productCardControls.ts
-var groupSelector = { sectionType: "variants", selector: "menu", variantMode: "productGroup" };
+var SELECT_VARIANT = { en: "Select Variant" };
+var PRODUCT_GROUP = { en: "Option" };
+var groupSelector = { label: PRODUCT_GROUP, sectionType: "variants", selector: "menu", variantMode: "productGroup" };
 var variantSelector = ({ productOptions }) => {
   if (!productOptions.showVariantSelectors) return [];
   const single = productOptions.variantSelectorDisplayMode === "single";
   return [
     {
       hideOutOfStockVariants: single || productOptions.hideOutOfStockVariants,
+      ...single && { label: SELECT_VARIANT },
       sectionType: "variants",
       selector: "menu",
       variantMode: single ? "single" : "multiple"
@@ -4308,7 +4333,7 @@ var quantity = ({ language: language3, quantityInputs: quantityInputs2 }) => qua
   })
 ] : [];
 var productCardControls = (settings) => [
-  ...subscriptionToggle(settings.productType),
+  ...subscriptionToggle(settings.productType, { frequencyLabel: "planName" }),
   groupSelector,
   ...variantSelector(settings),
   ...quantity(settings)
@@ -5605,6 +5630,25 @@ var disclaimerSections = (offer) => {
     }
   ];
 };
+var pagingDot = (buttonField, opacity) => ({
+  buttonField,
+  sectionType: SectionType.image,
+  source: `data:image/svg+xml,${encodeURIComponent(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><circle cx="4" cy="4" r="4" fill="#808080" fill-opacity="${opacity}"/></svg>`
+  )}`
+});
+var pagingDots = () => ({
+  alignment: { horizontal: HorizontalAlignment.center, vertical: VerticalAlignment.top },
+  sections: [
+    {
+      action: ButtonAction.showPagination,
+      buttonStyle: ButtonStyle.plain,
+      sections: [pagingDot(ButtonField.activePage, 1), pagingDot(ButtonField.inactivePage, 0.35)],
+      sectionType: SectionType.button
+    }
+  ],
+  sectionType: SectionType.layout
+});
 var composeOfferCard = (offer, input, storeName) => {
   const copy = {
     sections: [headlineText(offer.headline), smallText(offer.description)],
@@ -5661,6 +5705,7 @@ var composeOfferCard = (offer, input, storeName) => {
           sectionType: SectionType.layout
         },
         ...disclaimerSections(offer),
+        pagingDots(),
         /**
          * Ad-unit Privacy Policy footer (compliance). Its own end-aligned layout packs a fit-content
          * paragraph right; the paragraph's own `textAlign: end` covers the full-width case — together

package/dist/server/index.mjs

@@ -1320,6 +1320,13 @@ var CABButtonSection = z13.object({
     width: 300
   }),
   disableDowngrade: z13.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: z13.enum(["planName", "template"]).optional().catch(void 0),
   name: z13.string().optional(),
   optionId: z13.number().optional(),
   popover: z13.object({
@@ -2006,12 +2013,26 @@ var CABSeparatorSection = z25.object({
 });
 
 // src/schema/widgets/checkout-and-beyond/variants.ts
-import { slice } from "es-toolkit/compat";
+import { isEmpty, pickBy, slice } from "es-toolkit/compat";
 import { v7 as uuidv712 } from "uuid";
 import { z as z26 } from "zod";
 var CABVariantsSection = z26.object({
   ...CABVariableFields,
   hideOutOfStockVariants: z26.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: z26.record(z26.string(), z26.string()).transform((label2) => {
+    const filled = pickBy(label2, (value) => value.trim() !== "");
+    return isEmpty(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: z26.string().optional(),
   sectionId: z26.uuid().default(() => uuidv712()),
   sectionType: z26.literal(SectionType.variants).default(SectionType.variants),
@@ -3291,6 +3312,7 @@ var subscriptionToggle = (productType, labels = {}) => {
       buttonStyle: "plain",
       /** A `subscription` widget offers no one-time purchase; suppress the downgrade so the buyer can't switch to one-time. */
       ...productType === "subscription" && { disableDowngrade: true },
+      ...labels.frequencyLabel && { frequencyLabel: labels.frequencyLabel },
       sections: [
         slot("subscriptionOption", void 0),
         slot("switchToOneTimePurchase", labels.oneTime),
@@ -4215,13 +4237,16 @@ var convertPayButtonBlock = (raw, report) => {
 };
 
 // src/transforms/postPurchase/productCardControls.ts
-var groupSelector = { sectionType: "variants", selector: "menu", variantMode: "productGroup" };
+var SELECT_VARIANT = { en: "Select Variant" };
+var PRODUCT_GROUP = { en: "Option" };
+var groupSelector = { label: PRODUCT_GROUP, sectionType: "variants", selector: "menu", variantMode: "productGroup" };
 var variantSelector = ({ productOptions }) => {
   if (!productOptions.showVariantSelectors) return [];
   const single = productOptions.variantSelectorDisplayMode === "single";
   return [
     {
       hideOutOfStockVariants: single || productOptions.hideOutOfStockVariants,
+      ...single && { label: SELECT_VARIANT },
       sectionType: "variants",
       selector: "menu",
       variantMode: single ? "single" : "multiple"
@@ -4236,7 +4261,7 @@ var quantity = ({ language: language3, quantityInputs: quantityInputs2 }) => qua
   })
 ] : [];
 var productCardControls = (settings) => [
-  ...subscriptionToggle(settings.productType),
+  ...subscriptionToggle(settings.productType, { frequencyLabel: "planName" }),
   groupSelector,
   ...variantSelector(settings),
   ...quantity(settings)
@@ -5533,6 +5558,25 @@ var disclaimerSections = (offer) => {
     }
   ];
 };
+var pagingDot = (buttonField, opacity) => ({
+  buttonField,
+  sectionType: SectionType.image,
+  source: `data:image/svg+xml,${encodeURIComponent(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><circle cx="4" cy="4" r="4" fill="#808080" fill-opacity="${opacity}"/></svg>`
+  )}`
+});
+var pagingDots = () => ({
+  alignment: { horizontal: HorizontalAlignment.center, vertical: VerticalAlignment.top },
+  sections: [
+    {
+      action: ButtonAction.showPagination,
+      buttonStyle: ButtonStyle.plain,
+      sections: [pagingDot(ButtonField.activePage, 1), pagingDot(ButtonField.inactivePage, 0.35)],
+      sectionType: SectionType.button
+    }
+  ],
+  sectionType: SectionType.layout
+});
 var composeOfferCard = (offer, input, storeName) => {
   const copy = {
     sections: [headlineText(offer.headline), smallText(offer.description)],
@@ -5589,6 +5633,7 @@ var composeOfferCard = (offer, input, storeName) => {
           sectionType: SectionType.layout
         },
         ...disclaimerSections(offer),
+        pagingDots(),
         /**
          * Ad-unit Privacy Policy footer (compliance). Its own end-aligned layout packs a fit-content
          * paragraph right; the paragraph's own `textAlign: end` covers the full-width case — together

package/dist/transforms/index.cjs

@@ -757,6 +757,13 @@ var CABButtonSection = import_zod7.z.object({
     width: 300
   }),
   disableDowngrade: import_zod7.z.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: import_zod7.z.enum(["planName", "template"]).optional().catch(void 0),
   name: import_zod7.z.string().optional(),
   optionId: import_zod7.z.number().optional(),
   popover: import_zod7.z.object({
@@ -1449,6 +1456,20 @@ var import_zod20 = require("zod");
 var CABVariantsSection = import_zod20.z.object({
   ...CABVariableFields,
   hideOutOfStockVariants: import_zod20.z.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: import_zod20.z.record(import_zod20.z.string(), import_zod20.z.string()).transform((label) => {
+    const filled = (0, import_compat3.pickBy)(label, (value) => value.trim() !== "");
+    return (0, import_compat3.isEmpty)(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: import_zod20.z.string().optional(),
   sectionId: import_zod20.z.uuid().default(() => (0, import_uuid12.v7)()),
   sectionType: import_zod20.z.literal(SectionType.variants).default(SectionType.variants),
@@ -3159,6 +3180,7 @@ var subscriptionToggle = (productType, labels = {}) => {
       buttonStyle: "plain",
       /** A `subscription` widget offers no one-time purchase; suppress the downgrade so the buyer can't switch to one-time. */
       ...productType === "subscription" && { disableDowngrade: true },
+      ...labels.frequencyLabel && { frequencyLabel: labels.frequencyLabel },
       sections: [
         slot("subscriptionOption", void 0),
         slot("switchToOneTimePurchase", labels.oneTime),
@@ -4091,13 +4113,16 @@ var convertPayButtonBlock = (raw, report) => {
 };
 
 // src/transforms/postPurchase/productCardControls.ts
-var groupSelector = { sectionType: "variants", selector: "menu", variantMode: "productGroup" };
+var SELECT_VARIANT = { en: "Select Variant" };
+var PRODUCT_GROUP = { en: "Option" };
+var groupSelector = { label: PRODUCT_GROUP, sectionType: "variants", selector: "menu", variantMode: "productGroup" };
 var variantSelector = ({ productOptions }) => {
   if (!productOptions.showVariantSelectors) return [];
   const single = productOptions.variantSelectorDisplayMode === "single";
   return [
     {
       hideOutOfStockVariants: single || productOptions.hideOutOfStockVariants,
+      ...single && { label: SELECT_VARIANT },
       sectionType: "variants",
       selector: "menu",
       variantMode: single ? "single" : "multiple"
@@ -4112,7 +4137,7 @@ var quantity = ({ language, quantityInputs: quantityInputs2 }) => quantityInputs
   })
 ] : [];
 var productCardControls = (settings) => [
-  ...subscriptionToggle(settings.productType),
+  ...subscriptionToggle(settings.productType, { frequencyLabel: "planName" }),
   groupSelector,
   ...variantSelector(settings),
   ...quantity(settings)

package/dist/transforms/index.mjs

@@ -696,6 +696,13 @@ var CABButtonSection = z7.object({
     width: 300
   }),
   disableDowngrade: z7.boolean().default(false),
+  /**
+   * What labels a `switchToSubscription` button's frequency options. `planName` shows the selling plan's
+   * own name (legacy post-purchase, L115) and falls back to the `subscriptionOption` template for a plan
+   * without one; absent or `template` is the template alone (the checkout card). Optional and additive
+   * (REB-24846); an unknown value reads as absent.
+   */
+  frequencyLabel: z7.enum(["planName", "template"]).optional().catch(void 0),
   name: z7.string().optional(),
   optionId: z7.number().optional(),
   popover: z7.object({
@@ -1382,12 +1389,26 @@ var CABSeparatorSection = z19.object({
 });
 
 // src/schema/widgets/checkout-and-beyond/variants.ts
-import { slice } from "es-toolkit/compat";
+import { isEmpty, pickBy, slice } from "es-toolkit/compat";
 import { v7 as uuidv712 } from "uuid";
 import { z as z20 } from "zod";
 var CABVariantsSection = z20.object({
   ...CABVariableFields,
   hideOutOfStockVariants: z20.boolean().default(false),
+  /**
+   * The menu's own label per buyer locale (`selectLanguage`), for the whole-variant (`single`) and the
+   * product-group menus; `multiple` labels each option's menu by its name. Optional and additive
+   * (REB-24846): absent, a renderer keeps its own label; the post-purchase converter sets legacy's
+   * "Select Variant" and "Option" (L93, L97). A malformed label drops only itself.
+   *
+   * A blank (or whitespace-only) entry is dropped per locale, so that buyer falls back to `en` instead of
+   * `selectLanguage` returning `''` — which a renderer's `??` fallback would show as an empty menu label.
+   * A label left with no entries reads as absent.
+   */
+  label: z20.record(z20.string(), z20.string()).transform((label) => {
+    const filled = pickBy(label, (value) => value.trim() !== "");
+    return isEmpty(filled) ? void 0 : filled;
+  }).optional().catch(void 0),
   name: z20.string().optional(),
   sectionId: z20.uuid().default(() => uuidv712()),
   sectionType: z20.literal(SectionType.variants).default(SectionType.variants),
@@ -3098,6 +3119,7 @@ var subscriptionToggle = (productType, labels = {}) => {
       buttonStyle: "plain",
       /** A `subscription` widget offers no one-time purchase; suppress the downgrade so the buyer can't switch to one-time. */
       ...productType === "subscription" && { disableDowngrade: true },
+      ...labels.frequencyLabel && { frequencyLabel: labels.frequencyLabel },
       sections: [
         slot("subscriptionOption", void 0),
         slot("switchToOneTimePurchase", labels.oneTime),
@@ -4030,13 +4052,16 @@ var convertPayButtonBlock = (raw, report) => {
 };
 
 // src/transforms/postPurchase/productCardControls.ts
-var groupSelector = { sectionType: "variants", selector: "menu", variantMode: "productGroup" };
+var SELECT_VARIANT = { en: "Select Variant" };
+var PRODUCT_GROUP = { en: "Option" };
+var groupSelector = { label: PRODUCT_GROUP, sectionType: "variants", selector: "menu", variantMode: "productGroup" };
 var variantSelector = ({ productOptions }) => {
   if (!productOptions.showVariantSelectors) return [];
   const single = productOptions.variantSelectorDisplayMode === "single";
   return [
     {
       hideOutOfStockVariants: single || productOptions.hideOutOfStockVariants,
+      ...single && { label: SELECT_VARIANT },
       sectionType: "variants",
       selector: "menu",
       variantMode: single ? "single" : "multiple"
@@ -4051,7 +4076,7 @@ var quantity = ({ language, quantityInputs: quantityInputs2 }) => quantityInputs
   })
 ] : [];
 var productCardControls = (settings) => [
-  ...subscriptionToggle(settings.productType),
+  ...subscriptionToggle(settings.productType, { frequencyLabel: "planName" }),
   groupSelector,
   ...variantSelector(settings),
   ...quantity(settings)

package/dist/transforms/postPurchase/productCardControls.d.ts

@@ -1,7 +1,7 @@
 import { type ProductCardSettings } from '../../transforms/postPurchase/productCardSettings';
 /**
  * The card's controls in legacy `ProductOffer` order: purchase mode, product group, variants, quantity.
- * The purchase mode is the checkout card's `switchToSubscription` button as-is (its default labels, and
- * `disableDowngrade` for a subscription-only widget).
+ * The purchase mode is the checkout card's `switchToSubscription` button (its default labels, and
+ * `disableDowngrade` for a subscription-only widget), its frequencies labelled by plan name (L115).
  */
 export declare const productCardControls: (settings: ProductCardSettings) => Record<string, unknown>[];

package/dist/transforms/productCard/subscriptionToggle.d.ts

@@ -1,4 +1,7 @@
+import { type CABButtonSection } from '../../schema/widgets/checkout-and-beyond/button';
 export type SubscriptionToggleLabels = {
+    /** What labels the frequency options; only the post-purchase card sets it (`planName`, L115). */
+    frequencyLabel?: CABButtonSection['frequencyLabel'];
     /** The switch-to-one-time label override. */
     oneTime?: string;
     /** The ONE upsell label legacy had; it fills both upsell slots. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rebuy/rebuy",
-    "version": "3.45.0",
+    "version": "3.47.0",
     "description": "Shared zod schemas, legacy-to-CAB widget transforms, and server orchestrators for Rebuy's Shopify consumers (rebuy-api, admin-nextjs, rebuy-shopify-extensions)",
     "license": "MIT",
     "author": "Rebuy, Inc.",