@useinsider/guido 3.8.0 → 3.8.1-beta.0fbf78a

package/dist/extensions/Blocks/controlFactories.js

@@ -1,250 +1,276 @@
-import { TextAlignBuiltInControl as s, TextColorBuiltInControl as l, TextSizeBuiltInControl as u, TextStyleBuiltInControl as i, TextFontFamilyBuiltInControl as c, ButtonBackgroundColorBuiltInControl as d, TextPaddingsBuiltInControl as a, ImageSizeBuiltInControl as g, ImageMarginsBuiltInControl as x, ButtonAlignBuiltInControl as C, ButtonBorderBuiltInControl as f, ButtonBorderRadiusBuiltInControl as B, ButtonColorBuiltInControl as T, ButtonFontFamilyBuiltInControl as I, ButtonMarginsBuiltInControl as y, ButtonPaddingsBuiltInControl as m, ButtonTextBuiltInControl as A, ButtonTextSizeBuiltInControl as S, ButtonTextStyleAndFontColorBuiltInControl as N, ButtonFitToContainerBuiltInControl as b, TextLineSpacingBuiltInControl as q } from "../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
-function k(o, n, r) {
-  return class extends s {
+import { TextAlignBuiltInControl as a, TextColorBuiltInControl as g, TextSizeBuiltInControl as x, TextStyleBuiltInControl as f, TextFontFamilyBuiltInControl as C, ButtonBackgroundColorBuiltInControl as T, TextPaddingsBuiltInControl as B, ImageSizeBuiltInControl as I, ImageMarginsBuiltInControl as y, ButtonAlignBuiltInControl as m, ButtonBorderBuiltInControl as S, ButtonBorderRadiusBuiltInControl as A, ButtonColorBuiltInControl as b, ButtonFontFamilyBuiltInControl as N, ButtonMarginsBuiltInControl as q, ButtonPaddingsBuiltInControl as $, ButtonTextBuiltInControl as k, ButtonTextSizeBuiltInControl as p, ButtonTextStyleAndFontColorBuiltInControl as F, ButtonFitToContainerBuiltInControl as h, TextLineSpacingBuiltInControl as M } from "../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
+const z = "buttonTextStyleForm";
+function P(o, n, r) {
+  return class extends a {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function p(o, n, r) {
-  return class extends l {
+function _(o, n, r) {
+  return class extends g {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function F(o, n, r) {
-  return class extends u {
+function v(o, n, r) {
+  return class extends x {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function z(o, n, r) {
-  return class extends i {
+function L(o, n, r) {
+  return class extends f {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function M(o, n, r) {
-  return class extends c {
+function R(o, n, r) {
+  return class extends C {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function P(o, n, r) {
-  return class extends d {
+function O(o, n, r) {
+  return class extends T {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function h(o, n, r) {
-  return class extends a {
+function Y(o, n, r) {
+  return class extends B {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       if (!n || !r)
-        return [t];
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        return [e];
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function L(o, n, r) {
-  return class extends q {
+function w(o, n, r) {
+  return class extends M {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      return [t];
+    getTargetNodes(e) {
+      return [e];
     }
   };
 }
-function R(o, n, r = ".ins-recommendation-product-container") {
-  return class extends C {
+function D(o, n, r = ".ins-recommendation-product-container") {
+  return class extends m {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function j(o, n, r = ".ins-recommendation-product-container") {
-  return class extends T {
+function H(o, n, r = ".ins-recommendation-product-container") {
+  return class extends b {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function v(o, n, r = ".ins-recommendation-product-container") {
-  return class extends f {
+function K(o, n, r = ".ins-recommendation-product-container") {
+  return class extends S {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function w(o, n, r = ".ins-recommendation-product-container") {
-  return class extends B {
+function U(o, n, r = ".ins-recommendation-product-container") {
+  return class extends A {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function D(o, n, r = ".ins-recommendation-product-container") {
-  return class extends I {
+function V(o, n, r = ".ins-recommendation-product-container") {
+  return class extends N {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function E(o, n, r = ".ins-recommendation-product-container") {
-  return class extends y {
+function W(o, n, r = ".ins-recommendation-product-container") {
+  return class extends q {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function G(o, n, r = ".ins-recommendation-product-container") {
-  return class extends m {
+function X(o, n, r = ".ins-recommendation-product-container") {
+  return class extends $ {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function H(o, n, r = ".ins-recommendation-product-container") {
-  return class extends A {
+function j(o, n, r = ".ins-recommendation-product-container") {
+  return class extends k {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function J(o, n, r = ".ins-recommendation-product-container") {
-  return class extends S {
+function G(o, n, r = ".ins-recommendation-product-container") {
+  return class extends p {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function K(o, n, r) {
-  return class extends N {
+function J(o, n, r) {
+  return class extends F {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    }
+    /**
+     * Propagates Bold/Italic to ALL product buttons, not just the focused one.
+     *
+     * Stripo's built-in applies font-color/size to every target node but writes
+     * the text-style (font-weight/font-style) only to the selected button. Bold/italic
+     * are plain inline CSS on the `<a class="es-button">` (no tags), so we mirror them
+     * onto every button's anchor. The toggle state comes from the control's form
+     * (`buttonTextStyleForm.{bold,italic}`) because the patched node isn't updated yet
+     * when this runs. Returned modifications are merged into the parent control's patch.
+     */
+    getAdditionalModifications(e) {
+      const t = e.closest(r);
+      if (!t)
+        return;
+      const i = t.querySelectorAll(`[esd-extension-block-id="${n}"] a.es-button`);
+      if (!i.length)
+        return;
+      const s = this.api.getValues()[z];
+      if (!s)
+        return;
+      const u = s.bold ? "bold" : "normal", c = s.italic ? "italic" : "normal", l = this.api.getDocumentModifier();
+      return i.forEach((d) => {
+        l.modifyHtml(d).setStyle("font-weight", u).setStyle("font-style", c);
+      }), l;
     }
   };
 }
-function O(o, n, r) {
-  return class extends b {
+function Q(o, n, r) {
+  return class extends h {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
-      const e = t.closest(r);
-      return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+    getTargetNodes(e) {
+      const t = e.closest(r);
+      return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
   };
 }
-function Q(o, n, r) {
-  return class extends g {
+function Z(o, n, r) {
+  return class extends I {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       try {
-        const e = t.closest(r);
-        return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        const t = e.closest(r);
+        return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
       } catch {
         return [];
       }
     }
   };
 }
-function U(o, n, r) {
-  return class extends x {
+function tt(o, n, r) {
+  return class extends y {
     getId() {
       return o;
     }
-    getTargetNodes(t) {
+    getTargetNodes(e) {
       try {
-        const e = t.closest(r);
-        return e ? e.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
+        const t = e.closest(r);
+        return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
       } catch {
         return [];
       }
@@ -252,25 +278,25 @@ function U(o, n, r) {
   };
 }
 export {
-  R as createButtonAlignControl,
-  v as createButtonBorderControl,
-  w as createButtonBorderRadiusControl,
-  j as createButtonColorControl,
-  O as createButtonFitToContainerControl,
-  D as createButtonFontFamilyControl,
-  E as createButtonMarginsControl,
-  G as createButtonPaddingsControl,
-  H as createButtonTextControl,
-  J as createButtonTextSizeControl,
-  K as createButtonTextStyleAndFontColorControl,
-  U as createImageMarginsControl,
-  Q as createImageSizeControl,
-  h as createPaddingsControl,
-  k as createTextAlignControl,
-  P as createTextBackgroundColorControl,
-  p as createTextColorControl,
-  M as createTextFontFamilyControl,
-  L as createTextLineSpacingControl,
-  F as createTextSizeControl,
-  z as createTextStyleControl
+  D as createButtonAlignControl,
+  K as createButtonBorderControl,
+  U as createButtonBorderRadiusControl,
+  H as createButtonColorControl,
+  Q as createButtonFitToContainerControl,
+  V as createButtonFontFamilyControl,
+  W as createButtonMarginsControl,
+  X as createButtonPaddingsControl,
+  j as createButtonTextControl,
+  G as createButtonTextSizeControl,
+  J as createButtonTextStyleAndFontColorControl,
+  tt as createImageMarginsControl,
+  Z as createImageSizeControl,
+  Y as createPaddingsControl,
+  P as createTextAlignControl,
+  O as createTextBackgroundColorControl,
+  _ as createTextColorControl,
+  R as createTextFontFamilyControl,
+  w as createTextLineSpacingControl,
+  v as createTextSizeControl,
+  L as createTextStyleControl
 };

package/dist/src/composables/useHtmlValidator.d.ts

@@ -1,4 +1,31 @@
 import type { DynamicContent } from '@@/Types/generic';
+import type { FiltersResponse } from '@@/Types/recommendation';
+/**
+ * Parses a `{{recoId_index_attributeName}}` variable (already stripped of the
+ * braces/whitespace) into its recommendation id and attribute name. Returns
+ * null for anything that isn't a well-formed recommendation variable.
+ */
+export declare function parseRecommendationVariable(field: string): {
+    recoId: string;
+    attribute: string;
+} | null;
+/**
+ * Builds the set of attribute forms valid inside partner-authored
+ * `{{recoId_index_attribute}}` variables: the built-in compiler attributes plus
+ * each account attribute in its canonical token form — bare for
+ * `defaultAttribute`, `product_attribute.<name>` for `productAttribute`. Using
+ * `resolveProductAttrValue` (the same producer the block builder uses) keeps the
+ * validator's notion of "valid form" identical to what is actually emitted.
+ */
+export declare function buildPartnerAttributeNameSet(filterList: FiltersResponse): Set<string>;
+/**
+ * Returns the `{{...}}` custom fields in the HTML that are invalid. Partner
+ * attributes in `ins-skip-compile` blocks (recoId ∈ ignoredIds) are checked
+ * against `ignoredAttributeNames`; Guido-generated reco variables and known merge
+ * tags pass. An unrecognized dotted token is ignored: it was never captured
+ * before, so flagging it would false-positive on merge tags like `{{user.name}}`.
+ */
+export declare function findInvalidCustomFields(html: string, validCustomFields: string[], recommendationBlockIds: string[], ignoredIds: Set<string>, ignoredAttributeNames: Set<string> | null): string[];
 export declare const useHtmlValidator: () => {
     validateHtml: (html: string, customFields: DynamicContent[], isOnSaveValidation?: boolean) => Promise<boolean>;
 };

package/dist/src/composables/useHtmlValidator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/compiler/utils/recommendationIgnoreUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns true when a recommendation block has opted out of Guido's
+ * product-data → template-variable substitution. Partners signal opt-out by
+ * adding the `ins-skip-compile` class on the `.recommendation-block-v2`
+ * element. Only the variable substitution is skipped — campaign URL building,
+ * hidden-row removal, Outlook image widths, discount conditions, text-trim CSS
+ * and general HTML optimizations still apply. See `CSS_CLASS_SKIP_COMPILE` for
+ * the full scope.
+ */
+export declare function isIgnoredRecommendationBlock(block: Element): boolean;
+/**
+ * DOM-parses the HTML once and returns the set of `recommendation-id`
+ * values that belong to ignored blocks. Use this in regex/string-based
+ * compiler rules where the rule processes flat matches and only has the
+ * extracted block ID rather than a DOM Element reference.
+ */
+export declare function getIgnoredRecommendationBlockIds(html: string): Set<string>;

package/dist/src/config/compiler/utils/recommendationIgnoreUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -5,3 +5,18 @@ export declare function extractTitleText(block: Element): string;
  * the caller treats that as "no segment background".
  */
 export declare function extractCardBgColor(block: Element): string;
+/**
+ * Reads the legacy block's own `currency-*` attributes into a
+ * `currencySettings`-shaped object that `mapCurrency` understands. Used as a
+ * fallback when the external recommendationConfigs map has no entry for this
+ * block, so the migrated block keeps its real currency instead of defaulting.
+ * Returns undefined when the block carries no `currency` attribute.
+ */
+export declare function extractCurrencyFromBlock(block: Element): Record<string, string> | undefined;
+/**
+ * True when a PM has manually opted the legacy block out of content
+ * regeneration by adding the `ins-skip-compile` class. Detected before rebuild
+ * so the migrator preserves the partner's markup verbatim (keeping their
+ * hand-authored variables) instead of regenerating the block.
+ */
+export declare function isPartnerManagedBlock(block: Element): boolean;

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

@@ -8,4 +8,12 @@ export declare function buildBlockHtml(params: {
     extraClasses?: string;
     legacyId?: string;
     legacyBgColor?: string;
+    /**
+     * When set, the block's existing inner HTML is preserved verbatim instead
+     * of regenerating product rows — used for partner-customized blocks so
+     * their hand-authored `{{...}}` variables survive migration.
+     */
+    preserveInnerHtml?: string;
+    /** Adds the `ins-skip-compile` opt-out class to the migrated block. */
+    skipCompile?: boolean;
 }): string;

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

@@ -120,11 +120,11 @@ export declare const ButtonControls: {
         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;
             getLabels(): import("@stripoinc/ui-editor-extensions").ButtonTextStyleAndFontColorControlLabels | undefined;
             api: import("@stripoinc/ui-editor-extensions").ControlApi;
             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/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, 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_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, 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_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, 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

@@ -23,6 +23,18 @@ export declare const MOBILE_ROW_SELECTOR = ".ins-recommendation-mobile-row";
  * `{{cId_pIdx_url}}` template variable.
  */
 export declare const CSS_CLASS_RECO_BUTTON = "reco-v3-button";
+/**
+ * Opt-out class for partners who want to inject their own template variables
+ * into a recommendation block. When present on `.recommendation-block-v2`,
+ * Guido skips ONLY its product-data → template-variable substitution
+ * (`replaceProductAttributes`) for that block — partners author their own
+ * `{{recoId_index_attribute}}` variables. Everything else (campaign URL
+ * building, hidden-row removal, Outlook image widths, text-trim CSS, discount
+ * conditions, store hydration, store-level config validation, and general HTML
+ * optimizations) still applies. The class is preserved in the final compiled
+ * output so partners may use it for their own styling.
+ */
+export declare const CSS_CLASS_SKIP_COMPILE = "ins-skip-compile";
 /**
  * Currency HTML attributes set on the block element
  * These are read by the HTML compiler at runtime to format prices
@@ -56,8 +68,19 @@ export declare const ATTR_CUSTOM_PREFIX = "customAttr:";
 export declare const ATTR_DATA_CUSTOM_ATTRIBUTES = "data-custom-attributes";
 /** HTML attribute on <td> elements identifying the product attribute for compiler template variable generation */
 export declare const ATTR_PRODUCT_ATTR = "product-attr";
+/** Prefix `resolveProductAttrValue` puts on custom (non-default) product attributes in `product-attr` values */
+export declare const PRODUCT_ATTRIBUTE_PREFIX = "product_attribute.";
 /**
  * Default attribute names that are already represented by built-in composition toggle items.
  * Used to exclude these from the custom attribute dropdown to prevent duplication with toggles.
  */
 export declare const BUILT_IN_DEFAULT_ATTRIBUTES: Set<string>;
+/**
+ * Attribute names valid inside a `{{recoId_index_attributeName}}` template
+ * variable regardless of the account's custom attribute list. Every built-in
+ * composition attribute is valid, plus `currency` and `discount` which the
+ * compiler emits but are not composition toggles. Custom attributes are
+ * validated separately against the account's fetched attribute list
+ * (`stripo/email-recommendation-attributes`).
+ */
+export declare const RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES: Set<string>;

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

@@ -120,11 +120,11 @@ export declare const ButtonControls: {
         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;
             getLabels(): import("@stripoinc/ui-editor-extensions").ButtonTextStyleAndFontColorControlLabels | undefined;
             api: import("@stripoinc/ui-editor-extensions").ControlApi;
             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/controls/cardComposition/index.d.ts

@@ -17,6 +17,13 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    /**
+     * Card composition restructures the block (toggles/reorders/adds attribute
+     * cells), which would corrupt a partner-managed (`ins-skip-compile`) block's
+     * preserved markup. There is no native tab-disable API, so the whole control
+     * container is rendered inert (greyed + non-interactive) instead.
+     */
+    _syncDisabledState(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     private _initializeComposition;

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

@@ -21,6 +21,11 @@ export declare class LayoutOrientationControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Layout orientation restructures the whole block, which is meaningless for
+     * partner-managed (`ins-skip-compile`) blocks — disable the control there.
+     */
+    _syncDisabledState(): void;
     _setFormValues(): void;
     /**
      * Handles layout change
@@ -31,7 +36,8 @@ export declare class LayoutOrientationControl extends CommonControl {
      * Regenerates product rows based on the selected layout
      * Uses unified style-preserving regeneration to maintain user customizations
      * @param layout - The layout to use for regeneration (passed explicitly to avoid stale DOM reads)
+     * @param composition - The preserved card composition, incl. customAttr:* entries
      */
-    _regenerateProductRows(layout: Orientation): void;
+    _regenerateProductRows(layout: Orientation, composition: string[]): void;
     _listenToFormUpdates(): void;
 }