@useinsider/guido 3.17.0 → 3.18.0-beta.41e529d

package/dist/services/recommendationApi.js

@@ -1,52 +1,100 @@
-import { useHttp as d } from "../composables/useHttp.js";
-import { QUERY_PARAMS as l, URLS as u } from "../enums/extensions/recommendationBlock.js";
-const R = (o) => o.reduce(
-  (a, t, s) => (a[s] = {
-    attributeName: t.attributeName,
-    attributeJs: t.attributeJs,
-    attributeType: t.attributeType,
-    type: t.type,
-    displayName: t.displayName,
-    isFilterable: t.isFilterable
-  }, a),
+import { useHttp as y } from "../composables/useHttp.js";
+import { URLS as c, QUERY_PARAMS as u } from "../enums/extensions/recommendationBlock.js";
+const g = "[sr_strategies.status][=][active]*[sr_strategies.suitable_channels][~][EMAIL]", l = (s) => s.reduce(
+  (i, o, d) => (i[d] = {
+    attributeName: o.attributeName,
+    attributeJs: o.attributeJs,
+    attributeType: o.attributeType,
+    type: o.type,
+    displayName: o.displayName,
+    isFilterable: o.isFilterable
+  }, i),
   {}
-), f = () => {
-  const { get: o } = d(), { get: a } = d({ headers: {} }), t = "6KcLM9TwheVB1mgK";
+), _ = () => {
+  const { get: s, post: i } = y(), { get: o } = y({ headers: {} }), d = "6KcLM9TwheVB1mgK";
   return {
     fetchRecommendationCreateData: async () => {
       try {
-        return (await o("/newsletter/recommendations/create-data")).data;
-      } catch (e) {
-        throw console.error("fetchUserModalState error:", e), e;
+        return (await s(`${c.NEWSLETTER_RECOMMENDATIONS_PATH}/create-data`)).data;
+      } catch (t) {
+        throw console.error("fetchUserModalState error:", t), t;
       }
     },
     fetchRecommendationFilters: async () => {
       try {
-        const { data: e } = await o(
-          u.PRODUCT_ATTRIBUTES_PATH
-        ), n = Array.isArray(e) ? e : (e == null ? void 0 : e.data) ?? [];
-        return R(n);
-      } catch (e) {
-        throw console.error("fetchRecommendationFilters error:", e), e;
+        const { data: t } = await s(
+          c.PRODUCT_ATTRIBUTES_PATH
+        ), r = Array.isArray(t) ? t : (t == null ? void 0 : t.data) ?? [];
+        return l(r);
+      } catch (t) {
+        throw console.error("fetchRecommendationFilters error:", t), t;
       }
     },
-    fetchRecommendationProducts: async (e, n) => {
-      var i;
+    fetchRecommendationProducts: async (t, r) => {
+      var e;
       try {
-        const r = new URLSearchParams(Object.entries(n));
-        r.set(l.CLIENT_ID, t);
-        const m = decodeURIComponent(r.toString());
+        const a = new URLSearchParams(Object.entries(r));
+        a.set(u.CLIENT_ID, d);
+        const m = decodeURIComponent(a.toString());
         console.debug("🏁 Recommendation API Query:", m);
-        const c = await a(
-          `${u.RECOMMENDATION_API_URL}/v2/${e}?${m}`
+        const n = await o(
+          `${c.RECOMMENDATION_API_URL}/v2/${t}?${m}`
         );
-        return ((i = c == null ? void 0 : c.data) == null ? void 0 : i.data) ?? [];
-      } catch (r) {
-        throw console.error("fetchRecommendationProducts error:", r), r;
+        return ((e = n == null ? void 0 : n.data) == null ? void 0 : e.data) ?? [];
+      } catch (a) {
+        throw console.error("fetchRecommendationProducts error:", a), a;
       }
+    },
+    fetchRecommendationProductsByUrl: async (t) => {
+      var r;
+      try {
+        const e = new RegExp(`[?&]${u.CLIENT_ID}=`).test(t), a = t.includes("?") ? "&" : "?", m = e ? t : `${t}${a}${u.CLIENT_ID}=${d}`, n = await o(
+          m
+        );
+        return ((r = n == null ? void 0 : n.data) == null ? void 0 : r.data) ?? [];
+      } catch (e) {
+        return console.error("fetchRecommendationProductsByUrl error:", e), [];
+      }
+    },
+    fetchRecommendationStrategies: async () => {
+      try {
+        const { data: t } = await s(
+          `${c.RECOMMENDATION_STRATEGIES_PATH}?filters=${encodeURIComponent(g)}`
+        );
+        return Array.isArray(t) ? t : (t == null ? void 0 : t.data) ?? [];
+      } catch (t) {
+        throw console.error("fetchRecommendationStrategies error:", t), t;
+      }
+    },
+    generateStrategyEndpoint: async (t, r) => {
+      try {
+        const { data: e } = await i(
+          `${c.RECOMMENDATION_STRATEGIES_PATH}/endpoint-generate`,
+          {
+            campaignId: 0,
+            pageTypes: [],
+            isPreviewer: !1,
+            strategy: t,
+            userId: "",
+            currency: r
+          }
+        );
+        return !e || typeof e != "object" || !("full_path" in e || "data" in e) ? (console.error("generateStrategyEndpoint unexpected response shape:", e), null) : "full_path" in e ? e : e.data;
+      } catch (e) {
+        return console.error("generateStrategyEndpoint error:", e), null;
+      }
+    },
+    migrateLegacyStrategy: async (t) => {
+      const { data: r } = await i(
+        `${c.NEWSLETTER_RECOMMENDATIONS_PATH}/migrate-strategies`,
+        t
+      ), e = r && typeof r == "object" && "data" in r ? r.data : r, a = e == null ? void 0 : e.strategyId;
+      if (a == null || a === "")
+        throw new Error("[Guido] migrate-strategies returned no strategyId");
+      return String(a);
     }
   };
 };
 export {
-  f as useRecommendationApi
+  _ as useRecommendationApi
 };

package/dist/src/@types/config/schemas.d.ts

@@ -50,6 +50,8 @@ export declare const IdentitySchema: v.ObjectSchema<{
     readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "userId is required">]>;
     /** Optional variation ID for A/B testing */
     readonly variationId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Optional numeric campaign ID of the host campaign; absent for templates and modules */
+    readonly campaignId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
 }, undefined>;
 /**
  * Partner configuration - organization and product context
@@ -395,6 +397,7 @@ export declare const FeaturesSchema: v.ObjectSchema<{
     readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
     readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    readonly reusableRecommendationStrategy: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
  * Default block types available in Stripo
@@ -624,6 +627,8 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "userId is required">]>;
         /** Optional variation ID for A/B testing */
         readonly variationId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Optional numeric campaign ID of the host campaign; absent for templates and modules */
+        readonly campaignId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>;
     /** Partner configuration (required) */
     readonly partner: v.ObjectSchema<{
@@ -794,6 +799,7 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
         /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
         readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        readonly reusableRecommendationStrategy: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Block configuration */
     readonly blocks: v.OptionalSchema<v.ObjectSchema<{

package/dist/src/components/organisms/extensions/recommendation/AssignStrategyDrawer.vue.d.ts

@@ -0,0 +1,3 @@
+import '@useinsider/design-system-organisms/style';
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, 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/extensions/recommendation/LegacyStrategyUpdatedModal.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, 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/extensions/recommendation/RemoveStrategyModal.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, 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/extensions/recommendation/StrategyInfoBoxContent.vue.d.ts

@@ -0,0 +1,15 @@
+import type { RrsStrategy } from '@@/Types/recommendation';
+type __VLS_Props = {
+    strategy: RrsStrategy;
+};
+declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -11,6 +11,7 @@ export declare const useConfig: () => {
             templateId: string;
             userId: string;
             variationId?: string | undefined;
+            campaignId?: string | undefined;
         };
         partner: {
             name: string;
@@ -99,6 +100,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")[];
@@ -145,6 +147,7 @@ export declare const useConfig: () => {
         templateId: string;
         userId: string;
         variationId?: string | undefined;
+        campaignId?: string | undefined;
     } | null>;
     partner: import("vue").ComputedRef<{
         name: string;
@@ -233,6 +236,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/useLegacyStrategyConversion.d.ts

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

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

@@ -0,0 +1,18 @@
+import type { ModuleAddData, ModuleModifier } from '@@/Types/stripo';
+export declare const UNRESOLVED_DYNAMIC_CONTENT_ON_DROP_KEY = "dynamic-content.unresolved-attributes-on-drop";
+/**
+ * Repairs saved modules as they are dropped or copied into the editor, in one pass
+ * over the module HTML. Two independent repairs run through a single write-back:
+ *
+ * - Dynamic content: saved modules serialize merge-tag chips by their display label
+ *   (`{{ Phone Number }}`); this maps them back to their canonical token
+ *   (`{{phone_number}}`) using the account's dynamic-content list.
+ * - Items currency: v2 Items blocks can carry price `data-curency` /
+ *   `data-currency_symbol` attrs that drifted from their `esd-ext-config`; these are
+ *   healed from config (the export contract reads those exact attrs).
+ *
+ * Wired into Stripo via the `onModuleAdd` init callback (see `useStripo`).
+ */
+export declare const useModuleRepair: () => {
+    handleModuleAdd: (data: ModuleAddData, modifier: ModuleModifier) => void;
+};

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/composables/useSyncModuleExtractor.d.ts

@@ -1,4 +1,6 @@
 import type { SyncModuleExtractResult } from '@@/Types/events';
+export declare const SYNC_MODULE_CLASS = "esd-synchronizable-module";
+export declare const SYNC_MODULE_SELECTOR = ".esd-synchronizable-module";
 export declare const useSyncModuleExtractor: () => {
     extractSyncModuleData: (html: string) => SyncModuleExtractResult;
 };

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

@@ -0,0 +1,3 @@
+export declare const useSyncModuleBlockValidator: () => {
+    validateSyncModuleBlocks: (rawHtml: string, silent?: boolean) => boolean;
+};

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,9 @@ 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;
+    NEWSLETTER_RECOMMENDATIONS_PATH: string;
 };
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;

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

@@ -16,6 +16,10 @@ export declare const BLOCK_ID: BlockId;
  * - Onboarding support
  */
 export declare class ItemsBlock extends Block {
+    /** Block instances whose currency attrs were already self-healed this session (SD-147588 — undo-safe). */
+    private _currencyHealed;
+    /** blockInstanceIds already claimed by a live block this session (SD-147588 collision detection). */
+    private _seenInstanceIds;
     getId(): string;
     getIcon(): string;
     getBlockCompositionType(): BlockCompositionType;
@@ -42,4 +46,35 @@ export declare class ItemsBlock extends Block {
      * relies on this td-level fallback in pairProductVariables.
      */
     private _stampProductTdDomAttributes;
+    /**
+     * Whether a currency self-heal pass should run for this block (SD-147588). The only gate here is
+     * once-per-session: heal each instance at most once, so the auto-fix can't fight undo (undo
+     * re-drifts the attr, which would otherwise re-trigger the heal forever). The position-vs-symbol
+     * authority split lives in `_reconcileCurrencyDomAttributes` — position is always authoritative,
+     * the symbol write alone is skipped for the 'USD' sentinel — so we must NOT gate the whole pass
+     * on symbol customization here, or a default-symbol block with a toggled location never heals.
+     */
+    private _shouldReconcileCurrency;
+    /** Marks a block instance's currency as reconciled so it is not healed again (undo-safe). */
+    private _markCurrencyHealed;
+    /**
+     * Resolves the id for a just-created block to one that is unique per live instance.
+     * A saved module serializes its blockInstanceId, so every re-drop of the same module
+     * arrives with an id already owned by a live instance — reusing it collides both the
+     * currency heal guard and settings-panel switch detection. Mint a fresh id on absence
+     * or collision, otherwise keep the existing one. Registers the result as claimed.
+     */
+    private _resolveInstanceId;
+    /**
+     * Stamps the export-read currency attrs onto every price `<p>` from config, so a template whose
+     * attrs drifted (e.g. a location toggle before the sync fix) self-heals to match the editor.
+     * Config is the source of truth — never derive from visible text.
+     *
+     * Authority split lives in `currencyAttrTargets` (SD-147588) — position only when a location
+     * is recorded, symbol only when customized — so this heal and the module-drop repair can't drift.
+     *
+     * Returns true only when an attr actually changed, so the caller can skip an empty apply that
+     * would otherwise re-trigger onDocumentChanged and loop.
+     */
+    private _reconcileCurrencyDomAttributes;
 }

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

@@ -0,0 +1,43 @@
+/**
+ * Single owner for the Items price currency export contract (SD-147588).
+ *
+ * `data-curency` is deliberately misspelled (one `r`) — it is the attribute the
+ * server-side export transform (pairProductVariables) actually reads, so every
+ * layer that writes it and the live reader (template, controls, block self-heal,
+ * pairProductVariables) MUST go through these constants. A typo fix or mapping change
+ * in one of them would otherwise silently break sync with the others and ship the wrong
+ * currency position/token to the inbox. Mirrors the Recommendation block's `CURRENCY_ATTR`.
+ *
+ * Exception: the legacy migrator reads the raw misspelled string on purpose — it parses
+ * old templates frozen with that exact attr name, so it must NOT follow a future rename here.
+ */
+export declare const ITEMS_CURRENCY_ATTR: {
+    readonly POSITION: "data-curency";
+    readonly SYMBOL: "data-currency_symbol";
+};
+/** Currency location select value `'1'` = after (price then symbol), anything else = before. */
+export declare function currencyPositionFromLocation(location: string | undefined): 'after' | 'before';
+/**
+ * Whether a currency symbol is a partner customization vs the 'USD' default sentinel (SD-144644).
+ * The default value means "use the catalog currency", so it is treated as NOT customized — the one
+ * rule shared by the export transform (pairProductVariables) and the block self-heal, kept here so
+ * the two layers can never drift. Trims first so a whitespace-only value is not read as custom.
+ */
+export declare function isCustomCurrencySymbol(symbol: string | null | undefined): boolean;
+export interface CurrencyAttrTargets {
+    /** Desired `data-curency`; `undefined` = leave the DOM attr as-is (no location recorded). */
+    position?: 'before' | 'after';
+    /** Desired `data-currency_symbol`; `undefined` = leave it (empty / the 'USD' sentinel). */
+    symbol?: string;
+}
+/**
+ * The single authority rule for which price currency attrs a config wants written,
+ * shared by the block self-heal (Items/block.ts) and the module-drop repair
+ * (itemsCurrencyRepair) so the two can never drift (SD-147588). Position is authoritative
+ * only when a location is explicitly recorded (an absent value is "unknown", not 'before');
+ * the symbol is written only for a custom value (never the 'USD' default sentinel).
+ */
+export declare function currencyAttrTargets(config: {
+    priceCurrencyLocation?: string;
+    priceCurrencySymbol?: string;
+}): CurrencyAttrTargets;

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

@@ -0,0 +1,6 @@
+/**
+ * Block root selector — the container Stripo stamps on every v2 Items block.
+ * Legacy (`.esd-cart-items-block` &co.) is deliberately out of scope: it is
+ * normalized to v2 by `itemsBlockMigrator` at template load.
+ */
+export declare const ITEMS_BLOCK_SELECTOR = ".items-block-v2";

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

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

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

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

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