@useinsider/guido 2.0.0-beta.a4f9fa2 → 2.0.0-beta.a7d687e

package/dist/services/recommendationApi.js

@@ -1,7 +1,7 @@
-import { useHttp as c } from "../composables/useHttp.js";
-import { URLS as a } from "../enums/extensions/recommendationBlock.js";
-const R = () => {
-  const { get: o } = c();
+import { useHttp as a } from "../composables/useHttp.js";
+import { URLS as s } from "../enums/extensions/recommendationBlock.js";
+const u = () => {
+  const { get: o } = a();
   return {
     fetchRecommendationCreateData: async () => {
       try {
@@ -18,14 +18,15 @@ const R = () => {
         throw console.error("fetchRecommendationFilters error:", e), e;
       }
     },
-    fetchRecommendationProducts: async (e, n) => {
+    fetchRecommendationProducts: async (e, c) => {
+      var n;
       try {
-        const t = decodeURIComponent(new URLSearchParams(Object.entries(n)).toString());
+        const t = decodeURIComponent(new URLSearchParams(Object.entries(c)).toString());
         console.debug("🏁 Recommendation API Query:", t);
         const r = await o(
-          `${a.RECOMMENDATION_API_URL}/v2/${e}?${t}`
+          `${s.RECOMMENDATION_API_URL}/v2/${e}?${t}`
         );
-        return (r == null ? void 0 : r.data) ?? [];
+        return ((n = r == null ? void 0 : r.data) == null ? void 0 : n.data) ?? [];
       } catch (t) {
         throw console.error("fetchRecommendationProducts error:", t), t;
       }
@@ -33,5 +34,5 @@ const R = () => {
   };
 };
 export {
-  R as useRecommendationApi
+  u as useRecommendationApi
 };

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
  */
@@ -346,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
  *
@@ -358,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) */
@@ -510,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/components/organisms/email-preview/desktop-preview/DesktopBrowserHeader.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

package/dist/src/components/organisms/header/EditorActions.vue.d.ts

@@ -0,0 +1,4 @@
+declare const _default: import("vue").DefineComponent<{}, {
+    handleSave: (isSilent: boolean) => Promise<import("../../../@types/stripo").SavedTemplateDetails | undefined>;
+}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

package/dist/src/components/organisms/header/EditorToolbar.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

package/dist/src/components/organisms/header/RightSlot.vue.d.ts

@@ -1,4 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<import("../../../@types/stripo").SavedTemplateDetails | undefined>;
+    handleSave: (isSilent: boolean) => Promise<import("../../../@types/stripo.js").SavedTemplateDetails | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

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/composables/useActionsApi.d.ts

@@ -7,4 +7,5 @@ export declare const useActionsApi: () => {
     getPreviewData: (options?: CompileEmailOptions) => Promise<CompiledEmailResult>;
     updateTimerInClonedTemplate: () => Promise<string | null>;
     updateHtmlAndCss: (html: string, css: string) => void;
+    editorSave: () => void;
 };

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

@@ -91,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<{
@@ -177,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/enums/academy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Centralized Academy Links
+ *
+ * All external academy documentation links should be defined here
+ * for easy maintenance and domain migration.
+ */
+export declare const ACADEMY_LINKS: {
+    readonly EMAIL_EDITOR: "https://academy.insiderone.com//docs/email-drag-and-drop-editor";
+    readonly GLOBAL_UNSUBSCRIBE: "https://academy.insiderone.com//docs/global-unsubscribe-preference-center";
+    readonly AMP_FOR_EMAILS: "https://academy.insiderone.com//docs/amp-for-emails";
+};
+export type AcademyLinkKey = keyof typeof ACADEMY_LINKS;

package/dist/src/enums/onboarding.d.ts

@@ -3,4 +3,3 @@ export declare const UI_EDITOR_SELECTOR = "ui-editor";
 export declare const CARD_COMPOSITION_TAB_SELECTOR = "button[role=\"tab\"][aria-label=\"Card Composition\"]";
 export declare const SETTINGS_TAB_SELECTOR = "button[role=\"tab\"][aria-label=\"Settings\"]";
 export declare const RIBBON_SELECTOR = ".in-ribbons-wrapper";
-export declare const ACADEMY_LINK = "https://academy.useinsider.com/docs/email-drag-drop-editor";

package/dist/src/enums/unsubscribe.d.ts

@@ -17,7 +17,6 @@ export declare const DEFAULT_UNSUBSCRIBE_GROUP: {
     readonly name: "Global Unsubscribe";
     readonly sendGridId: "G";
 };
-export declare const ACADEMY_LINK = "https://academy.useinsider.com/docs/global-unsubscribe-preference-center";
 export declare const UNSUBSCRIBE_PAGES_LINK = "/email/unsubscribe-pages";
 export declare const PAGE_TYPES: {
     GLOBAL_UNSUBSCRIBE: number;

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

@@ -8,5 +8,7 @@ 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,14 +29,5 @@ 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,5 +8,7 @@ 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 _updateVerticalLayout;
     private _updateHorizontalLayout;
+    private _updateVerticalLayout;
     _getPriceOrientation(): string;
 }

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

@@ -31,6 +31,10 @@ 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,7 +42,6 @@ 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,4 +1,30 @@
 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: {
@@ -53,37 +79,25 @@ 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;
             };
         };
@@ -91,37 +105,25 @@ 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,7 +41,6 @@ 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,7 +10,6 @@ interface ItemsBlockState {
     currencySymbol: string;
     currencyLocation: string;
     formattedPrice: boolean;
-    singlePrice: boolean;
     priceOrientation: 'vertical' | 'horizontal';
     templateData: {
         imageSrc: string;
@@ -32,7 +31,6 @@ 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,8 +1,6 @@
-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;
@@ -10,25 +8,6 @@ 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.
@@ -41,5 +20,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, migrate, formattedPrice, configBlockAttributes, nodeConfig, nameStyles, buttonStyles, priceStyles, originalPriceStyles, quantityStyles, priceOrientation, }: TemplateParameters): string;
+export declare function getDefaultTemplate({ orientation, itemsType, itemId, currencySymbol, currencyLocation, formattedPrice, }: TemplateParameters): string;
 export default migrationTemplate;

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

@@ -0,0 +1,23 @@
+import { ImmutableHtmlElementNode, ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+/**
+ * Gets the esd-config-block element from the current node.
+ * Searches within the closest .items-block-v2 container.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ * @returns The config block element or null if not found
+ */
+export declare function getConfigBlock(currentNode: ImmutableHtmlNode | undefined): ImmutableHtmlElementNode | null;
+/**
+ * Converts an attribute value to a boolean.
+ * Handles string values '1', 'true', and null/undefined cases.
+ * @param value - The attribute value (string or null)
+ * @param defaultValue - Default value to return if value is null/undefined (default: false)
+ * @returns The boolean value
+ */
+export declare function attributeToBoolean(value: string | null, defaultValue?: boolean): boolean;
+/**
+ * Gets a string attribute value with a default fallback.
+ * @param value - The attribute value (string or null)
+ * @param defaultValue - Default value to return if value is null/undefined (default: '')
+ * @returns The string value or default
+ */
+export declare function attributeToString(value: string | null, defaultValue?: string): string;

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

@@ -0,0 +1,32 @@
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { configAttributes } from '../enums/productEnums';
+type StoreSetter<T> = (value: T) => void;
+interface SyncConfig<T> {
+    attributeName: keyof typeof configAttributes;
+    storeSetter: StoreSetter<T>;
+    converter: (value: string | null) => T;
+}
+/**
+ * Generic utility to sync an attribute value from esd-config-block to the store.
+ * This makes attribute values mutable by syncing them from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ * @param config - Configuration object with attribute name, store setter, and value converter
+ */
+export declare function syncAttributeFromConfigBlock<T>(currentNode: ImmutableHtmlNode | undefined, config: SyncConfig<T>): void;
+/**
+ * Helper to create a sync config for boolean attributes.
+ * @param attributeName - The attribute name from configAttributes
+ * @param storeSetter - The store setter function
+ * @param defaultValue - Default value if attribute is not set (default: false)
+ * @returns Sync configuration object
+ */
+export declare function createBooleanSyncConfig(attributeName: keyof typeof configAttributes, storeSetter: StoreSetter<boolean>, defaultValue?: boolean): SyncConfig<boolean>;
+/**
+ * Helper to create a sync config for string attributes.
+ * @param attributeName - The attribute name from configAttributes
+ * @param storeSetter - The store setter function
+ * @param defaultValue - Default value if attribute is not set (default: '')
+ * @returns Sync configuration object
+ */
+export declare function createStringSyncConfig(attributeName: keyof typeof configAttributes, storeSetter: StoreSetter<string>, defaultValue?: string): SyncConfig<string>;
+export {};

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

@@ -0,0 +1,50 @@
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+/**
+ * Reads name trimming value from esd-config-block attribute and updates the store.
+ * This makes the trimming value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncNameTrimmingFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads hide discount value from esd-config-block attribute and updates the store.
+ * This makes the hide discount value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncHideDiscountFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads formatted price value from esd-config-block attribute and updates the store.
+ * This makes the formatted price value mutable by syncing it from the DOM.
+ * Defaults to true if not set, since formatted is the default.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncFormattedPriceFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads currency symbol value from esd-config-block attribute and updates the store.
+ * This makes the currency symbol value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncCurrencySymbolFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads currency location value from esd-config-block attribute and updates the store.
+ * This makes the currency location value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncCurrencyLocationFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads button link value from esd-config-block attribute and updates the store.
+ * This makes the button link value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncButtonLinkFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads image link value from esd-config-block attribute and updates the store.
+ * This makes the image link value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncImageLinkFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;
+/**
+ * Reads price orientation value from esd-config-block attribute and updates the store.
+ * This makes the price orientation value mutable by syncing it from the DOM.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ */
+export declare function syncPriceOrientationFromAttributes(currentNode: ImmutableHtmlNode | undefined): void;

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

@@ -0,0 +1,8 @@
+import { ImmutableHtmlNode, ControlApi } from '@stripoinc/ui-editor-extensions';
+/**
+ * Updates attributes on the esd-config-block element based on current store state.
+ * This utility can be called from controls whenever they change values that affect attributes.
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ * @param api - The API object from the control (usually this.api)
+ */
+export declare function updateConfigBlockAttributes(currentNode: ImmutableHtmlNode | undefined, api: ControlApi): void;

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/blockIds.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Block IDs used in the Recommendation Extension
+ * These IDs are used in the esd-extension-block-id attribute to identify specific blocks
+ */
+export declare enum RecommendationBlockId {
+    BUTTON = "recommendation-block-button",
+    NAME = "recommendation-block-name",
+    PRICE = "recommendation-block-price",
+    OLD_PRICE = "recommendation-block-old-price",
+    OMNIBUS_PRICE = "recommendation-block-omnibus-price",
+    OMNIBUS_DISCOUNT = "recommendation-block-omnibus-discount",
+    IMAGE = "recommendation-block-image"
+}