@useinsider/guido 2.0.0-beta.e73ba15 → 2.0.0-beta.fb0f99d

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

@@ -15,3 +15,13 @@ export declare const MIN_PRODUCT_COUNT = 1;
 export declare const MAX_PRODUCTS_PER_ROW = 4;
 /** Minimum number of products per row in vertical layout */
 export declare const MIN_PRODUCTS_PER_ROW = 1;
+/** Default column spacing between product cards (5px on each side = 10px total) */
+export declare const DEFAULT_COLUMN_SPACING = 10;
+/** Default row spacing between product rows */
+export declare const DEFAULT_ROW_SPACING = 20;
+/** Minimum spacing value */
+export declare const MIN_SPACING = 0;
+/** Maximum spacing value */
+export declare const MAX_SPACING = 50;
+/** Spacing adjustment step */
+export declare const SPACING_STEP = 5;

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

@@ -1,4 +1,3 @@
-import type { Orientation } from '@@/Types/recommendation';
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const CARD_BACKGROUND_COLOR_CONTROL_ID = "recommendation-card-background-color-control";
@@ -12,15 +11,6 @@ export declare class CardBackgroundColorControl extends CommonControl {
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _setFormValues(): void;
-    /**
-     * Gets the block element - either currentNode itself or as a descendant
-     * The currentNode could BE the block element or contain it
-     */
-    _getBlockElement(): ImmutableHtmlNode | null;
-    /**
-     * Gets the current layout orientation from the block's data attribute
-     */
-    _getCurrentLayout(): Orientation;
     /**
      * Gets the appropriate selector based on layout
      * Vertical: .product-card-segment (inner table per product cell)

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

@@ -1,20 +1,3 @@
-/**
- * Main Recommendation Block Control
- *
- * This is a coordinator control that composes all recommendation configuration
- * sub-controls into a single settings panel. It handles:
- * - Initial API data fetching
- * - Store subscriptions for product refresh
- * - Coordinating lifecycle of sub-controls
- *
- * Sub-controls are also exported individually for flexibility:
- * - AlgorithmControl: Strategy and product IDs
- * - LocaleControl: Language selection
- * - CurrencyControl: Currency formatting settings
- * - ProductLayoutControl: Product count and grid layout
- * - FiltersControl: Filter selection
- * - ShuffleControl: Product shuffle toggle
- */
 import { CommonControl } from '../../../common-control';
 import { AlgorithmControl, ALGORITHM_CONTROL_ID } from './algorithm';
 import { CurrencyControl, CURRENCY_CONTROL_ID } from './currency';
@@ -47,8 +30,14 @@ export declare class RecommendationBlockControl extends CommonControl {
      * Each sub-control manages its own form values and event listeners
      */
     _initializeSubControls(): void;
+    /**
+     * Debounced product fetch to prevent rapid API calls during config changes
+     */
+    private _debouncedFetchProducts;
     /**
      * Listen to store changes that require product refresh
+     * Only triggers for meaningful config changes (size, strategy, filters, etc.)
+     * Uses debounce to prevent rapid API calls
      */
     _listenStateUpdates(): void;
 }

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

@@ -1,4 +1,3 @@
-import type { Orientation } from '@@/Types/recommendation';
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const SPACING_CONTROL_ID = "recommendation-spacing-control";
@@ -14,10 +13,6 @@ export declare class SpacingControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
-    /**
-     * Gets the current layout orientation from the block's data attribute
-     */
-    _getCurrentLayout(): Orientation;
     /**
      * Updates column spacing visibility based on layout orientation
      * Column spacing is hidden for horizontal layout (products are stacked vertically)

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

@@ -1,5 +1,6 @@
 import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationProduct } from '@@/Types/recommendation';
 interface StoreState {
+    /** Maps campaign URLs for recommendation blocks. Used by templateLibraryApi when saving templates. */
     recommendationCampaignUrls: Record<string, string>;
     recommendationConfigs: {
         cardsInRow: number;

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

@@ -0,0 +1,77 @@
+/**
+ * Node Type Guards and Tag Name Utilities
+ *
+ * Provides type-safe utilities for working with ImmutableHtmlNode.
+ * Handles both standard DOM properties and Stripo's custom methods.
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+/** Interface for nodes with standard tagName property */
+interface NodeWithTagName {
+    tagName: string;
+}
+/** Interface for nodes with getStyle method */
+export interface NodeWithGetStyle {
+    getStyle: (property: string) => string | null | undefined;
+}
+/** Interface for nodes with parent method */
+export interface NodeWithParent {
+    parent: () => ImmutableHtmlNode | null;
+}
+/**
+ * Type guard to check if a node has getStyle method
+ * @param node - The node to check
+ */
+export declare function hasGetStyle(node: unknown): node is NodeWithGetStyle;
+/**
+ * Type guard to check if a node has parent method
+ * @param node - The node to check
+ */
+export declare function hasParent(node: unknown): node is NodeWithParent;
+/**
+ * Type guard to check if a node is a TD element
+ * @param node - The node to check
+ */
+export declare function isTdNode(node: unknown): node is ImmutableHtmlNode & NodeWithTagName;
+/**
+ * Safely retrieves a style value from a node
+ * @param node - The node to get the style from
+ * @param property - The CSS property name
+ * @returns The style value or null if not accessible
+ */
+export declare function safeGetStyle(node: ImmutableHtmlNode | null, property: string): string | null | undefined;
+/**
+ * Safely retrieves the parent element of a node
+ * @param node - The node to get the parent from
+ * @returns The parent node or null if not accessible
+ */
+export declare function safeGetParent(node: ImmutableHtmlNode | null): ImmutableHtmlNode | null;
+/**
+ * Safely retrieves the tag name from a node.
+ * Handles both standard DOM tagName property and Stripo's getTagName() method.
+ * @param node - The node to get the tag name from
+ * @param defaultValue - Default value if tag name cannot be determined (default: 'UNKNOWN')
+ * @returns The uppercase tag name
+ */
+export declare function getTagName(node: ImmutableHtmlNode | null | undefined, defaultValue?: string): string;
+/**
+ * Checks if a tag name represents a table cell element.
+ * Includes standard TD and Stripo's custom block types (BLOCK_IMAGE, BLOCK_BUTTON).
+ * @param tagName - The tag name to check (case-insensitive)
+ * @returns True if the tag represents a table cell
+ */
+export declare function isTableCellTag(tagName: string): boolean;
+/**
+ * Checks if a node is a table cell element.
+ * Combines getTagName and isTableCellTag for convenience.
+ * @param node - The node to check
+ * @returns True if the node is a table cell element
+ */
+export declare function isTableCellNode(node: ImmutableHtmlNode | null | undefined): boolean;
+/**
+ * Gets the appropriate CSS display value for showing a table element.
+ * Table cells use 'table-cell', table rows use 'table-row'.
+ * @param node - The table element node
+ * @returns The CSS display value ('table-cell' or 'table-row')
+ */
+export declare function getTableDisplayValue(node: ImmutableHtmlNode | null | undefined): 'table-cell' | 'table-row';
+export {};

package/dist/src/extensions/Blocks/common-control.d.ts

@@ -75,7 +75,7 @@ export declare abstract class CommonControl extends Control {
      * @returns true if block instance changed, false otherwise
      */
     protected handleBlockInstanceChange(syncFunction: (node: ImmutableHtmlNode) => void, updateUI: () => void, blockInstanceIdAttribute?: string): boolean;
-    _GuLabel({ text, name, position }: LabelProps): string;
+    _GuLabel({ text, name }: LabelProps): string;
     _GuToggle(name: string): string;
     _GuSelectItem({ text, value }: {
         text: string;

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

@@ -1,4 +1,4 @@
-import type { GuidoConfig, GuidoConfigInput, IdentityConfig, PartnerConfig, TemplateConfig, EditorConfig, UIConfig, FeaturesConfig, BlocksConfig, CompilerConfig } from '@@/Types/config';
+import type { GuidoConfig, GuidoConfigInput, IdentityConfig, PartnerConfig, TemplateConfig, EditorConfig, UIConfig, FeaturesConfig, BlocksConfig, CompilerConfig, CallbacksConfig } from '@@/Types/config';
 interface ConfigStoreState {
     /** Whether the config has been initialized */
     initialized: boolean;
@@ -96,6 +96,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => IdentityConfig | null;
     /**
@@ -188,6 +191,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => PartnerConfig | null;
     /**
@@ -280,6 +286,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => TemplateConfig | null;
     /**
@@ -372,6 +381,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => EditorConfig | null;
     /**
@@ -464,6 +476,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => UIConfig | null;
     /**
@@ -556,6 +571,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => FeaturesConfig | null;
     /**
@@ -648,6 +666,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => BlocksConfig | null;
     /**
@@ -740,8 +761,106 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => CompilerConfig | null;
+    /**
+     * Get the callbacks configuration
+     */
+    callbacks: (state: {
+        initialized: boolean;
+        config: {
+            identity: {
+                templateId: string;
+                userId: string;
+                variationId?: string | undefined;
+            };
+            partner: {
+                name: string;
+                productType: 60 | 49 | 97;
+                messageType: 1 | 2;
+                username: string;
+            };
+            template: {
+                html: string;
+                css: string;
+                preselectedDynamicContent: {
+                    text: string;
+                    value: string;
+                    fallback?: string | undefined;
+                    format?: {
+                        key: string;
+                        value: string;
+                    } | undefined;
+                }[];
+                selectedUnsubscribePages: number[];
+                forceRecreate: boolean;
+            };
+            editor: {
+                locale: string;
+                translationsPath: string;
+                migrationDate: number;
+                emailHeader: {
+                    senderName: string;
+                    subject: string;
+                };
+            };
+            ui: {
+                showHeader: boolean;
+                backButtonLabel?: string | undefined;
+            };
+            features: {
+                dynamicContent: boolean;
+                saveAsTemplate: boolean;
+                versionHistory: boolean;
+                testMessage: boolean;
+                displayConditions: boolean;
+                unsubscribe: boolean;
+                modulesDisabled: 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")[];
+                includeCustoms: ("dynamic-content" | "checkbox-block" | "radio-button-block" | "recommendation-block" | "unsubscribe-block" | "coupon-block" | "items-block")[];
+            };
+            compiler: {
+                customRules: ({
+                    type: "replace";
+                    search: string;
+                    replacement: string;
+                    replaceAll?: boolean | undefined;
+                    id: string;
+                    description?: string | undefined;
+                    priority: number;
+                } | {
+                    type: "regex";
+                    pattern: string;
+                    replacement: string;
+                    flags?: string | undefined;
+                    id: string;
+                    description?: string | undefined;
+                    priority: number;
+                } | {
+                    type: "remove";
+                    targets: string[];
+                    id: string;
+                    description?: string | undefined;
+                    priority: number;
+                } | {
+                    type: "custom";
+                    processor: (html: string) => string;
+                    id: string;
+                    description?: string | undefined;
+                    priority: number;
+                })[];
+                ignoreDefaultRules: boolean;
+            };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
+        } | null;
+    } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => CallbacksConfig | null;
     /**
      * Get the template ID
      */
@@ -832,6 +951,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => string;
     /**
@@ -924,6 +1046,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => string;
     /**
@@ -1016,6 +1141,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => string;
     /**
@@ -1108,6 +1236,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => string;
     /**
@@ -1200,6 +1331,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => number;
     /**
@@ -1292,6 +1426,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => number;
     /**
@@ -1384,6 +1521,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => string;
     /**
@@ -1476,6 +1616,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => boolean;
     /**
@@ -1568,6 +1711,9 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 })[];
                 ignoreDefaultRules: boolean;
             };
+            callbacks: {
+                externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+            };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => (feature: keyof FeaturesConfig) => boolean;
 }, {

package/dist/static/styles/components/button.css.js

@@ -48,7 +48,7 @@ const o = `.control-shadow-wrapper:has(.button) {
 }
 
 .e2e-text-insert-controls .control-shadow-wrapper:not(:last-of-type) {
-    margin-right: 16px;
+    margin-right: 6px;
 }
 
 .flat-white > .button {

package/dist/stores/config.js

@@ -64,6 +64,13 @@ const s = o("guido-config", {
       var e;
       return ((e = i.config) == null ? void 0 : e.compiler) ?? null;
     },
+    /**
+     * Get the callbacks configuration
+     */
+    callbacks: (i) => {
+      var e;
+      return ((e = i.config) == null ? void 0 : e.callbacks) ?? null;
+    },
     /**
      * Get the template ID
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "2.0.0-beta.e73ba15",
+  "version": "2.0.0-beta.fb0f99d",
   "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",