@useinsider/guido 3.17.0 → 3.18.0

package/dist/src/components/organisms/extensions/recommendation/StrategyInfoBoxContent.vue.d.ts

@@ -0,0 +1,15 @@
+import type { RrsStrategy } from '@@/Types/recommendation';
+type __VLS_Props = {
+    strategy: RrsStrategy;
+};
+declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -99,6 +99,7 @@ export declare const useConfig: () => {
             autosave: boolean;
             allowlistEnabled: boolean;
             linkTrackingIds: boolean;
+            reusableRecommendationStrategy: boolean;
         };
         blocks: {
             excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
@@ -233,6 +234,7 @@ export declare const useConfig: () => {
         autosave: boolean;
         allowlistEnabled: boolean;
         linkTrackingIds: boolean;
+        reusableRecommendationStrategy: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{
         excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];

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

@@ -0,0 +1,18 @@
+import type { ModuleAddData, ModuleModifier } from '@@/Types/stripo';
+export declare const UNRESOLVED_DYNAMIC_CONTENT_ON_DROP_KEY = "dynamic-content.unresolved-attributes-on-drop";
+/**
+ * Repairs saved modules as they are dropped or copied into the editor, in one pass
+ * over the module HTML. Two independent repairs run through a single write-back:
+ *
+ * - Dynamic content: saved modules serialize merge-tag chips by their display label
+ *   (`{{ Phone Number }}`); this maps them back to their canonical token
+ *   (`{{phone_number}}`) using the account's dynamic-content list.
+ * - Items currency: v2 Items blocks can carry price `data-curency` /
+ *   `data-currency_symbol` attrs that drifted from their `esd-ext-config`; these are
+ *   healed from config (the export contract reads those exact attrs).
+ *
+ * Wired into Stripo via the `onModuleAdd` init callback (see `useStripo`).
+ */
+export declare const useModuleRepair: () => {
+    handleModuleAdd: (data: ModuleAddData, modifier: ModuleModifier) => void;
+};

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

@@ -18,6 +18,7 @@ export declare const useRecommendation: () => {
     getRecommendationCampaignData: (id: string) => CampaignData;
     buildCampaignUrl: (campaignId: string, overrides?: {
         strategy: string;
+        strategyId: string;
         language: string;
         currencyCode: string;
         size: string;

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

@@ -1,4 +1,6 @@
 import type { SyncModuleExtractResult } from '@@/Types/events';
+export declare const SYNC_MODULE_CLASS = "esd-synchronizable-module";
+export declare const SYNC_MODULE_SELECTOR = ".esd-synchronizable-module";
 export declare const useSyncModuleExtractor: () => {
     extractSyncModuleData: (html: string) => SyncModuleExtractResult;
 };

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

@@ -0,0 +1,3 @@
+export declare const useSyncModuleBlockValidator: () => {
+    validateSyncModuleBlocks: (rawHtml: string, silent?: boolean) => boolean;
+};

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

@@ -1,4 +1,12 @@
 export declare function extractTitleText(block: Element): string;
+/**
+ * Fallback for legacy configs that carry no `p_recommendation_title` variable:
+ * the rendered HTML decides. A missing or `display: none` title container means
+ * the user never saw a title, so the migrated block keeps it toggled off.
+ * @param block - The legacy recommendation block element
+ * @returns True when the legacy block renders a visible title
+ */
+export declare function hasVisibleTitle(block: Element): boolean;
 /**
  * Card background lives on either the block (`bgcolor`/`style`) or per-card
  * cells (`.product-card`). Returns empty string when no background is set —

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

@@ -8,5 +8,6 @@ export declare const ACADEMY_LINKS: {
     readonly EMAIL_EDITOR: "https://academy.insiderone.com/docs/email-drag-and-drop-editor";
     readonly GLOBAL_UNSUBSCRIBE: "https://academy.insiderone.com/docs/global-unsubscribe-preference-center";
     readonly AMP_FOR_EMAILS: "https://academy.insiderone.com/docs/amp-for-emails";
+    readonly EMAIL_RECOMMENDATION_BLOCK: "https://academy.insiderone.com/docs/new-editor-email-recommendation-block";
 };
 export type AcademyLinkKey = keyof typeof ACADEMY_LINKS;

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

@@ -1,4 +1,5 @@
 export declare const DEFAULT_LOCALE = "tr-TR";
+export declare const DOTTED_DATE_LOCALE = "tr-TR";
 export declare const DEFAULT = "default";
 export declare const DEFAULT_TZ = "UTC";
 export declare const FORMAT_MAPPING: Record<string, string>;

package/dist/src/enums/extensions/recommendationBlock.d.ts

@@ -3,6 +3,8 @@ import type { RecommendationFeedItem } from '@@/Types/recommendation';
 export declare const URLS: {
     RECOMMENDATION_API_URL: string;
     PRODUCT_ATTRIBUTES_PATH: string;
+    RECOMMENDATION_STRATEGIES_PATH: string;
+    RECOMMENDATION_STRATEGIES_PANEL_PATH: string;
 };
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;

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

@@ -16,6 +16,10 @@ export declare const BLOCK_ID: BlockId;
  * - Onboarding support
  */
 export declare class ItemsBlock extends Block {
+    /** Block instances whose currency attrs were already self-healed this session (SD-147588 — undo-safe). */
+    private _currencyHealed;
+    /** blockInstanceIds already claimed by a live block this session (SD-147588 collision detection). */
+    private _seenInstanceIds;
     getId(): string;
     getIcon(): string;
     getBlockCompositionType(): BlockCompositionType;
@@ -42,4 +46,35 @@ export declare class ItemsBlock extends Block {
      * relies on this td-level fallback in pairProductVariables.
      */
     private _stampProductTdDomAttributes;
+    /**
+     * Whether a currency self-heal pass should run for this block (SD-147588). The only gate here is
+     * once-per-session: heal each instance at most once, so the auto-fix can't fight undo (undo
+     * re-drifts the attr, which would otherwise re-trigger the heal forever). The position-vs-symbol
+     * authority split lives in `_reconcileCurrencyDomAttributes` — position is always authoritative,
+     * the symbol write alone is skipped for the 'USD' sentinel — so we must NOT gate the whole pass
+     * on symbol customization here, or a default-symbol block with a toggled location never heals.
+     */
+    private _shouldReconcileCurrency;
+    /** Marks a block instance's currency as reconciled so it is not healed again (undo-safe). */
+    private _markCurrencyHealed;
+    /**
+     * Resolves the id for a just-created block to one that is unique per live instance.
+     * A saved module serializes its blockInstanceId, so every re-drop of the same module
+     * arrives with an id already owned by a live instance — reusing it collides both the
+     * currency heal guard and settings-panel switch detection. Mint a fresh id on absence
+     * or collision, otherwise keep the existing one. Registers the result as claimed.
+     */
+    private _resolveInstanceId;
+    /**
+     * Stamps the export-read currency attrs onto every price `<p>` from config, so a template whose
+     * attrs drifted (e.g. a location toggle before the sync fix) self-heals to match the editor.
+     * Config is the source of truth — never derive from visible text.
+     *
+     * Authority split lives in `currencyAttrTargets` (SD-147588) — position only when a location
+     * is recorded, symbol only when customized — so this heal and the module-drop repair can't drift.
+     *
+     * Returns true only when an attr actually changed, so the caller can skip an empty apply that
+     * would otherwise re-trigger onDocumentChanged and loop.
+     */
+    private _reconcileCurrencyDomAttributes;
 }

package/dist/src/extensions/Blocks/Items/constants/currency.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Single owner for the Items price currency export contract (SD-147588).
+ *
+ * `data-curency` is deliberately misspelled (one `r`) — it is the attribute the
+ * server-side export transform (pairProductVariables) actually reads, so every
+ * layer that writes it and the live reader (template, controls, block self-heal,
+ * pairProductVariables) MUST go through these constants. A typo fix or mapping change
+ * in one of them would otherwise silently break sync with the others and ship the wrong
+ * currency position/token to the inbox. Mirrors the Recommendation block's `CURRENCY_ATTR`.
+ *
+ * Exception: the legacy migrator reads the raw misspelled string on purpose — it parses
+ * old templates frozen with that exact attr name, so it must NOT follow a future rename here.
+ */
+export declare const ITEMS_CURRENCY_ATTR: {
+    readonly POSITION: "data-curency";
+    readonly SYMBOL: "data-currency_symbol";
+};
+/** Currency location select value `'1'` = after (price then symbol), anything else = before. */
+export declare function currencyPositionFromLocation(location: string | undefined): 'after' | 'before';
+/**
+ * Whether a currency symbol is a partner customization vs the 'USD' default sentinel (SD-144644).
+ * The default value means "use the catalog currency", so it is treated as NOT customized — the one
+ * rule shared by the export transform (pairProductVariables) and the block self-heal, kept here so
+ * the two layers can never drift. Trims first so a whitespace-only value is not read as custom.
+ */
+export declare function isCustomCurrencySymbol(symbol: string | null | undefined): boolean;
+export interface CurrencyAttrTargets {
+    /** Desired `data-curency`; `undefined` = leave the DOM attr as-is (no location recorded). */
+    position?: 'before' | 'after';
+    /** Desired `data-currency_symbol`; `undefined` = leave it (empty / the 'USD' sentinel). */
+    symbol?: string;
+}
+/**
+ * The single authority rule for which price currency attrs a config wants written,
+ * shared by the block self-heal (Items/block.ts) and the module-drop repair
+ * (itemsCurrencyRepair) so the two can never drift (SD-147588). Position is authoritative
+ * only when a location is explicitly recorded (an absent value is "unknown", not 'before');
+ * the symbol is written only for a custom value (never the 'USD' default sentinel).
+ */
+export declare function currencyAttrTargets(config: {
+    priceCurrencyLocation?: string;
+    priceCurrencySymbol?: string;
+}): CurrencyAttrTargets;

package/dist/src/extensions/Blocks/Items/utils/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Block root selector — the container Stripo stamps on every v2 Items block.
+ * Legacy (`.esd-cart-items-block` &co.) is deliberately out of scope: it is
+ * normalized to v2 by `itemsBlockMigrator` at template load.
+ */
+export declare const ITEMS_BLOCK_SELECTOR = ".items-block-v2";

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

@@ -8,6 +8,8 @@
  * - Merging partial updates with existing config
  */
 import type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig } from '../types/nodeConfig';
+export declare const PRE_RRS_CONFIG_VERSION = 1;
+export declare const CURRENT_CONFIG_VERSION = 2;
 /**
  * Default currency configuration
  * Uses USD as the base currency with standard formatting
@@ -32,6 +34,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>;
 /**
@@ -47,9 +50,3 @@ export declare const DEFAULT_NODE_CONFIG: RecommendationNodeConfig;
  * View Together and Purchase Together algorithms are disabled because these require product id.
  */
 export declare const EXCLUDED_ALGORITHM_IDS: number[];
-/**
- * Current configuration version
- * Increment this when making breaking changes to the schema
- * Used for migration detection
- */
-export declare const CURRENT_CONFIG_VERSION = 1;

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';
+export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, PRE_RRS_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
@@ -68,12 +72,20 @@ export declare const ATTR_CUSTOM_PREFIX = "customAttr:";
 export declare const ATTR_DATA_CUSTOM_ATTRIBUTES = "data-custom-attributes";
 /** HTML data attribute on the block root holding the comma-joined composition order */
 export declare const ATTR_DATA_CARD_COMPOSITION = "data-card-composition";
+/** HTML attribute on the block root carrying its per-document unique id */
+export declare const RECOMMENDATION_ID_ATTR = "recommendation-id";
 /** 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/index.d.ts

@@ -9,8 +9,9 @@ import { PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID } from './pricePlacem
 import { ProductCountControl, PRODUCT_COUNT_CONTROL_ID } from './productCount';
 import { ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID } from './productLayout';
 import { ShuffleControl, SHUFFLE_CONTROL_ID } from './shuffle';
+import { StrategyControl, STRATEGY_CONTROL_ID } from './strategy';
 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, PricePlacementControl, PRICE_PLACEMENT_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, StrategyControl, STRATEGY_CONTROL_ID, };
 export * from './utils';
 /**
  * Main recommendation block control that composes all sub-controls
@@ -19,7 +20,9 @@ export * from './utils';
 export declare class RecommendationBlockControl extends CommonControl {
     private store;
     private storeUnsubscription;
-    private syncedBlockIds;
+    private syncedConfigs;
+    private pendingNodeConfigWrite;
+    private pendingConfigFlushTimer;
     private algorithmControl;
     private localeControl;
     private currencyControl;
@@ -29,8 +32,12 @@ export declare class RecommendationBlockControl extends CommonControl {
     private shuffleControl;
     private pricePlacementControl;
     private layoutOrientationControl;
+    private strategyControl;
+    private rrsEnabled;
     getId(): string;
+    private get _subControls();
     getTemplate(): string;
+    private _showControlsForBlock;
     onRender(): Promise<void>;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
@@ -42,7 +49,6 @@ export declare class RecommendationBlockControl extends CommonControl {
     /**
      * Syncs persisted node config into the Pinia store's block state.
      *
-     * setCurrentBlock() creates a default entry (USD, en_US, mostPopular).
      * For saved templates, the real config lives in the node (e.g., TRY, tr_TR).
      * This method reads it and patches the store so fetchRecommendationProducts()
      * uses the correct values.
@@ -50,6 +56,41 @@ export declare class RecommendationBlockControl extends CommonControl {
      * Uses triggerRefetch: false because the fetch hasn't happened yet —
      * values are being prepared for the upcoming initial fetch.
      */
+    /**
+     * Re-syncs the store when the node config moved since we last read it.
+     *
+     * Undo/redo, the code editor and version-history restore rewrite the node
+     * config behind the store's back — Stripo exposes no undo signal, so a
+     * fingerprint diff on this hook is the only way to notice (SD-149105).
+     * An unchanged fingerprint means the move came from us, so runtime store
+     * edits are never clobbered (SD-141049).
+     */
+    private _syncNodeConfigIfChanged;
+    private _capturePendingNodeConfigWrite;
+    /**
+     * Accumulates the pending write into `documentModifier` without applying, so the
+     * caller's apply() commits config and re-render as ONE undo entry.
+     *
+     * Deliberately does not consume the pending record: the product helpers call
+     * apply() only when they actually changed something, so this batch may never be
+     * committed and the flush has to stay able to write it standalone.
+     * @param documentModifier - The batch to accumulate into
+     * @returns Whether anything was staged
+     */
+    private _stagePendingNodeConfig;
+    /**
+     * Arms the guaranteed fallback write, once the product fetch has settled. The
+     * delay only has to outlast the re-render debounce that fetch triggers — firing
+     * earlier writes the config on its own and the undo entry splits in two again.
+     */
+    private _scheduleConfigFlush;
+    private _clearConfigFlush;
+    /**
+     * Writes the deferred change standalone when the batch it was staged into never
+     * committed. Always targets the LIVE node — the captured one is an immutable
+     * snapshot the intervening re-render staled, and saveConfig swallows that failure.
+     */
+    private _flushPendingNodeConfig;
     private _syncNodeConfigToStore;
     /**
      * Fetches initial data for a block in three phases:
@@ -106,9 +147,4 @@ export declare class RecommendationBlockControl extends CommonControl {
      * We skip that tick and update tracking references instead.
      */
     private _listenStateUpdates;
-    /**
-     * Persists the current filter state from Pinia store to the Stripo node config.
-     * This ensures filters survive template save/reload cycles.
-     */
-    private _persistFiltersToNodeConfig;
 }

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

@@ -0,0 +1,16 @@
+import { CommonControl } from '../../../common-control';
+export declare const STRATEGY_CONTROL_ID = "recommendation-strategy-control";
+export declare class StrategyControl extends CommonControl {
+    private store;
+    private storeUnsubscription;
+    private listeners;
+    private lastPaintedState;
+    getId(): string;
+    getTemplate(): string;
+    private _strategyAction;
+    onRender(): void;
+    onDestroy(): void;
+    private _teardown;
+    private _setupButtonListeners;
+    private _renderState;
+}

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

@@ -25,7 +25,7 @@ import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
  * Stripo Extension API interface for document modifications
  * Extracted to allow type-safe usage without importing full Stripo types
  */
-interface DocumentModifier {
+export interface DocumentModifier {
     modifyHtml: (node: ImmutableHtmlNode) => {
         setNodeConfig: (config: Record<string, unknown>) => DocumentModifier;
         setAttribute: (name: string, value: string) => DocumentModifier;
@@ -90,6 +90,17 @@ export declare class RecommendationConfigService {
      * @returns The new complete configuration
      */
     static updateConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, updates: PartialNodeConfig, description: string): RecommendationNodeConfig;
+    /**
+     * Accumulate a config update into an existing modifier batch, WITHOUT applying.
+     *
+     * The caller owns the apply(), so the write shares one undo entry with the rest
+     * of that batch — a change whose visible result only lands after an async product
+     * fetch would otherwise cost the user two undo presses (SD-149105).
+     * @param documentModifier - The batch to accumulate into (caller applies)
+     * @param node - The immutable HTML node to write to
+     * @param updates - Partial config with values to update
+     */
+    static stageConfig(documentModifier: DocumentModifier, node: ImmutableHtmlNode, updates: PartialNodeConfig): void;
     /**
      * Initialize configuration for a new block
      *