@useinsider/guido 3.17.0-beta.8dc8fbb → 3.17.0-beta.a0d17c2

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/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/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/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
@@ -70,10 +74,16 @@ export declare const ATTR_DATA_CUSTOM_ATTRIBUTES = "data-custom-attributes";
 export declare const ATTR_DATA_CARD_COMPOSITION = "data-card-composition";
 /** HTML attribute on <td> elements identifying the product attribute for compiler template variable generation */
 export declare const ATTR_PRODUCT_ATTR = "product-attr";
+/** Class every composition attribute row carries — the visibility toggle and the compiler both key on it */
+export declare const CSS_CLASS_ATTRIBUTE_ROW = "recommendation-attribute-row";
 /** Row wrapper of one composition entry inside a product card */
 export declare const SELECTOR_ATTRIBUTE_ROW = ".recommendation-attribute-row";
 /** HTML attribute on an attribute row holding its composition key */
 export declare const ATTR_DATA_ATTRIBUTE_TYPE = "data-attribute-type";
+/** HTML attribute on an attribute row holding its visibility (`1` / `0`) */
+export declare const ATTR_DATA_VISIBILITY = "data-visibility";
+/** Class on the spacer cell of the row that trails a title */
+export declare const CSS_CLASS_SPACER = "spacer";
 /** Prefix `resolveProductAttrValue` puts on custom (non-default) product attributes in `product-attr` values */
 export declare const PRODUCT_ATTRIBUTE_PREFIX = "product_attribute.";
 /**

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

@@ -33,6 +33,8 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     private _normalizeComposition;
     private _readCustomAttributesFromNode;
     private _readVisibilityFromRows;
+    private _withTitlePresence;
+    private _hasTitle;
     private _getDefaultVisibilities;
     private _extractVisibilityFromRows;
     private _parseVisibilityValue;
@@ -187,6 +189,15 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _buildCompositionHtml;
     private _applyVisibilityToBlock;
+    private _applyTitleVisibilityToBlock;
+    private _resolveTitleInjection;
+    private _readTitleHtml;
+    private _findTitleRows;
+    private _findTitleRowsByClass;
+    private _isSpacerRow;
+    private _findTitleContainerBody;
+    private _readInnerHtml;
+    private _defaultTitleParagraph;
     /**
      * Finds the composition array index for the Nth custom attribute (0-based).
      * Scans left-to-right, counting only entries with the custom prefix.

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

@@ -11,6 +11,7 @@
  */
 export { RecommendationBlockControl, CONTROL_BLOCK_ID, AlgorithmControl, ALGORITHM_CONTROL_ID, LocaleControl, LOCALE_CONTROL_ID, CurrencyControl, CURRENCY_CONTROL_ID, ProductCountControl, PRODUCT_COUNT_CONTROL_ID, ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID, FiltersControl, FILTERS_CONTROL_ID, ShuffleControl, SHUFFLE_CONTROL_ID, LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID, PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID, } from './main';
 export * from './main/utils';
+export { TitleControls } from './title';
 export { NameControls } from './name';
 export { PriceControls } from './price';
 export { OldPriceControls } from './oldPrice';

package/dist/src/extensions/Blocks/Recommendation/controls/main/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
      *