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

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

@@ -1,73 +0,0 @@
-import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
-import { CommonControl } from '../../../common-control';
-export declare const SPACING_CONTROL_ID = "recommendation-spacing-control";
-/**
- * Control for managing spacing between product cards
- * - Column spacing: horizontal gap between cards in the same row
- * - Row spacing: vertical gap between different rows
- */
-export declare class SpacingControl extends CommonControl {
-    private store;
-    private unsubscribeOrientation;
-    getId(): string;
-    getTemplate(): string;
-    onRender(): void;
-    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
-    onDestroy(): void;
-    /**
-     * Updates column spacing visibility based on layout orientation
-     * Column spacing is hidden for horizontal layout (products are stacked vertically)
-     * Reads from store first for reliability, falls back to DOM
-     */
-    _updateColumnSpacingVisibility(): void;
-    /**
-     * Reads spacing values from data attributes or returns defaults
-     */
-    _setFormValues(): void;
-    /**
-     * Gets stored column spacing from the first attribute row cell's padding.
-     * For vertical layout: cells inside .recommendation-attribute-row have padding applied.
-     * For horizontal layout: the parent of .product-card-wrapper has the padding.
-     * The padding is applied as "0 {halfSpacing}px", so we extract and multiply by 2.
-     */
-    _getStoredColumnSpacing(): number;
-    /**
-     * Gets stored row spacing from the first spacer element's height style
-     */
-    _getStoredRowSpacing(): number;
-    /**
-     * Handles column spacing changes.
-     * For vertical layout: applies horizontal padding to all cells inside attribute rows.
-     * For horizontal layout: applies padding to parent of product card wrappers.
-     */
-    _onColumnSpacingChange(spacing: number): void;
-    /**
-     * Handles row spacing changes
-     * Applies height to all spacer elements between product rows
-     */
-    _onRowSpacingChange(spacing: number): void;
-    /**
-     * Stores column spacing value in block data attribute
-     */
-    _storeColumnSpacing(spacing: number): void;
-    /**
-     * Stores row spacing value in block data attribute
-     */
-    _storeRowSpacing(spacing: number): void;
-    _listenToFormUpdates(): void;
-    /**
-     * Debounced version of _onColumnSpacingChange
-     * Prevents excessive DOM updates when user rapidly adjusts the counter
-     */
-    _debouncedOnColumnSpacingChange: import("@vueuse/shared").PromisifyFn<(spacing: number) => void>;
-    /**
-     * Debounced version of _onRowSpacingChange
-     * Prevents excessive DOM updates when user rapidly adjusts the counter
-     */
-    _debouncedOnRowSpacingChange: import("@vueuse/shared").PromisifyFn<(spacing: number) => void>;
-    /**
-     * Subscribe to store orientation changes
-     * Updates column spacing visibility when layout changes via the layout control
-     */
-    _subscribeToOrientationChanges(): void;
-}

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

@@ -1,8 +0,0 @@
-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

@@ -1,25 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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

@@ -1,39 +0,0 @@
-/**
- * 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

@@ -1,45 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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/vertical/template.d.ts

@@ -1,33 +0,0 @@
-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

@@ -1,19 +0,0 @@
-/**
- * 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/Recommendation/utils/tagName.d.ts

@@ -1,77 +0,0 @@
-/**
- * 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 {};