@useinsider/guido 3.16.0 → 3.17.0-beta.58179dc

package/dist/extensions/Blocks/Recommendation/templates/utils.js

@@ -1,8 +1,9 @@
-import { ATTR_PRODUCT_PRICE as l, ATTR_PRODUCT_OLD_PRICE as a, ATTR_CUSTOM_PREFIX as T, ATTR_PRODUCT_IMAGE as m, ATTR_PRODUCT_NAME as C, ATTR_PRODUCT_OMNIBUS_PRICE as _, ATTR_PRODUCT_OMNIBUS_DISCOUNT as p, ATTR_PRODUCT_BUTTON as y, PRODUCT_ATTRIBUTE_PREFIX as I } from "../constants/selectors.js";
+import { ATTR_PRODUCT_PRICE as l, ATTR_PRODUCT_OLD_PRICE as a, ATTR_CUSTOM_PREFIX as T, ATTR_PRODUCT_IMAGE as b, ATTR_PRODUCT_NAME as _, ATTR_PRODUCT_OMNIBUS_PRICE as C, ATTR_PRODUCT_OMNIBUS_DISCOUNT as A, ATTR_PRODUCT_BUTTON as p, PRODUCT_ATTRIBUTE_PREFIX as I } from "../constants/selectors.js";
 import { useRecommendationExtensionStore as L } from "../store/recommendation.js";
-import { compositionKeyToProductAttr as A, isDefaultProductAttr as b, bareAttributeName as S, findFilterByBareName as $, productAttrToCompositionKey as h } from "../utils/compositionKeys.js";
+import { compositionKeyToProductAttr as y, isDefaultProductAttr as f, bareAttributeName as S, findFilterByBareName as $, productAttrToCompositionKey as P } from "../utils/compositionKeys.js";
 import { formatPrice as B } from "../utils/priceFormatter.js";
-function k() {
+import { buildTitleRows as k } from "./titleRows.js";
+function x() {
   const t = L(), { currencySettings: e } = t.recommendationConfigs;
   return {
     code: e.value,
@@ -13,17 +14,17 @@ function k() {
     thousandSeparator: e.thousandSeparator
   };
 }
-function f(t, e = "price") {
-  const o = k(), n = t[e], c = (n == null ? void 0 : n[o.code]) ?? Object.values(n ?? {})[0] ?? 0;
+function m(t, e = "price") {
+  const o = x(), n = t[e], c = (n == null ? void 0 : n[o.code]) ?? Object.values(n ?? {})[0] ?? 0;
   return B({
     price: c,
     currency: o
   });
 }
 function q(t) {
-  return f(t, "price") === f(t, "original_price");
+  return m(t, "price") === m(t, "original_price");
 }
-function x(t) {
+function N(t) {
   return t.replace(/_/g, " ").replace(/\b\w/g, (e) => e.toUpperCase());
 }
 function J(t) {
@@ -34,115 +35,114 @@ function J(t) {
     skip: n ? l : a
   };
 }
-function N(t) {
+function F(t) {
   const e = Array.isArray(t) ? t[t.length - 1] : t;
   if (typeof e == "string")
     return e;
   if (typeof e == "number")
     return String(e);
 }
-function w(t, e) {
+function v(t, e) {
   var o;
   return ((o = $(t, e)) == null ? void 0 : o.type) === "defaultAttribute";
 }
-function F(t, e) {
-  return w(t, e) ? t : `${I}${t}`;
+function w(t, e) {
+  return v(t, e) ? t : `${I}${t}`;
 }
 function Q(t) {
-  return h(t);
+  return P(t);
 }
-const v = Symbol("customCellHtml");
+const M = Symbol("customCellHtml");
 function Z(t, e, o = {}) {
-  const n = t[v];
+  const n = t[M];
   if (!n)
     return { ...t };
   const c = { ...t };
-  return e.filter((s) => s.startsWith(T) && !c[s]).forEach((s) => {
-    const i = A(s), r = b(i) ? F(i, o) : i, u = S(r), R = x(u), D = b(r);
-    c[s] = (d, U) => {
+  return e.filter((i) => i.startsWith(T) && !c[i]).forEach((i) => {
+    const s = y(i), r = f(s) ? w(s, o) : s, u = S(r), h = N(u), D = f(r);
+    c[i] = (d, U) => {
       var g;
-      const E = D ? d[u] : (g = d.product_attributes) == null ? void 0 : g[u], O = N(E) ?? R;
-      return n(r, O, U);
+      const O = D ? d[u] : (g = d.product_attributes) == null ? void 0 : g[u], E = F(O) ?? h;
+      return n(r, E, U);
     };
   }), c;
 }
 function tt(t, e, o = []) {
-  const n = t.startsWith(T) ? h(S(A(t))) : t, s = n !== t && !o.includes(n) ? n : t, i = (r) => (r == null ? void 0 : r[t]) ?? (r == null ? void 0 : r[s]);
+  const n = t.startsWith(T) ? P(S(y(t))) : t, i = n !== t && !o.includes(n) ? n : t, s = (r) => (r == null ? void 0 : r[t]) ?? (r == null ? void 0 : r[i]);
   return {
     cellPadding: e.cellPadding,
     cardBackgroundColor: e.cardBackgroundColor,
-    cellBackgroundColor: i(e.cellBackgroundColors),
-    cellAlignment: i(e.cellAlignments),
-    cellClasses: i(e.cellClasses),
-    omnibusText: i(e.omnibusTexts),
-    styleTemplate: i(e.styleTemplates)
+    cellBackgroundColor: s(e.cellBackgroundColors),
+    cellAlignment: s(e.cellAlignments),
+    cellClasses: s(e.cellClasses),
+    omnibusText: s(e.omnibusTexts),
+    styleTemplate: s(e.styleTemplates)
   };
 }
 const et = {
   TITLE: "You May Also Like!"
 }, ot = [
-  m,
-  C,
+  b,
+  _,
   a,
   l,
-  _,
-  p,
-  y
+  C,
+  A,
+  p
 ], nt = {
-  [m]: !0,
-  [C]: !0,
+  [b]: !0,
+  [_]: !0,
   [l]: !0,
   [a]: !0,
-  [_]: !1,
-  [p]: !1,
-  [y]: !0
-}, M = 10;
-function W(t = M) {
+  [C]: !1,
+  [A]: !1,
+  [p]: !0
+}, W = 10;
+function rt(t = W) {
   return `
     <tr>
         <td class="spacer" style="height: ${t}px;"></td>
     </tr>
 `;
 }
-const H = W();
-function V(t, e) {
+function H(t, e) {
   return e ? e.pStyle ?? "" : t;
 }
-function rt(t, e, o) {
-  const n = V(e.pStyle, o), c = o ? o.openTags ?? "" : e.openTags, s = o ? o.closeTags ?? "" : e.closeTags;
-  return `<p contenteditable="false" style="${n}">${c}${t}${s}</p>`;
+function it(t, e, o) {
+  const n = H(e.pStyle, o), c = o ? o.openTags ?? "" : e.openTags, i = o ? o.closeTags ?? "" : e.closeTags;
+  return `<p contenteditable="false" style="${n}">${c}${t}${i}</p>`;
 }
 function st(t, e) {
   const o = [];
   return t && o.push(t), e && o.push(`background-color: ${e};`), o.join(" ");
 }
-function Y(t) {
+function V(t) {
   return t ? ` background-color: ${t};` : "";
 }
-function it(t) {
-  const e = Y(t);
+function ct(t) {
+  const e = V(t);
   return e ? ` style="${e.trim()}"` : "";
 }
-function ct(t, e = "") {
+function lt(t, e = "") {
   return {
     before: (t == null ? void 0 : t.before) ?? e,
     after: (t == null ? void 0 : t.after) ?? ""
   };
 }
-function lt(t, e) {
+function at(t, e) {
   return `${(e == null ? void 0 : e.openTags) ?? ""}${t}${(e == null ? void 0 : e.closeTags) ?? ""}`;
 }
-function at(t) {
+function ut(t) {
   return t != null && t.buttonFitToContainer ? "es-button-border es-fw" : "es-button-border";
 }
-const ut = "display: block; max-width: 100%; height: auto;", dt = "border-width: 1px; background: rgb(217, 234, 211); border-color: rgb(106, 168, 79);", gt = "color: rgb(56, 118, 29); background: rgb(217, 234, 211); font-family: arial, 'helvetica neue', helvetica, sans-serif; font-size: 16px; font-weight: normal; line-height: 120%; mso-border-alt: 10px solid rgb(217, 234, 211); mso-padding-alt: 0;", P = "https://email-static.useinsider.com/stripo/modules/email-recommendation-v3/assets/images/image-placeholder.png";
-function bt(t) {
-  return !t || typeof t != "string" || t.trim() === "" ? P : t.startsWith("http://") ? t.replace("http://", "https://") : t;
+const dt = "display: block; max-width: 100%; height: auto;", gt = "border-width: 1px; background: rgb(217, 234, 211); border-color: rgb(106, 168, 79);", ft = "color: rgb(56, 118, 29); background: rgb(217, 234, 211); font-family: arial, 'helvetica neue', helvetica, sans-serif; font-size: 16px; font-weight: normal; line-height: 120%; mso-border-alt: 10px solid rgb(217, 234, 211); mso-padding-alt: 0;", R = "https://email-static.useinsider.com/stripo/modules/email-recommendation-v3/assets/images/image-placeholder.png";
+function mt(t) {
+  return !t || typeof t != "string" || t.trim() === "" ? R : t.startsWith("http://") ? t.replace("http://", "https://") : t;
 }
-function G(t) {
+function Y(t) {
   return {
     name: "Product Name",
-    image_url: P,
+    image_url: R,
     price: { USD: 18 },
     original_price: { USD: 20 },
     discount: { USD: 2 },
@@ -154,19 +154,20 @@ function G(t) {
     category: []
   };
 }
-function ft(t = 6) {
+function Tt(t = 6) {
   return Array.from(
     { length: t },
-    (e, o) => G(String(o + 1))
+    (e, o) => Y(String(o + 1))
   );
 }
-function Tt(t = "grid", e) {
+function bt(t = "grid", e) {
   const o = t === "list" ? `
-        data-layout="list"` : "", n = e ? ` ${e}` : "";
+        data-layout="list"` : "", n = e ? ` ${e}` : "", i = `recommendation-block-v2 esd-block-recommendation-v3-block es-p20${t === "list" ? " es-m-p0 ins-recommendation-list-layout" : ""}${n}`, s = t === "list" ? "" : `
+                                        {-{-MOBILE_PRODUCT_ROWS-}-}`, r = t === "list" ? ' style="display: none;"' : "";
   return `
     <td
         align="left"
-        class="${`recommendation-block-v2 esd-block-recommendation-v3-block es-p20${t === "list" ? " es-m-p0 ins-recommendation-list-layout" : ""}${n}`}"${o}>
+        class="${i}"${o}>
         <table width="100%" cellpadding="0" cellspacing="0" border="0">
             <tr>
                 <td align="center">
@@ -177,28 +178,7 @@ function Tt(t = "grid", e) {
                         cellspacing="0"
                         border="0">
                         <tbody>
-                            <tr>
-                                <td>
-                                    <table
-                                        width="100%"
-                                        cellpadding="0"
-                                        cellspacing="0"
-                                        border="0">
-                                        <tbody>
-                                            <tr>
-                                                <td
-                                                    class="esd-block-text es-p10t es-p10b es-p20l es-p20r"
-                                                    align="center">
-                                                    <p style="font-size: 28px; color: #333333;">
-                                                        <strong>{-{-TITLE-}-}</strong>
-                                                    </p>
-                                                </td>
-                                            </tr>
-                                        </tbody>
-                                    </table>
-                                </td>
-                            </tr>
-                            ${H}
+                            ${k()}
                             <tr>
                                 <td>
                                     <table
@@ -213,7 +193,7 @@ function Tt(t = "grid", e) {
                                     </table>
                                 </td>
                             </tr>
-                            <tr class="ins-recommendation-mobile-row"${t === "list" ? ' style="display: none;"' : ""}>
+                            <tr class="ins-recommendation-mobile-row"${r}>
                                 <td>
                                     <table
                                         class="ins-recommendation-product-container
@@ -223,8 +203,7 @@ function Tt(t = "grid", e) {
                                         cellspacing="0"
                                         border="0"
                                         style="display: none;"
-                                    >${t === "list" ? "" : `
-                                        {-{-MOBILE_PRODUCT_ROWS-}-}`}
+                                    >${s}
                                     </table>
                                 </td>
                             </tr>
@@ -237,37 +216,36 @@ function Tt(t = "grid", e) {
 `;
 }
 export {
-  v as CUSTOM_CELL_HTML,
+  M as CUSTOM_CELL_HTML,
   et as DEFAULTS,
-  gt as DEFAULT_BUTTON_ANCHOR_STYLE,
-  dt as DEFAULT_BUTTON_BORDER_STYLE,
+  ft as DEFAULT_BUTTON_ANCHOR_STYLE,
+  gt as DEFAULT_BUTTON_BORDER_STYLE,
   ot as DEFAULT_CARD_COMPOSITION,
   nt as DEFAULT_CARD_VISIBILITY,
-  ut as DEFAULT_IMG_STYLE,
-  M as DEFAULT_ROW_SPACING_PX,
-  P as PLACEHOLDER_IMAGE,
-  Y as bgColorFragment,
+  dt as DEFAULT_IMG_STYLE,
+  W as DEFAULT_ROW_SPACING_PX,
+  R as PLACEHOLDER_IMAGE,
+  V as bgColorFragment,
   tt as buildCellOptions,
   Z as buildElementRenderer,
-  W as buildSpacer,
-  it as cellBgStyleAttr,
-  Tt as createBlockTemplate,
-  f as formatProductPrice,
-  k as getCurrentCurrencyConfig,
-  ft as getDefaultProducts,
-  w as isDefaultAttribute,
+  rt as buildSpacer,
+  ct as cellBgStyleAttr,
+  bt as createBlockTemplate,
+  m as formatProductPrice,
+  x as getCurrentCurrencyConfig,
+  Tt as getDefaultProducts,
+  v as isDefaultAttribute,
   q as isSamePrice,
-  lt as renderButtonLabel,
-  rt as renderStyledParagraph,
-  at as resolveButtonBorderClass,
+  at as renderButtonLabel,
+  it as renderStyledParagraph,
+  ut as resolveButtonBorderClass,
   J as resolveInlinePriceOrder,
-  ct as resolveOmnibusText,
-  V as resolvePStyle,
-  F as resolveProductAttrValue,
+  lt as resolveOmnibusText,
+  H as resolvePStyle,
+  w as resolveProductAttrValue,
   st as resolveSegmentBgStyle,
-  bt as sanitizeImageUrl,
-  H as spacer,
+  mt as sanitizeImageUrl,
   Q as toCustomCompositionKey,
-  x as toDisplayName,
-  N as toDisplayableAttributeValue
+  N as toDisplayName,
+  F as toDisplayableAttributeValue
 };

package/dist/extensions/Blocks/Recommendation/utils/legacyTitle.js

@@ -0,0 +1,20 @@
+import { CONTAINER_SELECTOR as s, CSS_CLASS_SPACER as c } from "../constants/selectors.js";
+import { getMainContainerTbody as a } from "../controls/main/utils.js";
+const l = "td.esd-block-text";
+function C(n) {
+  return "getInnerText" in n && n.getInnerText().trim().length > 0;
+}
+function T(n) {
+  return "children" in n && n.children().some((e) => "hasClass" in e && e.hasClass(c));
+}
+function h(n) {
+  const e = a(n), i = e && "children" in e ? e.children() : [], [t, o] = i, r = t == null ? void 0 : t.querySelector(l);
+  if (!(!r || r.closest(s) || !C(r)))
+    return {
+      cell: r,
+      rows: o && T(o) ? [t, o] : [t]
+    };
+}
+export {
+  h as findLegacyTitle
+};

package/dist/extensions/Blocks/Recommendation/utils/productIds.js

@@ -0,0 +1,6 @@
+function n(t) {
+  return t.map((i) => String(i ?? "").trim()).filter(Boolean).join(",");
+}
+export {
+  n as sanitizeProductIds
+};

package/dist/src/config/migrator/recommendation/extractors.d.ts

@@ -1,4 +1,12 @@
 export declare function extractTitleText(block: Element): string;
+/**
+ * Fallback for legacy configs that carry no `p_recommendation_title` variable:
+ * the rendered HTML decides. A missing or `display: none` title container means
+ * the user never saw a title, so the migrated block keeps it toggled off.
+ * @param block - The legacy recommendation block element
+ * @returns True when the legacy block renders a visible title
+ */
+export declare function hasVisibleTitle(block: Element): boolean;
 /**
  * Card background lives on either the block (`bgcolor`/`style`) or per-card
  * cells (`.product-card`). Returns empty string when no background is set —

package/dist/src/config/migrator/recommendationTitleMigrator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Only reaches a template Stripo has no stored copy of — an already-saved campaign
+ * opens from Stripo storage and is tagged by `RecommendationBlock._healLegacyTitle`.
+ */
+export declare function migrateRecommendationTitle(html: string): string;

package/dist/src/extensions/Blocks/Recommendation/block.d.ts

@@ -48,6 +48,21 @@ export declare class RecommendationBlock extends Block {
      * @param node - The block node that may need migration
      */
     onDocumentChanged(node: ImmutableHtmlNode): void;
+    /**
+     * Adopts the plain text cell a pre-SD-147795 block used as its title.
+     *
+     * `recommendationTitleMigrator` tags that cell before the document is handed
+     * to Stripo, but Stripo serves a template it already holds in its own storage
+     * (`forceRecreate: false`) and drops the HTML we pass, so for an already-saved
+     * campaign the tagging only ever lands here. Without it the title is an
+     * ordinary text block: Card Composition reads the toggle as off while the
+     * title is on screen, switching it on prepends a second title, and the cell
+     * keeps the generic delete/duplicate node actions the CSS hides by class.
+     *
+     * Partner-managed blocks are left alone, the same exclusion the migrator makes.
+     * @param node - The block node that may still carry an untagged title
+     */
+    private _healLegacyTitle;
     /**
      * Called when a block is deleted from the template
      *

package/dist/src/extensions/Blocks/Recommendation/constants/blockIds.d.ts

@@ -10,5 +10,6 @@ export declare enum RecommendationBlockId {
     OMNIBUS_PRICE = "recommendation-block-omnibus-price",
     OMNIBUS_DISCOUNT = "recommendation-block-omnibus-discount",
     IMAGE = "recommendation-block-image",
-    CUSTOM_ATTRIBUTE = "recommendation-block-custom-attribute"
+    CUSTOM_ATTRIBUTE = "recommendation-block-custom-attribute",
+    TITLE = "recommendation-block-title"
 }

package/dist/src/extensions/Blocks/Recommendation/constants/controlIds.d.ts

@@ -65,5 +65,12 @@ export declare enum RecommendationControlId {
     CUSTOM_ATTR_SIZE = "recommendation-block-custom-attr-size-control",
     CUSTOM_ATTR_STYLE = "recommendation-block-custom-attr-style-control",
     CUSTOM_ATTR_TEXT_TRIM = "recommendation-block-custom-attr-text-trim-control",
+    TITLE_ALIGN = "recommendation-block-title-align-control",
+    TITLE_BACKGROUND = "recommendation-block-title-background-control",
+    TITLE_COLOR = "recommendation-block-title-color-control",
+    TITLE_FONT_FAMILY = "recommendation-block-title-font-family-control",
+    TITLE_PADDINGS = "recommendation-block-title-paddings-control",
+    TITLE_SIZE = "recommendation-block-title-size-control",
+    TITLE_STYLE = "recommendation-block-title-style-control",
     SYNC_INFO_MESSAGE = "recommendation-block-sync-info-message"
 }

package/dist/src/extensions/Blocks/Recommendation/constants/defaultConfig.d.ts

@@ -32,6 +32,7 @@ export declare const DEFAULT_COMPOSITION: string[];
 /**
  * Default visibility settings for card elements
  * Omnibus elements are hidden by default (not all regions require them)
+ * The block-level title is visible on a fresh drop.
  */
 export declare const DEFAULT_VISIBILITY: Record<string, boolean>;
 /**

package/dist/src/extensions/Blocks/Recommendation/constants/index.d.ts

@@ -8,6 +8,6 @@
  */
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
-export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CSS_CLASS_RECO_BUTTON, CSS_CLASS_SKIP_COMPILE, RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CARD_COMPOSITION, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, SELECTOR_ATTRIBUTE_ROW, ATTR_DATA_ATTRIBUTE_TYPE, PRODUCT_ATTRIBUTE_PREFIX, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
+export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CSS_CLASS_RECO_BUTTON, CSS_CLASS_SKIP_COMPILE, RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_RECOMMENDATION_TITLE, SELECTOR_TITLE_CELL, ATTR_CUSTOM_PREFIX, ATTR_DATA_CARD_COMPOSITION, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, CSS_CLASS_ATTRIBUTE_ROW, CSS_CLASS_SPACER, SELECTOR_ATTRIBUTE_ROW, ATTR_DATA_ATTRIBUTE_TYPE, ATTR_DATA_VISIBILITY, PRODUCT_ATTRIBUTE_PREFIX, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
 export { LAYOUT_VALUES, LAYOUT_OPTIONS, DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, DEFAULT_MOBILE_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, MAX_MOBILE_PRODUCTS_PER_ROW, MIN_MOBILE_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, DEFAULT_MOBILE_COLUMN_SPACING, DEFAULT_MOBILE_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
 export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

package/dist/src/extensions/Blocks/Recommendation/constants/selectors.d.ts

@@ -58,6 +58,10 @@ export declare const ATTR_PRODUCT_OLD_PRICE = "productOldPrice";
 export declare const ATTR_PRODUCT_OMNIBUS_PRICE = "productOmnibusPrice";
 export declare const ATTR_PRODUCT_OMNIBUS_DISCOUNT = "productOmnibusDiscount";
 export declare const ATTR_PRODUCT_BUTTON = "productButton";
+export declare const ATTR_RECOMMENDATION_TITLE = "recommendationTitle";
+export declare const CSS_CLASS_TITLE_CELL = "ins-recommendation-title";
+/** Title cell — the only `esd-block-text` living outside the product containers. */
+export declare const SELECTOR_TITLE_CELL = ".ins-recommendation-title";
 /**
  * Custom attribute constants
  * Used for dynamically added product attributes in Card Composition
@@ -70,10 +74,16 @@ export declare const ATTR_DATA_CUSTOM_ATTRIBUTES = "data-custom-attributes";
 export declare const ATTR_DATA_CARD_COMPOSITION = "data-card-composition";
 /** HTML attribute on <td> elements identifying the product attribute for compiler template variable generation */
 export declare const ATTR_PRODUCT_ATTR = "product-attr";
+/** Class every composition attribute row carries — the visibility toggle and the compiler both key on it */
+export declare const CSS_CLASS_ATTRIBUTE_ROW = "recommendation-attribute-row";
 /** Row wrapper of one composition entry inside a product card */
 export declare const SELECTOR_ATTRIBUTE_ROW = ".recommendation-attribute-row";
 /** HTML attribute on an attribute row holding its composition key */
 export declare const ATTR_DATA_ATTRIBUTE_TYPE = "data-attribute-type";
+/** HTML attribute on an attribute row holding its visibility (`1` / `0`) */
+export declare const ATTR_DATA_VISIBILITY = "data-visibility";
+/** Class on the spacer cell of the row that trails a title */
+export declare const CSS_CLASS_SPACER = "spacer";
 /** Prefix `resolveProductAttrValue` puts on custom (non-default) product attributes in `product-attr` values */
 export declare const PRODUCT_ATTRIBUTE_PREFIX = "product_attribute.";
 /**

package/dist/src/extensions/Blocks/Recommendation/controls/cardComposition/index.d.ts

@@ -33,6 +33,8 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     private _normalizeComposition;
     private _readCustomAttributesFromNode;
     private _readVisibilityFromRows;
+    private _withTitlePresence;
+    private _hasTitle;
     private _getDefaultVisibilities;
     private _extractVisibilityFromRows;
     private _parseVisibilityValue;
@@ -187,6 +189,14 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _buildCompositionHtml;
     private _applyVisibilityToBlock;
+    private _applyTitleVisibilityToBlock;
+    private _resolveTitleInjection;
+    private _findTitleRows;
+    private _findTitleRowsByClass;
+    private _isSpacerRow;
+    private _findTitleContainerBody;
+    private _readInnerHtml;
+    private _defaultTitleParagraph;
     /**
      * Finds the composition array index for the Nth custom attribute (0-based).
      * Scans left-to-right, counting only entries with the custom prefix.

package/dist/src/extensions/Blocks/Recommendation/controls/index.d.ts

@@ -11,6 +11,7 @@
  */
 export { RecommendationBlockControl, CONTROL_BLOCK_ID, AlgorithmControl, ALGORITHM_CONTROL_ID, LocaleControl, LOCALE_CONTROL_ID, CurrencyControl, CURRENCY_CONTROL_ID, ProductCountControl, PRODUCT_COUNT_CONTROL_ID, ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID, FiltersControl, FILTERS_CONTROL_ID, ShuffleControl, SHUFFLE_CONTROL_ID, LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID, PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID, } from './main';
 export * from './main/utils';
+export { TitleControls } from './title';
 export { NameControls } from './name';
 export { PriceControls } from './price';
 export { OldPriceControls } from './oldPrice';

package/dist/src/extensions/Blocks/Recommendation/controls/main/utils.d.ts

@@ -70,6 +70,7 @@ export interface RegenerateProductRowsOptions {
     /** Optional: pass composition directly to avoid stale DOM reads after setAttribute */
     composition?: string[];
 }
+export declare function getMainContainerTbody(currentNode: ImmutableHtmlNode): ImmutableHtmlNode | null;
 /**
  * Regenerates only the mobile product container rows and commits in a single apply().
  * Standalone entry point for callers that change mobile-only settings

package/dist/src/extensions/Blocks/Recommendation/controls/title/index.d.ts

@@ -0,0 +1,86 @@
+export declare const TitleControls: {
+    readonly align: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+    readonly color: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+    readonly size: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+    readonly style: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+    readonly fontFamily: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+    readonly background: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getAdditionalModifications(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+    readonly paddings: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+            getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+            getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+            isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+        };
+    };
+};

package/dist/src/extensions/Blocks/Recommendation/templates/titleRows.d.ts

@@ -0,0 +1,13 @@
+export declare const DEFAULT_TITLE_TEXT = "You May Also Like!";
+export declare const DEFAULT_TITLE_PARAGRAPH: string;
+/**
+ * Builds the two block-level title rows: the title itself and the spacer below it.
+ * Both carry the same `recommendation-attribute-row` tagging a card attribute row has,
+ * so the Card Composition toggle hides the pair together and the compiler's
+ * `[data-visibility="0"]` sweep drops both — no leading gap when the title is off.
+ * @param paragraphHtml - Full `<p>` markup rendered inside the title cell
+ * @param visible - Whether the title starts visible
+ * @param spacerHeightPx - Height of the spacer row below the title
+ * @returns HTML string with the title row followed by its spacer row
+ */
+export declare function buildTitleRows(paragraphHtml?: string, visible?: boolean, spacerHeightPx?: number): string;

package/dist/src/extensions/Blocks/Recommendation/utils/legacyTitle.d.ts

@@ -0,0 +1,20 @@
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+export interface LegacyTitle {
+    /** The untagged title cell. */
+    cell: ImmutableHtmlNode;
+    /** Its wrapper row, plus the spacer row below it when there is one. */
+    rows: ImmutableHtmlNode[];
+}
+/**
+ * Finds the untagged title a pre-SD-147795 block still carries: a non-empty
+ * `esd-block-text` cell that sits outside the product containers and wraps the
+ * container's first row.
+ *
+ * This is `recommendationTitleMigrator`'s rule applied to the live document.
+ * The migrator alone cannot reach a saved campaign: Stripo serves a template it
+ * already holds in its own storage (`forceRecreate: false`) and drops the HTML
+ * the pre-load migration hands it, so the tagging has to be applied here too.
+ * @param block - The `.recommendation-block-v2` node
+ * @returns The legacy title, or `undefined` when the block has none
+ */
+export declare function findLegacyTitle(block: ImmutableHtmlNode): LegacyTitle | undefined;