@useinsider/guido 2.0.0-beta.435da98 → 2.0.0-beta.4f6e85f

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const o = { stripo: { version: "2.47.0" } }, s = {
+const o = { stripo: { version: "2.52.0" } }, s = {
   guido: o
 };
 export {

package/dist/services/stripoApi.js

@@ -1,8 +1,8 @@
 import { useHttp as m } from "../composables/useHttp.js";
-import { useToaster as u } from "../composables/useToaster.js";
-import { MAX_DEFAULT_TEMPLATE_ID as i } from "../enums/defaults.js";
+import { useToaster as i } from "../composables/useToaster.js";
+import { MAX_DEFAULT_TEMPLATE_ID as p } from "../enums/defaults.js";
 const y = () => {
-  const { get: r } = m(), { handleError: o } = u();
+  const { get: r } = m(), { handleError: o } = i();
   return {
     getToken: async () => {
       try {
@@ -26,17 +26,13 @@ const y = () => {
     getDefaultTemplate: async () => {
       const t = {
         html: "",
-        css: "",
-        forceRecreate: !0
+        css: ""
       };
       try {
-        const c = new URLSearchParams(window.location.search).get("default-template"), s = c ? parseInt(c) : 0, l = s >= 1 && s <= i ? s : 0, { data: n } = await r(
+        const c = new URLSearchParams(window.location.search).get("default-template"), s = c ? parseInt(c) : 0, l = s >= 1 && s <= p ? s : 0, { data: n } = await r(
           `/stripo/default-template/${l}`
         ), a = typeof n == "string" ? JSON.parse(n) : n;
-        return !a || typeof a != "object" || !("html" in a) || !("css" in a) ? t : {
-          ...a,
-          forceRecreate: !0
-        };
+        return !a || typeof a != "object" || !("html" in a) || !("css" in a) ? t : a;
       } catch (e) {
         return o(e, "Failed to fetch default template"), t;
       }

package/dist/src/@types/config/index.d.ts

@@ -7,8 +7,8 @@
  * - Default values for optional configuration
  * - Validation utilities
  */
-export { MessageType, ProductType, GuidoConfigSchema, IdentitySchema, PartnerSchema, TemplateSchema, EditorSchema, UISchema, FeaturesSchema, BlocksSchema, CompilerSchema, DynamicContentSchema, EmailHeaderSchema, DefaultBlockTypeSchema, CustomBlockTypeSchema, CompilerRuleSchema, CompilerRuleTypeSchema, ReplaceRuleSchema, RegexRuleSchema, RemoveRuleSchema, CustomRuleSchema, } from './schemas';
-export type { GuidoConfig, GuidoConfigInput, IdentityConfig, IdentityConfigInput, PartnerConfig, PartnerConfigInput, TemplateConfig, TemplateConfigInput, EditorConfig, EditorConfigInput, UIConfig, UIConfigInput, FeaturesConfig, FeaturesConfigInput, BlocksConfig, BlocksConfigInput, CompilerConfig, CompilerConfigInput, EmailHeader, DynamicContent, DefaultBlockType, CustomBlockType, BlockType, FeatureName, CompilerRule, ReplaceRule, RegexRule, RemoveRule, CustomRule, DeepPartial, ConfigOverrides, } from './types';
+export { MessageType, ProductType, GuidoConfigSchema, IdentitySchema, PartnerSchema, TemplateSchema, EditorSchema, UISchema, FeaturesSchema, BlocksSchema, CompilerSchema, CallbacksSchema, DynamicContentSchema, EmailHeaderSchema, DefaultBlockTypeSchema, CustomBlockTypeSchema, CompilerRuleSchema, CompilerRuleTypeSchema, ReplaceRuleSchema, RegexRuleSchema, RemoveRuleSchema, CustomRuleSchema, } from './schemas';
+export type { GuidoConfig, GuidoConfigInput, IdentityConfig, IdentityConfigInput, PartnerConfig, PartnerConfigInput, TemplateConfig, TemplateConfigInput, EditorConfig, EditorConfigInput, UIConfig, UIConfigInput, FeaturesConfig, FeaturesConfigInput, BlocksConfig, BlocksConfigInput, CompilerConfig, CompilerConfigInput, CallbacksConfig, CallbacksConfigInput, ExternalValidationHandler, EmailHeader, DynamicContent, DefaultBlockType, CustomBlockType, BlockType, FeatureName, CompilerRule, ReplaceRule, RegexRule, RemoveRule, CustomRule, DeepPartial, ConfigOverrides, } from './types';
 export { DEFAULT_EMAIL_HEADER, DEFAULT_TEMPLATE, DEFAULT_EDITOR, DEFAULT_UI, DEFAULT_FEATURES, DEFAULT_BLOCKS, DEFAULT_COMPILER, DEFAULT_PRODUCT_TYPE, DEFAULT_MESSAGE_TYPE, DEFAULT_USERNAME, EDITOR_TYPE, TEST_PARTNERS, isTestPartner, } from './defaults';
 export { validateConfig, parseConfig, parseConfigSafe, getValidationErrors, isValidConfig, validateIdentity, validatePartner, } from './validator';
 export type { ValidationResult, ValidationError, } from './validator';

package/dist/src/@types/config/schemas.d.ts

@@ -5,7 +5,14 @@
  * All types are inferred from these schemas to ensure single source of truth.
  * @module @types/config/schemas
  */
+import type { SavedTemplateDetails } from '../stripo';
 import * as v from 'valibot';
+/**
+ * Handler function for external validation before save
+ * @param data - The template details to validate
+ * @returns Promise<boolean> - true if valid, false to cancel save
+ */
+export type ExternalValidationHandler = (data: SavedTemplateDetails) => Promise<boolean>;
 /**
  * Message type constants for email templates
  */
@@ -90,6 +97,8 @@ export declare const TemplateSchema: v.ObjectSchema<{
     }, undefined>, undefined>, readonly []>;
     /** Selected unsubscribe page IDs */
     readonly selectedUnsubscribePages: v.OptionalSchema<v.ArraySchema<v.NumberSchema<undefined>, undefined>, readonly []>;
+    /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
+    readonly forceRecreate: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
  * Email header configuration (sender name and subject)
@@ -344,6 +353,16 @@ export declare const CompilerSchema: v.ObjectSchema<{
     /** Skip default compiler rules */
     readonly ignoreDefaultRules: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
+/**
+ * Callbacks configuration - event handlers and hooks
+ */
+export declare const CallbacksSchema: v.ObjectSchema<{
+    /**
+     * External validation handler called before save completes.
+     * Return false to cancel the save operation.
+     */
+    readonly externalValidation: v.OptionalSchema<v.CustomSchema<ExternalValidationHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
+}, undefined>;
 /**
  * Complete Guido configuration schema
  *
@@ -356,6 +375,7 @@ export declare const CompilerSchema: v.ObjectSchema<{
  * - features: Feature toggles
  * - blocks: Block configuration
  * - compiler: HTML compilation
+ * - callbacks: Event handlers and hooks
  */
 export declare const GuidoConfigSchema: v.ObjectSchema<{
     /** Identity configuration (required) */
@@ -400,6 +420,8 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         }, undefined>, undefined>, readonly []>;
         /** Selected unsubscribe page IDs */
         readonly selectedUnsubscribePages: v.OptionalSchema<v.ArraySchema<v.NumberSchema<undefined>, undefined>, readonly []>;
+        /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
+        readonly forceRecreate: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Editor settings */
     readonly editor: v.OptionalSchema<v.ObjectSchema<{
@@ -506,4 +528,12 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         /** Skip default compiler rules */
         readonly ignoreDefaultRules: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
+    /** Callbacks and event handlers */
+    readonly callbacks: v.OptionalSchema<v.ObjectSchema<{
+        /**
+         * External validation handler called before save completes.
+         * Return false to cancel the save operation.
+         */
+        readonly externalValidation: v.OptionalSchema<v.CustomSchema<ExternalValidationHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
+    }, undefined>, {}>;
 }, undefined>;

package/dist/src/@types/config/types.d.ts

@@ -5,7 +5,7 @@
  * This ensures type definitions are always in sync with validation.
  * @module @types/config/types
  */
-import type { GuidoConfigSchema, IdentitySchema, PartnerSchema, TemplateSchema, EditorSchema, UISchema, FeaturesSchema, BlocksSchema, CompilerSchema, DynamicContentSchema, EmailHeaderSchema, CompilerRuleSchema, ReplaceRuleSchema, RegexRuleSchema, RemoveRuleSchema, CustomRuleSchema, DefaultBlockTypeSchema, CustomBlockTypeSchema } from './schemas';
+import type { GuidoConfigSchema, IdentitySchema, PartnerSchema, TemplateSchema, EditorSchema, UISchema, FeaturesSchema, BlocksSchema, CompilerSchema, CallbacksSchema, DynamicContentSchema, EmailHeaderSchema, CompilerRuleSchema, ReplaceRuleSchema, RegexRuleSchema, RemoveRuleSchema, CustomRuleSchema, DefaultBlockTypeSchema, CustomBlockTypeSchema, ExternalValidationHandler } from './schemas';
 import type * as v from 'valibot';
 /**
  * Complete validated Guido configuration.
@@ -41,6 +41,10 @@ export type FeaturesConfig = v.InferOutput<typeof FeaturesSchema>;
 export type BlocksConfig = v.InferOutput<typeof BlocksSchema>;
 /** Compiler configuration (custom rules, ignore defaults) */
 export type CompilerConfig = v.InferOutput<typeof CompilerSchema>;
+/** Callbacks configuration (event handlers and hooks) */
+export type CallbacksConfig = v.InferOutput<typeof CallbacksSchema>;
+/** Re-export ExternalValidationHandler for convenience */
+export type { ExternalValidationHandler };
 /** Email header configuration (senderName, subject) */
 export type EmailHeader = v.InferOutput<typeof EmailHeaderSchema>;
 /** Dynamic content item */
@@ -85,6 +89,8 @@ export type FeaturesConfigInput = v.InferInput<typeof FeaturesSchema>;
 export type BlocksConfigInput = v.InferInput<typeof BlocksSchema>;
 /** Input type for compiler configuration */
 export type CompilerConfigInput = v.InferInput<typeof CompilerSchema>;
+/** Input type for callbacks configuration */
+export type CallbacksConfigInput = v.InferInput<typeof CallbacksSchema>;
 /** Default Stripo block types */
 export type DefaultBlockType = v.InferOutput<typeof DefaultBlockTypeSchema>;
 /** Custom Guido block types */

package/dist/src/composables/useConfig.d.ts

@@ -31,6 +31,7 @@ export declare const useConfig: () => {
                 } | undefined;
             }[];
             selectedUnsubscribePages: number[];
+            forceRecreate: boolean;
         };
         editor: {
             locale: string;
@@ -90,6 +91,9 @@ export declare const useConfig: () => {
             })[];
             ignoreDefaultRules: boolean;
         };
+        callbacks: {
+            externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+        };
     } | null>;
     initialized: import("vue").Ref<boolean>;
     identity: import("vue").ComputedRef<{
@@ -116,6 +120,7 @@ export declare const useConfig: () => {
             } | undefined;
         }[];
         selectedUnsubscribePages: number[];
+        forceRecreate: boolean;
     } | null>;
     editor: import("vue").ComputedRef<{
         locale: string;
@@ -175,6 +180,9 @@ export declare const useConfig: () => {
         })[];
         ignoreDefaultRules: boolean;
     } | null>;
+    callbacks: import("vue").ComputedRef<{
+        externalValidation?: import("@@/Types/config").ExternalValidationHandler | undefined;
+    } | null>;
     templateId: import("vue").ComputedRef<string>;
     userId: import("vue").ComputedRef<string>;
     variationId: import("vue").ComputedRef<string>;

package/dist/src/config/migrator/itemsBlockMigrator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Migrates legacy ItemsBlock templates to v2 format
+ * @param html - HTML string containing legacy items blocks
+ * @returns Migrated HTML with replaced variables and cleaned conditionals
+ */
+export declare function migrateItemsBlock(html: string): string;

package/dist/src/extensions/Blocks/Items/controls/button/link.d.ts

@@ -8,7 +8,5 @@ export declare class ButtonLinkControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
-    _listenToFormUpdates(): void;
-    _onLinkChange(value: string): void;
     _getLink(): string;
 }

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

@@ -29,5 +29,14 @@ export declare class ItemsBlockCardCompositionControl extends CommonControl {
     _onProductQuantityChange(value: boolean): void;
     _onProductPriceChange(value: boolean): void;
     _onProductOriginalPriceChange(value: boolean): void;
+    /**
+     * Updates both price cell widths in vertical layout based on priceOrientation and visibility.
+     * - When priceOrientation is 'vertical': both cells are 100% (stacked layout)
+     * - When priceOrientation is 'horizontal':
+     *   - When original price is hidden, price cell expands to 100%
+     *   - When price is hidden, original price cell expands to 100%
+     *   - When both are visible, they share 50% each
+     */
+    _updatePriceCellWidthsForVerticalLayout(): void;
     _onProductButtonChange(value: boolean): void;
 }

package/dist/src/extensions/Blocks/Items/controls/image/link.d.ts

@@ -8,7 +8,5 @@ export declare class ImageLinkControl extends CommonControl {
     getTemplate(): string;
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
-    _listenToFormUpdates(): void;
-    _onLinkChange(value: string): void;
     _getLink(): string;
 }

package/dist/src/extensions/Blocks/Items/controls/price/priceOrientation.d.ts

@@ -9,7 +9,7 @@ export declare class PriceOrientationControl extends CommonControl {
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _onPriceOrientationChange(value: string): void;
-    private _updateHorizontalLayout;
     private _updateVerticalLayout;
+    private _updateHorizontalLayout;
     _getPriceOrientation(): string;
 }

package/dist/src/extensions/Blocks/Items/controls/price/singlePrice.d.ts

@@ -0,0 +1,18 @@
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+import { ItemsBlockControlId } from '../../enums/controlEnums';
+export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_SINGLE_PRICE;
+export declare class PriceSinglePriceControl extends CommonControl {
+    private store;
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    /**
+     * Syncs single price state from nodeConfig.
+     */
+    private _syncSinglePriceFromNodeConfig;
+    _onSinglePriceChange(value: boolean): void;
+    private _updatePriceBlock;
+    _getSinglePrice(): string;
+}

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

@@ -31,10 +31,6 @@ export declare class ItemsBlockControl extends CommonControl {
     _updatePrice(price: string): void;
     _updateOriginalPrice(originalPrice: string): void;
     _updateQuantity(quantity: string): void;
-    /**
-     * @todo Optimize template reordering for performance.
-     * @description Reorders the template structure based on current orientation and visibility settings.
-     */
     _reOrderTemplate(): void;
     _updateDataTypeAttributes(itemsType: ProductType): void;
     _updateDataNumberAttributes(itemId: string): void;

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

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

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

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

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

@@ -41,6 +41,7 @@ export declare const DefaultConfigValues: {
     productOriginalPriceVisible: string;
     productButtonVisible: string;
     productImageWidth: string;
+    productImageHeight: string;
 };
 export declare const ItemInCartOptions: {
     [x: string]: {

package/dist/src/extensions/Blocks/Items/store/items-block.d.ts

@@ -10,6 +10,7 @@ interface ItemsBlockState {
     currencySymbol: string;
     currencyLocation: string;
     formattedPrice: boolean;
+    singlePrice: boolean;
     priceOrientation: 'vertical' | 'horizontal';
     templateData: {
         imageSrc: string;
@@ -31,6 +32,7 @@ export declare const useItemsBlockStore: import("pinia").StoreDefinition<"guidoI
     setCurrencySymbol(currencySymbol: string): void;
     setCurrencyLocation(currencyLocation: string): void;
     setFormattedPrice(formattedPrice: boolean): void;
+    setSinglePrice(singlePrice: boolean): void;
     setPriceOrientation(priceOrientation: "vertical" | "horizontal"): void;
     setTemplateData(templateData: ItemsBlockState["templateData"]): void;
     updateFromAttributes(attributes: {

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

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

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

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

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

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