@useinsider/guido 3.8.1 → 3.8.2-beta.06011ff

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
@@ -63,3 +75,12 @@ export declare const PRODUCT_ATTRIBUTE_PREFIX = "product_attribute.";
  * 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/algorithm.d.ts

@@ -24,6 +24,6 @@ export declare class AlgorithmControl extends CommonControl {
     _initializeSelectItems(): void;
     _setProductIdsVisibility(strategy?: string): void;
     _onAlgorithmChange(value: string): void;
-    _onProductIdsChange(value: string): void;
+    _onProductIdsChange(value: string[]): void;
     _listenToFormUpdates(): void;
 }

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/common-control.d.ts

@@ -6,6 +6,12 @@ interface TextInputProps {
     className?: string;
     disabled?: boolean;
 }
+interface MultiSelectProps {
+    name: string;
+    placeholder?: string;
+    className?: string;
+    disabled?: boolean;
+}
 interface LabelProps {
     text: string;
     name?: string;
@@ -145,5 +151,6 @@ export declare abstract class CommonControl extends Control {
         value: string;
     }[]): string;
     _GuCheckbox(name: string, caption: string): string;
+    _GuMultiSelect({ name, placeholder, className, disabled }: MultiSelectProps): string;
 }
 export {};

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

@@ -10,6 +10,7 @@ interface StoreState {
     typeSelectionDrawerStatus: boolean;
     isGlobalUnsubscribeDisabled: boolean;
     isSubscriptionPreferencesCenterDisabled: boolean;
+    pendingBlockId: string | null;
 }
 export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guidoUnsubscribe", StoreState, {
     getSelectedCollection: (state: {
@@ -35,6 +36,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => number[];
     getSelectedTemplateByActiveType: (state: {
         templates: {
@@ -59,6 +61,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => number;
     getTemplatesByActiveType: (state: {
         templates: {
@@ -83,6 +86,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => {
         id: number;
         name: string;
@@ -119,6 +123,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => (id: number) => string;
     getSelectedUnsubscribePagesByCollection: (state: {
         templates: {
@@ -143,6 +148,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => (collectionType: number) => number[];
     isActiveTypeFirstInCollection: (state: {
         templates: {
@@ -167,6 +173,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => boolean;
     isActiveTypeLastInCollection: (state: {
         templates: {
@@ -191,6 +198,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => boolean;
     hasTemplatesByCollectionType: (state: {
         templates: {
@@ -215,6 +223,7 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => Record<number, boolean>;
     unsubscribePagesStatus: (state: {
         templates: {
@@ -239,10 +248,11 @@ export declare const useUnsubscribeStore: import("pinia").StoreDefinition<"guido
         typeSelectionDrawerStatus: boolean;
         isGlobalUnsubscribeDisabled: boolean;
         isSubscriptionPreferencesCenterDisabled: boolean;
+        pendingBlockId: string | null;
     } & import("pinia").PiniaCustomStateProperties<StoreState>) => boolean;
 }, {
     $reset(): void;
-    fetchTemplates(): Promise<void>;
+    fetchTemplates(force?: boolean): Promise<void>;
     setCollection(collectionType: number): void;
     setCollectionWithoutAutoSelection(collectionType: number): void;
     setSelectedTemplate(template: number): void;

package/dist/src/utils/ampErrorFilter.d.ts

@@ -1,2 +1,3 @@
 export declare const AMP_ERROR_WHITELISTED_TOKENS: string[];
+export declare const AMP_ERROR_STRIPPED_ATTRIBUTE_FRAGMENTS: string[];
 export declare const filterAmpErrors: (ampErrors: string[]) => string[];

package/dist/stores/unsubscribe.js

@@ -1,6 +1,6 @@
 import { TYPE_COLLECTIONS as i, PAGE_TYPES as p } from "../enums/unsubscribe.js";
 import { useUnsubscribeApi as d } from "../services/unsubscribeApi.js";
-import { defineStore as h } from "pinia";
+import { defineStore as u } from "pinia";
 let o = null;
 const r = () => ({
   templates: [],
@@ -12,8 +12,9 @@ const r = () => ({
   pageSelectionDrawerStatus: !1,
   typeSelectionDrawerStatus: !1,
   isGlobalUnsubscribeDisabled: !1,
-  isSubscriptionPreferencesCenterDisabled: !1
-}), b = h("guidoUnsubscribe", {
+  isSubscriptionPreferencesCenterDisabled: !1,
+  pendingBlockId: null
+}), b = u("guidoUnsubscribe", {
   state: () => r(),
   getters: {
     getSelectedCollection: (e) => i[e.selectedCollectionType],
@@ -62,10 +63,10 @@ const r = () => ({
         selectedUnsubscribePages: t
       });
     },
-    async fetchTemplates() {
-      this.templates.length || (o || (o = (async () => {
-        const { getUnsubscribePages: e } = d();
-        this.templates = await e();
+    async fetchTemplates(e = !1) {
+      !e && this.templates.length || ((e || !o) && (o = (async () => {
+        const { getUnsubscribePages: t } = d();
+        this.templates = await t();
       })().finally(() => {
         o = null;
       })), await o);

package/dist/utils/ampErrorFilter.js

@@ -1,8 +1,9 @@
-import { MERGE_TAGS as t } from "../enums/unsubscribe.js";
-const E = Object.values(t), c = (r) => r.filter(
-  (e) => !E.some((o) => e.includes(o))
+import { MERGE_TAGS as R } from "../enums/unsubscribe.js";
+const o = Object.values(R), s = ["attribute 'contenteditable'"], _ = (E) => E.filter(
+  (e) => !o.some((t) => e.includes(t)) && !s.some((t) => e.includes(t))
 );
 export {
-  E as AMP_ERROR_WHITELISTED_TOKENS,
-  c as filterAmpErrors
+  s as AMP_ERROR_STRIPPED_ATTRIBUTE_FRAGMENTS,
+  o as AMP_ERROR_WHITELISTED_TOKENS,
+  _ as filterAmpErrors
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.8.1",
+  "version": "3.8.2-beta.06011ff",
   "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",