@useinsider/guido 2.0.0-beta.c948eab → 2.0.0-beta.c9db5fd

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/components/organisms/header/RightSlot.vue.d.ts

@@ -1,4 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<import("../../../@types/stripo.js").SavedTemplateDetails | undefined>;
+    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/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/onboarding.d.ts

@@ -3,3 +3,4 @@ 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,6 +17,7 @@ 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/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"
+}

package/dist/src/extensions/Blocks/Recommendation/{constants.d.ts → constants/controlIds.d.ts}

@@ -1,14 +1,3 @@
-/**
- * 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",
-    IMAGE = "recommendation-block-image"
-}
 /**
  * Control IDs used in the Recommendation Extension
  * These IDs are returned by the getId() method of each control
@@ -32,6 +21,7 @@ export declare enum RecommendationControlId {
     NAME_PADDINGS = "recommendation-block-name-paddings-control",
     NAME_SIZE = "recommendation-block-name-size-control",
     NAME_STYLE = "recommendation-block-name-style-control",
+    NAME_TEXT_TRIM = "recommendation-block-name-text-trim-control",
     PRICE_ALIGN = "recommendation-block-price-align-control",
     PRICE_BACKGROUND = "recommendation-block-price-background-control",
     PRICE_COLOR = "recommendation-block-price-color-control",
@@ -46,6 +36,24 @@ export declare enum RecommendationControlId {
     OLD_PRICE_PADDINGS = "recommendation-block-old-price-paddings-control",
     OLD_PRICE_SIZE = "recommendation-block-old-price-size-control",
     OLD_PRICE_STYLE = "recommendation-block-old-price-style-control",
+    OMNIBUS_PRICE_ALIGN = "recommendation-block-omnibus-price-align-control",
+    OMNIBUS_PRICE_BACKGROUND = "recommendation-block-omnibus-price-background-control",
+    OMNIBUS_PRICE_COLOR = "recommendation-block-omnibus-price-color-control",
+    OMNIBUS_PRICE_FONT_FAMILY = "recommendation-block-omnibus-price-font-family-control",
+    OMNIBUS_PRICE_PADDINGS = "recommendation-block-omnibus-price-paddings-control",
+    OMNIBUS_PRICE_SIZE = "recommendation-block-omnibus-price-size-control",
+    OMNIBUS_PRICE_STYLE = "recommendation-block-omnibus-price-style-control",
+    OMNIBUS_PRICE_TEXT_BEFORE = "recommendation-block-omnibus-price-text-before-control",
+    OMNIBUS_PRICE_TEXT_AFTER = "recommendation-block-omnibus-price-text-after-control",
+    OMNIBUS_DISCOUNT_ALIGN = "recommendation-block-omnibus-discount-align-control",
+    OMNIBUS_DISCOUNT_BACKGROUND = "recommendation-block-omnibus-discount-background-control",
+    OMNIBUS_DISCOUNT_COLOR = "recommendation-block-omnibus-discount-color-control",
+    OMNIBUS_DISCOUNT_FONT_FAMILY = "recommendation-block-omnibus-discount-font-family-control",
+    OMNIBUS_DISCOUNT_PADDINGS = "recommendation-block-omnibus-discount-paddings-control",
+    OMNIBUS_DISCOUNT_SIZE = "recommendation-block-omnibus-discount-size-control",
+    OMNIBUS_DISCOUNT_STYLE = "recommendation-block-omnibus-discount-style-control",
+    OMNIBUS_DISCOUNT_TEXT_BEFORE = "recommendation-block-omnibus-discount-text-before-control",
+    OMNIBUS_DISCOUNT_TEXT_AFTER = "recommendation-block-omnibus-discount-text-after-control",
     IMAGE_SIZE = "recommendation-block-image-size-control",
     IMAGE_MARGINS = "recommendation-block-image-margins-control"
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Recommendation Extension Constants
+ *
+ * This module re-exports all constants for the Recommendation extension.
+ * Import from this file for cleaner imports.
+ * @example
+ * import { RecommendationBlockId, CONTAINER_SELECTOR } from './constants';
+ */
+export { RecommendationBlockId } from './blockIds';
+export { RecommendationControlId } from './controlIds';
+export { CONTAINER_SELECTOR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, } from './selectors';

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

@@ -0,0 +1,19 @@
+/**
+ * CSS selectors and data attributes used across the Recommendation extension
+ */
+/**
+ * Container selector for the product container element
+ * Used across controls to target elements within the recommendation block
+ */
+export declare const CONTAINER_SELECTOR = ".ins-recommendation-product-container";
+/**
+ * Attribute type constants used in templates
+ * These are used as keys in ElementRenderer and composition arrays
+ */
+export declare const ATTR_PRODUCT_IMAGE = "productImage";
+export declare const ATTR_PRODUCT_NAME = "productName";
+export declare const ATTR_PRODUCT_PRICE = "productPrice";
+export declare const ATTR_PRODUCT_OLD_PRICE = "productOldPrice";
+export declare const ATTR_PRODUCT_OMNIBUS_PRICE = "productOmnibusPrice";
+export declare const ATTR_PRODUCT_OMNIBUS_DISCOUNT = "productOmnibusDiscount";
+export declare const ATTR_PRODUCT_BUTTON = "productButton";

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

@@ -0,0 +1,143 @@
+/**
+ * Button Element Controls
+ *
+ * Controls for styling the CTA button element in recommendation cards.
+ */
+/**
+ * Grouped Button Controls
+ * Use this object for cleaner imports in extension.ts
+ */
+export declare const ButtonControls: {
+    readonly align: {
+        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;
+        };
+    };
+    readonly border: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ButtonBorderControlLabels | undefined;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            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;
+        };
+    };
+    readonly borderRadius: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ButtonBorderRadiusControlLabels | undefined;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            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;
+        };
+    };
+    readonly color: {
+        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;
+        };
+    };
+    readonly fontFamily: {
+        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;
+        };
+    };
+    readonly margins: {
+        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;
+        };
+    };
+    readonly paddings: {
+        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;
+        };
+    };
+    readonly text: {
+        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;
+        };
+    };
+    readonly textSize: {
+        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;
+        };
+    };
+    readonly textStyleAndFontColor: {
+        new (): {
+            getId(): string;
+            getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+            getParentControlId(): string;
+            getLabels(): import("@stripoinc/ui-editor-extensions").ButtonTextStyleAndFontColorControlLabels | undefined;
+            api: import("@stripoinc/ui-editor-extensions").ControlApi;
+            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;
+        };
+    };
+    readonly fitToContent: {
+        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/Recommendation/controls/cardBackground/index.d.ts

@@ -0,0 +1,41 @@
+import type { Orientation } from '@@/Types/recommendation';
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+export declare const CARD_BACKGROUND_COLOR_CONTROL_ID = "recommendation-card-background-color-control";
+/**
+ * Control for managing recommendation card background color
+ * This control is displayed in the Styles tab
+ */
+export declare class CardBackgroundColorControl extends CommonControl {
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    /**
+     * Gets the block element - either currentNode itself or as a descendant
+     * The currentNode could BE the block element or contain it
+     */
+    _getBlockElement(): ImmutableHtmlNode | null;
+    /**
+     * Gets the current layout orientation from the block's data attribute
+     */
+    _getCurrentLayout(): Orientation;
+    /**
+     * Gets the appropriate selector based on layout
+     * Vertical: .product-card-segment (inner table per product cell)
+     * Horizontal: .product-card-wrapper (table per product row)
+     */
+    _getCardSelector(): string;
+    /**
+     * Reads the current background color from the first product card element
+     * @returns The background color value or 'transparent' if not found
+     */
+    _getCurrentCardBackgroundColor(): string;
+    /**
+     * Handles card background color changes
+     * Applies the color to all product card elements based on layout
+     */
+    _onCardBackgroundColorChange(color: string): void;
+    _listenToFormUpdates(): void;
+}

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

@@ -0,0 +1,95 @@
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+export declare const COMPOSITION_CONTROL_BLOCK_ID = "ui-elements-recommendation-card-composition";
+export interface CardCompositionItem {
+    key: string;
+    label: string;
+    visible: boolean;
+}
+export declare class RecommendationCardCompositionControl extends CommonControl {
+    private store;
+    private unsubscribeOrientation;
+    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
+     */
+    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
+     * Note: Reordering is only applied for vertical layout
+     */
+    private _applyCompositionToBlock;
+    /**
+     * Reorders attribute rows within each product card based on composition order
+     * Targets the tbody inside each product-attribute-cell to preserve card structure
+     */
+    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 elements
+     * - <tr> elements: use display: none / table-row
+     * - <td> elements: use display: none / table-cell
+     */
+    private _applyVisibilityToBlock;
+    /**
+     * Gets the current layout orientation from store or DOM
+     */
+    private _getCurrentLayout;
+    /**
+     * Updates orderable state based on layout orientation
+     * Adds/removes disabled class to hide drag icons for horizontal layout
+     */
+    private _updateOrderableState;
+    /**
+     * Subscribe to store orientation changes
+     * Updates orderable state when layout changes via the layout control
+     */
+    private _subscribeToOrientationChanges;
+}

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

@@ -0,0 +1,35 @@
+/**
+ * Image Element Controls
+ *
+ * Controls for styling the product image element in recommendation cards.
+ */
+/**
+ * Grouped Image Controls
+ * Use this object for cleaner imports in extension.ts
+ */
+export declare const ImageControls: {
+    readonly size: {
+        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;
+        };
+    };
+    readonly margins: {
+        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;
+        };
+    };
+};