@useinsider/guido 3.17.0-beta.668ca65 → 3.17.0-beta.6b602e7

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

@@ -34,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>;
 /**

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, 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

@@ -20,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;
@@ -54,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:
@@ -110,11 +147,4 @@ export declare class RecommendationBlockControl extends CommonControl {
      * We skip that tick and update tracking references instead.
      */
     private _listenStateUpdates;
-    /**
-     * Persists filter + strategy state to the Stripo node config so it survives
-     * save/reload (strategyId must reach esd-ext-config before any save).
-     * `size` rides along: assigning a strategy writes it to the store only, and a
-     * stale node config would rebuild the block against the old slot count.
-     */
-    private _persistFiltersToNodeConfig;
 }

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

@@ -2,6 +2,7 @@ import { CommonControl } from '../../../common-control';
 export declare const STRATEGY_CONTROL_ID = "recommendation-strategy-control";
 export declare class StrategyControl extends CommonControl {
     private store;
+    private legacyConversion;
     private storeUnsubscription;
     private listeners;
     private lastPaintedState;

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
      *

package/dist/src/extensions/Blocks/Recommendation/store/recommendation.d.ts

@@ -1,4 +1,4 @@
-import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationCampaignUrlValue, RecommendationProduct, RrsStrategy } from '@@/Types/recommendation';
+import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationCampaignUrlValue, RecommendationProduct, RrsMigrationPayload, RrsStrategy } from '@@/Types/recommendation';
 export interface PerBlockConfigs {
     cardsInRow: number;
     currencySettings: {
@@ -22,6 +22,7 @@ export interface PerBlockConfigs {
     shuffleProducts: boolean;
     strategy: string;
     strategyId: string;
+    nodeConfigVersion: number;
     textTrimming: boolean;
     unresponsive: boolean;
     size: string;
@@ -35,11 +36,14 @@ interface PerBlockState {
     filterStatus: boolean;
     filterSelectionDrawerStatus: boolean;
     assignStrategyDrawerStatus: boolean;
+    removeStrategyModalStatus: boolean;
+    legacyStrategyUpdatedModalStatus: boolean;
     filterGroup: number;
     /** Whether initial API data (filters, algorithms, products) has been fetched for this block */
     isInitialized: boolean;
     /** Snapshot of filters taken when the drawer opens, used to revert on cancel */
     filterSnapshot: Filter[] | null;
+    legacyConversionLoading: boolean;
 }
 /**
  * Persisted-config subset used by `seedBlockUrlConfig` to reconstruct
@@ -177,6 +181,76 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         currentRecommendationId: number | null;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
+    removeStrategyModalStatus(state: {
+        recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
+        activePredictiveAlgorithms: number[];
+        languages: Languages;
+        currencyList: {
+            text: string;
+            value: string;
+        }[];
+        filterList: FiltersResponse;
+        strategies: {
+            [x: string]: unknown;
+            strategy_id: number;
+            name: string;
+            status: string;
+            suitable_channels: string;
+            size?: (number | string) | undefined;
+        }[];
+        strategiesLoading: boolean;
+        strategyUrlTemplates: Record<string, string>;
+        blockStates: Record<number, PerBlockState>;
+        currentRecommendationId: number | null;
+        configVersion: number;
+    } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
+    isLegacyStrategyBlock(): boolean;
+    legacyConversionLoading(state: {
+        recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
+        activePredictiveAlgorithms: number[];
+        languages: Languages;
+        currencyList: {
+            text: string;
+            value: string;
+        }[];
+        filterList: FiltersResponse;
+        strategies: {
+            [x: string]: unknown;
+            strategy_id: number;
+            name: string;
+            status: string;
+            suitable_channels: string;
+            size?: (number | string) | undefined;
+        }[];
+        strategiesLoading: boolean;
+        strategyUrlTemplates: Record<string, string>;
+        blockStates: Record<number, PerBlockState>;
+        currentRecommendationId: number | null;
+        configVersion: number;
+    } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
+    legacyStrategyUpdatedModalStatus(state: {
+        recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
+        activePredictiveAlgorithms: number[];
+        languages: Languages;
+        currencyList: {
+            text: string;
+            value: string;
+        }[];
+        filterList: FiltersResponse;
+        strategies: {
+            [x: string]: unknown;
+            strategy_id: number;
+            name: string;
+            status: string;
+            suitable_channels: string;
+            size?: (number | string) | undefined;
+        }[];
+        strategiesLoading: boolean;
+        strategyUrlTemplates: Record<string, string>;
+        blockStates: Record<number, PerBlockState>;
+        currentRecommendationId: number | null;
+        configVersion: number;
+    } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     assignedStrategy(state: {
         recommendationCampaignUrls: Record<string, RecommendationCampaignUrlValue>;
         activePredictiveAlgorithms: number[];
@@ -406,9 +480,14 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     cancelFilterDrawer(): void;
     openAssignStrategyDrawer(): void;
     closeAssignStrategyDrawer(): void;
+    openLegacyStrategyUpdatedModal(): void;
+    closeLegacyStrategyUpdatedModal(): void;
+    openRemoveStrategyModal(): void;
+    closeRemoveStrategyModal(): void;
     fetchStrategies(): Promise<void>;
     resolveStrategyUrlTemplate(strategy: RrsStrategy, currency: string): Promise<string>;
     assignStrategy(strategy: RrsStrategy): void;
+    convertLegacyStrategy(payload: RrsMigrationPayload): Promise<string>;
     removeStrategy(): void;
     fetchRecommendationCreateData(): Promise<void>;
     fetchRecommendationFilters(): Promise<void>;

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

@@ -0,0 +1,13 @@
+export declare const DEFAULT_TITLE_TEXT = "You May Also Like!";
+export declare const DEFAULT_TITLE_PARAGRAPH: string;
+/**
+ * Builds the two block-level title rows: the title itself and the spacer below it.
+ * Both carry the same `recommendation-attribute-row` tagging a card attribute row has,
+ * so the Card Composition toggle hides the pair together and the compiler's
+ * `[data-visibility="0"]` sweep drops both — no leading gap when the title is off.
+ * @param paragraphHtml - Full `<p>` markup rendered inside the title cell
+ * @param visible - Whether the title starts visible
+ * @param spacerHeightPx - Height of the spacer row below the title
+ * @returns HTML string with the title row followed by its spacer row
+ */
+export declare function buildTitleRows(paragraphHtml?: string, visible?: boolean, spacerHeightPx?: number): string;

package/dist/src/extensions/Blocks/Recommendation/types/nodeConfig.d.ts

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

package/dist/src/extensions/Blocks/Recommendation/utils/legacyStrategyMigration.d.ts

@@ -0,0 +1,39 @@
+import type { Filter, RrsMigrationFilterGroup, RrsMigrationPayload } from '@@/Types/recommendation';
+type FilterAttribute = {
+    value: string;
+    type: string;
+};
+/**
+ * A block authored before reusable strategies: it still carries a plain feed
+ * configuration (compiled into a feed URL string) instead of a strategy id.
+ * Blocks created under RRS stamp `CURRENT_CONFIG_VERSION`, so the version is
+ * what separates "never converted" from "not assigned yet".
+ */
+export declare function isLegacyStrategyConfig({ strategyId, nodeConfigVersion }: {
+    strategyId: string;
+    nodeConfigVersion: number;
+}): boolean;
+/**
+ * Groups the block's valid filters the way the feed URL groups them, in the
+ * shape the migration endpoint validates. The URL's filter DSL states no
+ * attribute type and cannot express a mixed-operator group, which is exactly
+ * what this override exists to supply.
+ */
+export declare function toMigrationFilterGroups(filters: Filter[], attributes: FilterAttribute[]): RrsMigrationFilterGroup[];
+interface MigrationInputs {
+    blockId: number;
+    url: string;
+    templateId: string;
+    variationId: string;
+    strategy: string;
+    productIds: string[];
+    filters: Filter[];
+    attributes: FilterAttribute[];
+}
+/**
+ * The server names and de-duplicates the strategy, so nothing here derives a
+ * name; `campaignId`/`variationId` only feed that name and fall back to 0 for
+ * templates and modules, which carry no numeric campaign.
+ */
+export declare function buildLegacyMigrationPayload({ blockId, url, templateId, variationId, strategy, productIds, filters, attributes, }: MigrationInputs): RrsMigrationPayload;
+export {};

package/dist/src/extensions/Blocks/Recommendation/utils/nodeConfigWriter.d.ts

@@ -0,0 +1,31 @@
+import type { DocumentModifier } from '../services/configService';
+import type { PartialNodeConfig } from '../types/nodeConfig';
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+interface ConfigWriterApi {
+    getDocumentModifier: () => DocumentModifier;
+    getDocumentRootHtmlNode: () => ImmutableHtmlNode;
+}
+/**
+ * Keeps a document handle alive for writes the settings panel can no longer make.
+ * Deliberately not cleared on deselect — that is the exact moment the handle is
+ * needed. It is replaced on the next render, and goes stale only if the editor
+ * itself is torn down.
+ */
+export declare function registerNodeConfigWriter(api: ConfigWriterApi): void;
+/**
+ * Commits a config change and its product re-render straight to the document,
+ * bypassing the settings panel.
+ *
+ * Host-rendered UI (the remove-strategy modal) lives outside `ui-editor`, and
+ * Stripo deselects the block on the first click that lands there — destroying the
+ * control that normally does both, before the store change even happens.
+ *
+ * Mirrors the control's regenerate routine so config and cards land in ONE undo
+ * entry, and so partner-managed blocks keep their hand-authored cells.
+ * @param description - labels the undo entry only when there are no cards to
+ * re-render; the product helpers label their own batch.
+ * @returns whether the write reached a node
+ */
+export declare function commitBlockChangeOutsidePanel(blockId: number, updates: PartialNodeConfig, products: RecommendationProduct[], description: string): boolean;
+export {};

package/dist/src/services/recommendationApi.d.ts

@@ -1,4 +1,4 @@
-import type { InitialResponse, FiltersResponse, RecommendationProduct, RecommendationProductsParams, RrsEndpointGenerateResponse, RrsStrategy } from '@@/Types/recommendation';
+import type { InitialResponse, FiltersResponse, RecommendationProduct, RecommendationProductsParams, RrsEndpointGenerateResponse, RrsMigrationPayload, RrsStrategy } from '@@/Types/recommendation';
 export declare const useRecommendationApi: () => {
     fetchRecommendationCreateData: () => Promise<InitialResponse>;
     fetchRecommendationFilters: () => Promise<FiltersResponse>;
@@ -6,4 +6,5 @@ export declare const useRecommendationApi: () => {
     fetchRecommendationProductsByUrl: (url: string) => Promise<RecommendationProduct[]>;
     fetchRecommendationStrategies: () => Promise<RrsStrategy[]>;
     generateStrategyEndpoint: (strategy: RrsStrategy, currency: string) => Promise<RrsEndpointGenerateResponse | null>;
+    migrateLegacyStrategy: (payload: RrsMigrationPayload) => Promise<string>;
 };

package/dist/src/utils/genericUtil.d.ts

@@ -25,3 +25,8 @@ export declare const getCsrfToken: () => string;
 export declare const getUrlParams: () => URLSearchParams;
 export declare const getUrlParam: (paramName: string, defaultValue?: string) => string;
 export declare const replaceString: (string?: string, values?: Record<string, string | number>, isRemoveEmptyValues?: boolean) => string;
+/**
+ * Narrows an unknown API value to a printable string; anything that is neither
+ * a string nor a number becomes ''.
+ */
+export declare const asText: (value: unknown) => string;

package/dist/static/assets/icons/filled-arrow-rising.svg.js

@@ -0,0 +1,5 @@
+const C = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12.9403 5.51003L17.6328 11.0273C17.8845 11.3769 18.0068 11.8382 17.9997 12.2963L18 12.3333C18 13.2538 17.4627 14 16.8 14H15V15C15 15.5523 14.5523 16 14 16H10C9.44772 16 9 15.5523 9 15V14H7.2C6.53726 14 6 13.2538 6 12.3333L6.00029 12.2963C5.9932 11.8382 6.11551 11.3769 6.36722 11.0273L11.0597 5.51003C11.3182 5.15101 11.6615 4.98153 12 5.00159C12.3386 4.98153 12.6818 5.15101 12.9403 5.51003Z"/><path d="M10 18C9.44772 18 9 18.4477 9 19C9 19.5523 9.44772 20 10 20H14C14.5523 20 15 19.5523 15 19C15 18.4477 14.5523 18 14 18H10Z"/></svg>
+`;
+export {
+  C as default
+};

package/dist/static/assets/icons/line-info.svg.js

@@ -0,0 +1,5 @@
+const C = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 4C14.1217 4 16.1566 4.84285 17.6569 6.34315C19.1571 7.84344 20 9.87827 20 12C20 14.1217 19.1571 16.1566 17.6569 17.6569C16.1566 19.1571 14.1217 20 12 20C9.87827 20 7.84344 19.1571 6.34315 17.6569C4.84285 16.1566 4 14.1217 4 12C4 9.87827 4.84285 7.84344 6.34315 6.34315C7.84344 4.84285 9.87827 4 12 4ZM12 5.6C10.3026 5.6 8.67475 6.27428 7.47452 7.47452C6.27428 8.67475 5.6 10.3026 5.6 12C5.6 13.6974 6.27428 15.3253 7.47452 16.5255C8.67475 17.7257 10.3026 18.4 12 18.4C13.6974 18.4 15.3253 17.7257 16.5255 16.5255C17.7257 15.3253 18.4 13.6974 18.4 12C18.4 10.3026 17.7257 8.67475 16.5255 7.47452C15.3253 6.27428 13.6974 5.6 12 5.6ZM11.496 10.448C11.928 10.448 12.264 10.552 12.496 10.768C12.736 10.976 12.848 11.248 12.848 11.584V11.688L12.824 11.944C12.816 12.064 12.8 12.176 12.776 12.28L12.736 12.432L12.288 14.024L12.248 14.152C12.1976 14.376 12.1629 14.6032 12.144 14.832C12.144 15.04 12.192 15.184 12.288 15.264C12.384 15.344 12.544 15.376 12.776 15.376C12.888 15.376 13.016 15.36 13.152 15.32L13.392 15.24L13.448 15.216L13.328 15.712L12.848 15.896L12.584 15.992L12.464 16.032C12.248 16.112 12 16.144 11.72 16.144C11.28 16.144 10.944 16.04 10.696 15.824C10.5803 15.7241 10.488 15.5998 10.4258 15.4602C10.3636 15.3205 10.3329 15.1689 10.336 15.016C10.3355 14.787 10.3624 14.5587 10.416 14.336L10.448 14.176L10.896 12.576L10.936 12.424L11 12.144C11.024 12.008 11.04 11.88 11.04 11.768C11.04 11.56 11 11.424 10.912 11.344C10.832 11.264 10.672 11.224 10.432 11.224C10.312 11.224 10.192 11.24 10.072 11.272L9.856 11.352L9.76 11.376L9.88 10.888L10.168 10.776C10.36 10.696 10.544 10.632 10.728 10.576C11 10.496 11.256 10.448 11.496 10.448ZM12.496 7.536C12.792 7.536 13.04 7.632 13.248 7.832C13.464 8.024 13.568 8.264 13.568 8.544C13.568 8.816 13.464 9.056 13.248 9.248C13.04 9.44 12.792 9.544 12.496 9.544C12.2 9.544 11.944 9.44 11.736 9.248C11.52 9.056 11.416 8.816 11.416 8.544C11.416 8.264 11.52 8.024 11.736 7.824C11.944 7.632 12.2 7.536 12.496 7.536Z"/></svg>
+`;
+export {
+  C as default
+};