@useinsider/guido 2.0.0-beta.dd0d492 → 2.0.0-beta.e66a90a

package/dist/package.json.js

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

package/dist/services/stripoApi.js

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

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

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

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

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

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

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

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

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

package/dist/src/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/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;
+}