@useinsider/guido 2.0.0-beta.1c331b8 → 2.0.0-beta.1f72712

package/dist/src/components/wrappers/WpDrawer.vue.d.ts

@@ -33,8 +33,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<
     descriptionStatus: boolean;
     descriptionText: string;
 }>>>, {
-    className: string;
     size: "small" | "medium" | "large";
+    className: string;
     closeOnOutsideClick: boolean;
     descriptionStatus: boolean;
     descriptionText: string;

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

@@ -1,3 +1,10 @@
+/**
+ * Recommendation Block
+ *
+ * Main block class for the Recommendation extension.
+ * Handles block lifecycle including configuration initialization and migration.
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { Block, BlockCompositionType } from '@stripoinc/ui-editor-extensions';
 export declare const BLOCK_ID = "recommendation-block";
 export declare class RecommendationBlock extends Block {
@@ -8,4 +15,31 @@ export declare class RecommendationBlock extends Block {
     getName(): string;
     getDescription(): string;
     getTemplate(): string;
+    /**
+     * Called when a new block is dropped into the template
+     *
+     * Initializes the block with default configuration stored via node config.
+     * This ensures the configuration persists with the template.
+     * @param node - The newly created block node
+     */
+    onCreated(node: ImmutableHtmlNode): void;
+    /**
+     * Called when the document changes or template is loaded
+     *
+     * Handles migration from legacy templates that don't have node config.
+     * Also handles config version upgrades for future migrations.
+     * @param node - The block node that may need migration
+     */
+    onDocumentChanged(node: ImmutableHtmlNode): void;
+    /**
+     * Migrate configuration from legacy format
+     *
+     * Legacy templates may store configuration in:
+     * - data-attributes (data-layout, data-card-composition, etc.)
+     * - Pinia store (lost on reload - this is what we're fixing)
+     *
+     * This method reads what we can from the DOM and initializes proper node config.
+     * @param node - The block node to migrate
+     */
+    private _migrateFromLegacy;
 }

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

@@ -0,0 +1,49 @@
+/**
+ * Default Configuration for Recommendation Block
+ *
+ * This module provides the default values for RecommendationNodeConfig.
+ * These values are used when:
+ * - A new block is dropped into the template
+ * - Migrating legacy templates without stored config
+ * - Merging partial updates with existing config
+ */
+import type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig } from '../types/nodeConfig';
+/**
+ * Default currency configuration
+ * Uses USD as the base currency with standard formatting
+ * Note: symbol stores the currency code (e.g., 'USD'), not the symbol character ('$')
+ * This matches the Currency Symbol dropdown which shows currency codes
+ */
+export declare const DEFAULT_CURRENCY: CurrencyConfig;
+/**
+ * Default omnibus price text configuration
+ * Pre-filled with common EU Omnibus Directive text
+ */
+export declare const DEFAULT_OMNIBUS_PRICE: OmnibusTextConfig;
+/**
+ * Default omnibus discount text configuration
+ */
+export declare const DEFAULT_OMNIBUS_DISCOUNT: OmnibusTextConfig;
+/**
+ * Default card composition order
+ * Defines the visual order of elements in product cards
+ */
+export declare const DEFAULT_COMPOSITION: string[];
+/**
+ * Default visibility settings for card elements
+ * Omnibus elements are hidden by default (not all regions require them)
+ */
+export declare const DEFAULT_VISIBILITY: Record<string, boolean>;
+/**
+ * Complete default configuration for Recommendation Block
+ *
+ * This is the single source of truth for default values.
+ * All other code should import and use this constant.
+ */
+export declare const DEFAULT_NODE_CONFIG: RecommendationNodeConfig;
+/**
+ * Current configuration version
+ * Increment this when making breaking changes to the schema
+ * Used for migration detection
+ */
+export declare const CURRENT_CONFIG_VERSION = 1;

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

@@ -8,5 +8,6 @@
  */
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
-export { CONTAINER_SELECTOR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, } from './selectors';
-export { DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, } from './layout';
+export { CONTAINER_SELECTOR, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, } from './selectors';
+export { DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
+export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, } from './defaultConfig';

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

@@ -15,3 +15,13 @@ export declare const MIN_PRODUCT_COUNT = 1;
 export declare const MAX_PRODUCTS_PER_ROW = 4;
 /** Minimum number of products per row in vertical layout */
 export declare const MIN_PRODUCTS_PER_ROW = 1;
+/** Default column spacing between product cards (5px on each side = 10px total) */
+export declare const DEFAULT_COLUMN_SPACING = 10;
+/** Default row spacing between product rows */
+export declare const DEFAULT_ROW_SPACING = 20;
+/** Minimum spacing value */
+export declare const MIN_SPACING = 0;
+/** Maximum spacing value */
+export declare const MAX_SPACING = 50;
+/** Spacing adjustment step */
+export declare const SPACING_STEP = 5;

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

@@ -6,6 +6,18 @@
  * Used across controls to target elements within the recommendation block
  */
 export declare const CONTAINER_SELECTOR = ".ins-recommendation-product-container";
+/**
+ * Currency HTML attributes set on the block element
+ * These are read by the HTML compiler at runtime to format prices
+ */
+export declare const CURRENCY_ATTR: {
+    readonly CURRENCY: "currency";
+    readonly SYMBOL: "currency-symbol";
+    readonly ALIGNMENT: "currency-alignment";
+    readonly THOUSAND_SEPARATOR: "currency-thousand-separator";
+    readonly DECIMAL_SEPARATOR: "currency-decimal-separator";
+    readonly DECIMAL_COUNT: "currency-decimal-count";
+};
 /**
  * Attribute type constants used in templates
  * These are used as keys in ElementRenderer and composition arrays

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

@@ -3,6 +3,8 @@
  *
  * Manages recommendation block layout orientation
  * Allows switching between vertical (grid) and horizontal (list) layouts
+ *
+ * Configuration is stored via node config (persists with template).
  */
 import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
@@ -22,7 +24,7 @@ export declare class LayoutControl extends CommonControl {
     _setFormValues(): void;
     /**
      * Handles layout change
-     * Updates the block's data attribute and regenerates product rows
+     * Updates node config, data attribute and regenerates product rows
      */
     _onLayoutChange(layout: Orientation): void;
     /**

package/dist/src/extensions/Blocks/Recommendation/controls/main/algorithm.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Algorithm Selection Control
+ *
+ * Handles recommendation algorithm selection and product IDs for manual merchandising:
+ * - Algorithm/strategy selection
+ * - Product IDs input (visible only for manual merchandising)
+ *
+ * Configuration is stored via node config (persists with template).
+ * Algorithm options are fetched from API and cached in Pinia store.
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const ALGORITHM_CONTROL_ID = "recommendation-algorithm-control";
 /**
@@ -8,9 +19,10 @@ export declare class AlgorithmControl extends CommonControl {
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _setFormValues(): void;
     _initializeSelectItems(): void;
-    _setProductIdsVisibility(): void;
+    _setProductIdsVisibility(strategy?: string): void;
     _onAlgorithmChange(value: string): void;
     _onProductIdsChange(value: string): void;
     _listenToFormUpdates(): void;

package/dist/src/extensions/Blocks/Recommendation/controls/main/currency.d.ts

@@ -1,3 +1,19 @@
+/**
+ * Currency Settings Control
+ *
+ * Handles all currency-related configuration for recommendation products:
+ * - Currency type
+ * - Currency location (before/after)
+ * - Currency symbol
+ * - Thousand separator
+ * - Decimal separator
+ * - Decimal count
+ *
+ * Configuration is stored via node config (persists with template).
+ * Currency options are fetched from API and cached in Pinia store.
+ */
+import type { CurrencyConfig } from '../../types/nodeConfig';
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const CURRENCY_CONTROL_ID = "recommendation-currency-control";
 /**
@@ -5,12 +21,25 @@ export declare const CURRENCY_CONTROL_ID = "recommendation-currency-control";
  */
 export declare class CurrencyControl extends CommonControl {
     private store;
+    private storeUnsubscription;
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    onDestroy(): void;
     _setFormValues(): void;
     _initializeSelectItems(): void;
+    _updateCurrency(updates: Partial<CurrencyConfig>): void;
     _onCurrencyChange(value: string): void;
-    _onCurrencyConfigChange(item: string, value: string | number): void;
+    _onCurrencyLocationChange(value: string): void;
+    _onCurrencySymbolChange(value: string): void;
+    _onThousandSeparatorChange(value: string): void;
+    _onDecimalSeparatorChange(value: string): void;
+    _onDecimalCountChange(value: string): void;
     _listenToFormUpdates(): void;
+    /**
+     * Subscribe to store changes to update currency selects when API data arrives
+     * This handles the case where the control renders before currency list is loaded
+     */
+    _subscribeToStoreChanges(): void;
 }

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

@@ -1,3 +1,21 @@
+/**
+ * Main Recommendation Block Control
+ *
+ * This is a coordinator control that composes all recommendation configuration
+ * sub-controls into a single settings panel. It handles:
+ * - Initial API data fetching
+ * - Store subscriptions for product refresh
+ * - Coordinating lifecycle of sub-controls
+ *
+ * Sub-controls are also exported individually for flexibility:
+ * - AlgorithmControl: Strategy and product IDs
+ * - LocaleControl: Language selection
+ * - CurrencyControl: Currency formatting settings
+ * - ProductLayoutControl: Product count and grid layout
+ * - FiltersControl: Filter selection
+ * - ShuffleControl: Product shuffle toggle
+ */
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 import { AlgorithmControl, ALGORITHM_CONTROL_ID } from './algorithm';
 import { CurrencyControl, CURRENCY_CONTROL_ID } from './currency';
@@ -24,6 +42,7 @@ export declare class RecommendationBlockControl extends CommonControl {
     getId(): string;
     getTemplate(): string;
     onRender(): Promise<void>;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     /**
      * Initialize all sub-controls with the shared API context

package/dist/src/extensions/Blocks/Recommendation/controls/main/locale.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Locale Selection Control
+ *
+ * Handles locale/language selection for recommendation products.
+ * Configuration is stored via node config (persists with template).
+ * Language options are fetched from API and cached in Pinia store.
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const LOCALE_CONTROL_ID = "recommendation-locale-control";
 /**
@@ -8,6 +16,7 @@ export declare class LocaleControl extends CommonControl {
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _setFormValues(): void;
     _initializeSelectItems(): void;
     _onLocaleChange(value: string): void;

package/dist/src/extensions/Blocks/Recommendation/controls/main/productLayout.d.ts

@@ -5,6 +5,8 @@
  * - Number of products to show
  * - Products per row (hidden for horizontal layout)
  * - Triggers product row regeneration on changes
+ *
+ * Configuration is stored via node config (persists with template).
  */
 import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
@@ -21,11 +23,10 @@ export declare class ProductLayoutControl extends CommonControl {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     _setFormValues(): void;
-    _initializeCounterValues(): void;
     /**
      * Updates "Products in One Row" visibility based on layout orientation
      * This control is hidden for horizontal layout (products always take full width)
-     * Reads from store first (reliable during state transitions), falls back to DOM
+     * Reads from node config first, falls back to DOM
      */
     _updateProductsInRowVisibility(): void;
     _onProductCountChange(value: string): void;
@@ -35,6 +36,7 @@ export declare class ProductLayoutControl extends CommonControl {
     _listenToFormUpdates(): void;
     /**
      * Subscribe to store changes to update visibility when layout changes
+     * This is still needed because layout changes come from LayoutControl
      */
     _listenStateUpdates(): void;
 }

package/dist/src/extensions/Blocks/Recommendation/controls/main/shuffle.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Shuffle Products Control
+ *
+ * Handles the toggle for shuffling/randomizing recommended products.
+ * Configuration is stored via node config (persists with template).
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const SHUFFLE_CONTROL_ID = "recommendation-shuffle-control";
 /**
@@ -8,6 +15,7 @@ export declare class ShuffleControl extends CommonControl {
     getId(): string;
     getTemplate(): string;
     onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _setFormValues(): void;
     _initializeToggle(): void;
     _onShuffleChange(value: boolean): void;

package/dist/src/extensions/Blocks/Recommendation/controls/main/utils.d.ts

@@ -7,6 +7,7 @@
  * - Product row regeneration
  * - Spacing reapplication
  */
+import type { CurrencyConfig } from '../../types/nodeConfig';
 import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
 import { type Orientation } from '../../templates';
@@ -78,4 +79,22 @@ export interface ApplyCardBackgroundColorOptions {
  * @param options - Configuration options
  */
 export declare function applyCardBackgroundColor(options: ApplyCardBackgroundColorOptions): void;
+export interface SetCurrencyAttributesOptions {
+    currentNode: ImmutableHtmlNode | null | undefined;
+    documentModifier: DocumentModifier;
+    currency: CurrencyConfig;
+}
+/**
+ * Sets currency configuration as HTML attributes on the block element
+ * These attributes are read by the HTML compiler at runtime to format prices
+ * @param options - Configuration options
+ */
+export declare function setCurrencyAttributes(options: SetCurrencyAttributesOptions): void;
+/**
+ * Reads currency configuration from block HTML attributes
+ * Used to restore settings when loading a template
+ * @param currentNode - The current template node
+ * @returns CurrencyConfig or null if attributes not found
+ */
+export declare function getCurrencyAttributesFromBlock(currentNode: ImmutableHtmlNode | null | undefined): Partial<CurrencyConfig> | null;
 export {};

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

@@ -1,3 +1,13 @@
+/**
+ * Spacing Control
+ *
+ * Manages spacing between product cards:
+ * - Column spacing: horizontal gap between cards in the same row
+ * - Row spacing: vertical gap between different rows
+ *
+ * Configuration is stored via node config (persists with template).
+ * Actual spacing is applied to DOM elements via inline styles.
+ */
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 export declare const SPACING_CONTROL_ID = "recommendation-spacing-control";
@@ -13,14 +23,15 @@ export declare class SpacingControl extends CommonControl {
     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
+     * Reads from node config first, falls back to store then DOM
      */
     _updateColumnSpacingVisibility(): void;
     /**
-     * Reads spacing values from data attributes or returns defaults
+     * Reads spacing values from node config first, falls back to DOM styles
      */
     _setFormValues(): void;
     /**

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

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

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

package/dist/src/extensions/Blocks/Recommendation/store/recommendation.d.ts

@@ -1,5 +1,6 @@
 import type { Orientation, Languages, Currency, NumericSeparator, FiltersResponse, Filter, RecommendationProduct } from '@@/Types/recommendation';
 interface StoreState {
+    /** Maps campaign URLs for recommendation blocks. Used by templateLibraryApi when saving templates. */
     recommendationCampaignUrls: Record<string, string>;
     recommendationConfigs: {
         cardsInRow: number;

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

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