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

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

@@ -0,0 +1,46 @@
+function a(t) {
+  return typeof t == "object" && t !== null && "tagName" in t && typeof t.tagName == "string";
+}
+function r(t) {
+  return typeof t == "object" && t !== null && "getTagName" in t && typeof t.getTagName == "function";
+}
+function n(t) {
+  return typeof t == "object" && t !== null && "getStyle" in t && typeof t.getStyle == "function";
+}
+function u(t) {
+  return typeof t == "object" && t !== null && "parent" in t && typeof t.parent == "function";
+}
+function g(t) {
+  return typeof t == "object" && t !== null && "tagName" in t && t.tagName === "TD";
+}
+function p(t, e) {
+  return !t || !n(t) ? null : t.getStyle(e);
+}
+function N(t) {
+  return !t || !u(t) ? null : t.parent();
+}
+function l(t, e = "UNKNOWN") {
+  return t ? a(t) ? t.tagName.toUpperCase() : r(t) ? t.getTagName().toUpperCase() : e : e;
+}
+const f = /* @__PURE__ */ new Set(["TD", "BLOCK_IMAGE", "BLOCK_BUTTON"]);
+function i(t) {
+  return f.has(t.toUpperCase());
+}
+function c(t) {
+  const e = l(t);
+  return i(e);
+}
+function s(t) {
+  return c(t) ? "table-cell" : "table-row";
+}
+export {
+  s as getTableDisplayValue,
+  l as getTagName,
+  n as hasGetStyle,
+  u as hasParent,
+  c as isTableCellNode,
+  i as isTableCellTag,
+  g as isTdNode,
+  N as safeGetParent,
+  p as safeGetStyle
+};

package/dist/extensions/Blocks/common-control.js

@@ -52,7 +52,7 @@ class _ extends O {
     const T = o !== this.lastBlockInstanceId;
     return T ? (this.currentNode && e(this.currentNode), n(), this.lastBlockInstanceId = o) : n(), T;
   }
-  _GuLabel({ text: e, name: n = "", position: E = "top" }) {
+  _GuLabel({ text: e, name: n = "", position: E = "left" }) {
     return `
             <${t.LABEL} 
                 style="${E === "top" ? "margin-bottom: 8px;" : ""}"

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

@@ -9,4 +9,4 @@
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
 export { CONTAINER_SELECTOR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, } from './selectors';
-export { DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, } from './layout';
+export { DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';

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

@@ -15,6 +15,7 @@
  * - FiltersControl: Filter selection
  * - ShuffleControl: Product shuffle toggle
  */
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 import { AlgorithmControl, ALGORITHM_CONTROL_ID } from './algorithm';
 import { CurrencyControl, CURRENCY_CONTROL_ID } from './currency';
@@ -41,14 +42,21 @@ export declare class RecommendationBlockControl extends CommonControl {
     getId(): string;
     getTemplate(): string;
     onRender(): Promise<void>;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     /**
      * Initialize all sub-controls with the shared API context
      * 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/main/productLayout.d.ts

@@ -21,7 +21,6 @@ export declare class ProductLayoutControl extends CommonControl {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     _setFormValues(): void;
-    _initializeCounterValues(): void;
     /**
      * Updates "Products in One Row" visibility based on layout orientation
      * This control is hidden for horizontal layout (products always take full width)

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,7 @@ 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;
+    onDestroy(): void;
     /**
      * 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/package.json

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