@useinsider/guido 3.2.1-beta.d58ee72 → 3.3.0-beta.1778fd7

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

@@ -0,0 +1,4 @@
+export declare const useRibbonOffset: () => {
+    ribbonOffset: import("vue").Ref<number>;
+    getTopPosition: (baseTop: number) => string;
+};

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

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

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

@@ -0,0 +1,3 @@
+export declare const useCouponBlockValidator: () => {
+    validateCouponBlockTags: (html: string) => boolean;
+};

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

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

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

@@ -0,0 +1,2 @@
+import { type LegacyVariable, type MappedComposition } from './types';
+export declare function mapComposition(variables: LegacyVariable[] | undefined): MappedComposition;

package/dist/src/config/migrator/recommendation/compositionMapper.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,7 @@
+export declare function extractTitleText(block: Element): string;
+/**
+ * Card background lives on either the block (`bgcolor`/`style`) or per-card
+ * cells (`.product-card`). Returns empty string when no background is set —
+ * the caller treats that as "no segment background".
+ */
+export declare function extractCardBgColor(block: Element): string;

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,11 @@
+import type { MappedComposition } from './types';
+import type { RecommendationNodeConfig } from '@@/Extensions/Blocks/Recommendation/types/nodeConfig';
+export declare function buildBlockHtml(params: {
+    nodeConfig: RecommendationNodeConfig;
+    composition: MappedComposition;
+    cardBg: string;
+    titleText: string;
+    extraClasses?: string;
+    legacyId?: string;
+    legacyBgColor?: string;
+}): string;

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

@@ -0,0 +1,15 @@
+import type { LegacyProductConfig } from './types';
+/**
+ * `esd-dev-product-config` is double-HTML-encoded JSON: serialization
+ * escapes once to embed inside the attribute, and Stripo's templating
+ * layer escapes a second time when round-tripping. Returns `null` when
+ * the attribute is missing or unable to be parsed — the caller treats
+ * either case as an abort.
+ */
+export declare function parseLegacyConfig(block: Element): LegacyProductConfig | null;
+/**
+ * Older legacy templates omitted the canonical
+ * `ins-recommendation-v3-campaign-id` attribute but always included the
+ * `ins-recommendation-v3-block-<id>` class — fall back to scraping it.
+ */
+export declare function parseRecommendationId(block: Element): number | null;

package/dist/src/config/migrator/recommendation/parseLegacyConfig.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,7 @@
+import type { LegacyProductConfig } from './types';
+import type { CurrencyConfig, RecommendationNodeConfig } from '@@/Extensions/Blocks/Recommendation/types/nodeConfig';
+import type { LegacyRecommendationConfig } from '@@/Types/config';
+/** Defensive against missing/malformed legacy `currencySettings` — defaults are per-field, not whole-object. */
+export declare function mapCurrency(legacy: unknown): CurrencyConfig;
+export type SettingsPartial = Pick<RecommendationNodeConfig, 'recommendationId' | 'strategy' | 'productIds' | 'size' | 'shuffleProducts' | 'language' | 'currency' | 'filters' | 'layout' | 'cardsInRow' | 'mobileCardsInRow' | 'mobileLayoutEnabled' | 'previousMobileCardsInRow' | 'columnSpacing' | 'rowSpacing' | 'mobileColumnSpacing' | 'mobileRowSpacing' | 'omnibusPrice' | 'omnibusDiscount' | 'configVersion'>;
+export declare function mapSettings(recCfg: LegacyRecommendationConfig, parsed: LegacyProductConfig, id: number): SettingsPartial;

package/dist/src/config/migrator/recommendation/settingsMapper.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,5 @@
+import type { LegacyButtonTheme, LegacyImageTheme, LegacyTextTheme, MappedButtonStyle, MappedImageStyle, MappedTextStyle } from './types';
+export declare function mapTextTheme(theme: LegacyTextTheme | undefined): MappedTextStyle;
+export declare function mapButtonTheme(theme: LegacyButtonTheme | undefined): MappedButtonStyle;
+export declare function mapImageTheme(theme: LegacyImageTheme | undefined): MappedImageStyle;
+export declare function appendStyle(existing: string | undefined, addition: string | undefined): string;

package/dist/src/config/migrator/recommendation/themeMapper.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,205 @@
+/**
+ * Internal types for the legacy Recommendation block migrator.
+ *
+ * The legacy block stores its full state as a JSON blob inside the
+ * `esd-dev-product-config` HTML attribute. These interfaces describe
+ * the subset of that schema we depend on. All fields are optional —
+ * legacy data is heterogeneous and we use defensive optional chaining
+ * everywhere downstream.
+ */
+/** Per-side numeric values used by border / padding theme fields. */
+export interface LegacySides<T = number> {
+    left?: T;
+    right?: T;
+    top?: T;
+    bottom?: T;
+}
+/** Padding shape used for both desktop and mobile in legacy theme. */
+export interface LegacyPaddingViewport {
+    all?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+/** Padding object covering both desktop and mobile breakpoints. */
+export interface LegacyPadding {
+    desktop?: LegacyPaddingViewport;
+    mobile?: LegacyPaddingViewport;
+}
+/** Border-radius shape — observed in two flavours: shorthand or per-corner. */
+export interface LegacyBorderRadius {
+    /** Single shorthand value (e.g. `radius: 4`). */
+    radius?: number;
+    /** Per-corner: top-left / top-right / bottom-right / bottom-left (in px). */
+    lt?: number;
+    rt?: number;
+    rb?: number;
+    lb?: number;
+}
+/** Theme attached to text-like variables (name, prices, omnibus, custom-attr). */
+export interface LegacyTextTheme {
+    textStyle?: {
+        'font-family'?: string;
+        'font-size'?: string;
+        'font-weight'?: string;
+        'font-style'?: string;
+    };
+    textColor?: {
+        color?: string;
+    };
+    textBackgroundColor?: {
+        color?: string;
+    };
+    textPadding?: LegacyPadding;
+    textLineSpacing?: {
+        lineSpacing?: string;
+        'font-lineSpacing'?: string;
+    };
+    textAlign?: {
+        align?: string;
+    };
+    textTrimming?: boolean;
+}
+/** Theme attached to image variables. */
+export interface LegacyImageTheme {
+    imageSize?: {
+        width?: number;
+        height?: number;
+    };
+}
+/** Theme attached to the button variable. */
+export interface LegacyButtonTheme {
+    buttonStyle?: {
+        'font-family'?: string;
+        'font-size'?: string;
+        'font-weight'?: string;
+        'font-style'?: string;
+    };
+    buttonStretch?: {
+        stretched?: boolean;
+    };
+    buttonInternalPadding?: LegacyPadding;
+    buttonExternalPadding?: LegacyPadding;
+    buttonText?: {
+        text?: string;
+    };
+    buttonColor?: {
+        color?: string;
+    };
+    textButtonColor?: {
+        color?: string;
+    };
+    buttonBorder?: {
+        width?: LegacySides<number>;
+        style?: LegacySides<string>;
+        color?: LegacySides<string>;
+    };
+    buttonBorderRadius?: LegacyBorderRadius;
+    buttonAlign?: {
+        align?: string;
+    };
+}
+/** Block-level theme. */
+export interface LegacyBlockTheme {
+    blockAdapt?: {
+        adapt?: boolean;
+    };
+    blockPadding?: LegacyPadding;
+}
+/** Single composition.variable entry from `esd-dev-product-config`. */
+export interface LegacyVariable {
+    /** e.g. `p_name`, `p_button`, `p_attribute_<ts>`. */
+    variable?: string;
+    /** Marker that distinguishes custom product attributes (`'p_attribute'`). */
+    variableType?: string;
+    /** Selector legacy used to address this element in the HTML. */
+    visibilityAreaSelector?: string;
+    /** Custom-attribute value (e.g. `product_attribute.brand`). */
+    value?: string;
+    /** Whether the element is hidden in the legacy block. */
+    hidden?: boolean;
+    /** Sort order across composition entries (lower = earlier). */
+    positionIdx?: number;
+    /** Element-kind-specific theme bag. */
+    theme?: LegacyTextTheme & LegacyImageTheme & LegacyButtonTheme;
+    /** Custom attribute marker. */
+    custom?: boolean;
+}
+/** Full decoded `esd-dev-product-config` shape. */
+export interface LegacyProductConfig {
+    rowCount?: number;
+    totalCount?: number;
+    orientation?: string;
+    composition?: {
+        variables?: LegacyVariable[];
+    };
+    theme?: LegacyBlockTheme;
+}
+/** Element kind dispatched from a legacy `variable` value. */
+export type ElementKind = 'image' | 'text' | 'button' | 'custom' | 'title';
+/** Mapping output from a single legacy variable. */
+export interface MappedVariable {
+    /** Composition key (`productName`, `customAttr:brand`, …) or `__title__` for titles. */
+    key: string;
+    kind: ElementKind;
+    hidden: boolean;
+    positionIdx: number;
+    /** Original legacy variable (kept for downstream theme mapping). */
+    legacy: LegacyVariable;
+    /** For custom attrs: bare attribute name (e.g. `brand`). */
+    customAttrName?: string;
+    /** For custom attrs: full `product-attr` value (e.g. `product_attribute.brand`). */
+    customAttrValue?: string;
+}
+/** CSS style strings + attributes resolved from a single text-like theme. */
+export interface MappedTextStyle {
+    /** Inline CSS for outer `<td>` (background, padding). */
+    tdStyle: string;
+    /** Inline CSS for inner `<p>` (typography, color, line-height, text-align). */
+    pStyle: string;
+    /** Value for `<td align>` attribute, if any. */
+    align?: string;
+    /** Whether to wrap content in `<strong>`. */
+    wrapBold: boolean;
+    /** Whether to wrap content in `<em>`. */
+    wrapItalic: boolean;
+    /** True if `textTrimming: true` in theme. */
+    textTrimming: boolean;
+}
+/** Resolved button styles. */
+export interface MappedButtonStyle {
+    /** Inline CSS for outer `<td>` (external padding). */
+    tdStyle: string;
+    /** Value for `<td align>`, if any. */
+    align?: string;
+    /** Inline CSS for `<span class="es-button-border">`. */
+    spanStyle: string;
+    /** Inline CSS for `<a class="es-button">`. */
+    aStyle: string;
+    /** Button label text. */
+    text?: string;
+}
+/** Resolved image styles. */
+export interface MappedImageStyle {
+    /** Width in pixels (number form) — applied as both `width=` attr and CSS. */
+    width?: number;
+    /** Height in pixels. */
+    height?: number;
+}
+/** Per-variable mapped style bag, keyed by composition key. */
+export type PerElementStyles = Record<string, MappedTextStyle | MappedButtonStyle | MappedImageStyle | undefined>;
+/** Composition mapper output. */
+export interface MappedComposition {
+    composition: string[];
+    visibility: Record<string, boolean>;
+    customAttributes: string[];
+    /** Mapping of customAttr key → full `product-attr` value. */
+    customAttrValues: Record<string, string>;
+    /** Title variable, if present (for separate title rendering). */
+    titleVariable?: LegacyVariable;
+    /** Resolved styles per composition key. */
+    perElementStyles: PerElementStyles;
+    /** Whether *any* element had `textTrimming: true`. */
+    anyTextTrimming: boolean;
+}

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

@@ -1 +1,13 @@
-export declare function migrateRecommendation(html: string): string;
+/**
+ * Idempotent: the selector matches only blocks that have
+ * `esd-dev-product-config` AND lack `recommendation-block-v2`, so
+ * re-running on a migrated template is a no-op.
+ */
+import type { LegacyRecommendationConfig } from '@@/Types/config';
+/**
+ * Migrate all legacy Recommendation Blocks in the given HTML string.
+ * @param html              - Full template HTML.
+ * @param recommendationConfigs - Map of campaign-id → legacy config (`Record<string, LegacyRecommendationConfig>`).
+ * @returns Migrated HTML, or the original HTML if no legacy blocks exist.
+ */
+export declare function migrateRecommendation(html: string, recommendationConfigs?: Record<string, LegacyRecommendationConfig>): string;

package/dist/src/config/migrator/recommendationMigrator.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -6,11 +6,16 @@ export declare const URLS: {
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
 };
-export declare const RecommendationFeedSourceMaps: RecommendationFeedItem[];
+/**
+ * Get recommendation feed source maps lazily so translated names resolve at access time.
+ * Must be called within a Vue component context or after Pinia is initialized.
+ */
+export declare const getRecommendationFeedSourceMaps: () => RecommendationFeedItem[];
 export declare const PriceAttributes: string[];
 export declare const currencyLocationMaps: TextValueObject[];
 export declare const currencyOperators: TextValueObject[];
 export declare const currencyDecimalCounts: TextValueObject[];
+export declare const OP_ANY_OF = "||";
 export declare const operatorOptionsForStrings: TextValueObject[];
 export declare const operatorOptionsForArrayOfStrings: TextValueObject[];
 export declare const operatorOptionsForNumbers: TextValueObject[];

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

@@ -3,3 +3,9 @@ export declare const UI_EDITOR_SELECTOR = "ui-editor";
 export declare const CARD_COMPOSITION_TAB_SELECTOR = "button[role=\"tab\"][aria-label=\"Card Composition\"]";
 export declare const SETTINGS_TAB_SELECTOR = "button[role=\"tab\"][aria-label=\"Settings\"]";
 export declare const RIBBON_SELECTOR = ".in-ribbons-wrapper";
+export declare const DYNAMIC_CONTENT_BUTTON_SELECTOR = "#guido__btn-add-dynamic-content";
+export declare const AMP_TOGGLE_BUTTON_SELECTOR = ".guido__amp-toggle-html";
+export declare const AMP_TOGGLE_WRAPPER_SELECTOR = ".in-segments-wrapper";
+export declare const HEADER_SELECTOR = "[data-testid=\"guido-header\"]";
+export declare const POPOVER_LEFT_OFFSET = 158;
+export declare const POPOVER_TOP_GAP = 10;

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

@@ -12,10 +12,20 @@ export declare const URLS: {
     UNSUBSCRIBE_URL: string;
     PREFERENCES_URL: string;
 };
+export declare const PRODUCT_TYPE_URL_SEGMENTS: {
+    readonly 60: "email";
+    readonly 49: "journey";
+    readonly 97: "email";
+};
 export declare const INSIDER_ID = "iid";
-export declare const DEFAULT_UNSUBSCRIBE_GROUP: {
-    readonly name: "Global Unsubscribe";
-    readonly sendGridId: "G";
+export declare const DEFAULT_UNSUBSCRIBE_GROUP_SEND_GRID_ID = "G";
+/**
+ * Get the default unsubscribe group lazily so the translated name resolves at access time.
+ * Must be called within a Vue component context or after Pinia is initialized.
+ */
+export declare const getDefaultUnsubscribeGroup: () => {
+    name: string;
+    sendGridId: string;
 };
 export declare const UNSUBSCRIBE_PAGES_LINK = "/email/unsubscribe-pages";
 export declare const PAGE_TYPES: {

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

@@ -1,4 +1,4 @@
-declare const migrationTemplate = "\n    <td\n        align=\"left\"\n        esd-extension-block-id=\"radio-button-block\"\n        esd-handler-name=\"esd-extension-RadioButtonBlock\"\n        class=\"\n            radio-button\n            radio-button-v2\n            esd-block-ra\n            esd-radio-button-block\n            esd-extension-block\n            es-p10t\n            es-p10b\n            es-p30r\n            es-p30l\"\n    >\n        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n            <tbody>\n                <tr>\n                    <td align=\"left\" width=\"70%\" style=\"vertical-align: top;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    {-{-TITLE-}-}\n                                </tr>\n                                <tr>\n                                    {-{-DESCRIPTION-}-}\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                    <td align=\"right\" width=\"30%\" style=\"vertical-align: middle;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioYes\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;>\n                                                    </td>\n                                                {-{-YES-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioNo\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                </td>\n                                                {-{-NO-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                </tr>\n            </tbody>\n        </table>\n    </td>\n";
+declare const migrationTemplate = "\n    <td\n        align=\"left\"\n        esd-extension-block-id=\"radio-button-block\"\n        esd-handler-name=\"esd-extension-RadioButtonBlock\"\n        class=\"\n            radio-button-block\n            radio-button-v2\n            esd-block-ra\n            esd-radio-button-block\n            esd-extension-block\n            es-p10t\n            es-p10b\n            es-p30r\n            es-p30l\"\n    >\n        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n            <tbody>\n                <tr>\n                    <td align=\"left\" width=\"70%\" style=\"vertical-align: top;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    {-{-TITLE-}-}\n                                </tr>\n                                <tr>\n                                    {-{-DESCRIPTION-}-}\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                    <td align=\"right\" width=\"30%\" style=\"vertical-align: middle;\">\n                        <table cellpadding=\"0\" cellspacing=\"0\" role=\"presentation\" width=\"100%\">\n                            <tbody>\n                                <tr>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioYes\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                    </td>\n                                                {-{-YES-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                    <td width=\"50%\">\n                                        <table width=\"100%\">\n                                            <tr>\n                                                <td width=\"24\">\n                                                    <input\n                                                        type=\"radio\"\n                                                        id=\"radioNo\"\n                                                        name=\"unsubscribe\"\n                                                        data-cke-editable=\"1\"\n                                                        style=\"margin: 0px; vertical-align: middle;\">\n                                                </td>\n                                                {-{-NO-}-}\n                                            </tr>\n                                        </table>\n                                    </td>\n                                </tr>\n                            </tbody>\n                        </table>\n                    </td>\n                </tr>\n            </tbody>\n        </table>\n    </td>\n";
 /**
  * @returns The template for the default checkbox block
  */

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

@@ -63,5 +63,6 @@ export declare enum RecommendationControlId {
     CUSTOM_ATTR_PADDINGS = "recommendation-block-custom-attr-paddings-control",
     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",
     SYNC_INFO_MESSAGE = "recommendation-block-sync-info-message"
 }

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

@@ -13,10 +13,12 @@
  * product cards — changing "brand" color won't affect "rating_star" color.
  */
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CustomAttributeTextTrimControl } from './textTrim';
 /**
  * Grouped Custom Attribute Controls
  * Use this object for cleaner imports in extension.ts
  */
+export { CustomAttributeTextTrimControl } from './textTrim';
 export declare const CustomAttributeControls: {
     readonly align: {
         new (): {
@@ -102,4 +104,5 @@ export declare const CustomAttributeControls: {
             isVisible(_node: ImmutableHtmlNode): boolean;
         };
     };
+    readonly textTrim: typeof CustomAttributeTextTrimControl;
 };

package/dist/src/extensions/Blocks/Recommendation/controls/customAttribute/textTrim.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Custom Attribute Text Trim Control
+ *
+ * Per-attribute text trimming for custom product attributes.
+ * Unlike NameTextTrimControl which applies to ALL product names globally,
+ * this control is scoped to a specific custom attribute type via the
+ * `product-attr` HTML attribute — changing text-trim on "brand" won't
+ * affect "rating_star".
+ *
+ * CSS rules are shared with NameTextTrimControl via shared/textTrimCssRules.ts.
+ */
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+/**
+ * Control for enabling/disabling text trimming on individual custom attributes.
+ * Scoped per attribute type using the `product-attr` HTML attribute.
+ */
+export declare class CustomAttributeTextTrimControl extends CommonControl {
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    _getCurrentTrimState(): boolean;
+    /**
+     * Finds all custom attribute elements of the same type as the current node.
+     *
+     * Similar to getCustomAttrTargetNodes in customAttribute/index.ts, but adapted
+     * for CommonControl lifecycle where currentNode is a class property (not a
+     * parameter from Stripo's getTargetNodes override).
+     */
+    _getTargetElements(): ImmutableHtmlNode[];
+    _onTextTrimChange(enabled: boolean): void;
+    _listenToFormUpdates(): void;
+}

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

@@ -0,0 +1 @@
+export {};

package/dist/src/extensions/Blocks/Recommendation/controls/name/textTrim.d.ts

@@ -1,9 +1,9 @@
-import { ImmutableCssNode, ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 /**
- * Control for enabling/disabling text trimming on product names
+ * Control for enabling/disabling text trimming on product names.
  * When enabled, adds a CSS class that applies text-overflow: ellipsis
- * and injects the required CSS rules into the document stylesheet
+ * and injects the required CSS rules into the document stylesheet.
  */
 export declare class NameTextTrimControl extends CommonControl {
     getId(): string;
@@ -12,23 +12,6 @@ export declare class NameTextTrimControl extends CommonControl {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _setFormValues(): void;
     _getCurrentTrimState(): boolean;
-    /**
-     * Finds an existing CSS rule in the document stylesheet by exact query
-     * @param query - The CSS query to search for (uses Stripo's CSS query syntax)
-     * @returns The CSS rule node if found, undefined otherwise
-     */
-    _findCssRule(query: string): ImmutableCssNode | undefined;
-    /**
-     * Finds the .text-trim-enabled p rule by searching all text-trim rules and comparing selectors
-     * This is needed because Stripo's CSS query syntax interprets spaces as path separators
-     * @returns true if the rule exists
-     */
-    _hasParagraphRule(): boolean;
-    /**
-     * Ensures the text-trim CSS rules exist in the document stylesheet
-     * Only adds rules if they don't already exist (prevents duplicates across multiple blocks)
-     */
-    _ensureCssRulesExist(): void;
     _onTextTrimChange(enabled: boolean): void;
     _listenToFormUpdates(): void;
 }

package/dist/src/extensions/Blocks/Recommendation/controls/shared/textTrimCssRules.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared Text Trim CSS Rule Management
+ *
+ * Extracted from NameTextTrimControl to be reused by CustomAttributeTextTrimControl.
+ * Follows the same pattern as controls/mobileLayout/cssRules.ts — standalone
+ * functions that accept an API parameter, importable by any control class.
+ *
+ * The CSS rules are document-scoped (shared across all recommendation blocks).
+ * Once injected, they persist until the template is closed.
+ */
+import type { ImmutableCssNode } from '@stripoinc/ui-editor-extensions';
+import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
+export declare const CSS_CLASS_TEXT_TRIM = "text-trim-enabled";
+interface CssCapableApi {
+    getDocumentRootCssNode: () => ImmutableCssNode | null;
+    getDocumentModifier: () => {
+        modifyCss: (node: ImmutableCssNode) => {
+            appendRule: (rule: string) => void;
+        };
+        apply: (desc: ModificationDescription) => void;
+    };
+}
+/**
+ * Ensures the text-trim CSS rules exist in the document stylesheet.
+ * Only adds rules if they don't already exist (prevents duplicates across blocks).
+ * Calls getDocumentRootCssNode once and passes it to both checks.
+ */
+export declare function ensureTextTrimCssRulesExist(api: CssCapableApi): void;
+export {};

package/dist/src/extensions/Blocks/Recommendation/services/configService.d.ts

@@ -95,15 +95,23 @@ export declare class RecommendationConfigService {
      *
      * Called when a block is first created (dropped into template).
      * Can optionally merge in partial config from migration.
+     *
+     * The `wasFreshDrop` flag distinguishes a brand-new drop (no prior config)
+     * from a clone (Stripo replays the source's setNodeConfig payload before
+     * onCreated fires). Callers use this to skip side-effects already inherited
+     * from the source.
      * @example
      * // In Block.onCreated lifecycle
-     * RecommendationConfigService.initializeConfig(this.api, node);
+     * const { config, wasFreshDrop } = RecommendationConfigService.initializeConfig(this.api, node);
      * @param api - Stripo extension API with document modifier
      * @param node - The immutable HTML node to initialize
      * @param partialConfig - Optional partial config to merge with defaults
-     * @returns The initialized configuration
+     * @returns The initialized configuration and whether the node was a fresh drop
      */
-    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): RecommendationNodeConfig;
+    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): {
+        config: RecommendationNodeConfig;
+        wasFreshDrop: boolean;
+    };
     /**
      * Save complete configuration to a node
      *
@@ -119,6 +127,16 @@ export declare class RecommendationConfigService {
      *
      * Reads existing data-attributes and creates a proper node config.
      * Used when loading templates created before node config was implemented.
+     *
+     * Sources, in priority order (later overrides earlier):
+     * 1. `esd-ext-config` JSON blob — emitted by the recommendation migrator and
+     *    by hand-authored new templates. Carries the full RecommendationNodeConfig
+     *    (strategy, language, currency, filters, productIds, etc.) which the
+     *    discrete data-* attrs below cannot capture.
+     * 2. Discrete `data-*` attributes — runtime source of truth for
+     *    layout/composition/spacing; controls keep these in sync as the user
+     *    edits, so we let them override the JSON blob if they disagree.
+     * 3. `currency-*` attributes — durable currency source on the block element.
      * @param api - Stripo extension API with document modifier
      * @param node - The block node to migrate
      * @returns The migrated configuration

package/dist/src/extensions/Blocks/Recommendation/services/configService.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,5 +1,5 @@
 import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationProduct } from '@@/Types/recommendation';
-interface PerBlockConfigs {
+export interface PerBlockConfigs {
     cardsInRow: number;
     currencySettings: {
         name: string;
@@ -36,6 +36,25 @@ interface PerBlockState {
     /** Snapshot of filters taken when the drawer opens, used to revert on cancel */
     filterSnapshot: Filter[] | null;
 }
+/**
+ * Persisted-config subset used by `seedBlockUrlConfig` to reconstruct
+ * `recommendationConfigs` from a node-config JSON blob without coupling the
+ * caller to the full `RecommendationNodeConfig` shape. Separator strings are
+ * narrowed at the seed boundary.
+ */
+export interface PerBlockUrlConfig {
+    strategy: string;
+    language: string;
+    size: string;
+    productIds: string[];
+    filters: Filter[];
+    shuffleProducts: boolean;
+    currencyCode: string;
+    currencyAlignment: 'before' | 'after';
+    currencyDecimalCount: number;
+    currencyDecimalSeparator: string;
+    currencyThousandSeparator: string;
+}
 interface StoreState {
     recommendationCampaignUrls: Record<string, string>;
     activePredictiveAlgorithms: number[];
@@ -202,6 +221,21 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
      * Automatically cleaned up when removeBlockState deletes the block entry.
      */
     markBlockInitialized(id: number): void;
+    /**
+     * Seeds the URL-relevant fields of a block from a persisted node config.
+     *
+     * Used at save-time to ensure the campaign URL is built from the
+     * persisted truth (the `esd-ext-config` blob in the raw HTML) even when
+     * the user never selected the block in this editor session — without
+     * this seed, `_syncNodeConfigToStore` would never have run for that
+     * block and the store would hold default values (USD/en_US/mostPopular)
+     * instead of the real config.
+     *
+     * Creates the block entry if missing; otherwise patches only the URL-
+     * relevant subset and leaves runtime fields (e.g., `recommendedProducts`,
+     * `isInitialized`) alone.
+     */
+    seedBlockUrlConfig(id: number, config: PerBlockUrlConfig): void;
     /**
      * Patches the current block's recommendationConfigs.
      * Replaces `store.$patch({ recommendationConfigs: { ... } })` pattern.
@@ -238,6 +272,12 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     deleteFilter(filter: Filter): void;
     addFilter(filter: Filter): void;
     generateFilterQuery(): string;
+    /**
+     * Validation-only check invoked at save-CTA time. Defined as an action
+     * (not a getter) so reading it does not register reactive tracking on
+     * every block's recommendationConfigs across user edits.
+     */
+    hasInvalidBlock(): boolean;
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
 }>;