@useinsider/guido 2.1.0-beta.7d0f92a → 2.1.0-beta.860ef21

package/dist/src/extensions/Blocks/Recommendation/services/configService.d.ts

@@ -1,151 +0,0 @@
-/**
- * Recommendation Config Service
- *
- * Service for managing Recommendation block configuration via Stripo's node config API.
- * This replaces the Pinia store for persistent configuration data.
- *
- * Key features:
- * - Reads/writes config to/from node using `getNodeConfig`/`setNodeConfig`
- * - Configuration persists with the template HTML
- * - Each block has independent configuration (no global state)
- * - Integrates with Stripo's undo/redo via `ModificationDescription`
- *
- * Usage pattern similar to legacy `blockConfigurationService`:
- * @example
- * // Read config
- * const config = RecommendationConfigService.getConfig(node);
- * // Update config
- * RecommendationConfigService.updateConfig(api, node, { strategy: 'mostPopular' }, 'Changed algorithm');
- * @see https://plugin.stripo.email/extensions/reference/blocks/Block
- */
-import type { RecommendationNodeConfig, PartialNodeConfig } from '../types/nodeConfig';
-import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
-import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
-/**
- * Stripo Extension API interface for document modifications
- * Extracted to allow type-safe usage without importing full Stripo types
- */
-interface DocumentModifier {
-    modifyHtml: (node: ImmutableHtmlNode) => {
-        setNodeConfig: (config: Record<string, unknown>) => DocumentModifier;
-        setAttribute: (name: string, value: string) => DocumentModifier;
-        setStyle: (prop: string, value: string) => DocumentModifier;
-        setInnerHtml: (html: string) => DocumentModifier;
-    };
-    apply: (desc: ModificationDescription) => void;
-}
-interface DocumentModifierApi {
-    getDocumentModifier: () => DocumentModifier;
-}
-/**
- * Service for managing Recommendation block configuration
- *
- * All methods are static for easy usage without instantiation.
- * The service follows the same patterns as the legacy `blockConfigurationService`.
- */
-export declare class RecommendationConfigService {
-    /**
-     * Get configuration from a node, with defaults for missing values
-     *
-     * This is the primary way to read configuration from a block.
-     * Always returns a complete config object with defaults merged in.
-     * @example
-     * const config = RecommendationConfigService.getConfig(this.currentNode);
-     * console.log(config.strategy); // 'mostPopular'
-     * @param node - The immutable HTML node to read config from
-     * @returns Complete configuration with defaults for missing values
-     */
-    static getConfig(node: ImmutableHtmlNode | null | undefined): RecommendationNodeConfig;
-    /**
-     * Check if a node has valid configuration stored
-     *
-     * Used for migration detection - returns false for legacy templates
-     * that need their configuration migrated.
-     * @param node - The immutable HTML node to check
-     * @returns True if node has valid config with version number
-     */
-    static hasConfig(node: ImmutableHtmlNode | null | undefined): boolean;
-    /**
-     * Get the configuration version from a node
-     * @param node - The immutable HTML node to check
-     * @returns Config version number, or 0 if no config exists
-     */
-    static getConfigVersion(node: ImmutableHtmlNode | null | undefined): number;
-    /**
-     * Update specific configuration values
-     *
-     * Merges the updates with existing config and persists to node.
-     * This is the primary way to update configuration from controls.
-     * @example
-     * RecommendationConfigService.updateConfig(
-     *   this.api,
-     *   this.currentNode,
-     *   { strategy: 'complementaryItems' },
-     *   'Changed recommendation algorithm'
-     * );
-     * @param api - Stripo extension API with document modifier
-     * @param node - The immutable HTML node to update
-     * @param updates - Partial config with values to update
-     * @param description - Human-readable description for undo/redo
-     * @returns The new complete configuration
-     */
-    static updateConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, updates: PartialNodeConfig, description: string): RecommendationNodeConfig;
-    /**
-     * Initialize configuration for a new block
-     *
-     * Called when a block is first created (dropped into template).
-     * Can optionally merge in partial config from migration.
-     * @example
-     * // In Block.onCreated lifecycle
-     * RecommendationConfigService.initializeConfig(this.api, node);
-     * @param api - Stripo extension API with document modifier
-     * @param node - The immutable HTML node to initialize
-     * @param partialConfig - Optional partial config to merge with defaults
-     * @returns The initialized configuration
-     */
-    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): RecommendationNodeConfig;
-    /**
-     * Save complete configuration to a node
-     *
-     * Low-level method - prefer `updateConfig` or `initializeConfig` in most cases.
-     * @param api - Stripo extension API with document modifier
-     * @param node - The immutable HTML node to save to
-     * @param config - Complete configuration to save
-     * @param description - Human-readable description for undo/redo
-     */
-    static saveConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, config: RecommendationNodeConfig, description: string): void;
-    /**
-     * Migrate configuration from legacy data-attributes
-     *
-     * Reads existing data-attributes and creates a proper node config.
-     * Used when loading templates created before node config was implemented.
-     * @param api - Stripo extension API with document modifier
-     * @param node - The block node to migrate
-     * @returns The migrated configuration
-     */
-    static migrateFromDataAttributes(api: DocumentModifierApi, node: ImmutableHtmlNode): RecommendationNodeConfig;
-    /**
-     * Check if configuration needs migration
-     * @param node - The block node to check
-     * @returns True if migration is needed
-     */
-    static needsMigration(node: ImmutableHtmlNode | null | undefined): boolean;
-    /**
-     * Clone default config to avoid mutations
-     */
-    private static cloneDefaults;
-    /**
-     * Merge partial config with defaults
-     *
-     * Deep merges nested objects like currency, omnibus settings.
-     */
-    private static mergeWithDefaults;
-    /**
-     * Deep merge for nested objects
-     *
-     * Recursively merges source into target, preserving existing values
-     * that aren't explicitly overwritten.
-     */
-    private static deepMerge;
-}
-export {};

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

@@ -1,6 +0,0 @@
-/**
- * Recommendation Extension Services
- *
- * This module re-exports all services for the Recommendation extension.
- */
-export { RecommendationConfigService } from './configService';

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

@@ -1,20 +0,0 @@
-import type { ElementRenderer } from '../utils';
-/**
- * Grid element renderer
- * Each element returns a `<td>` containing a nested table structure:
- * - Outer `<td>` has padding for column spacing
- * - Inner `<table class="product-card-segment">` supports background color
- * - Content is inside the inner table
- *
- * This structure allows:
- * 1. Row-based alignment (all same attributes in one row)
- * 2. Per-card background color via inner table
- * 3. Column spacing via outer cell padding
- */
-export declare const DEFAULT_CELL_PADDING = "0 5px";
-/**
- * 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 gridElementRenderer: ElementRenderer;

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

@@ -1,33 +0,0 @@
-import type { RecommendationProduct } from '@@/Types/recommendation';
-import { type ElementRenderer } from '../utils';
-/**
- * Generates attribute-aligned product rows for grid 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 prepareGridAttributeRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[]): string;
-/**
- * Prepares grid 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 prepareGridProductRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[]): string;
-/**
- * Prepares grid 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(recommendationId?: number): string;
-export declare function generateBlockTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: 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, sanitizeImageUrl, 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
- * // List layout (full-width rows)
- * prepareProductRows(products, 'list');
- * @example
- * // Grid layout
- * prepareProductRows(products, 'grid', { productsPerRow: 3 });
- * @param products - Array of products to display
- * @param layout - The layout orientation ('list' or 'grid')
- * @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 ('list' or 'grid')
- * @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 ('list' or 'grid')
- * @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/list/elementRenderer.d.ts

@@ -1,8 +0,0 @@
-import type { ElementRenderer } from '../utils';
-/**
- * List 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 listElementRenderer: ElementRenderer;

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

@@ -1,25 +0,0 @@
-import type { RecommendationProduct } from '@@/Types/recommendation';
-import { DEFAULTS, getDefaultProducts } from '../utils';
-/**
- * Migration template for list layout
- * Used when migrating old recommendation blocks to list 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=\"list\"\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 list 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 list 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/list/template.d.ts

@@ -1,18 +0,0 @@
-import type { RecommendationProduct } from '@@/Types/recommendation';
-/**
- * Generates a list product card with 3-column layout
- * Uses listElementRenderer 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 getListProductCard(product: RecommendationProduct): string;
-/**
- * Prepares list 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/utils.d.ts

@@ -1,57 +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 = 'list' | 'grid';
-/**
- * Options for prepareProductRows unified function
- */
-export interface PrepareProductRowsOptions {
-    /** Number of products per row (only for grid 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 const PLACEHOLDER_IMAGE = "https://email-static.useinsider.com/stripo/modules/email-recommendation-v3/assets/images/image-placeholder.png";
-/**
- * Sanitizes product image URLs for consistent rendering
- * - Converts http:// to https:// to avoid mixed content issues
- * - Returns placeholder for invalid/empty URLs
- * @param url - The image URL to sanitize
- * @returns Sanitized HTTPS URL or placeholder
- */
-export declare function sanitizeImageUrl(url: string | undefined | null): string;
-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 ('list' or 'grid')
- * @param instanceClass - Optional instance-specific class (e.g., 'ins-recommendation-v3-block-1')
- *   for CSS scoping per block instance. Must be included in the initial template HTML because
- *   Stripo's Angular rendering manages the class attribute and overwrites dynamic setAttribute changes.
- * @returns HTML template string with {-{-TITLE-}-} and {-{-PRODUCT_ROWS-}-} placeholders
- */
-export declare function createBlockTemplate(layout?: Orientation, instanceClass?: string): string;

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

@@ -1,7 +0,0 @@
-/**
- * Recommendation Extension Types
- *
- * This module re-exports all type definitions for the Recommendation extension.
- */
-export type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig, PartialNodeConfig, DeepPartialNodeConfig, } from './nodeConfig';
-export { isValidNodeConfig, hasMinimalConfig, } from './nodeConfig';

package/dist/src/extensions/Blocks/Recommendation/types/nodeConfig.d.ts

@@ -1,160 +0,0 @@
-/**
- * Node Configuration Types for Recommendation Block
- *
- * This module defines the TypeScript interfaces for configuration data
- * stored via Stripo's `setNodeConfig`/`getNodeConfig` APIs.
- *
- * The configuration persists with the template HTML, solving:
- * - Configuration loss on save/reload
- * - Multi-block independence
- * - Undo/redo integration
- * @see https://plugin.stripo.email/extensions/reference/blocks/Block
- */
-import type { Filter } from '@@/Types/recommendation';
-/**
- * Currency display and formatting settings
- */
-export interface CurrencyConfig {
-    /** Currency code (e.g., 'USD', 'EUR', 'TRY') */
-    code: string;
-    /** Currency symbol (e.g., '$', '€', '₺') */
-    symbol: string;
-    /** Symbol position relative to price */
-    alignment: 'before' | 'after';
-    /** Number of decimal places (-1 for no formatting) */
-    decimalCount: number;
-    /** Character used for decimal separation */
-    decimalSeparator: '.' | ',';
-    /** Character used for thousands separation */
-    thousandSeparator: '.' | ',' | ' ' | '';
-}
-/**
- * Configuration for omnibus price/discount text wrappers
- * Used to display EU Omnibus Directive compliant pricing
- */
-export interface OmnibusTextConfig {
-    /** Text to prepend (e.g., 'Lowest 30-day price: ') */
-    textBefore: string;
-    /** Text to append */
-    textAfter: string;
-}
-/**
- * Complete configuration schema for Recommendation Block
- *
- * This interface combines:
- * - Legacy `esd-dev-product-config` structure patterns
- * - Current data-attribute based settings
- * - Campaign data that was previously in Pinia store
- *
- * All properties are persisted with the template via `setNodeConfig`.
- */
-export interface RecommendationNodeConfig {
-    /**
-     * Recommendation algorithm/strategy
-     * @example 'mostPopular', 'complementaryItems', 'manualMerchandising'
-     */
-    strategy: string;
-    /**
-     * Product IDs for manual merchandising strategy
-     * Only used when strategy === 'manualMerchandising'
-     */
-    productIds: string[];
-    /**
-     * Number of products to fetch from API
-     * Stored as string for consistency with API params
-     */
-    size: string;
-    /**
-     * Whether to randomize product order on each load
-     */
-    shuffleProducts: boolean;
-    /**
-     * Locale/language for product data
-     * @example 'en_US', 'tr_TR', 'de_DE'
-     */
-    language: string;
-    /**
-     * Currency display and formatting configuration
-     */
-    currency: CurrencyConfig;
-    /**
-     * Product filters for narrowing recommendations
-     * Uses existing Filter interface from recommendation types
-     */
-    filters: Filter[];
-    /**
-     * Layout orientation
-     * - 'grid': Products in a grid, attributes aligned across products
-     * - 'list': Products in rows, each product is a full-width card
-     */
-    layout: 'grid' | 'list';
-    /**
-     * Number of products per row (grid layout only)
-     */
-    cardsInRow: number;
-    /**
-     * Horizontal spacing between product cards in pixels (grid layout only)
-     */
-    columnSpacing: number;
-    /**
-     * Vertical spacing between product rows in pixels
-     */
-    rowSpacing: number;
-    /**
-     * Order of card elements from top to bottom
-     * Array of ATTR_PRODUCT_* constants
-     * @example ['productImage', 'productName', 'productPrice', 'productButton']
-     */
-    composition: string[];
-    /**
-     * Visibility flags for each card element
-     * Keys are ATTR_PRODUCT_* constants
-     */
-    visibility: Record<string, boolean>;
-    /**
-     * Omnibus price text configuration
-     * For EU Omnibus Directive compliance
-     */
-    omnibusPrice: OmnibusTextConfig;
-    /**
-     * Omnibus discount text configuration
-     * For EU Omnibus Directive compliance
-     */
-    omnibusDiscount: OmnibusTextConfig;
-    /**
-     * Whether to trim long product names with ellipsis
-     */
-    textTrimming: boolean;
-    /**
-     * Configuration version for future migrations
-     * Increment when making breaking changes to schema
-     */
-    configVersion: number;
-    /**
-     * Unique identifier for this recommendation block instance
-     * Used to isolate per-block state in the Pinia store
-     * 0 = not yet assigned (default for new/migrating blocks)
-     */
-    recommendationId: number;
-}
-/**
- * Partial configuration for updates
- * All fields are optional to support partial updates via `updateConfig`
- */
-export type PartialNodeConfig = Partial<RecommendationNodeConfig>;
-/**
- * Deep partial for nested objects
- */
-export type DeepPartialNodeConfig = {
-    [K in keyof RecommendationNodeConfig]?: RecommendationNodeConfig[K] extends object ? Partial<RecommendationNodeConfig[K]> : RecommendationNodeConfig[K];
-};
-/**
- * Check if an object is a valid RecommendationNodeConfig
- * Used for migration detection and validation
- */
-export declare function isValidNodeConfig(obj: unknown): obj is RecommendationNodeConfig;
-/**
- * Check if a node config has the minimum required fields
- * Used to detect legacy templates that need migration
- */
-export declare function hasMinimalConfig(obj: unknown): boolean;

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

@@ -1,33 +0,0 @@
-/**
- * Price Formatting Utilities
- *
- * Provides functions for formatting prices according to currency settings.
- * Used to format prices displayed in recommendation product cards.
- */
-import type { CurrencyConfig } from '../types/nodeConfig';
-/**
- * Options for formatting a price
- */
-export interface FormatPriceOptions {
-    /** The numeric price value */
-    price: number;
-    /** Currency configuration */
-    currency: CurrencyConfig;
-}
-/**
- * Formats a numeric price according to currency settings
- * @example
- * // Returns: "$ 1,999.99"
- * formatPrice({ price: 1999.99, currency: currencyConfig })
- * @param options - Formatting options
- * @returns Formatted price string
- */
-export declare function formatPrice(options: FormatPriceOptions): string;
-/**
- * Parses a formatted price string back to a number
- * Useful for extracting numeric values from formatted price displays
- * @param formattedPrice - The formatted price string
- * @param currency - Currency configuration for parsing
- * @returns Parsed numeric value or NaN if parsing fails
- */
-export declare function parseFormattedPrice(formattedPrice: string, currency: CurrencyConfig): number;