@useinsider/guido 3.8.1 → 3.8.2-beta.189e91c

package/dist/src/@types/config/schemas.d.ts

@@ -139,6 +139,10 @@ export declare const LegacyRecommendationConfigSchema: v.LooseObjectSchema<{
     readonly size: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
     /** Vertical responsiveness flag (legacy size=1 variants) */
     readonly verticalResponsiveness: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Legacy "Move to next line" price placement toggle (cardPricePlacement.js) */
+    readonly isPriceMovedToNextLine: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Legacy "Hide if same as discounted" / delete-price-for-zero-sale toggle */
+    readonly isPriceDeletedForZeroSale: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
 }, undefined>;
 /**
  * Migration-only inputs scoped to this template.
@@ -195,6 +199,10 @@ export declare const TemplateMigrationSchema: v.ObjectSchema<{
         readonly size: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
         /** Vertical responsiveness flag (legacy size=1 variants) */
         readonly verticalResponsiveness: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** Legacy "Move to next line" price placement toggle (cardPricePlacement.js) */
+        readonly isPriceMovedToNextLine: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** Legacy "Hide if same as discounted" / delete-price-for-zero-sale toggle */
+        readonly isPriceDeletedForZeroSale: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>, {}>;
 }, undefined>;
 /**
@@ -274,6 +282,10 @@ export declare const TemplateSchema: v.ObjectSchema<{
             readonly size: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
             /** Vertical responsiveness flag (legacy size=1 variants) */
             readonly verticalResponsiveness: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            /** Legacy "Move to next line" price placement toggle (cardPricePlacement.js) */
+            readonly isPriceMovedToNextLine: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            /** Legacy "Hide if same as discounted" / delete-price-for-zero-sale toggle */
+            readonly isPriceDeletedForZeroSale: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         }, undefined>, undefined>, {}>;
     }, undefined>, {}>;
 }, undefined>;
@@ -665,6 +677,10 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
                 readonly size: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
                 /** Vertical responsiveness flag (legacy size=1 variants) */
                 readonly verticalResponsiveness: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                /** Legacy "Move to next line" price placement toggle (cardPricePlacement.js) */
+                readonly isPriceMovedToNextLine: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                /** Legacy "Hide if same as discounted" / delete-price-for-zero-sale toggle */
+                readonly isPriceDeletedForZeroSale: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             }, undefined>, undefined>, {}>;
         }, undefined>, {}>;
     }, undefined>, {}>;

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

@@ -60,6 +60,8 @@ export declare const useConfig: () => {
                         blockType?: string | undefined;
                         size?: string | number | undefined;
                         verticalResponsiveness?: boolean | undefined;
+                        isPriceMovedToNextLine?: boolean | undefined;
+                        isPriceDeletedForZeroSale?: boolean | undefined;
                     } & {
                         [key: string]: unknown;
                     };
@@ -186,6 +188,8 @@ export declare const useConfig: () => {
                     blockType?: string | undefined;
                     size?: string | number | undefined;
                     verticalResponsiveness?: boolean | undefined;
+                    isPriceMovedToNextLine?: boolean | undefined;
+                    isPriceDeletedForZeroSale?: boolean | undefined;
                 } & {
                     [key: string]: unknown;
                 };

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/composables/usePreviewInteractionGuard.d.ts

@@ -0,0 +1,3 @@
+export declare const usePreviewInteractionGuard: () => {
+    blockPreviewInteractions: (iframe: HTMLIFrameElement) => void;
+};

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

@@ -0,0 +1,10 @@
+/**
+ * Substitutes recommendation product variables in compiled preview HTML with the
+ * blocks' fetched sample products, then simulates the email-service hide rule by
+ * emptying the original-price cell (DOM kept) for slots with no real discount.
+ * Returns the input unchanged when there are no reco blocks or no products.
+ */
+export declare function substituteRecommendationPreview(html: string): string;
+export declare const useRecommendationPreview: () => {
+    substituteRecommendationPreview: typeof substituteRecommendationPreview;
+};

package/dist/src/composables/validators/useUnsubscribeBlockValidator.d.ts

@@ -1,3 +1,4 @@
 export declare const useUnsubscribeBlockValidator: () => {
     validateUnsubscribeBlockUniqueness: (html: string) => boolean;
+    validateUnsubscribeBlockHasTemplate: (html: string) => boolean;
 };

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/config/migrator/recommendation/settingsMapper.d.ts

@@ -3,5 +3,5 @@ import type { CurrencyConfig, RecommendationNodeConfig } from '@@/Extensions/Blo
 import type { LegacyRecommendationConfig } from '@@/Types/config';
 /** Defensive against missing/malformed legacy `currencySettings` — defaults are per-field, not whole-object. */
 export declare function mapCurrency(legacy: unknown): CurrencyConfig;
-export type SettingsPartial = Pick<RecommendationNodeConfig, 'recommendationId' | 'strategy' | 'productIds' | 'size' | 'shuffleProducts' | 'language' | 'currency' | 'filters' | 'layout' | 'cardsInRow' | 'mobileCardsInRow' | 'mobileLayoutEnabled' | 'previousMobileCardsInRow' | 'columnSpacing' | 'rowSpacing' | 'mobileColumnSpacing' | 'mobileRowSpacing' | 'omnibusPrice' | 'omnibusDiscount' | 'configVersion'>;
+export type SettingsPartial = Pick<RecommendationNodeConfig, 'recommendationId' | 'strategy' | 'productIds' | 'size' | 'shuffleProducts' | 'language' | 'currency' | 'filters' | 'layout' | 'cardsInRow' | 'mobileCardsInRow' | 'mobileLayoutEnabled' | 'previousMobileCardsInRow' | 'columnSpacing' | 'rowSpacing' | 'mobileColumnSpacing' | 'mobileRowSpacing' | 'omnibusPrice' | 'omnibusDiscount' | 'priceMovedToNextLine' | 'priceHideIfSameAsDiscounted' | 'configVersion'>;
 export declare function mapSettings(recCfg: LegacyRecommendationConfig, parsed: LegacyProductConfig, id: number): SettingsPartial;

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

@@ -117,6 +117,16 @@ export declare class RecommendationBlock extends Block {
      * added classes via setAttribute.
      */
     private _assignRecommendationId;
+    /**
+     * Stamps the `hide-price` attribute (read by email-service at send time) on
+     * the block element from the config flag.
+     */
+    private _stampHidePrice;
+    /**
+     * Stamps `hide-price` from config only when the block lacks the attribute —
+     * heals templates saved before this feature without dirtying current ones.
+     */
+    private _healHidePriceAttr;
     /**
      * Gets the recommendation-id from a block node
      */

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;
@@ -43,6 +50,15 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _tryReorderInPlace;
     private _createBuiltInItemHtml;
+    /**
+     * Inline mode: the merged "Product Prices" group item. It moves as a unit in
+     * the main list (both keys stay adjacent) and contains a nested 2-item drag
+     * to reorder Product Price ↔ Product Original Price — which flips the inline
+     * render order via `resolveInlinePriceOrder`. The group keeps a single
+     * visibility toggle (`data-action-for="productPrice"`). Nested sub-items use a
+     * plain drag handle (no UE button → untouched by the reorder-icon rescue).
+     */
+    private _createPriceGroupItemHtml;
     private _createCustomItemHtml;
     /**
      * Builds select options from the store's filterList.
@@ -98,7 +114,23 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _rescueReorderIconsToStore;
     private _setupEventListeners;
+    /**
+     * Builds the composition key order from the orderable list, expanding the
+     * inline "Product Prices" group into its two sub-keys (in nested DOM order)
+     * so both price keys stay adjacent and in the user-chosen order.
+     */
+    private _extractCompositionOrder;
     private _setupDragAndDrop;
+    /**
+     * Wires drag/drop reordering for one item level on the shared list. Both the
+     * top-level items and the nested price sub-items use this; they never fight
+     * because each only sets its `dragged` ref when its own `itemSelector` matches
+     * at dragstart (and the top-level one additionally ignores drags originating
+     * inside `ignoreSelector`). Every drop re-reads the full composition via
+     * `_extractCompositionOrder`, so both levels commit through `_onReorder`
+     * identically.
+     */
+    private _registerDragHandlers;
     private _setupDeleteHandler;
     private _onAddAttribute;
     /**
@@ -155,9 +187,10 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     private _extractSegmentBgFromCard;
     private _getControlContainer;
     /**
-     * Adds/removes orderable-disabled class based on layout orientation.
-     * List layout hides drag handles via CSS and disables draggable attribute
-     * to prevent native browser drag-and-drop from working without the handle.
+     * Ensures composition reorder is enabled. Both grid and list layouts now
+     * support reordering — top-level items and the nested price sub-items are all
+     * draggable. (Items render with `draggable="true"`; this just clears any stale
+     * disabled state.)
      */
     private _updateOrderableState;
     /**

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

@@ -9,7 +9,7 @@
  * // Or individual imports
  * import { NameAlignControl, ButtonColorControl } from './controls';
  */
-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, } from './main';
+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 { NameControls } from './name';
 export { PriceControls } from './price';

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

@@ -5,11 +5,12 @@ import { CurrencyControl, CURRENCY_CONTROL_ID } from './currency';
 import { FiltersControl, FILTERS_CONTROL_ID } from './filters';
 import { LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID } from './layoutOrientation';
 import { LocaleControl, LOCALE_CONTROL_ID } from './locale';
+import { PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID } from './pricePlacement';
 import { ProductCountControl, PRODUCT_COUNT_CONTROL_ID } from './productCount';
 import { ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID } from './productLayout';
 import { ShuffleControl, SHUFFLE_CONTROL_ID } from './shuffle';
 export declare const CONTROL_BLOCK_ID = "ui-elements-recommendation-block";
-export { 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, };
+export { 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, };
 export * from './utils';
 /**
  * Main recommendation block control that composes all sub-controls
@@ -26,6 +27,7 @@ export declare class RecommendationBlockControl extends CommonControl {
     private productLayoutControl;
     private filtersControl;
     private shuffleControl;
+    private pricePlacementControl;
     private layoutOrientationControl;
     getId(): string;
     getTemplate(): string;

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/pricePlacement.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Price Placement Control
+ *
+ * Two block-level price settings ported from the legacy product block, shown
+ * above the Currency control in the main Settings tab:
+ *
+ * - "Product Price Orientation" (`priceMovedToNextLine`): a vertical/horizontal
+ *   icon radio (mirrors the Items block control). `vertical` (default) keeps the
+ *   price and original price on separate stacked rows (current Guido look);
+ *   `horizontal` renders them inline on the same line and Card Composition
+ *   collapses them into a single "Product Prices" entry.
+ * - "Hide if same as discounted" (`priceHideIfSameAsDiscounted`): a toggle.
+ *   When ON, email-service blanks the redundant original price at send time when
+ *   it equals the sale price (see the `hide-price` block attribute below).
+ *
+ * Orientation re-renders the rows (it changes the saved template layout).
+ * Hide-if-same NEVER touches the template — it only persists config + stamps the
+ * `hide-price` attribute; the visual hide is simulated in the preview and applied
+ * for real server-side by email-service.
+ */
+import type { RecommendationNodeConfig } from '../../types/nodeConfig';
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+export declare const PRICE_PLACEMENT_CONTROL_ID = "recommendation-price-placement-control";
+type Orientation = 'vertical' | 'horizontal';
+/**
+ * Control for the block-level price orientation radio + hide-if-same toggle.
+ */
+export declare class PricePlacementControl extends CommonControl {
+    private store;
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(config: RecommendationNodeConfig): void;
+    _initializeHideToggle(config: RecommendationNodeConfig): void;
+    /**
+     * Disables the orientation radio when a price element is hidden via Card
+     * Composition — orientation is meaningless without both prices visible.
+     * Visibility lives on the attribute rows' `data-visibility` (set by the Card
+     * Composition control). Inline mode has no standalone original-price row, so
+     * the merged "Product Prices" entry (the price row) governs.
+     */
+    _updateOrientationDisabled(): void;
+    _onOrientationChange(orientation: Orientation): void;
+    _onHideIfSameChange(value: boolean): void;
+    /**
+     * Mirrors the hide-if-same flag onto the durable `hide-price` block attribute
+     * read by email-service at send time.
+     */
+    _stampHideIfSameAttr(value: boolean): void;
+    /**
+     * Rebuilds the product rows so the renderer re-reads the inline/stacked
+     * layout flag from the store. Used by the orientation change only.
+     */
+    _regenerate(): void;
+    _listenToFormUpdates(): void;
+}
+export {};

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/store/recommendation.d.ts

@@ -25,6 +25,8 @@ export interface PerBlockConfigs {
     unresponsive: boolean;
     size: string;
     customAttributes: string[];
+    priceMovedToNextLine: boolean;
+    priceHideIfSameAsDiscounted: boolean;
 }
 interface PerBlockState {
     recommendationConfigs: PerBlockConfigs;

package/dist/src/extensions/Blocks/Recommendation/templates/grid/elementRenderer.d.ts

@@ -1,4 +1,5 @@
-import { type ElementRenderer } from '../utils';
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { type ElementRenderer, type CellRenderOptions } from '../utils';
 /**
  * Grid element renderer
  * Each element returns a `<td>` containing a nested table structure:
@@ -24,4 +25,15 @@ export declare const ATTRIBUTE_CELL_CLASS = "attribute-cell";
  * card-composition control so both render identical filler markup.
  */
 export declare function buildFillerCell(columnWidth: string, padding?: string): string;
+/**
+ * Renders the inline price cell used when "Move to next line" is OFF: the sale
+ * price and original price sit side by side in a single attribute cell, each
+ * keeping its own `esd-extension-block-id` + `product-*` class so the per-element
+ * style controls and the compiler keep working.
+ *
+ * `originalFirst` preserves the card-composition order (original before sale when
+ * `productOldPrice` precedes `productPrice` in the composition) so the side-by-side
+ * order matches the stacked order.
+ */
+export declare function renderInlineGridPriceCell(product: RecommendationProduct, originalFirst?: boolean, priceOptions?: CellRenderOptions, oldPriceOptions?: CellRenderOptions, cardBackgroundColor?: string): string;
 export declare const gridElementRenderer: ElementRenderer;

package/dist/src/extensions/Blocks/Recommendation/templates/grid/template.d.ts

@@ -1,5 +1,5 @@
 import type { FiltersResponse, RecommendationProduct } from '@@/Types/recommendation';
-import { type ElementRenderer, type RenderOptions } from '../utils';
+import { type ElementRenderer, type PricePlacementFlags, type RenderOptions } from '../utils';
 /**
  * Generates attribute-aligned product rows for grid layout.
  * Creates rows where each row contains one attribute type from all products.
@@ -9,7 +9,7 @@ import { type ElementRenderer, type RenderOptions } from '../utils';
  * @param composition - Array defining order of card elements
  * @returns HTML string for attribute-aligned rows
  */
-export declare function prepareGridAttributeRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions): string;
+export declare function prepareGridAttributeRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions & PricePlacementFlags): string;
 /**
  * Prepares grid product rows with attribute-aligned structure
  * Groups products into rows, then generates attribute-aligned HTML for each group
@@ -19,7 +19,7 @@ export declare function prepareGridAttributeRows(products: RecommendationProduct
  * @param composition - Array defining order of card elements
  * @returns HTML string for all product rows
  */
-export declare function prepareGridProductRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions): string;
+export declare function prepareGridProductRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions & PricePlacementFlags): string;
 /**
  * Prepares grid product rows with attribute-aligned structure.
  * Uses row-based rendering where each attribute type forms a single row across all products.
@@ -28,6 +28,6 @@ export declare function prepareGridProductRows(products: RecommendationProduct[]
  * @param composition - Array defining element order
  * @returns HTML string for product rows
  */
-export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions): string;
+export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions & PricePlacementFlags): string;
 export declare function getDefaultTemplate(recommendationId?: number): string;
 export declare function generateBlockTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: string[], mobileProductsPerRow?: number): string;

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

@@ -6,7 +6,7 @@
  */
 import type { RecommendationProduct } from '@@/Types/recommendation';
 import { type Orientation, type PrepareProductRowsOptions } from './utils';
-export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefaultProducts, spacer, sanitizeImageUrl, createBlockTemplate, toDisplayableAttributeValue, type Orientation, type PrepareProductRowsOptions, type ElementRenderer, type ProductCardGetter, type AttributeStyleTemplate, type AttributeStyleTemplates, type CellBackgroundColors, type CellAlignments, type CellClasses, type OmnibusTexts, } from './utils';
+export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefaultProducts, isSamePrice, spacer, sanitizeImageUrl, createBlockTemplate, toDisplayableAttributeValue, type Orientation, type PrepareProductRowsOptions, type ElementRenderer, type ProductCardGetter, type AttributeStyleTemplate, type AttributeStyleTemplates, type CellBackgroundColors, type CellAlignments, type CellClasses, type OmnibusTexts, } from './utils';
 /**
  * Unified function to prepare product rows for any layout.
  * Delegates to the appropriate layout-specific implementation.

package/dist/src/extensions/Blocks/Recommendation/templates/list/elementRenderer.d.ts

@@ -1,8 +1,17 @@
-import { type ElementRenderer } from '../utils';
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { type ElementRenderer, type CellRenderOptions } from '../utils';
 /**
  * List element renderer
  * - Image and Button return `<td>` cells for the 3-column layout
  * - Name and Prices return `<tr><td>` rows for the info cell table
  * All elements have esd-block-* classes for Stripo selection
  */
+/**
+ * Inline price info row used when "Move to next line" is OFF: the sale price and
+ * original price sit in two cells of one row. Each keeps its block id + class so
+ * style controls and the compiler keep working. `originalFirst` preserves the
+ * card-composition order (original before sale by default) so it matches the
+ * stacked order.
+ */
+export declare function renderInlineListPriceRow(product: RecommendationProduct, originalFirst?: boolean, priceOptions?: CellRenderOptions, oldPriceOptions?: CellRenderOptions): string;
 export declare const listElementRenderer: ElementRenderer;

package/dist/src/extensions/Blocks/Recommendation/templates/list/template.d.ts

@@ -1,5 +1,5 @@
 import type { FiltersResponse, RecommendationProduct } from '@@/Types/recommendation';
-import { type RenderOptions } from '../utils';
+import { type PricePlacementFlags, type RenderOptions } from '../utils';
 /**
  * Generates a list product card with 3-column layout
  * Uses buildElementRenderer to render Image, Info content, and Button
@@ -12,7 +12,7 @@ import { type RenderOptions } from '../utils';
  * @param composition - Array defining order of card elements
  * @returns HTML string for a single product card row
  */
-export declare function getListProductCard(product: RecommendationProduct, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions): string;
+export declare function getListProductCard(product: RecommendationProduct, composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions & PricePlacementFlags): string;
 /**
  * Prepares list product rows
  * Each product is a full-width row with 3-column layout
@@ -20,6 +20,6 @@ export declare function getListProductCard(product: RecommendationProduct, compo
  * @param composition - Array defining order of card elements
  * @returns HTML string for product rows
  */
-export declare function prepareProductRows(products: RecommendationProduct[], composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions): string;
+export declare function prepareProductRows(products: RecommendationProduct[], composition?: string[], filterList?: FiltersResponse, renderOptions?: RenderOptions & PricePlacementFlags): string;
 export declare function getDefaultTemplate(): string;
 export declare function generateBlockTemplate(products: RecommendationProduct[], title?: string, composition?: string[]): string;