@useinsider/guido 3.18.2-beta.eedafd2 → 3.18.2-beta.f42547e

package/dist/src/components/Guido.vue.d.ts

@@ -15,23 +15,7 @@ declare const _default: import("vue").DefineComponent<__VLS_WithDefaults<__VLS_T
         close: () => void;
     };
     hasChanges: import("vue").ComputedRef<boolean>;
-    saveSilent: () => Promise<{
-        dynamicContentList: import("@@/Types/generic").DynamicContent[];
-        compiledHtml: string;
-        rawHtml: string;
-        css: string;
-        ampHtml: string;
-        ampErrors: string[];
-        modules: number[];
-        recommendation: {
-            campaignUrls: Record<string, import("../@types/recommendation").RecommendationCampaignUrlValue>;
-            configs: Record<string, string>;
-        };
-        unsubscribe: {
-            status: boolean;
-            config: number[];
-        };
-    } | undefined> | undefined;
+    saveSilent: () => Promise<Omit<SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
     setLoading: (value: boolean) => void;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {
     "dynamic-content:open": (detail: {

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

@@ -1,20 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<{
-        dynamicContentList: import("../../../@types/generic.js").DynamicContent[];
-        compiledHtml: string;
-        rawHtml: string;
-        css: string;
-        ampHtml: string;
-        ampErrors: string[];
-        modules: number[];
-        recommendation: {
-            campaignUrls: Record<string, import("../../../@types/recommendation.js").RecommendationCampaignUrlValue>;
-            configs: Record<string, string>;
-        };
-        unsubscribe: {
-            status: boolean;
-            config: number[];
-        };
-    } | undefined> | undefined;
+    handleSave: (isSilent: boolean) => Promise<Omit<import("../../../@types/stripo.js").SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

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

@@ -1,20 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<{
-        dynamicContentList: import("../../../@types/generic.js").DynamicContent[];
-        compiledHtml: string;
-        rawHtml: string;
-        css: string;
-        ampHtml: string;
-        ampErrors: string[];
-        modules: number[];
-        recommendation: {
-            campaignUrls: Record<string, import("../../../@types/recommendation.js").RecommendationCampaignUrlValue>;
-            configs: Record<string, string>;
-        };
-        unsubscribe: {
-            status: boolean;
-            config: number[];
-        };
-    } | undefined> | undefined;
+    handleSave: (isSilent: boolean) => Promise<Omit<import("../../../@types/stripo.js").SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

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

@@ -1,20 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<{
-        dynamicContentList: import("../../../@types/generic.js").DynamicContent[];
-        compiledHtml: string;
-        rawHtml: string;
-        css: string;
-        ampHtml: string;
-        ampErrors: string[];
-        modules: number[];
-        recommendation: {
-            campaignUrls: Record<string, import("../../../@types/recommendation.js").RecommendationCampaignUrlValue>;
-            configs: Record<string, string>;
-        };
-        unsubscribe: {
-            status: boolean;
-            config: number[];
-        };
-    } | undefined> | undefined;
+    handleSave: (isSilent: boolean) => Promise<Omit<import("../../../@types/stripo.js").SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

package/dist/src/components/wrappers/WpDrawer.vue.d.ts

@@ -10,11 +10,11 @@ interface Props {
     status: boolean;
     titleText: string;
 }
-declare var __VLS_13: {}, __VLS_15: {};
+declare var __VLS_12: {}, __VLS_14: {};
 type __VLS_Slots = {} & {
-    headerBottomSlot?: (props: typeof __VLS_13) => any;
+    headerBottomSlot?: (props: typeof __VLS_12) => any;
 } & {
-    default?: (props: typeof __VLS_15) => any;
+    default?: (props: typeof __VLS_14) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     className: string;
@@ -26,7 +26,6 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<
     cancelOrBackButtonEvent: () => void;
     onCloseEvent: () => void;
     primaryButtonEvent: () => void;
-    secondaryButtonEvent: () => void;
 }, string, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     className: string;
     size: string;

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

@@ -99,7 +99,6 @@ export declare const useConfig: () => {
             autosave: boolean;
             allowlistEnabled: boolean;
             linkTrackingIds: boolean;
-            allowSaveWithErrors: boolean;
             reusableRecommendationStrategy: boolean;
         };
         blocks: {
@@ -235,7 +234,6 @@ export declare const useConfig: () => {
         autosave: boolean;
         allowlistEnabled: boolean;
         linkTrackingIds: boolean;
-        allowSaveWithErrors: boolean;
         reusableRecommendationStrategy: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{

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

@@ -1,12 +1,5 @@
 import type { DynamicContent } from '@@/Types/generic';
 import type { FiltersResponse } from '@@/Types/recommendation';
-/**
- * Extracts recommendation block IDs directly from the HTML by parsing
- * the recommendation-id attribute on block elements.
- * This avoids depending on store state which may not be populated
- * when the settings panel hasn't been opened yet (e.g., saved templates).
- */
-export declare function getRecommendationBlockIds(html: string): string[];
 /**
  * Parses a `{{recoId_index_attributeName}}` variable (already stripped of the
  * braces/whitespace) into its recommendation id and attribute name. Returns
@@ -34,20 +27,6 @@ export declare function buildPartnerAttributeNameSet(filterList: FiltersResponse
  * before, so flagging it would false-positive on merge tags like `{{user.name}}`.
  */
 export declare function findInvalidCustomFields(html: string, validCustomFields: string[], recommendationBlockIds: string[], ignoredIds: Set<string>, ignoredAttributeNames: Set<string> | null): string[];
-/**
- * Returns the invalid `{{ ... }}` dynamic-content tags found in the HTML.
- *
- * A tag's variable name is the part before the first `|` (everything after it is the fallback).
- * Surrounding whitespace is always allowed (trimmed). A tag is valid only when the variable name
- * is an allowed system token, or it is a clean identifier (`[A-Za-z0-9_.]`) and — when a `|` is
- * present — the fallback after it is not empty. Otherwise the tag is invalid (e.g.
- * `{{Api Response: OA1 Main Item Url}}` — spaces/`:` — or `{{bounce|}}` — empty fallback).
- *
- * `data-*` block-config attribute values are excluded from the scan: blocks such as Items/cart
- * store product merge tags (`data-product_button_link="{{Abandoned Cart Item (1) Url}}"`) that the
- * backend resolves through its own pipeline, so they must not be treated as user-authored tags.
- */
-export declare function getInvalidDynamicContentTags(html: string): string[];
 export declare const useHtmlValidator: () => {
     validateHtml: (html: string, customFields: DynamicContent[], isOnSaveValidation?: boolean) => Promise<boolean>;
 };

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

@@ -1,9 +1,4 @@
 import type { SavedTemplateDetails } from '@@/Types/stripo';
-type SaveDetails = Omit<SavedTemplateDetails, 'metadata' | 'silent'>;
-type SaveResult = SaveDetails | undefined;
 export declare const useSave: () => {
-    save: (suppressEmit?: boolean, silent?: boolean) => Promise<SaveResult>;
-    saveWithErrors: () => Promise<SaveResult>;
-    saveRawOnly: () => Promise<SaveResult>;
+    save: (suppressEmit?: boolean, silent?: boolean) => Promise<Omit<SavedTemplateDetails, "metadata" | "silent"> | undefined>;
 };
-export {};

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

@@ -1,6 +1,3 @@
-export declare const COUPON_TAG_MODIFIED_KEY = "newsletter.coupon-tag-modified";
-/** Pure core: the tag text of every coupon block whose code was modified. */
-export declare function findInvalidCouponBlocks(html: string): string[];
 export declare const useCouponBlockValidator: () => {
     validateCouponBlockTags: (html: string) => boolean;
 };

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

@@ -1,14 +1,4 @@
-declare const SINGLETON_BLOCK_RULES: {
-    pageType: number;
-    messageKey: string;
-}[];
-export declare const EMPTY_BLOCK_KEY = "unsubscription-preference.select-page-to-continue";
-/** Pure core: the singleton rules whose page type appears more than once. */
-export declare function findDuplicateUnsubPageTypes(html: string): typeof SINGLETON_BLOCK_RULES;
-/** Pure core: count of unsubscribe blocks with no page type or page list chosen. */
-export declare function countUnsubBlocksWithoutPage(html: string): number;
 export declare const useUnsubscribeBlockValidator: () => {
     validateUnsubscribeBlockUniqueness: (html: string) => boolean;
     validateUnsubscribeBlockHasTemplate: (html: string) => boolean;
 };
-export {};

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

@@ -5,7 +5,9 @@ export declare const URLS: {
     PRODUCT_ATTRIBUTES_PATH: string;
     RECOMMENDATION_STRATEGIES_PATH: string;
     RECOMMENDATION_STRATEGIES_PANEL_PATH: string;
+    RECOMMENDATION_STRATEGY_CREATE_PATH: string;
 };
+export declare const strategyEditPath: (strategyId: string | number) => string;
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
 };

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

@@ -10,6 +10,7 @@
 import type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig } from '../types/nodeConfig';
 export declare const PRE_RRS_CONFIG_VERSION = 1;
 export declare const CURRENT_CONFIG_VERSION = 2;
+export declare const RRS_CONFIG_VERSION = 2;
 /**
  * Default currency configuration
  * Uses USD as the base currency with standard formatting

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

@@ -10,4 +10,4 @@ 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_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';
+export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, PRE_RRS_CONFIG_VERSION, RRS_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

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

@@ -70,6 +70,8 @@ export declare class RecommendationBlockControl extends CommonControl {
      * state was rebuilt with (SD-150347).
      */
     private _syncNodeConfigIfChanged;
+    /** Whether the deferred write would move the node's strategyId — see the caller (SD-149916). */
+    private _isPendingStrategyIdChange;
     private _capturePendingNodeConfigWrite;
     /**
      * Accumulates the pending write into `documentModifier` without applying, so the

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 onboardingStore;
     private storeUnsubscription;
     private listeners;
     private lastPaintedState;
@@ -9,6 +10,14 @@ export declare class StrategyControl extends CommonControl {
     getTemplate(): string;
     private _strategyAction;
     onRender(): void;
+    /**
+     * Whether the document itself says this block has no strategy.
+     *
+     * Read the node, not the store: when the main control cannot resolve the block id off the
+     * node it never syncs the persisted config, so the store still holds defaults (empty
+     * strategyId) for an assigned block.
+     */
+    private _isNodeUnassigned;
     onDestroy(): void;
     private _teardown;
     private _setupButtonListeners;

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

@@ -107,7 +107,7 @@ export interface RegenerateWithStylesOptions extends Omit<RegenerateProductRowsO
  * HTML removes the need for any post-rebuild reapply pass.
  * @param options - Configuration options for regeneration
  */
-export declare function regenerateProductRowsWithStyles(options: RegenerateWithStylesOptions): void;
+export declare function regenerateProductRowsWithStyles(options: RegenerateWithStylesOptions): boolean;
 /**
  * Adjusts a products array to a target size.
  * Used by ProductLayoutControl to synchronously match products to the new size
@@ -151,6 +151,11 @@ export interface UpdateProductContentInPlaceOptions {
     currentNode: ImmutableHtmlNode | null | undefined;
     documentModifier: DocumentModifier;
     products: RecommendationProduct[];
+    /**
+     * Called when the batch was actually committed. Identical products commit nothing, which
+     * leaves anything a caller staged into the same batch unwritten unless it applies itself.
+     */
+    onApplied?: () => void;
 }
 /**
  * Updates product content in-place without regenerating HTML structure.
@@ -161,7 +166,7 @@ export interface UpdateProductContentInPlaceOptions {
  * After updating desktop, also updates mobile container to keep them in sync.
  *
  * Falls back to false when product count changed (need to add/remove elements).
- * @param options - Configuration options
+ * @param options - Configuration options; `onApplied` fires only when a batch was committed
  * @returns true if in-place update was successful, false to fall back to full regeneration
  */
 export declare function updateProductContentInPlace(options: UpdateProductContentInPlaceOptions): boolean;

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

@@ -83,8 +83,11 @@ interface StoreState {
     strategies: RrsStrategy[];
     strategiesLoading: boolean;
     strategyUrlTemplates: Record<string, string>;
+    strategiesFetched: boolean;
+    strategiesSettled: boolean;
     blockStates: Record<number, PerBlockState>;
     currentRecommendationId: number | null;
+    strategyPanelOpen: boolean;
     configVersion: number;
 }
 export declare const useRecommendationExtensionStore: import("pinia").StoreDefinition<"guidoRecommendationExtension", StoreState, {
@@ -111,8 +114,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): PerBlockConfigs;
     /**
@@ -137,8 +143,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): RecommendationProduct[];
     /**
@@ -163,8 +172,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     assignStrategyDrawerStatus(state: {
@@ -186,8 +198,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     removeStrategyModalStatus(state: {
@@ -209,8 +224,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     assignedStrategy(state: {
@@ -232,8 +250,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): RrsStrategy | null;
     /**
@@ -258,8 +279,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): boolean;
     /**
@@ -284,8 +308,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): number;
     hasFilters(): boolean;
@@ -311,8 +338,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         text: string;
@@ -337,8 +367,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         text: string;
@@ -363,8 +396,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         }[];
         strategiesLoading: boolean;
         strategyUrlTemplates: Record<string, string>;
+        strategiesFetched: boolean;
+        strategiesSettled: boolean;
         blockStates: Record<number, PerBlockState>;
         currentRecommendationId: number | null;
+        strategyPanelOpen: boolean;
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         text: string;
@@ -445,6 +481,40 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     openRemoveStrategyModal(): void;
     closeRemoveStrategyModal(): void;
     fetchStrategies(): Promise<void>;
+    invalidateStrategies(): void;
+    /**
+     * Opens a Smart Recommender strategy page in a new tab and refreshes the list every time
+     * the user comes back. `visibilitychange` only: a `focus` listener would also fire when
+     * focus merely returns from the Stripo canvas iframe to the panel, refetching and
+     * regenerating the canvas while the user never left the editor (SD-149916).
+     *
+     * Deliberately NOT one-shot: the strategy tab stays open, so a user can create a second
+     * strategy in it and come back again — a listener that disarmed on the first return would
+     * leave that one missing from the list. It disarms on the first return AFTER that tab is
+     * closed instead, so an ordinary alt-tab later in the session costs nothing. Armed only
+     * once the user actually opens a strategy page, so anyone who never does pays nothing.
+     */
+    _armStrategyPageReturn(url: string): void;
+    /**
+     * Reloads the products of the block the user is on, so an edit made in the strategy tab
+     * lands on the canvas instead of waiting for the assign drawer to be reopened.
+     *
+     * Only the selected block: the canvas regeneration is driven off the active block's
+     * product array, so refreshing an unselected block would fetch without redrawing it.
+     */
+    _refreshAssignedStrategyProducts(): Promise<void>;
+    /** Lets the editor tear the return listeners down when it unmounts. */
+    disposeStrategyPageReturn(): void;
+    /**
+     * Opens Smart Recommender's strategy creation page. Every return refreshes the list so the
+     * new strategy is offered; the user picks it themselves.
+     */
+    openStrategyCreation(): void;
+    /**
+     * Opens the strategy's edit page. Every return refreshes the list so the block reflects the
+     * edited configuration.
+     */
+    openStrategyEdit(strategyId: string | number): void;
     resolveStrategyUrlTemplate(strategy: RrsStrategy, currency: string): Promise<string>;
     assignStrategy(strategy: RrsStrategy): void;
     removeStrategy(): void;
@@ -463,10 +533,10 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
      */
     hasInvalidBlock(): boolean;
     /**
-     * Per-instance counterpart to `hasInvalidBlock`: the ids of every block
-     * that fails required-field validation, one drawer row each (SD-147430).
+     * Which required fields are missing across the design's blocks, so the save
+     * toaster can name the cause instead of always showing the generic message.
      */
-    invalidBlockIds(): string[];
+    invalidBlockFields(): string[];
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
     _doFetchStrategyProducts(blockId: number): Promise<void>;

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

@@ -0,0 +1,14 @@
+/**
+ * Writes a strategy change and its products straight to the document, without the settings panel.
+ *
+ * Every entry point is host-rendered UI outside `ui-editor`, and none of them can rely on the
+ * panel control: opening the strategy page deselects the block, so by the time the user comes back
+ * and presses Assign the control — and with it the subscription that does the node write, the
+ * product fetch and the repaint — is gone. The assignment then reaches Pinia and nothing else
+ * (SD-149916).
+ *
+ * Call AFTER the store change (`assignStrategy` / `removeStrategy`).
+ * @param description - labels the undo entry
+ * @returns whether the write reached a node
+ */
+export declare function commitStrategyChange(blockId: number, description: string): Promise<boolean>;

package/dist/src/extensions/Blocks/Recommendation/validation/requiredFields.d.ts

@@ -15,7 +15,11 @@ export interface RequiredField {
     getAvailableOptions?: (store: ExtensionStoreSlice) => string[];
     condition?: (config: PerBlockConfigs) => boolean;
 }
+/** Field key of the strategy/algorithm descriptor, used to pick the toaster message. */
+export declare const STRATEGY_FIELD_KEY = "strategy";
 export declare const REQUIRED_RECOMMENDATION_FIELDS: RequiredField[];
 export declare const RecommendationRequiredFieldsKey = "newsletter.recommendation-fill-required-fields";
+/** Shown instead of the generic message when the only thing missing is the strategy. */
+export declare const RecommendationAssignStrategyKey = "newsletter.recommendation-assign-strategy";
 export declare function getInvalidFields(config: PerBlockConfigs, store: ExtensionStoreSlice, fields?: RequiredField[]): string[];
 export declare function isConfigValid(config: PerBlockConfigs, store: ExtensionStoreSlice): boolean;