@useinsider/guido 3.6.0-beta.a8be7f8 → 3.6.0-beta.b75de0e

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

@@ -8,4 +8,12 @@ export declare function buildBlockHtml(params: {
     extraClasses?: string;
     legacyId?: string;
     legacyBgColor?: string;
+    /**
+     * When set, the block's existing inner HTML is preserved verbatim instead
+     * of regenerating product rows — used for partner-customized blocks so
+     * their hand-authored `{{...}}` variables survive migration.
+     */
+    preserveInnerHtml?: string;
+    /** Adds the `ins-skip-compile` opt-out class to the migrated block. */
+    skipCompile?: boolean;
 }): string;

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

@@ -1,6 +1,5 @@
 export declare enum ToasterTypeOptions {
     Success = "success",
     Warning = "warning",
-    Alert = "alert",
-    Dark = "dark"
+    Alert = "alert"
 }

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

@@ -55,19 +55,6 @@ export declare class RecommendationBlock extends Block {
      * @param node - The block node being deleted
      */
     onDelete(node: ImmutableHtmlNode): void;
-    /**
-     * Warns (dark advisory toaster) when the design holds more than one live
-     * recommendation block. Triggered from the user-add paths only (fresh drop
-     * and duplicate) — never from document-load/migration, so opening a template
-     * that already has multiple blocks does not fire it.
-     *
-     * Counting lives in `useRecommendationBlockWarning` so the same DOM-based
-     * logic (which ignores the empty shells deletions leave behind, SD-143028)
-     * is shared with the `module_dropped` handler — recommendation blocks can
-     * also arrive inside a saved structure. Wrapped in try/catch because the
-     * document root may be unavailable during initial load.
-     */
-    private _warnIfMultipleBlocks;
     /**
      * Generates the next unique recommendation ID by scanning all existing blocks
      * in the document and finding the maximum existing ID + 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, 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_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, 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_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, 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';

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

@@ -23,6 +23,18 @@ export declare const MOBILE_ROW_SELECTOR = ".ins-recommendation-mobile-row";
  * `{{cId_pIdx_url}}` template variable.
  */
 export declare const CSS_CLASS_RECO_BUTTON = "reco-v3-button";
+/**
+ * Opt-out class for partners who want to inject their own template variables
+ * into a recommendation block. When present on `.recommendation-block-v2`,
+ * Guido skips ONLY its product-data → template-variable substitution
+ * (`replaceProductAttributes`) for that block — partners author their own
+ * `{{recoId_index_attribute}}` variables. Everything else (campaign URL
+ * building, hidden-row removal, Outlook image widths, text-trim CSS, discount
+ * conditions, store hydration, store-level config validation, and general HTML
+ * optimizations) still applies. The class is preserved in the final compiled
+ * output so partners may use it for their own styling.
+ */
+export declare const CSS_CLASS_SKIP_COMPILE = "ins-skip-compile";
 /**
  * Currency HTML attributes set on the block element
  * These are read by the HTML compiler at runtime to format prices
@@ -61,3 +73,12 @@ export declare const ATTR_PRODUCT_ATTR = "product-attr";
  * Used to exclude these from the custom attribute dropdown to prevent duplication with toggles.
  */
 export declare const BUILT_IN_DEFAULT_ATTRIBUTES: Set<string>;
+/**
+ * Attribute names valid inside a `{{recoId_index_attributeName}}` template
+ * variable regardless of the account's custom attribute list. Every built-in
+ * composition attribute is valid, plus `currency` and `discount` which the
+ * compiler emits but are not composition toggles. Custom attributes are
+ * validated separately against the account's fetched attribute list
+ * (`stripo/email-recommendation-attributes`).
+ */
+export declare const RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES: Set<string>;

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

@@ -17,6 +17,13 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    /**
+     * Card composition restructures the block (toggles/reorders/adds attribute
+     * cells), which would corrupt a partner-managed (`ins-skip-compile`) block's
+     * preserved markup. There is no native tab-disable API, so the whole control
+     * container is rendered inert (greyed + non-interactive) instead.
+     */
+    _syncDisabledState(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     private _initializeComposition;

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

@@ -21,6 +21,11 @@ export declare class LayoutOrientationControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Layout orientation restructures the whole block, which is meaningless for
+     * partner-managed (`ins-skip-compile`) blocks — disable the control there.
+     */
+    _syncDisabledState(): void;
     _setFormValues(): void;
     /**
      * Handles layout change

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

@@ -30,6 +30,12 @@ export declare class ProductLayoutControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Products-per-row and mobile-layout restructure the block, which is
+     * meaningless for partner-managed (`ins-skip-compile`) blocks — disable
+     * these inputs there. Disabling coexists with the visibility logic above.
+     */
+    _syncDisabledState(): void;
     onDestroy(): void;
     _setFormValues(): void;
     /**

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

@@ -35,6 +35,15 @@ interface DocumentModifier {
  * @returns The block element or null if not found
  */
 export declare function getBlockElement(currentNode: ImmutableHtmlNode | null | undefined): ImmutableHtmlNode | null;
+/**
+ * True when the recommendation block has opted out of Guido's content
+ * regeneration via the `ins-skip-compile` class. Partner-managed blocks carry
+ * hand-authored `{{...}}` variables in their cells, so Guido must never
+ * overwrite their content with product data (regenerate / in-place update).
+ * @param currentNode - The current template node
+ * @returns True if the block opted out of content regeneration
+ */
+export declare function isPartnerManagedBlock(currentNode: ImmutableHtmlNode | null | undefined): boolean;
 /**
  * Gets the current layout orientation from the block's data attribute
  * Supports both old (horizontal/vertical) and new (list/grid) values for backward compatibility

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

@@ -0,0 +1,7 @@
+/**
+ * Returns the extra recommendation feed query params for an account, if any.
+ * Accounts without customizations get an empty object.
+ * @param partnerName Account subdomain (`config.partner.name`)
+ * @param strategy    Recommendation strategy key of the block
+ */
+export declare function getPartnerRecommendationParams(partnerName: string, strategy: string): Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.6.0-beta.a8be7f8",
+  "version": "3.6.0-beta.b75de0e",
   "description": "Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.",
   "main": "./dist/guido.umd.cjs",
   "module": "./dist/library.js",

package/dist/extensions/Blocks/Recommendation/useRecommendationBlockWarning.js

@@ -1,16 +0,0 @@
-import { useToaster as r } from "../../../composables/useToaster.js";
-import { useTranslations as s } from "../../../composables/useTranslations.js";
-import { ToasterTypeOptions as n } from "../../../enums/toaster.js";
-import { countLiveRecommendationBlocks as i } from "./utils/recommendationBlockCount.js";
-const a = "newsletter.multiple-reco-blocks-warning", f = () => {
-  const { showToaster: o } = r(), t = s();
-  return { warnIfMultipleBlocks: (e) => {
-    i(e) > 1 && o({
-      type: n.Dark,
-      message: t(a)
-    });
-  } };
-};
-export {
-  f as useRecommendationBlockWarning
-};

package/dist/extensions/Blocks/Recommendation/utils/recommendationBlockCount.js

@@ -1,9 +0,0 @@
-const r = ".recommendation-block-v2", t = ".recommendation-product-row";
-function n(o) {
-  return Array.from(o.querySelectorAll(r)).filter((e) => e.querySelector(t)).length;
-}
-export {
-  r as RECOMMENDATION_BLOCK_SELECTOR,
-  t as RECOMMENDATION_PRODUCT_ROW_SELECTOR,
-  n as countLiveRecommendationBlocks
-};

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

@@ -1,11 +0,0 @@
-import type { QueryableRoot } from './utils/recommendationBlockCount';
-/**
- * Advisory shown when a design ends up with more than one recommendation block,
- * since multiple blocks can slow campaign delivery. Shared by the block
- * lifecycle (direct drop / duplicate, counting the editor's document root) and
- * the `module_dropped` event (counting a parsed `getTemplateData()` document, so
- * recommendation blocks that arrive inside a saved structure are also covered).
- */
-export declare const useRecommendationBlockWarning: () => {
-    warnIfMultipleBlocks: (root: QueryableRoot) => void;
-};

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

@@ -1,28 +0,0 @@
-/**
- * Counts *live* recommendation blocks in a document.
- *
- * Deleting a recommendation block strips its inner content but leaves an empty
- * `.recommendation-block-v2` container shell behind — present in every document
- * representation the editor exposes (`getDocumentRoot`, `getDocumentRootHtmlNode`
- * and even `getTemplateData`). A raw class count therefore over-reports after a
- * delete→add cycle (SD-143028). The product row (`.recommendation-product-row`)
- * is present on every live block from drop time (the default template ships
- * product rows, both grid and list layouts) and is removed from a deleted
- * block's leftover shell, so filtering by it cleanly separates live blocks from
- * ghosts without reading any store.
- */
-export declare const RECOMMENDATION_BLOCK_SELECTOR = ".recommendation-block-v2";
-export declare const RECOMMENDATION_PRODUCT_ROW_SELECTOR = ".recommendation-product-row";
-interface QueryableNode {
-    querySelector(selector: string): unknown;
-}
-export interface QueryableRoot {
-    querySelectorAll(selector: string): Iterable<QueryableNode>;
-}
-/**
- * Counts the live recommendation blocks reachable from `root`. Works on the
- * editor's `ImmutableHtmlNode` document root (drop / duplicate paths) and on a
- * DOM `Document` parsed from `getTemplateData()` HTML (saved-module drop path).
- */
-export declare function countLiveRecommendationBlocks(root: QueryableRoot): number;
-export {};