@useinsider/guido 3.17.0-beta.77567eb → 3.17.0-beta.978ff7e

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

@@ -0,0 +1,5 @@
+/**
+ * Runs before the document reaches the editor, so a legacy title is already a
+ * composition item on the first render — no post-load adoption pass.
+ */
+export declare function migrateRecommendationTitle(html: string): string;

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,15 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _buildCompositionHtml;
     private _applyVisibilityToBlock;
+    private _applyTitleVisibilityToBlock;
+    private _resolveTitleInjection;
+    private _readTitleHtml;
+    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/types/nodeConfig.d.ts

@@ -138,6 +138,12 @@ export interface RecommendationNodeConfig {
      * Keys are ATTR_PRODUCT_* constants
      */
     visibility: Record<string, boolean>;
+    /**
+     * Snapshot of the block title's row markup before it's removed.
+     * Restored verbatim when the title is re-enabled.
+     * @default ''
+     */
+    previousTitleHtml: string;
     /**
      * Omnibus price text configuration
      * For EU Omnibus Directive compliance

package/dist/static/styles/customEditorStyle.css.js

@@ -43,7 +43,9 @@ const n = `.esd-x,
 .recommendation-block-v2 .product-omnibus-discount ue-node-actions,
 .recommendation-block-v2 .product-omnibus-discount ue-node-panel,
 .recommendation-block-v2 .product-button ue-node-actions,
-.recommendation-block-v2 .product-button ue-node-panel {
+.recommendation-block-v2 .product-button ue-node-panel,
+.recommendation-block-v2 .ins-recommendation-title ue-node-actions,
+.recommendation-block-v2 .ins-recommendation-title ue-node-panel {
     display: none !important;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.17.0-beta.77567eb",
+  "version": "3.17.0-beta.978ff7e",
   "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",
@@ -117,7 +117,7 @@
   },
   "guido": {
     "stripo": {
-      "version": "2.73.0"
+      "version": "2.72.1"
     }
   }
 }