@useinsider/guido 3.8.1-beta.2ee94c2 → 3.8.1-beta.6c0ee3f

package/dist/extensions/Blocks/controlFactories.js

@@ -1,6 +1,6 @@
-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) {
+import { TextAlignBuiltInControl as a, TextColorBuiltInControl as g, TextSizeBuiltInControl as f, TextStyleBuiltInControl as x, TextFontFamilyBuiltInControl as C, ButtonBackgroundColorBuiltInControl as T, TextPaddingsBuiltInControl as B, ImageSizeBuiltInControl as m, ImageMarginsBuiltInControl as y, ButtonAlignBuiltInControl as I, 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 h, ButtonFitToContainerBuiltInControl as F, TextLineSpacingBuiltInControl as M } from "../../node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js";
+const R = "buttonTextStyleForm", _ = "backgroundColor", E = /* @__PURE__ */ new Set(["", "transparent", "rgba(0, 0, 0, 0)"]);
+function z(o, n, r) {
   return class extends a {
     getId() {
       return o;
@@ -13,7 +13,7 @@ function P(o, n, r) {
     }
   };
 }
-function _(o, n, r) {
+function v(o, n, r) {
   return class extends g {
     getId() {
       return o;
@@ -26,8 +26,8 @@ function _(o, n, r) {
     }
   };
 }
-function v(o, n, r) {
-  return class extends x {
+function P(o, n, r) {
+  return class extends f {
     getId() {
       return o;
     }
@@ -39,8 +39,8 @@ function v(o, n, r) {
     }
   };
 }
-function L(o, n, r) {
-  return class extends f {
+function D(o, n, r) {
+  return class extends x {
     getId() {
       return o;
     }
@@ -52,7 +52,7 @@ function L(o, n, r) {
     }
   };
 }
-function R(o, n, r) {
+function K(o, n, r) {
   return class extends C {
     getId() {
       return o;
@@ -65,7 +65,7 @@ function R(o, n, r) {
     }
   };
 }
-function O(o, n, r) {
+function L(o, n, r) {
   return class extends T {
     getId() {
       return o;
@@ -76,9 +76,28 @@ function O(o, n, r) {
       const t = e.closest(r);
       return t ? t.querySelectorAll(`[esd-extension-block-id="${n}"]`) : [];
     }
+    /**
+     * Mirrors the picked background onto each target cell as an INLINE style.
+     *
+     * Stripo's built-in applies the background as a stylesheet rule, not inline. On
+     * regeneration we re-bake the captured color inline (cellBgStyleAttr); inline then
+     * outranks Stripo's rule in the cascade, so a later re-edit silently has no effect
+     * (SD-143023). Writing the inline here keeps it the single source of truth and in
+     * sync on every edit. Merged into the parent control's single patch (no extra apply).
+     */
+    getAdditionalModifications(e) {
+      const t = this.getTargetNodes(e);
+      if (!t.length)
+        return;
+      const s = this.api.getValues()[_], i = !s || E.has(s), c = this.api.getDocumentModifier();
+      return t.forEach((u) => {
+        const l = c.modifyHtml(u);
+        i ? l.removeStyle("background-color") : l.setStyle("background-color", s);
+      }), c;
+    }
   };
 }
-function Y(o, n, r) {
+function U(o, n, r) {
   return class extends B {
     getId() {
       return o;
@@ -91,7 +110,7 @@ function Y(o, n, r) {
     }
   };
 }
-function w(o, n, r) {
+function Y(o, n, r) {
   return class extends M {
     getId() {
       return o;
@@ -101,8 +120,8 @@ function w(o, n, r) {
     }
   };
 }
-function D(o, n, r = ".ins-recommendation-product-container") {
-  return class extends m {
+function w(o, n, r = ".ins-recommendation-product-container") {
+  return class extends I {
     getId() {
       return o;
     }
@@ -112,7 +131,7 @@ function D(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function H(o, n, r = ".ins-recommendation-product-container") {
+function G(o, n, r = ".ins-recommendation-product-container") {
   return class extends b {
     getId() {
       return o;
@@ -123,7 +142,7 @@ function H(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function K(o, n, r = ".ins-recommendation-product-container") {
+function H(o, n, r = ".ins-recommendation-product-container") {
   return class extends S {
     getId() {
       return o;
@@ -134,7 +153,7 @@ function K(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function U(o, n, r = ".ins-recommendation-product-container") {
+function V(o, n, r = ".ins-recommendation-product-container") {
   return class extends A {
     getId() {
       return o;
@@ -145,7 +164,7 @@ function U(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function V(o, n, r = ".ins-recommendation-product-container") {
+function W(o, n, r = ".ins-recommendation-product-container") {
   return class extends N {
     getId() {
       return o;
@@ -156,7 +175,7 @@ function V(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function W(o, n, r = ".ins-recommendation-product-container") {
+function X(o, n, r = ".ins-recommendation-product-container") {
   return class extends q {
     getId() {
       return o;
@@ -167,7 +186,7 @@ function W(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function X(o, n, r = ".ins-recommendation-product-container") {
+function j(o, n, r = ".ins-recommendation-product-container") {
   return class extends $ {
     getId() {
       return o;
@@ -178,7 +197,7 @@ function X(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function j(o, n, r = ".ins-recommendation-product-container") {
+function J(o, n, r = ".ins-recommendation-product-container") {
   return class extends k {
     getId() {
       return o;
@@ -189,7 +208,7 @@ function j(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function G(o, n, r = ".ins-recommendation-product-container") {
+function Q(o, n, r = ".ins-recommendation-product-container") {
   return class extends p {
     getId() {
       return o;
@@ -200,8 +219,8 @@ function G(o, n, r = ".ins-recommendation-product-container") {
     }
   };
 }
-function J(o, n, r) {
-  return class extends F {
+function Z(o, n, r) {
+  return class extends h {
     getId() {
       return o;
     }
@@ -223,21 +242,21 @@ function J(o, n, r) {
       const t = e.closest(r);
       if (!t)
         return;
-      const i = t.querySelectorAll(`[esd-extension-block-id="${n}"] a.es-button`);
-      if (!i.length)
+      const s = t.querySelectorAll(`[esd-extension-block-id="${n}"] a.es-button`);
+      if (!s.length)
         return;
-      const s = this.api.getValues()[z];
-      if (!s)
+      const i = this.api.getValues()[R];
+      if (!i)
         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);
+      const c = i.bold ? "bold" : "normal", u = i.italic ? "italic" : "normal", l = this.api.getDocumentModifier();
+      return s.forEach((d) => {
+        l.modifyHtml(d).setStyle("font-weight", c).setStyle("font-style", u);
       }), l;
     }
   };
 }
-function Q(o, n, r) {
-  return class extends h {
+function tt(o, n, r) {
+  return class extends F {
     getId() {
       return o;
     }
@@ -247,8 +266,8 @@ function Q(o, n, r) {
     }
   };
 }
-function Z(o, n, r) {
-  return class extends I {
+function et(o, n, r) {
+  return class extends m {
     getId() {
       return o;
     }
@@ -262,7 +281,7 @@ function Z(o, n, r) {
     }
   };
 }
-function tt(o, n, r) {
+function nt(o, n, r) {
   return class extends y {
     getId() {
       return o;
@@ -278,25 +297,25 @@ function tt(o, n, r) {
   };
 }
 export {
-  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
+  w as createButtonAlignControl,
+  H as createButtonBorderControl,
+  V as createButtonBorderRadiusControl,
+  G as createButtonColorControl,
+  tt as createButtonFitToContainerControl,
+  W as createButtonFontFamilyControl,
+  X as createButtonMarginsControl,
+  j as createButtonPaddingsControl,
+  J as createButtonTextControl,
+  Q as createButtonTextSizeControl,
+  Z as createButtonTextStyleAndFontColorControl,
+  nt as createImageMarginsControl,
+  et as createImageSizeControl,
+  U as createPaddingsControl,
+  z as createTextAlignControl,
+  L as createTextBackgroundColorControl,
+  v as createTextColorControl,
+  K as createTextFontFamilyControl,
+  Y as createTextLineSpacingControl,
+  P as createTextSizeControl,
+  D 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/CouponBlock/controls/index.d.ts

@@ -74,11 +74,11 @@ export declare const TextBackgroundControl: {
     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;
-        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/Items/controls/index.d.ts

@@ -232,11 +232,11 @@ export declare const OriginalPriceControls: {
         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;
-            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;
         };
     };
@@ -318,11 +318,11 @@ export declare const PriceControls: {
         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;
-            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;
         };
     };
@@ -404,11 +404,11 @@ export declare const NameControls: {
         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;
-            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, 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_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
@@ -63,3 +75,12 @@ export declare const PRODUCT_ATTRIBUTE_PREFIX = "product_attribute.";
  * 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/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

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

@@ -30,6 +30,12 @@ export declare class ProductLayoutControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Products-per-row and mobile-layout restructure the block, which is
+     * meaningless for partner-managed (`ins-skip-compile`) blocks — disable
+     * these inputs there. Disabling coexists with the visibility logic above.
+     */
+    _syncDisabledState(): void;
     onDestroy(): void;
     _setFormValues(): void;
     /**

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

@@ -35,6 +35,15 @@ interface DocumentModifier {
  * @returns The block element or null if not found
  */
 export declare function getBlockElement(currentNode: ImmutableHtmlNode | null | undefined): ImmutableHtmlNode | null;
+/**
+ * True when the recommendation block has opted out of Guido's content
+ * regeneration via the `ins-skip-compile` class. Partner-managed blocks carry
+ * hand-authored `{{...}}` variables in their cells, so Guido must never
+ * overwrite their content with product data (regenerate / in-place update).
+ * @param currentNode - The current template node
+ * @returns True if the block opted out of content regeneration
+ */
+export declare function isPartnerManagedBlock(currentNode: ImmutableHtmlNode | null | undefined): boolean;
 /**
  * Gets the current layout orientation from the block's data attribute
  * Supports both old (horizontal/vertical) and new (list/grid) values for backward compatibility

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

@@ -73,11 +73,11 @@ export declare const NameControls: {
         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;
-            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/oldPrice/index.d.ts

@@ -72,11 +72,11 @@ export declare const OldPriceControls: {
         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;
-            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/omnibusDiscount/index.d.ts

@@ -75,11 +75,11 @@ export declare const OmnibusDiscountControls: {
         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;
-            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/omnibusPrice/index.d.ts

@@ -75,11 +75,11 @@ export declare const OmnibusPriceControls: {
         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;
-            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/price/index.d.ts

@@ -72,11 +72,11 @@ export declare const PriceControls: {
         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;
-            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/controlFactories.d.ts

@@ -98,11 +98,20 @@ export declare function createTextBackgroundColorControl(controlId: string, targ
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
+        /**
+         * Mirrors the picked background onto each target cell as an INLINE style.
+         *
+         * Stripo's built-in applies the background as a stylesheet rule, not inline. On
+         * regeneration we re-bake the captured color inline (cellBgStyleAttr); inline then
+         * outranks Stripo's rule in the cascade, so a later re-edit silently has no effect
+         * (SD-143023). Writing the inline here keeps it the single source of truth and in
+         * sync on every edit. Merged into the parent control's single patch (no extra apply).
+         */
+        getAdditionalModifications(root: 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;
-        getAdditionalModifications(_root: ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
         isVisible(_node: ImmutableHtmlNode): boolean;
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.8.1-beta.2ee94c2",
+  "version": "3.8.1-beta.6c0ee3f",
   "description": "Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.",
   "main": "./dist/guido.umd.cjs",
   "module": "./dist/library.js",