@useinsider/guido 2.0.0 → 2.1.0-beta.13ada05

package/dist/src/extensions/Blocks/Items/controls/settingsControl.d.ts

@@ -3,12 +3,10 @@ import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../common-control';
 export declare const CONTROL_BLOCK_ID = "ui-elements-items-block";
 export declare class ItemsBlockControl extends CommonControl {
-    private store;
     getId(): string;
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
-    onDestroy(): void;
     _getItemsType(): string;
     _getOrientation(): string;
     _getItemInCart(): string;
@@ -18,7 +16,7 @@ export declare class ItemsBlockControl extends CommonControl {
     _initializeSelectItems(): void;
     _listenToFormUpdates(): void;
     _renderTemplate(): void;
-    _getTemplateData(): {
+    _getTemplateData(itemsTypeOverride?: ProductType, itemIdOverride?: string): {
         imageSrc: string;
         name: string;
         price: string;
@@ -26,19 +24,15 @@ export declare class ItemsBlockControl extends CommonControl {
         quantity: string;
         button: string;
     };
-    _updateImageSrc(imageSrc: string): void;
-    _updateName(name: string): void;
-    _updatePrice(price: string): void;
-    _updateOriginalPrice(originalPrice: string): void;
-    _updateQuantity(quantity: string): void;
-    /**
-     * @todo Optimize template reordering for performance.
-     * @description Reorders the template structure based on current orientation and visibility settings.
-     */
-    _reOrderTemplate(): void;
-    _updateDataTypeAttributes(itemsType: ProductType): void;
-    _updateDataNumberAttributes(itemId: string): void;
-    _reFillTemplate(): void;
+    _updateImageSrc(imageSrc: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _updateName(name: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _updatePrice(price: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _updateOriginalPrice(originalPrice: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _updateQuantity(quantity: string, itemsTypeOverride: ProductType | undefined, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _reOrderTemplate(modifier?: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _updateDataTypeAttributes(itemsType: ProductType, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _updateDataNumberAttributes(itemId: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
+    _reFillTemplate(itemsType?: ProductType): void;
     _recalculateTrimming(): void;
     private _getParagraphFromBlock;
     private _escapeRegex;

package/dist/src/extensions/Blocks/Items/enums/controlEnums.d.ts

@@ -42,6 +42,7 @@ export declare enum ItemsBlockControlId {
     PRICE_PADDINGS = "items-block-price-paddings-control",
     PRICE_HIDE_DISCOUNT = "items-block-price-hide-discount-control",
     PRICE_FORMATTED_PRICE = "items-block-price-formatted-price-control",
+    PRICE_SINGLE_PRICE = "items-block-price-single-price-control",
     PRICE_CURRENCY_SYMBOL = "items-block-price-currency-symbol-control",
     PRICE_CURRENCY_LOCATION = "items-block-price-currency-location-control",
     PRICE_ORIENTATION = "items-block-price-orientation-control",

package/dist/src/extensions/Blocks/Items/enums/productEnums.d.ts

@@ -1,30 +1,4 @@
 export declare const templateFirstLine = "<td align=\"center\" class=\"ins-product-td items-block items-block-v2\">";
-export declare const configAttributes: {
-    TYPE: string;
-    ITEMS_INDEX_SELECT_CONTROL_VALUE: string;
-    ORIENTATION: string;
-    PRODUCT_NAME_TRIMMING: string;
-    PRODUCT_PRICE_HIDE_DISCOUNT: string;
-    PRODUCT_PRICE_FORMATTED: string;
-    PRODUCT_PRICE_CURRENCY_SYMBOL: string;
-    PRODUCT_PRICE_CURRENCY_LOCATION: string;
-    PRODUCT_ORIGINAL_PRICE_CONTROL_ORIENTATION: string;
-    PRODUCT_BUTTON_LINK: string;
-    PRODUCT_IMAGE_LINK: string;
-    PRODUCT_NAME_CONTROL_VALUE: string;
-    PRODUCT_QUANTITY_CONTROL_VALUE: string;
-    PRODUCT_PRICE_CONTROL_VALUE: string;
-    BLOCK_INSTANCE_ID: string;
-    NAME_CONTROL_ENABLED: string;
-    QUANTITY_CONTROL_ENABLED: string;
-    PRICE_CONTROL_OPENED: string;
-    PRODUCT_IMAGE_VISIBLE: string;
-    PRODUCT_NAME_VISIBLE: string;
-    PRODUCT_QUANTITY_VISIBLE: string;
-    PRODUCT_PRICE_VISIBLE: string;
-    PRODUCT_ORIGINAL_PRICE_VISIBLE: string;
-    PRODUCT_BUTTON_VISIBLE: string;
-};
 export declare const productPairs: {
     PAIRS_FOR_EXTENSION: {
         imageSrc: {
@@ -79,25 +53,37 @@ export declare const productPairs: {
             CART_ITEMS: {
                 PRICE: string;
                 PRICE_FORMATTED: string;
+                SINGLE_PRICE: string;
+                SINGLE_PRICE_FORMATTED: string;
                 CURRENCY: string;
                 DEFAULT_PRICE: string;
                 DEFAULT_PRICE_FORMATTED: string;
+                DEFAULT_SINGLE_PRICE: string;
+                DEFAULT_SINGLE_PRICE_FORMATTED: string;
                 DEFAULT_CURRENCY: string;
             };
             BROWSED_ITEMS: {
                 PRICE: string;
                 PRICE_FORMATTED: string;
+                SINGLE_PRICE: string;
+                SINGLE_PRICE_FORMATTED: string;
                 CURRENCY: string;
                 DEFAULT_PRICE: string;
                 DEFAULT_PRICE_FORMATTED: string;
+                DEFAULT_SINGLE_PRICE: string;
+                DEFAULT_SINGLE_PRICE_FORMATTED: string;
                 DEFAULT_CURRENCY: string;
             };
             PURCHASED_ITEMS: {
                 PRICE: string;
                 PRICE_FORMATTED: string;
+                SINGLE_PRICE: string;
+                SINGLE_PRICE_FORMATTED: string;
                 CURRENCY: string;
                 DEFAULT_PRICE: string;
                 DEFAULT_PRICE_FORMATTED: string;
+                DEFAULT_SINGLE_PRICE: string;
+                DEFAULT_SINGLE_PRICE_FORMATTED: string;
                 DEFAULT_CURRENCY: string;
             };
         };
@@ -105,25 +91,37 @@ export declare const productPairs: {
             CART_ITEMS: {
                 PRICE: string;
                 PRICE_FORMATTED: string;
+                SINGLE_PRICE: string;
+                SINGLE_PRICE_FORMATTED: string;
                 CURRENCY: string;
                 DEFAULT_PRICE: string;
                 DEFAULT_PRICE_FORMATTED: string;
+                DEFAULT_SINGLE_PRICE: string;
+                DEFAULT_SINGLE_PRICE_FORMATTED: string;
                 DEFAULT_CURRENCY: string;
             };
             BROWSED_ITEMS: {
                 PRICE: string;
                 PRICE_FORMATTED: string;
+                SINGLE_PRICE: string;
+                SINGLE_PRICE_FORMATTED: string;
                 CURRENCY: string;
                 DEFAULT_PRICE: string;
                 DEFAULT_PRICE_FORMATTED: string;
+                DEFAULT_SINGLE_PRICE: string;
+                DEFAULT_SINGLE_PRICE_FORMATTED: string;
                 DEFAULT_CURRENCY: string;
             };
             PURCHASED_ITEMS: {
                 PRICE: string;
                 PRICE_FORMATTED: string;
+                SINGLE_PRICE: string;
+                SINGLE_PRICE_FORMATTED: string;
                 CURRENCY: string;
                 DEFAULT_PRICE: string;
                 DEFAULT_PRICE_FORMATTED: string;
+                DEFAULT_SINGLE_PRICE: string;
+                DEFAULT_SINGLE_PRICE_FORMATTED: string;
                 DEFAULT_CURRENCY: string;
             };
         };

package/dist/src/extensions/Blocks/Items/enums/settingsEnums.d.ts

@@ -29,11 +29,9 @@ export declare const DefaultConfigValues: {
     productPriceCurrencyLocationControlValue: string;
     productButtonLinkControlValue: string;
     productImageLinkControlValue: string;
-    productNameControlEnabled: string;
     productQuantityControlOpened: string;
     productNameControlTrim: string;
     productQuantityControlEnabled: string;
-    productPriceControlOpened: string;
     productImageVisible: string;
     productNameVisible: string;
     productQuantityVisible: string;
@@ -41,6 +39,7 @@ export declare const DefaultConfigValues: {
     productOriginalPriceVisible: string;
     productButtonVisible: string;
     productImageWidth: string;
+    productImageHeight: string;
 };
 export declare const ItemInCartOptions: {
     [x: string]: {

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

@@ -1,6 +1,8 @@
+import { type ItemsBlockConfig } from './utils/nodeConfigUtils';
 declare const migrationTemplate = "ADD YOUR MIGRATION HERE";
 type ProductType = 'CART_ITEMS' | 'BROWSED_ITEMS' | 'PURCHASED_ITEMS';
 type OrientationType = 'vertical' | 'horizontal';
+type PriceOrientationType = 'vertical' | 'horizontal';
 type TemplateParameters = {
     orientation: OrientationType;
     itemsType: ProductType;
@@ -8,6 +10,25 @@ type TemplateParameters = {
     currencySymbol?: string;
     currencyLocation?: string;
     formattedPrice?: boolean;
+    /** Whether to show single product price (price divided by quantity) */
+    singlePrice?: boolean;
+    migrate?: boolean;
+    /** Legacy config format (data-* attributes for migration) */
+    configBlockAttributes?: Record<string, string>;
+    /** New config format (Stripo V2 nodeConfig from esd-ext-config) */
+    nodeConfig?: Partial<ItemsBlockConfig>;
+    /** Extracted styles from a[product-attr="name"] for migration */
+    nameStyles?: string;
+    /** Extracted styles from a.es-button for migration */
+    buttonStyles?: string;
+    /** Extracted styles from p[product-attr="price"] for migration */
+    priceStyles?: string;
+    /** Extracted styles from p[product-attr="originalPrice"] for migration */
+    originalPriceStyles?: string;
+    /** Extracted styles from p[product-attr="quantity"] for migration */
+    quantityStyles?: string;
+    /** Price orientation within the card ('vertical' = stacked, 'horizontal' = side-by-side) */
+    priceOrientation?: PriceOrientationType;
 };
 /**
  * Generates the default template for the Items Block.
@@ -20,5 +41,5 @@ type TemplateParameters = {
  * @param params.formattedPrice - Whether to use formatted price display
  * @returns HTML template string for the Items Block
  */
-export declare function getDefaultTemplate({ orientation, itemsType, itemId, currencySymbol, currencyLocation, formattedPrice, }: TemplateParameters): string;
+export declare function getDefaultTemplate({ orientation, itemsType, itemId, currencySymbol, currencyLocation, migrate, formattedPrice, configBlockAttributes, nodeConfig, nameStyles, buttonStyles, priceStyles, originalPriceStyles, quantityStyles, priceOrientation, }: TemplateParameters): string;
 export default migrationTemplate;

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

@@ -0,0 +1,77 @@
+import { OrientationType, ProductType } from '@@/Types/extensions/items';
+import { ImmutableHtmlNode, ImmutableHtmlElementNode, ControlApi, BlockApi } from '@stripoinc/ui-editor-extensions';
+/**
+ * Typed configuration object for Items Block.
+ * Configuration is stored directly on the block node using Stripo V2's getNodeConfig/setNodeConfig API.
+ */
+export interface ItemsBlockConfig {
+    initialized: boolean;
+    blockInstanceId: string;
+    source: ProductType;
+    type: ProductType;
+    itemsSelectValue: string;
+    orientation: OrientationType;
+    nameTrimming: boolean;
+    priceHideDiscount: boolean;
+    priceFormatted: boolean;
+    priceSinglePrice: boolean;
+    priceCurrencySymbol: string;
+    priceCurrencyLocation: string;
+    priceOrientation: 'vertical' | 'horizontal';
+    quantityControlEnabled: boolean;
+    buttonLink: string;
+    imageLink: string;
+    buttonLabel: string;
+    /** Whether button should be full width (true = es-fw class) or inline (false = es-il class) */
+    buttonFullWidth: boolean;
+    imageVisible: boolean;
+    nameVisible: boolean;
+    quantityVisible: boolean;
+    priceVisible: boolean;
+    originalPriceVisible: boolean;
+    buttonVisible: boolean;
+}
+/**
+ * Generates a unique block instance ID.
+ */
+export declare function generateBlockInstanceId(): string;
+/**
+ * Escapes $ characters in a string for safe use in String.replace/replaceAll.
+ * Prevents currency symbols like "$", "R$", "HK$" from being interpreted as special replacement patterns.
+ */
+export declare const escapeReplacement: (str: string) => string;
+/**
+ * Returns default ItemsBlockConfig values.
+ * These are used when initializing a new block or when migrating from legacy format.
+ */
+export declare function getDefaultItemsBlockConfig(): ItemsBlockConfig;
+/**
+ * Gets the Items block container element from the current node.
+ * The container is identified by the `.items-block-v2` class (new) or `.esd-cart-items-block` (legacy).
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ * @returns The container element or null if not found
+ */
+export declare function getItemsBlockContainer(currentNode: ImmutableHtmlNode | undefined): ImmutableHtmlElementNode | null;
+/**
+ * Gets the node configuration from the Items block.
+ * Uses Stripo V2's getNodeConfig() API.
+ * Falls back to migrating from legacy config block if nodeConfig is empty.
+ * @param currentNode - The current node from the control
+ * @returns The ItemsBlockConfig object or null if not found
+ */
+export declare function getItemsBlockConfig(currentNode: ImmutableHtmlNode | undefined): ItemsBlockConfig | null;
+/**
+ * Sets the node configuration on the Items block.
+ * Uses Stripo V2's setNodeConfig() API.
+ * @param currentNode - The current node from the control
+ * @param api - The API object (ControlApi or BlockApi)
+ * @param config - The configuration to set (partial update supported)
+ * @param modifier - Optional document modifier for batching updates
+ */
+export declare function setItemsBlockConfig(currentNode: ImmutableHtmlNode | undefined, api: ControlApi | BlockApi, config: Partial<ItemsBlockConfig>, modifier?: ReturnType<typeof api.getDocumentModifier>): void;
+/**
+ * Gets the block instance ID from the node config.
+ * @param currentNode - The current node from the control
+ * @returns The block instance ID or null if not found
+ */
+export declare function getBlockInstanceIdFromConfig(currentNode: ImmutableHtmlNode | undefined): string | null;

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

@@ -7,22 +7,69 @@ export interface CardCompositionItem {
     visible: boolean;
 }
 export declare class RecommendationCardCompositionControl extends CommonControl {
-    private currentComposition;
-    private currentVisibility;
     getId(): string;
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     /**
-     * Initialize the composition order and visibility from the block or use defaults
+     * Creates the HTML content for an orderable item with label and toggle
+     */
+    private _createItemContent;
+    /**
+     * Registers event listeners for composition and visibility changes
+     */
+    private _registerValueChangeListeners;
+    /**
+     * Initializes composition order and visibility state from the current node
      */
     private _initializeComposition;
+    /**
+     * Reads composition order from node's data-card-composition attribute
+     * Falls back to default order if attribute is not present
+     */
+    private _readCompositionFromNode;
+    /**
+     * Builds visibility values object from the visibility map
+     */
+    private _buildVisibilityValues;
+    /**
+     * Read visibility state from individual row elements' data-visibility attributes
+     * This ensures toggles reflect the actual DOM state
+     */
+    private _readVisibilityFromRows;
+    /**
+     * Returns default visibility values for all items
+     */
+    private _getDefaultVisibilities;
+    /**
+     * Extracts visibility values from DOM nodes
+     */
+    private _extractVisibilityFromRows;
+    /**
+     * Parses visibility value from string to boolean
+     * Accepts "1", "true" as true, everything else as false
+     */
+    private _parseVisibilityValue;
+    /**
+     * Merges extracted visibilities with default values for missing keys
+     */
+    private _mergeWithDefaults;
     /**
      * Apply the reordered composition to the block's HTML structure
+     * Updates the data-card-composition attribute and reorders product attributes
      */
     private _applyCompositionToBlock;
+    /**
+     * Reorders attribute rows within each product row based on composition order
+     */
+    private _reorderProductAttributes;
+    /**
+     * Builds HTML string with attributes ordered according to composition
+     */
+    private _buildCompositionHtml;
     /**
      * Apply visibility changes to the block's HTML structure
+     * Updates display style and data-visibility attribute for all matching rows
      */
     private _applyVisibilityToBlock;
 }

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

@@ -1,3 +1,14 @@
+/**
+ * Attribute type constants used in templates
+ * These are used as keys in ElementRenderer and composition arrays
+ */
+export declare const ATTR_PRODUCT_IMAGE = "productImage";
+export declare const ATTR_PRODUCT_NAME = "productName";
+export declare const ATTR_PRODUCT_PRICE = "productPrice";
+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";
 /**
  * Block IDs used in the Recommendation Extension
  * These IDs are used in the esd-extension-block-id attribute to identify specific blocks
@@ -7,6 +18,8 @@ export declare enum RecommendationBlockId {
     NAME = "recommendation-block-name",
     PRICE = "recommendation-block-price",
     OLD_PRICE = "recommendation-block-old-price",
+    OMNIBUS_PRICE = "recommendation-block-omnibus-price",
+    OMNIBUS_DISCOUNT = "recommendation-block-omnibus-discount",
     IMAGE = "recommendation-block-image"
 }
 /**
@@ -32,6 +45,7 @@ export declare enum RecommendationControlId {
     NAME_PADDINGS = "recommendation-block-name-paddings-control",
     NAME_SIZE = "recommendation-block-name-size-control",
     NAME_STYLE = "recommendation-block-name-style-control",
+    NAME_TEXT_TRIM = "recommendation-block-name-text-trim-control",
     PRICE_ALIGN = "recommendation-block-price-align-control",
     PRICE_BACKGROUND = "recommendation-block-price-background-control",
     PRICE_COLOR = "recommendation-block-price-color-control",
@@ -46,6 +60,24 @@ export declare enum RecommendationControlId {
     OLD_PRICE_PADDINGS = "recommendation-block-old-price-paddings-control",
     OLD_PRICE_SIZE = "recommendation-block-old-price-size-control",
     OLD_PRICE_STYLE = "recommendation-block-old-price-style-control",
+    OMNIBUS_PRICE_ALIGN = "recommendation-block-omnibus-price-align-control",
+    OMNIBUS_PRICE_BACKGROUND = "recommendation-block-omnibus-price-background-control",
+    OMNIBUS_PRICE_COLOR = "recommendation-block-omnibus-price-color-control",
+    OMNIBUS_PRICE_FONT_FAMILY = "recommendation-block-omnibus-price-font-family-control",
+    OMNIBUS_PRICE_PADDINGS = "recommendation-block-omnibus-price-paddings-control",
+    OMNIBUS_PRICE_SIZE = "recommendation-block-omnibus-price-size-control",
+    OMNIBUS_PRICE_STYLE = "recommendation-block-omnibus-price-style-control",
+    OMNIBUS_PRICE_TEXT_BEFORE = "recommendation-block-omnibus-price-text-before-control",
+    OMNIBUS_PRICE_TEXT_AFTER = "recommendation-block-omnibus-price-text-after-control",
+    OMNIBUS_DISCOUNT_ALIGN = "recommendation-block-omnibus-discount-align-control",
+    OMNIBUS_DISCOUNT_BACKGROUND = "recommendation-block-omnibus-discount-background-control",
+    OMNIBUS_DISCOUNT_COLOR = "recommendation-block-omnibus-discount-color-control",
+    OMNIBUS_DISCOUNT_FONT_FAMILY = "recommendation-block-omnibus-discount-font-family-control",
+    OMNIBUS_DISCOUNT_PADDINGS = "recommendation-block-omnibus-discount-paddings-control",
+    OMNIBUS_DISCOUNT_SIZE = "recommendation-block-omnibus-discount-size-control",
+    OMNIBUS_DISCOUNT_STYLE = "recommendation-block-omnibus-discount-style-control",
+    OMNIBUS_DISCOUNT_TEXT_BEFORE = "recommendation-block-omnibus-discount-text-before-control",
+    OMNIBUS_DISCOUNT_TEXT_AFTER = "recommendation-block-omnibus-discount-text-after-control",
     IMAGE_SIZE = "recommendation-block-image-size-control",
     IMAGE_MARGINS = "recommendation-block-image-margins-control"
 }

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

@@ -17,8 +17,6 @@ export declare class RecommendationBlockControl extends CommonControl {
     _getProductLayout(): string;
     _getFilterStatus(): string;
     _getShuffleProducts(): string;
-    _getResponsive(): string;
-    _onFilterChange(value: boolean): void;
     _onFilterSelectClick(): void;
     _onDataChange(item: string, value: string | number | string[]): void;
     /**
@@ -26,6 +24,11 @@ export declare class RecommendationBlockControl extends CommonControl {
      */
     _getCardComposition(): string[];
     _regenerateProductRows(): void;
+    /**
+     * Reapply spacing values after product regeneration
+     * This ensures spacing persists when products are regenerated
+     */
+    _reapplySpacing(): void;
     _debouncedRegenerateProductRows: import("@vueuse/shared").PromisifyFn<() => void>;
     _onCurrencyConfigChange(item: string, value: string | number): void;
     _onCurrencyChange(value: string): void;

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

@@ -0,0 +1,25 @@
+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";
+/**
+ * Control for managing recommendation card background color
+ * This control is displayed in the Styles tab
+ */
+export declare class CardBackgroundColorControl extends CommonControl {
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    /**
+     * Reads the current background color from the first product card wrapper
+     * @returns The background color value or 'transparent' if not found
+     */
+    _getCurrentCardBackgroundColor(): string;
+    /**
+     * Handles card background color changes
+     * Applies the color to all product card wrapper elements
+     */
+    _onCardBackgroundColorChange(color: string): void;
+    _listenToFormUpdates(): void;
+}