@useinsider/guido 3.19.0 → 3.20.0-beta.0849ec7

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

@@ -11,6 +11,8 @@ export declare const useConfig: () => {
             templateId: string;
             userId: string;
             variationId?: string | undefined;
+            campaignId?: string | undefined;
+            templateLibraryId?: string | undefined;
         };
         partner: {
             name: string;
@@ -41,6 +43,7 @@ export declare const useConfig: () => {
             selectedUnsubscribePages: number[];
             forceRecreate: boolean;
             trackIdCounter: number;
+            recommendationCampaignUrls?: Record<string, unknown> | undefined;
             migration: {
                 recommendationConfigs: {
                     [x: string]: {
@@ -99,6 +102,7 @@ export declare const useConfig: () => {
             autosave: boolean;
             allowlistEnabled: boolean;
             linkTrackingIds: boolean;
+            allowSaveWithErrors: boolean;
             reusableRecommendationStrategy: boolean;
         };
         blocks: {
@@ -146,6 +150,8 @@ export declare const useConfig: () => {
         templateId: string;
         userId: string;
         variationId?: string | undefined;
+        campaignId?: string | undefined;
+        templateLibraryId?: string | undefined;
     } | null>;
     partner: import("vue").ComputedRef<{
         name: string;
@@ -176,6 +182,7 @@ export declare const useConfig: () => {
         selectedUnsubscribePages: number[];
         forceRecreate: boolean;
         trackIdCounter: number;
+        recommendationCampaignUrls?: Record<string, unknown> | undefined;
         migration: {
             recommendationConfigs: {
                 [x: string]: {
@@ -234,6 +241,7 @@ export declare const useConfig: () => {
         autosave: boolean;
         allowlistEnabled: boolean;
         linkTrackingIds: boolean;
+        allowSaveWithErrors: boolean;
         reusableRecommendationStrategy: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{

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

@@ -17,12 +17,11 @@
  *   - `error` segments (and message-level `isError` / `isCancelled`) trigger
  *     a localized toaster.
  *
+ * Every apply settles into a terminal `applyAcks` entry, so cortex moves its button on the write, not the click.
+ *
  * In dev (`import.meta.env.DEV`) every observed segment + message-level flag
  * change is also `console.debug`-logged with the prefix `[guido:cortex]` so a
  * developer can watch the agent stream in real time. In production this is
  * gated behind `localStorage.guido:debug:ai === '1'`.
- *
- * If cortex-fe isn't loaded the chat store is undefined and the bridge is a
- * no-op (intentional — Guido must still work standalone).
  */
 export declare const useCortexBlueprintBridge: () => void;

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

@@ -1,4 +1,16 @@
 type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
+/**
+ * Terminal outcome of an apply; every promise here settles with one, since the bridge acks on it.
+ * `superseded`: a newer payload for the same key replaced this one and owns the ack.
+ */
+export type ApplyOutcome = {
+    status: 'applied';
+} | {
+    status: 'failed';
+    error: unknown;
+} | {
+    status: 'superseded';
+};
 /**
  * Applies email_template blueprints from the chat agent to the Stripo editor.
  *
@@ -9,18 +21,19 @@ type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
  * - manual Apply click (first apply): immediate.
  * - blueprint_update after the user has applied once: debounced 250 ms trailing
  *   so rapid mid-stream updates don't thrash updateHtmlAndCss.
+ * - a click before Stripo is ready is queued and flushed when `isStripoInitialized` flips.
  */
 export declare const useEmailTemplateApplier: () => {
     applyStatus: import("vue").Ref<Record<string, ApplyStatus>>;
-    markPending: (blueprintId: string) => void;
-    applyTemplate: (blueprintId: string, data: {
+    markPending: (key: string) => void;
+    applyTemplate: (key: string, data: {
         html?: string;
         css?: string;
-    }) => void;
-    applyTemplateDebounced: (blueprintId: string, data: {
+    }) => Promise<ApplyOutcome>;
+    applyTemplateDebounced: (key: string, data: {
         html?: string;
         css?: string;
-    }) => void;
+    }) => Promise<ApplyOutcome>;
 };
 export declare const resetEmailTemplateApplier: () => void;
 export {};

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

@@ -19,6 +19,8 @@ export declare const provideGuidoActions: (actions: {
 }) => void;
 /**
  * Provides individual Guido action handlers
+ * @deprecated No consumer in src/ and not exported from library.ts — provideGuidoActions
+ * provides all four keys itself. Slated for deletion, see the SD-667788 dead-code ledger.
  */
 export declare const provideBackHandler: (handler: BackHandler) => void;
 export declare const provideSaveStartHandler: (handler: SaveStartHandler) => void;

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

@@ -1,5 +1,12 @@
 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
@@ -27,6 +34,20 @@ 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/useHttp.d.ts

@@ -16,6 +16,7 @@ export interface HttpError {
     status?: number;
     statusText?: string;
     response?: Response;
+    authReported?: boolean;
 }
 export declare const useHttp: (defaultOptions?: HttpOptions) => {
     loading: import("vue").ComputedRef<boolean>;
@@ -65,6 +66,7 @@ export declare const useHttp: (defaultOptions?: HttpOptions) => {
             json: () => Promise<any>;
             text: () => Promise<string>;
         } | undefined;
+        authReported?: boolean | undefined;
     } | null>;
     hasError: import("vue").ComputedRef<boolean>;
     request: <T = unknown>(method: HttpMethod, url: string, data?: unknown, options?: HttpOptions) => Promise<HttpResponse<T>>;

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

@@ -0,0 +1,3 @@
+export declare const useLegacyStrategyConversion: () => {
+    convertLegacyStrategy: () => Promise<string>;
+};

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

@@ -1,4 +1,9 @@
 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<Omit<SavedTemplateDetails, "metadata" | "silent"> | undefined>;
+    save: (suppressEmit?: boolean, silent?: boolean) => Promise<SaveResult>;
+    saveWithErrors: () => Promise<SaveResult>;
+    saveRawOnly: () => Promise<SaveResult>;
 };
+export {};

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

@@ -0,0 +1,6 @@
+import type { DynamicContent } from '@@/Types/generic';
+import type { SaveValidationError } from '@@/Types/save-validation';
+export declare const useSaveValidation: () => {
+    collectSaveValidationErrors: (compiledHtml: string, dynamicContentList: DynamicContent[]) => Promise<SaveValidationError[]>;
+    validateCurrentTemplate: () => Promise<SaveValidationError[]>;
+};

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

@@ -0,0 +1,3 @@
+export declare const useSaveValidationRollout: () => {
+    isEnabled: import("vue").ComputedRef<boolean>;
+};

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

@@ -1,3 +1,6 @@
+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,4 +1,14 @@
+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/config/migrator/index.d.ts

@@ -1,2 +1,3 @@
 import type { LegacyRecommendationConfig } from '@@/Types/config';
-export declare const migrate: (html: string, recommendationConfigs?: Record<string, LegacyRecommendationConfig>) => Promise<string>;
+import { type PartnerScopeMigrationOptions } from './recommendationPartnerMigrator';
+export declare const migrate: (html: string, recommendationConfigs?: Record<string, LegacyRecommendationConfig>, partnerScope?: PartnerScopeMigrationOptions) => Promise<string>;

package/dist/src/config/migrator/recommendationPartnerMigrator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Empties recommendation blocks copied in from another account and stamps the
+ * current one, before the editor ever sees the template (SD-151945).
+ *
+ * Runs at load rather than on document change: the stamp makes it a one-time
+ * pass per template, the campaign-URL rule only ever applies to the loaded HTML,
+ * and Stripo takes the result as the original document, so nothing is dirtied.
+ */
+export interface PartnerScopeMigrationOptions {
+    partnerName: string;
+    /** `undefined` when the host does not pass the map — the unstamped check is then off. */
+    campaignUrls?: Record<string, unknown>;
+    rrsEnabled: boolean;
+}
+/**
+ * @param html Template HTML, already normalized by `migrateRecommendation`.
+ * @returns Migrated HTML, or the original when no block needed a reset or a stamp.
+ */
+export declare function migrateRecommendationPartnerScope(html: string, { partnerName, campaignUrls, rrsEnabled }: PartnerScopeMigrationOptions): string;

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

@@ -1,11 +1,17 @@
 import type { TextValueObject } from '@@/Types/generic';
-import type { RecommendationFeedItem } from '@@/Types/recommendation';
+import type { RecommendationFeedItem, RrsMigrationTarget } from '@@/Types/recommendation';
 export declare const URLS: {
     RECOMMENDATION_API_URL: string;
     PRODUCT_ATTRIBUTES_PATH: string;
     RECOMMENDATION_STRATEGIES_PATH: string;
     RECOMMENDATION_STRATEGIES_PANEL_PATH: string;
+    NEWSLETTER_RECOMMENDATIONS_PATH: string;
+    MIGRATE_STRATEGIES_PATH: string;
+    TEMPLATE_MIGRATE_STRATEGIES_PATH: string;
 };
+export declare const strategyCreatePath: () => string;
+export declare const strategyEditPath: (strategyId: string | number) => string;
+export declare const MIGRATION_PATHS: Record<RrsMigrationTarget['scope'], string>;
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
 };

package/dist/src/enums/save-validation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stable discriminators for each save-validation rule site — one per rule that
+ * can produce a drawer row, kept in sync with the collector + legacy validator chains.
+ */
+export declare enum SaveValidationRule {
+    CouponTagModified = "coupon-tag-modified",
+    DuplicateUnsubBlock = "duplicate-unsub-block",
+    UnsubBlockMissingTemplate = "unsub-block-missing-template",
+    LiquidSyntax = "liquid-syntax",
+    InvalidLinks = "invalid-links",
+    LinkCheckInProgress = "link-check-in-progress",
+    CustomFieldScript = "custom-field-script",
+    EmptyHtml = "empty-html",
+    MismatchedBraces = "mismatched-braces",
+    InvalidDynamicTag = "invalid-dynamic-tag",
+    InvalidCustomField = "invalid-custom-field",
+    ConditionsSyntax = "conditions-syntax",
+    WrongEqualityOperator = "wrong-equality-operator",
+    MissingIfEndif = "missing-if-endif",
+    ConditionTagSpacing = "condition-tag-spacing",
+    BracesInsideIfTag = "braces-inside-if-tag",
+    RecommendationRequiredFields = "recommendation-required-fields",
+    RecommendationFilters = "recommendation-filters",
+    InvalidImageType = "invalid-image-type",
+    CheckboxUnsubGroup = "checkbox-unsub-group",
+    RadioButtonUnsubGroup = "radio-button-unsub-group"
+}

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

@@ -0,0 +1,44 @@
+/**
+ * Single owner for the Items card orientation-dependent layout contract (SD-149368).
+ *
+ * Two things depend on a card's orientation and are written across several layers:
+ *
+ * 1. Name column width — a horizontal card lays the name in a narrow side-by-side
+ *    column, so it is capped; a vertical card gives it a full-width row.
+ * 2. Block-cell padding — the collapsible price / original-price block-cell carries its
+ *    own inter-cell spacing (horizontal cards pad left/right, vertical cards pad
+ *    top/bottom) so a hidden element removes its own spacing instead of leaving a gap.
+ *
+ * Every layer that writes these — template render, layouts/horizontal.html,
+ * NameTrimmingControl (trimming toggle) and settingsControl (orientation change) — MUST
+ * derive them here, or a migrated / re-toggled card silently drifts out of sync with
+ * freshly generated markup (convention B1: cross-layer literals live in one module).
+ */
+export declare const NAME_HORIZONTAL_MAX_WIDTH = "130px";
+export declare const NAME_VERTICAL_MAX_WIDTH = "100%";
+/** Name max-width for a card orientation. Non-horizontal (incl. undefined) → full width. */
+export declare const nameMaxWidthFor: (orientation?: string) => string;
+/** Orientation-dependent inter-cell padding classes for a collapsible block-cell. */
+export declare const BLOCK_CELL_PADDING: {
+    readonly VERTICAL: "es-p5b es-p5t";
+    readonly HORIZONTAL: "es-p5l es-p5r";
+};
+/**
+ * Attribute the block-cell carries to mark its LAYOUT-owned padding orientation ('v'|'h').
+ * The orientation toggle keys off this marker so it only ever rewrites the padding the
+ * layout itself baked — a user's own es-p* padding classes are never matched or clobbered
+ * (SD-149368 F1), and a cell without the marker is left untouched rather than mis-swapped.
+ */
+export declare const BLOCK_CELL_PAD_ATTR = "data-items-cell-pad";
+/** Marker attribute (`data-items-cell-pad="v|h"`) for a block-cell in the given orientation. */
+export declare const blockCellPadMarker: (isVertical: boolean) => string;
+/** Padding classes (leading space included) for a block-cell in the given orientation. */
+export declare const blockCellPaddingFor: (isVertical: boolean) => string;
+/**
+ * Rewrites a block-cell's LAYOUT-owned padding classes to the target orientation, keyed off
+ * the BLOCK_CELL_PAD_ATTR marker. The orientation-change rebuild re-injects existing cells
+ * via getOuterHTML(), which still carry the previous orientation's padding — swap only the
+ * layout pair (and flip the marker) so price/original-price cells stay padded after a toggle
+ * (SD-149368 F3), while a user's own padding and any unmarked cell are left alone (F1).
+ */
+export declare const reorientBlockCellPadding: (html: string, toVertical: boolean) => string;

package/dist/src/extensions/Blocks/Items/enums/productEnums.d.ts

@@ -39,14 +39,17 @@ export declare const productPairs: {
             CART_ITEMS: {
                 ATTR: string;
                 DEFAULT: string;
+                LEGACY_DEFAULTS: readonly string[];
             };
             BROWSED_ITEMS: {
                 ATTR: string;
                 DEFAULT: string;
+                LEGACY_DEFAULTS: readonly string[];
             };
             PURCHASED_ITEMS: {
                 ATTR: string;
                 DEFAULT: string;
+                LEGACY_DEFAULTS: readonly string[];
             };
         };
         price: {

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

@@ -37,6 +37,25 @@ type TemplateParameters = {
     /** Price orientation within the card ('vertical' = stacked, 'horizontal' = side-by-side) */
     priceOrientation?: PriceOrientationType;
 };
+/**
+ * Applies price orientation styles to the generated HTML template.
+ *
+ * For Vertical Layout:
+ * - vertical price orientation: both cells 100% (stacked)
+ * - horizontal price orientation with both visible: both cells 50% (side-by-side)
+ * - horizontal price orientation with one hidden: visible cell 100%
+ *
+ * For Horizontal Layout:
+ * - horizontal price orientation: .horizontal-price visible, .vertical-price hidden
+ * - vertical price orientation: .horizontal-price hidden, .vertical-price visible
+ * @param html - The HTML template string with placeholders replaced
+ * @param layoutOrientation - The card layout orientation ('vertical' or 'horizontal')
+ * @param priceOrientation - The price orientation within the card ('vertical' or 'horizontal')
+ * @param isPriceVisible - Whether the price element is visible
+ * @param isOriginalPriceVisible - Whether the original price element is visible
+ * @returns HTML string with price orientation styles applied
+ */
+export declare const applyPriceOrientationStyles: (html: string, layoutOrientation: OrientationType, priceOrientation: PriceOrientationType, isPriceVisible?: boolean, isOriginalPriceVisible?: boolean) => string;
 /**
  * Generates the default template for the Items Block.
  * @param params - Template parameters including orientation, items type, item ID, and formatting options

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

@@ -15,6 +15,8 @@ export declare class RecommendationBlock extends Block {
      * This avoids generating a new (different) ID in onCreated().
      */
     private _pendingBlockId;
+    /** Ids already reset under their new name, so the deferred pass skips their stale snapshot. */
+    private _resetSourceIds;
     constructor();
     getId(): string;
     getIcon(): string;
@@ -73,6 +75,14 @@ export declare class RecommendationBlock extends Block {
      * in the document and finding the maximum existing ID + 1.
      */
     private _generateNextId;
+    /**
+     * Drops the "already fetched" claims of a block that arrived holding a baked id
+     * (saved module, paste, duplicate), so the settings panel reads its strategy again.
+     *
+     * Deferred a tick: the collision handlers rename a sibling first, and either sibling can be
+     * the renamed one depending on where the module was dropped (SD-149916).
+     */
+    private _scheduleArrivalReset;
     /**
      * Heals a duplicate that slipped past the create-time `_detectDuplicate`
      * scan (or that was persisted by an older template before SD-142352).

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,8 @@ 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 legacyConversion;
     private storeUnsubscription;
     private listeners;
     private lastPaintedState;
@@ -9,6 +11,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;