@useinsider/guido 2.0.0-beta.dd0d492 → 2.0.0-beta.e66a90a

package/dist/src/extensions/Blocks/Recommendation/templates/horizontal/elementRenderer.d.ts

@@ -0,0 +1,8 @@
+import type { ElementRenderer } from '../utils';
+/**
+ * Horizontal element renderer
+ * - Image and Button return `<td>` cells for the 3-column layout
+ * - Name and Prices return `<tr><td>` rows for the info cell table
+ * All elements have esd-block-* classes for Stripo selection
+ */
+export declare const horizontalElementRenderer: ElementRenderer;

package/dist/src/extensions/Blocks/Recommendation/templates/horizontal/migration.d.ts

@@ -0,0 +1,25 @@
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { DEFAULTS, getDefaultProducts } from '../utils';
+/**
+ * Migration template for horizontal layout
+ * Used when migrating old recommendation blocks to horizontal format
+ */
+declare const migrationTemplate = "\n    <td\n        align=\"left\"\n        esd-extension-block-id=\"recommendation-block\"\n        esd-handler-name=\"esd-extension-RecommendationBlock\"\n        class=\"ins-recommendation-v3-block-v2 esd-block-recommendation-v3-block esd-extension-block es-p20\"\n        data-layout=\"horizontal\"\n    >\n        <table width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\">\n            <tr>\n                <td align=\"center\">\n                    <table\n                        class=\"container\"\n                        width=\"100%\"\n                        cellpadding=\"0\"\n                        cellspacing=\"0\"\n                        border=\"0\">\n                        <tbody>\n                            <tr>\n                                <td>\n                                    <table\n                                        width=\"100%\"\n                                        cellpadding=\"0\"\n                                        cellspacing=\"0\"\n                                        border=\"0\">\n                                        <tbody>\n                                            <tr>\n                                                {-{-TITLE-}-}\n                                            </tr>\n                                        </tbody>\n                                    </table>\n                                </td>\n                            </tr>\n                            <tr>\n                                <td class=\"spacer\" style=\"height: 20px;\"></td>\n                            </tr>\n                            <tr>\n                                <td>\n                                    <table\n                                        class=\"ins-recommendation-product-container\"\n                                        width=\"100%\"\n                                        cellpadding=\"0\"\n                                        cellspacing=\"0\"\n                                        border=\"0\"\n                                    >\n                                        {-{-PRODUCT_ROWS-}-}\n                                    </table>\n                                </td>\n                            </tr>\n                        </tbody>\n                    </table>\n                </td>\n            </tr>\n        </table>\n    </td>\n";
+export declare function getMigrationTemplate(): string;
+/**
+ * Generates a custom horizontal migration template with specified products
+ * @param products - Array of products to display
+ * @param title - Optional title for the block
+ * @param composition - Optional array defining order of card elements
+ * @returns Complete HTML template
+ */
+export declare function generateMigrationTemplate(products: RecommendationProduct[], title?: string, composition?: string[]): string;
+/**
+ * Prepares horizontal product rows for migration
+ * @param products - Array of products to display
+ * @param composition - Optional array defining order of card elements
+ * @returns HTML string for product rows
+ */
+export declare function prepareProductRows(products: RecommendationProduct[], composition?: string[]): string;
+export { DEFAULTS, getDefaultProducts };
+export default migrationTemplate;

package/dist/src/extensions/Blocks/Recommendation/templates/horizontal/template.d.ts

@@ -0,0 +1,18 @@
+import type { RecommendationProduct } from '@@/Types/recommendation';
+/**
+ * Generates a horizontal product card with 3-column layout
+ * Uses horizontalElementRenderer to render Image, Info content, and Button
+ * Layout: [Image (120px)] [Info table (flexible)] [Button (100px)]
+ * @param product - The product data
+ * @returns HTML string for a single product card row
+ */
+export declare function getHorizontalProductCard(product: RecommendationProduct): string;
+/**
+ * Prepares horizontal product rows
+ * Each product is a full-width row with 3-column layout
+ * @param products - Array of products to display
+ * @returns HTML string for product rows
+ */
+export declare function prepareProductRows(products: RecommendationProduct[]): string;
+export declare function getDefaultTemplate(): string;
+export declare function generateBlockTemplate(products: RecommendationProduct[], title?: string): string;

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

@@ -0,0 +1,39 @@
+/**
+ * Unified Template API for Recommendation Block
+ *
+ * This module provides a single entry point for working with recommendation
+ * block templates, abstracting away the layout-specific implementations.
+ */
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { type Orientation, type PrepareProductRowsOptions } from './utils';
+export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefaultProducts, spacer, createBlockTemplate, type Orientation, type PrepareProductRowsOptions, type ElementRenderer, type ProductCardGetter, } from './utils';
+/**
+ * Unified function to prepare product rows for any layout.
+ * Delegates to the appropriate layout-specific implementation.
+ * @example
+ * // Horizontal layout (full-width rows)
+ * prepareProductRows(products, 'horizontal');
+ * @example
+ * // Vertical layout (grid)
+ * prepareProductRows(products, 'vertical', { productsPerRow: 3 });
+ * @param products - Array of products to display
+ * @param layout - The layout orientation ('horizontal' or 'vertical')
+ * @param options - Layout-specific options
+ * @returns HTML string for product rows
+ */
+export declare function prepareProductRows(products: RecommendationProduct[], layout: Orientation, options?: PrepareProductRowsOptions): string;
+/**
+ * Generates the default template for a given layout.
+ * @param layout - The layout orientation ('horizontal' or 'vertical')
+ * @returns Complete HTML template with default products
+ */
+export declare function getDefaultTemplate(layout?: Orientation): string;
+/**
+ * Generates a complete block template with custom products.
+ * @param products - Array of products to display
+ * @param layout - The layout orientation ('horizontal' or 'vertical')
+ * @param title - Title for the block
+ * @param options - Layout-specific options
+ * @returns Complete HTML template
+ */
+export declare function generateBlockTemplate(products: RecommendationProduct[], layout: Orientation, title?: string, options?: PrepareProductRowsOptions): string;

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

@@ -0,0 +1,45 @@
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { 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 '../constants';
+export type Orientation = 'horizontal' | 'vertical';
+/**
+ * Options for prepareProductRows unified function
+ */
+export interface PrepareProductRowsOptions {
+    /** Number of products per row (only for vertical layout, defaults to 3) */
+    productsPerRow?: number;
+    /** Array defining order of card elements */
+    composition?: string[];
+}
+/**
+ * Element renderer interface for product card elements
+ * Keys are ATTR_PRODUCT_* constants for consistent naming
+ */
+export interface ElementRenderer {
+    [ATTR_PRODUCT_IMAGE]: (product: RecommendationProduct) => string;
+    [ATTR_PRODUCT_NAME]: (product: RecommendationProduct) => string;
+    [ATTR_PRODUCT_PRICE]: (product: RecommendationProduct) => string;
+    [ATTR_PRODUCT_OLD_PRICE]: (product: RecommendationProduct) => string;
+    [ATTR_PRODUCT_OMNIBUS_PRICE]: (product: RecommendationProduct) => string;
+    [ATTR_PRODUCT_OMNIBUS_DISCOUNT]: (product: RecommendationProduct) => string;
+    [ATTR_PRODUCT_BUTTON]: (product: RecommendationProduct) => string;
+}
+/**
+ * Product card getter function type
+ * Used by prepareProductRows to generate individual product cards
+ */
+export type ProductCardGetter = (product: RecommendationProduct, composition?: string[]) => string;
+export declare const DEFAULTS: {
+    TITLE: string;
+    DESCRIPTION: string;
+};
+export declare const DEFAULT_CARD_COMPOSITION: string[];
+export declare const DEFAULT_CARD_VISIBILITY: Record<string, boolean>;
+export declare const spacer = "\n    <tr>\n        <td class=\"spacer\" style=\"height: 10px;\"></td>\n    </tr>\n";
+export declare function getDefaultProducts(): RecommendationProduct[];
+/**
+ * Creates the block template wrapper HTML for recommendation blocks.
+ * The template includes title placeholder and product container.
+ * @param layout - The layout orientation ('horizontal' or 'vertical')
+ * @returns HTML template string with {-{-TITLE-}-} and {-{-PRODUCT_ROWS-}-} placeholders
+ */
+export declare function createBlockTemplate(layout?: Orientation): string;

package/dist/src/extensions/Blocks/Recommendation/templates/vertical/elementRenderer.d.ts

@@ -0,0 +1,7 @@
+import type { ElementRenderer } from '../utils';
+/**
+ * Class name for outer cells in attribute rows
+ * Used by controls to reliably select direct children for spacing adjustments
+ */
+export declare const ATTRIBUTE_CELL_CLASS = "attribute-cell";
+export declare const verticalElementRenderer: ElementRenderer;

package/dist/src/extensions/Blocks/Recommendation/templates/{migrationTemplate.d.ts → vertical/migration.d.ts}

@@ -1,9 +1,17 @@
 import type { RecommendationProduct } from '@@/Types/recommendation';
-import { DEFAULTS, getDefaultProducts } from './templateUtils';
+import { DEFAULTS, getDefaultProducts, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY } from '../utils';
 declare const migrationTemplate = "\n    <td\n        align=\"left\"\n        esd-extension-block-id=\"recommendation-block\"\n        esd-handler-name=\"esd-extension-RecommendationBlock\"\n        class=\"ins-recommendation-v3-block-v2 esd-block-recommendation-v3-block esd-extension-block es-p20\"\n    >\n        <table width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\">\n            <tr>\n                <td align=\"center\">\n                    <table\n                        class=\"container\"\n                        width=\"100%\"\n                        cellpadding=\"0\"\n                        cellspacing=\"0\"\n                        border=\"0\">\n                        <tbody>\n                            <tr>\n                                <td>\n                                    <table\n                                        width=\"100%\"\n                                        cellpadding=\"0\"\n                                        cellspacing=\"0\"\n                                        border=\"0\">\n                                        <tbody>\n                                            <tr>\n                                                {-{-TITLE-}-}\n                                            </tr>\n                                        </tbody>\n                                    </table>\n                                </td>\n                            </tr>\n                            <tr>\n                                <td class=\"spacer\" style=\"height: 20px;\"></td>\n                            </tr>\n                            <tr>\n                                <td>\n                                    <table\n                                        class=\"ins-recommendation-product-container\"\n                                        width=\"100%\"\n                                        cellpadding=\"0\"\n                                        cellspacing=\"0\"\n                                        border=\"0\"\n                                    >\n                                        {-{-PRODUCT_ROWS-}-}\n                                    </table>\n                                </td>\n                            </tr>\n                        </tbody>\n                    </table>\n                </td>\n            </tr>\n        </table>\n    </td>\n";
+/**
+ * Prepares migration product rows with attribute-aligned structure.
+ * @param products - Array of products to display
+ * @param productsPerRow - Number of products per row
+ * @param composition - Array defining element order
+ * @returns HTML string for product rows
+ */
+export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[]): string;
 export declare function getMigrationTemplate(): string;
 /**
- * Generates a custom migration template with specified products and layout
+ * Generates a custom migration template with specified products and layout.
  * @param products - Array of products to display
  * @param productsPerRow - Number of products per row
  * @param title - Optional title for the block
@@ -11,6 +19,5 @@ export declare function getMigrationTemplate(): string;
  * @returns Complete HTML template
  */
 export declare function generateMigrationTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: string[]): string;
-export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[]): string;
-export { DEFAULTS, getDefaultProducts };
+export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefaultProducts, };
 export default migrationTemplate;

package/dist/src/extensions/Blocks/Recommendation/templates/vertical/template.d.ts

@@ -0,0 +1,33 @@
+import type { RecommendationProduct } from '@@/Types/recommendation';
+import { type ElementRenderer } from '../utils';
+/**
+ * Generates attribute-aligned product rows for vertical layout.
+ * Creates rows where each row contains one attribute type from all products.
+ * @param products - Array of products in this row group
+ * @param productsPerRow - Number of products per row (for column width calculation)
+ * @param elementRenderer - Object mapping attribute types to render functions
+ * @param composition - Array defining order of card elements
+ * @returns HTML string for attribute-aligned rows
+ */
+export declare function prepareVerticalAttributeRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[]): string;
+/**
+ * Prepares vertical product rows with attribute-aligned structure
+ * Groups products into rows, then generates attribute-aligned HTML for each group
+ * @param products - Array of products to display
+ * @param productsPerRow - Number of products per row
+ * @param elementRenderer - Object mapping attribute types to render functions
+ * @param composition - Array defining order of card elements
+ * @returns HTML string for all product rows
+ */
+export declare function prepareVerticalProductRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[]): string;
+/**
+ * Prepares vertical product rows with attribute-aligned structure.
+ * Uses row-based rendering where each attribute type forms a single row across all products.
+ * @param products - Array of products to display
+ * @param productsPerRow - Number of products per row
+ * @param composition - Array defining element order
+ * @returns HTML string for product rows
+ */
+export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[]): string;
+export declare function getDefaultTemplate(): string;
+export declare function generateBlockTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: string[]): string;

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

@@ -0,0 +1,19 @@
+/**
+ * Utility for preserving text styling when updating innerHTML
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+/**
+ * Preserves existing style tags when updating text content
+ *
+ * When users apply text styles (bold, italic, etc.) in Stripo, the editor wraps
+ * content in tags like <strong>, <em>, <u>, <s>. This function extracts those
+ * style tags from the original HTML and re-applies them to the new text content.
+ * @example
+ * // Original: <span class="omnibus-text-before"><strong>Lowest price: </strong></span>
+ * // After calling preserveTextStyles(element, 'Best price: ')
+ * // Result: <strong>Best price: </strong>
+ * @param element - The DOM element or ImmutableHtmlNode containing the styled text
+ * @param newText - The new text content to insert
+ * @returns The new text wrapped in the original style tags
+ */
+export declare function preserveTextStyles(element: ImmutableHtmlNode | Element, newText: string): string;

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/extensions/Blocks/controlFactories.d.ts

@@ -12,8 +12,9 @@
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 /**
  * Factory function to create text align controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextAlignControl(controlId: string, targetBlockId: string, containerSelector: string): {
+export declare function createTextAlignControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -27,8 +28,9 @@ export declare function createTextAlignControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text color controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextColorControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextColorControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -42,8 +44,9 @@ export declare function createTextColorControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text size controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextSizeControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextSizeControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -57,8 +60,9 @@ export declare function createTextSizeControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text style controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextStyleControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextStyleControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -72,8 +76,9 @@ export declare function createTextStyleControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text font family controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextFontFamilyControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextFontFamilyControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -87,8 +92,9 @@ export declare function createTextFontFamilyControl(controlId: string, targetBlo
 };
 /**
  * Factory function to create text background color controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextBackgroundColorControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextBackgroundColorControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -102,8 +108,25 @@ export declare function createTextBackgroundColorControl(controlId: string, targ
 };
 /**
  * Factory function to create paddings controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createPaddingsControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createPaddingsControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: ImmutableHtmlNode): boolean;
+    };
+};
+/**
+ * Factory function to create text line spacing controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
+ */
+export declare function createTextLineSpacingControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];