@useinsider/guido 2.0.0-beta.759c7d4 → 2.0.0-beta.76bc929

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const o = { stripo: { version: "2.47.0" } }, s = {
+const o = { stripo: { version: "2.52.0" } }, s = {
   guido: o
 };
 export {

package/dist/src/components/organisms/header/RightSlot.vue.d.ts

@@ -1,4 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<import("../../../@types/stripo.js").SavedTemplateDetails | undefined>;
+    handleSave: (isSilent: boolean) => Promise<import("../../../@types/stripo").SavedTemplateDetails | undefined>;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

package/dist/src/enums/onboarding.d.ts

@@ -3,3 +3,4 @@ export declare const UI_EDITOR_SELECTOR = "ui-editor";
 export declare const CARD_COMPOSITION_TAB_SELECTOR = "button[role=\"tab\"][aria-label=\"Card Composition\"]";
 export declare const SETTINGS_TAB_SELECTOR = "button[role=\"tab\"][aria-label=\"Settings\"]";
 export declare const RIBBON_SELECTOR = ".in-ribbons-wrapper";
+export declare const ACADEMY_LINK = "https://academy.useinsider.com/docs/email-drag-drop-editor";

package/dist/src/enums/unsubscribe.d.ts

@@ -17,6 +17,7 @@ export declare const DEFAULT_UNSUBSCRIBE_GROUP: {
     readonly name: "Global Unsubscribe";
     readonly sendGridId: "G";
 };
+export declare const ACADEMY_LINK = "https://academy.useinsider.com/docs/global-unsubscribe-preference-center";
 export declare const UNSUBSCRIBE_PAGES_LINK = "/email/unsubscribe-pages";
 export declare const PAGE_TYPES: {
     GLOBAL_UNSUBSCRIBE: number;

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

@@ -0,0 +1,13 @@
+/**
+ * Block IDs used in the Recommendation Extension
+ * These IDs are used in the esd-extension-block-id attribute to identify specific blocks
+ */
+export declare enum RecommendationBlockId {
+    BUTTON = "recommendation-block-button",
+    NAME = "recommendation-block-name",
+    PRICE = "recommendation-block-price",
+    OLD_PRICE = "recommendation-block-old-price",
+    OMNIBUS_PRICE = "recommendation-block-omnibus-price",
+    OMNIBUS_DISCOUNT = "recommendation-block-omnibus-discount",
+    IMAGE = "recommendation-block-image"
+}

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

@@ -1,14 +1,3 @@
-/**
- * Block IDs used in the Recommendation Extension
- * These IDs are used in the esd-extension-block-id attribute to identify specific blocks
- */
-export declare enum RecommendationBlockId {
-    BUTTON = "recommendation-block-button",
-    NAME = "recommendation-block-name",
-    PRICE = "recommendation-block-price",
-    OLD_PRICE = "recommendation-block-old-price",
-    IMAGE = "recommendation-block-image"
-}
 /**
  * Control IDs used in the Recommendation Extension
  * These IDs are returned by the getId() method of each control
@@ -32,6 +21,7 @@ export declare enum RecommendationControlId {
     NAME_PADDINGS = "recommendation-block-name-paddings-control",
     NAME_SIZE = "recommendation-block-name-size-control",
     NAME_STYLE = "recommendation-block-name-style-control",
+    NAME_TEXT_TRIM = "recommendation-block-name-text-trim-control",
     PRICE_ALIGN = "recommendation-block-price-align-control",
     PRICE_BACKGROUND = "recommendation-block-price-background-control",
     PRICE_COLOR = "recommendation-block-price-color-control",
@@ -46,6 +36,24 @@ export declare enum RecommendationControlId {
     OLD_PRICE_PADDINGS = "recommendation-block-old-price-paddings-control",
     OLD_PRICE_SIZE = "recommendation-block-old-price-size-control",
     OLD_PRICE_STYLE = "recommendation-block-old-price-style-control",
+    OMNIBUS_PRICE_ALIGN = "recommendation-block-omnibus-price-align-control",
+    OMNIBUS_PRICE_BACKGROUND = "recommendation-block-omnibus-price-background-control",
+    OMNIBUS_PRICE_COLOR = "recommendation-block-omnibus-price-color-control",
+    OMNIBUS_PRICE_FONT_FAMILY = "recommendation-block-omnibus-price-font-family-control",
+    OMNIBUS_PRICE_PADDINGS = "recommendation-block-omnibus-price-paddings-control",
+    OMNIBUS_PRICE_SIZE = "recommendation-block-omnibus-price-size-control",
+    OMNIBUS_PRICE_STYLE = "recommendation-block-omnibus-price-style-control",
+    OMNIBUS_PRICE_TEXT_BEFORE = "recommendation-block-omnibus-price-text-before-control",
+    OMNIBUS_PRICE_TEXT_AFTER = "recommendation-block-omnibus-price-text-after-control",
+    OMNIBUS_DISCOUNT_ALIGN = "recommendation-block-omnibus-discount-align-control",
+    OMNIBUS_DISCOUNT_BACKGROUND = "recommendation-block-omnibus-discount-background-control",
+    OMNIBUS_DISCOUNT_COLOR = "recommendation-block-omnibus-discount-color-control",
+    OMNIBUS_DISCOUNT_FONT_FAMILY = "recommendation-block-omnibus-discount-font-family-control",
+    OMNIBUS_DISCOUNT_PADDINGS = "recommendation-block-omnibus-discount-paddings-control",
+    OMNIBUS_DISCOUNT_SIZE = "recommendation-block-omnibus-discount-size-control",
+    OMNIBUS_DISCOUNT_STYLE = "recommendation-block-omnibus-discount-style-control",
+    OMNIBUS_DISCOUNT_TEXT_BEFORE = "recommendation-block-omnibus-discount-text-before-control",
+    OMNIBUS_DISCOUNT_TEXT_AFTER = "recommendation-block-omnibus-discount-text-after-control",
     IMAGE_SIZE = "recommendation-block-image-size-control",
     IMAGE_MARGINS = "recommendation-block-image-margins-control"
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Recommendation Extension Constants
+ *
+ * This module re-exports all constants for the Recommendation extension.
+ * Import from this file for cleaner imports.
+ * @example
+ * import { RecommendationBlockId, CONTAINER_SELECTOR } from './constants';
+ */
+export { RecommendationBlockId } from './blockIds';
+export { RecommendationControlId } from './controlIds';
+export { CONTAINER_SELECTOR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, } from './selectors';

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

@@ -0,0 +1,19 @@
+/**
+ * CSS selectors and data attributes used across the Recommendation extension
+ */
+/**
+ * Container selector for the product container element
+ * Used across controls to target elements within the recommendation block
+ */
+export declare const CONTAINER_SELECTOR = ".ins-recommendation-product-container";
+/**
+ * Attribute type constants used in templates
+ * These are used as keys in ElementRenderer and composition arrays
+ */
+export declare const ATTR_PRODUCT_IMAGE = "productImage";
+export declare const ATTR_PRODUCT_NAME = "productName";
+export declare const ATTR_PRODUCT_PRICE = "productPrice";
+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";

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

@@ -0,0 +1,143 @@
+/**
+ * Button Element Controls
+ *
+ * Controls for styling the CTA button element in recommendation cards.
+ */
+/**
+ * Grouped Button Controls
+ * Use this object for cleaner imports in extension.ts
+ */
+export declare const ButtonControls: {
+    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 border: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ButtonBorderControlLabels | 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;
+        };
+    };
+    readonly borderRadius: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ButtonBorderRadiusControlLabels | 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;
+        };
+    };
+    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 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 margins: {
+        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 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;
+        };
+    };
+    readonly text: {
+        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 textSize: {
+        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 textStyleAndFontColor: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            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;
+        };
+    };
+    readonly fitToContent: {
+        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/controls/cardBackground/index.d.ts

@@ -0,0 +1,41 @@
+import type { Orientation } from '@@/Types/recommendation';
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+export declare const CARD_BACKGROUND_COLOR_CONTROL_ID = "recommendation-card-background-color-control";
+/**
+ * Control for managing recommendation card background color
+ * This control is displayed in the Styles tab
+ */
+export declare class CardBackgroundColorControl extends CommonControl {
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    /**
+     * Gets the block element - either currentNode itself or as a descendant
+     * The currentNode could BE the block element or contain it
+     */
+    _getBlockElement(): ImmutableHtmlNode | null;
+    /**
+     * Gets the current layout orientation from the block's data attribute
+     */
+    _getCurrentLayout(): Orientation;
+    /**
+     * Gets the appropriate selector based on layout
+     * Vertical: .product-card-segment (inner table per product cell)
+     * Horizontal: .product-card-wrapper (table per product row)
+     */
+    _getCardSelector(): string;
+    /**
+     * Reads the current background color from the first product card element
+     * @returns The background color value or 'transparent' if not found
+     */
+    _getCurrentCardBackgroundColor(): string;
+    /**
+     * Handles card background color changes
+     * Applies the color to all product card elements based on layout
+     */
+    _onCardBackgroundColorChange(color: string): void;
+    _listenToFormUpdates(): void;
+}

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

@@ -0,0 +1,95 @@
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+export declare const COMPOSITION_CONTROL_BLOCK_ID = "ui-elements-recommendation-card-composition";
+export interface CardCompositionItem {
+    key: string;
+    label: string;
+    visible: boolean;
+}
+export declare class RecommendationCardCompositionControl extends CommonControl {
+    private store;
+    private unsubscribeOrientation;
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Creates the HTML content for an orderable item with label and toggle
+     */
+    private _createItemContent;
+    /**
+     * Registers event listeners for composition and visibility changes
+     */
+    private _registerValueChangeListeners;
+    /**
+     * Initializes composition order and visibility state from the current node
+     */
+    private _initializeComposition;
+    /**
+     * Reads composition order from node's data-card-composition attribute
+     * Falls back to default order if attribute is not present
+     */
+    private _readCompositionFromNode;
+    /**
+     * Builds visibility values object from the visibility map
+     */
+    private _buildVisibilityValues;
+    /**
+     * Read visibility state from individual row elements' data-visibility attributes
+     * This ensures toggles reflect the actual DOM state
+     */
+    private _readVisibilityFromRows;
+    /**
+     * Returns default visibility values for all items
+     */
+    private _getDefaultVisibilities;
+    /**
+     * Extracts visibility values from DOM nodes
+     */
+    private _extractVisibilityFromRows;
+    /**
+     * Parses visibility value from string to boolean
+     * Accepts "1", "true" as true, everything else as false
+     */
+    private _parseVisibilityValue;
+    /**
+     * Merges extracted visibilities with default values for missing keys
+     */
+    private _mergeWithDefaults;
+    /**
+     * Apply the reordered composition to the block's HTML structure
+     * Updates the data-card-composition attribute and reorders product attributes
+     * Note: Reordering is only applied for vertical layout
+     */
+    private _applyCompositionToBlock;
+    /**
+     * Reorders attribute rows within each product card based on composition order
+     * Targets the tbody inside each product-attribute-cell to preserve card structure
+     */
+    private _reorderProductAttributes;
+    /**
+     * Builds HTML string with attributes ordered according to composition
+     */
+    private _buildCompositionHtml;
+    /**
+     * Apply visibility changes to the block's HTML structure
+     * Updates display style and data-visibility attribute for all matching elements
+     * - <tr> elements: use display: none / table-row
+     * - <td> elements: use display: none / table-cell
+     */
+    private _applyVisibilityToBlock;
+    /**
+     * Gets the current layout orientation from store or DOM
+     */
+    private _getCurrentLayout;
+    /**
+     * Updates orderable state based on layout orientation
+     * Adds/removes disabled class to hide drag icons for horizontal layout
+     */
+    private _updateOrderableState;
+    /**
+     * Subscribe to store orientation changes
+     * Updates orderable state when layout changes via the layout control
+     */
+    private _subscribeToOrientationChanges;
+}

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

@@ -0,0 +1,35 @@
+/**
+ * Image Element Controls
+ *
+ * Controls for styling the product image element in recommendation cards.
+ */
+/**
+ * Grouped Image Controls
+ * Use this object for cleaner imports in extension.ts
+ */
+export declare const ImageControls: {
+    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 margins: {
+        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/controls/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Recommendation Block Controls
+ *
+ * This module exports all controls for the Recommendation extension.
+ * Controls are organized by element type for better discoverability.
+ * @example
+ * // Grouped imports (recommended)
+ * import { NameControls, ButtonControls } from './controls';
+ * // Or individual imports
+ * import { NameAlignControl, ButtonColorControl } from './controls';
+ */
+export { RecommendationBlockControl, CONTROL_BLOCK_ID } from './main';
+export { NameControls } from './name';
+export { PriceControls } from './price';
+export { OldPriceControls } from './oldPrice';
+export { OmnibusPriceControls } from './omnibusPrice';
+export { OmnibusDiscountControls } from './omnibusDiscount';
+export { ButtonControls } from './button';
+export { ImageControls } from './image';
+export { SpacingControl, SPACING_CONTROL_ID } from './spacing';
+export { CardBackgroundColorControl, CARD_BACKGROUND_COLOR_CONTROL_ID } from './cardBackground';
+export { LayoutControl, LAYOUT_CONTROL_ID } from './layout';
+export { RecommendationCardCompositionControl, COMPOSITION_CONTROL_BLOCK_ID } from './cardComposition';

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

@@ -0,0 +1,50 @@
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+import { type Orientation } from '../../templates';
+export declare const LAYOUT_CONTROL_ID = "recommendation-layout-control";
+/**
+ * Control for managing recommendation block layout orientation
+ * Allows switching between vertical (grid) and horizontal (list) layouts
+ */
+export declare class LayoutControl extends CommonControl {
+    private store;
+    private isChangingLayout;
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    /**
+     * Gets the block element - either currentNode itself or as a descendant
+     * The currentNode could BE the block element or contain it
+     */
+    _getBlockElement(): ImmutableHtmlNode | null;
+    /**
+     * Reads the current layout from the block's data attribute
+     * @returns The layout value ('vertical' or 'horizontal'), defaults to 'vertical'
+     */
+    _getCurrentLayout(): Orientation;
+    /**
+     * Get the current card composition from block data attribute or use default
+     */
+    _getCardComposition(): string[];
+    /**
+     * Handles layout change
+     * Updates the block's data attribute and regenerates product rows
+     */
+    _onLayoutChange(layout: Orientation): void;
+    /**
+     * Regenerates product rows based on the selected layout
+     */
+    _regenerateProductRows(layout: Orientation): void;
+    /**
+     * Gets current card background color from existing elements
+     * Checks both vertical (.product-card-segment) and horizontal (.product-card-wrapper) selectors
+     */
+    _getCurrentCardBackgroundColor(): string | null;
+    /**
+     * Applies card background color to appropriate elements based on layout
+     */
+    _applyCardBackgroundColor(bgColor: string | null, layout: Orientation): void;
+    _listenToFormUpdates(): void;
+}

package/dist/src/extensions/Blocks/Recommendation/{control.d.ts → controls/main/index.d.ts}

@@ -1,4 +1,6 @@
-import { CommonControl } from '../common-control';
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+import { type Orientation } from '../../templates';
 export declare const CONTROL_BLOCK_ID = "ui-elements-recommendation-block";
 export declare class RecommendationBlockControl extends CommonControl {
     private store;
@@ -8,6 +10,7 @@ export declare class RecommendationBlockControl extends CommonControl {
     getId(): string;
     getTemplate(): string;
     onRender(): Promise<void>;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     _setFormValues(): void;
     _initializeSelectItems(): void;
@@ -15,10 +18,18 @@ export declare class RecommendationBlockControl extends CommonControl {
     _getLanguages(): string;
     _getCurrency(): string;
     _getProductLayout(): string;
+    /**
+     * Gets the current layout orientation from the block's data attribute
+     */
+    _getCurrentLayout(): Orientation;
+    /**
+     * Updates "Products in One Row" visibility based on layout orientation
+     * This control is hidden for horizontal layout (products always take full width)
+     * Reads from store first (reliable during state transitions), falls back to DOM
+     */
+    _updateProductsInRowVisibility(): void;
     _getFilterStatus(): string;
     _getShuffleProducts(): string;
-    _getResponsive(): string;
-    _onFilterChange(value: boolean): void;
     _onFilterSelectClick(): void;
     _onDataChange(item: string, value: string | number | string[]): void;
     /**
@@ -26,6 +37,11 @@ export declare class RecommendationBlockControl extends CommonControl {
      */
     _getCardComposition(): string[];
     _regenerateProductRows(): void;
+    /**
+     * Reapply spacing values after product regeneration
+     * This ensures spacing persists when products are regenerated
+     */
+    _reapplySpacing(): void;
     _debouncedRegenerateProductRows: import("@vueuse/shared").PromisifyFn<() => void>;
     _onCurrencyConfigChange(item: string, value: string | number): void;
     _onCurrencyChange(value: string): void;