@useinsider/guido 2.0.0-beta.13ba613 → 2.0.0-beta.18d5b06

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const o = { stripo: { version: "2.52.0" } }, s = {
+const o = { stripo: { version: "2.47.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/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/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/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/CouponBlock/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Control IDs used in the CouponBlock Extension
+ * These IDs are returned by the getId() method of each control
+ */
+export declare enum CouponControlId {
+    TEXT_ALIGN = "coupon-block-text-align-control",
+    TEXT_COLOR = "coupon-block-text-color-control",
+    TEXT_SIZE = "coupon-block-text-size-control",
+    TEXT_STYLE = "coupon-block-text-style-control",
+    TEXT_FONT_FAMILY = "coupon-block-text-font-family-control",
+    TEXT_BACKGROUND = "coupon-block-text-background-control",
+    TEXT_PADDINGS = "coupon-block-text-paddings-control",
+    TEXT_LINE_SPACING = "coupon-block-text-line-spacing-control"
+}

package/dist/src/extensions/Blocks/CouponBlock/controls/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * CouponBlock Control Instances
+ *
+ * This file generates all control instances for the CouponBlock
+ * using the reusable factory functions from controlFactories.ts
+ *
+ * Note: Factory-generated controls use runtime class generation which TypeScript
+ * cannot fully type-check. The controls are type-safe at runtime.
+ *
+ * These controls apply directly to the selected root element (no targetBlockId/containerSelector)
+ * to ensure styles are applied correctly regardless of nested element structure.
+ */
+export declare const TextAlignControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextColorControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextSizeControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextStyleControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextFontFamilyControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextBackgroundControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextPaddingsControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};
+export declare const TextLineSpacingControl: {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};

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

@@ -1,3 +1,3 @@
-declare const migrationTemplate = "\n    <td \n        class=\"coupon-block coupon-block-v2 ins-coupon-code esd-block-text esd-extension-block\" \n        esd-extension-block-id=\"coupon-block\"\n    >\n        <p class=\"ins-title\" contenteditable=\"false\">{@COUPON_CODE}</p>\n    </td>\n";
+declare const migrationTemplate = "\n    <td\n        class=\"coupon-block coupon-block-v2 ins-coupon-code esd-block-text esd-extension-block\"\n        esd-extension-block-id=\"coupon-block\"\n    >\n        <p class=\"ins-title\" contenteditable=\"false\">{@COUPON_CODE}</p>\n    </td>\n";
 export declare function getDefaultTemplate(): string;
 export default migrationTemplate;

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/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,23 +8,6 @@ type TemplateParameters = {
     currencySymbol?: string;
     currencyLocation?: string;
     formattedPrice?: boolean;
-    migrate?: boolean;
-    /** Legacy config format (data-* attributes from esd-config-block) */
-    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.
@@ -39,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/common-control.d.ts

@@ -56,31 +56,26 @@ export declare abstract class CommonControl extends Control {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     /**
-     * Gets the Items block container element from the current node.
-     * @returns The container element or null if not found
-     */
-    protected getItemsBlockContainer(): ImmutableHtmlElementNode | null;
-    /**
-     * Gets the config block element from the current node (legacy support).
-     * @deprecated Use getNodeConfig() from nodeConfigUtils instead for Stripo V2
+     * Gets the config block element from the current node.
      * @returns The config block element or null if not found
      */
     protected getConfigBlock(): ImmutableHtmlElementNode | null;
     /**
-     * Gets the current block instance ID from the node config (Stripo V2) or legacy config block.
+     * Gets the current block instance ID from the config block.
+     * @param blockInstanceIdAttribute - The attribute name for block instance ID (default: 'data-block-instance-id')
      * @returns The block instance ID or null if not found
      */
-    protected getBlockInstanceId(): string | null;
+    protected getBlockInstanceId(blockInstanceIdAttribute?: string): string | null;
     /**
      * Handles block instance change detection and syncing.
-     * This is a helper method for controls that need to sync config when switching between block instances.
-     * Uses Stripo V2 nodeConfig API for block instance tracking.
-     * @param syncFunction - Function to call when block instance changes (to sync from node config)
+     * This is a helper method for controls that need to sync attributes when switching between block instances.
+     * @param syncFunction - Function to call when block instance changes (to sync from attributes)
      * @param updateUI - Function to call to update the UI (called both on change and when same block)
+     * @param blockInstanceIdAttribute - The attribute name for block instance ID (default: 'data-block-instance-id')
      * @returns true if block instance changed, false otherwise
      */
-    protected handleBlockInstanceChange(syncFunction: (node: ImmutableHtmlNode) => void, updateUI: () => void): boolean;
-    _GuLabel({ text, name, position }: LabelProps): string;
+    protected handleBlockInstanceChange(syncFunction: (node: ImmutableHtmlNode) => void, updateUI: () => void, blockInstanceIdAttribute?: string): boolean;
+    _GuLabel({ text, name }: LabelProps): string;
     _GuToggle(name: string): string;
     _GuSelectItem({ text, value }: {
         text: string;

package/dist/src/extensions/Blocks/controlFactories.d.ts

@@ -12,8 +12,9 @@
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 /**
  * Factory function to create text align controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextAlignControl(controlId: string, targetBlockId: string, containerSelector: string): {
+export declare function createTextAlignControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -27,8 +28,9 @@ export declare function createTextAlignControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text color controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextColorControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextColorControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -42,8 +44,9 @@ export declare function createTextColorControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text size controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextSizeControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextSizeControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -57,8 +60,9 @@ export declare function createTextSizeControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text style controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextStyleControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextStyleControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -72,8 +76,9 @@ export declare function createTextStyleControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text font family controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextFontFamilyControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextFontFamilyControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -87,8 +92,9 @@ export declare function createTextFontFamilyControl(controlId: string, targetBlo
 };
 /**
  * Factory function to create text background color controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextBackgroundColorControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextBackgroundColorControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -102,8 +108,25 @@ export declare function createTextBackgroundColorControl(controlId: string, targ
 };
 /**
  * Factory function to create paddings controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createPaddingsControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createPaddingsControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: ImmutableHtmlNode): boolean;
+    };
+};
+/**
+ * Factory function to create text line spacing controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
+ */
+export declare function createTextLineSpacingControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];