@useinsider/guido 3.2.0-beta.e01b42a → 3.2.0-beta.ec6228c

package/dist/services/templateLibraryApi.js

@@ -1,14 +1,15 @@
-import { useConfig as T } from "../composables/useConfig.js";
-import { useHttp as f } from "../composables/useHttp.js";
-import { useToaster as w } from "../composables/useToaster.js";
-import { useTranslations as b } from "../composables/useTranslations.js";
-import { EditorType as h } from "../enums/defaults.js";
-import { useRecommendationExtensionStore as C } from "../extensions/Blocks/Recommendation/store/recommendation.js";
-import { useSaveAsTemplateStore as v } from "../stores/save-as-template.js";
-import { base64EncodeWithSpecialChars as a } from "../utils/base64.js";
-import { useTemplatePreparation as S } from "../utils/templatePreparation.js";
-const R = () => {
-  const { get: n, post: c } = f(), { handleError: o, showToaster: i } = w(), { config: l } = T(), p = b();
+import { useConfig as w } from "../composables/useConfig.js";
+import { useHttp as b } from "../composables/useHttp.js";
+import { useToaster as h } from "../composables/useToaster.js";
+import { useTranslations as C } from "../composables/useTranslations.js";
+import { useLiquidValidator as S } from "../composables/validators/useLiquidValidator.js";
+import { EditorType as v } from "../enums/defaults.js";
+import { useRecommendationExtensionStore as N } from "../extensions/Blocks/Recommendation/store/recommendation.js";
+import { useSaveAsTemplateStore as x } from "../stores/save-as-template.js";
+import { base64EncodeWithSpecialChars as r } from "../utils/base64.js";
+import { useTemplatePreparation as A } from "../utils/templatePreparation.js";
+const $ = () => {
+  const { get: n, post: m } = b(), { handleError: o, showToaster: l } = h(), { config: c, isFeatureEnabled: p } = w(), { validateLiquidSyntax: g } = S(), u = C();
   return {
     getCategories: async () => {
       try {
@@ -26,7 +27,7 @@ const R = () => {
     },
     createCategory: async (e) => {
       try {
-        const { data: { id: t } } = await c(
+        const { data: { id: t } } = await m(
           "/newsletter/template-library/create-category",
           { name: e }
         );
@@ -36,55 +37,56 @@ const R = () => {
       }
     },
     createTemplate: async () => {
-      var e, t, g, y;
+      var e, t, d, y;
       try {
-        const { prepareTemplateDetails: m } = S(), r = v(), s = await m(), u = {
-          name: r.getTemplateName,
-          categories: r.getSelectedCategoryIds,
-          productId: ((t = (e = l.value) == null ? void 0 : e.partner) == null ? void 0 : t.productType) || 0,
-          editorType: h,
-          messageType: ((y = (g = l.value) == null ? void 0 : g.partner) == null ? void 0 : y.messageType) || 0,
-          content: a(s.compiledHtml),
-          css: a(s.css),
+        const { prepareTemplateDetails: i } = A(), s = x(), a = await i();
+        if (p("liquidSyntax") && !await g(a.compiledHtml))
+          return !1;
+        const f = {
+          name: s.getTemplateName,
+          categories: s.getSelectedCategoryIds,
+          productId: ((t = (e = c.value) == null ? void 0 : e.partner) == null ? void 0 : t.productType) || 0,
+          editorType: v,
+          messageType: ((y = (d = c.value) == null ? void 0 : d.partner) == null ? void 0 : y.messageType) || 0,
+          content: r(a.compiledHtml),
+          css: r(a.css),
           unsubscriptionPreferencePageStatus: !1,
           unsubscriptionPreferencePages: [],
-          recommendationCampaignUrls: a(
-            C().recommendationCampaignUrls
+          recommendationCampaignUrls: r(
+            N().recommendationCampaignUrls
           ),
-          recommendationConfigs: a({}),
+          recommendationConfigs: r({}),
           isGuido: !0,
-          stripoConfig: a({
+          // eslint-disable-next-line camelcase
+          template_engine: p("liquidSyntax") ? 1 : 0,
+          stripoConfig: r({
             editor: "stripo",
-            html: s.rawHtml,
-            css: s.css
+            html: a.rawHtml,
+            css: a.css
           })
-        }, { data: { type: d } } = await c(
+        }, { data: { type: T } } = await m(
           "/newsletter/template-library/create-template",
-          u
+          f
         );
-        if (d === "alert") {
-          i({
-            message: p(
-              "newsletter.template-library-save-alert",
-              { templateName: r.getTemplateName }
-            ),
-            type: "alert"
-          });
-          return;
-        }
-        i({
-          message: p(
+        return T === "alert" ? (l({
+          message: u(
+            "newsletter.template-library-save-alert",
+            { templateName: s.getTemplateName }
+          ),
+          type: "alert"
+        }), !1) : (l({
+          message: u(
             "newsletter.template-library-save-success",
-            { templateName: r.getTemplateName }
+            { templateName: s.getTemplateName }
           ),
           type: "success"
-        });
-      } catch (m) {
-        o(m, "Failed to create template");
+        }), !0);
+      } catch (i) {
+        return o(i, "Failed to create template"), !1;
       }
     }
   };
 };
 export {
-  R as useTemplateLibraryApi
+  $ as useTemplateLibraryApi
 };

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

@@ -8,7 +8,7 @@
  * - Validation utilities
  */
 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 type { GuidoConfig, GuidoConfigInput, IdentityConfig, IdentityConfigInput, PartnerConfig, PartnerConfigInput, FallbackFont, 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

@@ -47,6 +47,12 @@ export declare const IdentitySchema: v.ObjectSchema<{
 /**
  * Partner configuration - organization and product context
  */
+export declare const FallbackFontSchema: v.ObjectSchema<{
+    /** Fallback font name (e.g., "Georgia") */
+    readonly name: v.StringSchema<undefined>;
+    /** Fallback font family (e.g., "serif" or "sans-serif") */
+    readonly family: v.StringSchema<undefined>;
+}, undefined>;
 export declare const PartnerSchema: v.ObjectSchema<{
     /** Partner/organization name (required) */
     readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "partner.name is required">]>;
@@ -56,6 +62,13 @@ export declare const PartnerSchema: v.ObjectSchema<{
     readonly messageType: v.OptionalSchema<v.PicklistSchema<[1, 2], undefined>, 1>;
     /** Display name for the current user */
     readonly username: v.OptionalSchema<v.StringSchema<undefined>, "Guido User">;
+    /** Fallback font settings from partner settings — used to match backend size calculation */
+    readonly fallbackFont: v.OptionalSchema<v.ObjectSchema<{
+        /** Fallback font name (e.g., "Georgia") */
+        readonly name: v.StringSchema<undefined>;
+        /** Fallback font family (e.g., "serif" or "sans-serif") */
+        readonly family: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
 }, undefined>;
 /**
  * Dynamic content item schema
@@ -95,6 +108,8 @@ export declare const TemplateSchema: v.ObjectSchema<{
             readonly value: v.StringSchema<undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>, readonly []>;
+    /** Valid custom field attribute names from the partner's categorized fields */
+    readonly customFieldAttributes: v.OptionalSchema<v.ArraySchema<v.StringSchema<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) */
@@ -161,6 +176,10 @@ export declare const FeaturesSchema: v.ObjectSchema<{
     readonly unsubscribe: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
     /** Disable modules panel in the editor */
     readonly modulesDisabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /** Enable Liquid template syntax */
+    readonly liquidSyntax: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /** Enable autosave (2-min interval + tab-hide). User toggles on/off from the header. */
+    readonly autosave: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
  * Default block types available in Stripo
@@ -401,6 +420,13 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly messageType: v.OptionalSchema<v.PicklistSchema<[1, 2], undefined>, 1>;
         /** Display name for the current user */
         readonly username: v.OptionalSchema<v.StringSchema<undefined>, "Guido User">;
+        /** Fallback font settings from partner settings — used to match backend size calculation */
+        readonly fallbackFont: v.OptionalSchema<v.ObjectSchema<{
+            /** Fallback font name (e.g., "Georgia") */
+            readonly name: v.StringSchema<undefined>;
+            /** Fallback font family (e.g., "serif" or "sans-serif") */
+            readonly family: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
     }, undefined>;
     /** Template content and presets */
     readonly template: v.OptionalSchema<v.ObjectSchema<{
@@ -422,6 +448,8 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
                 readonly value: v.StringSchema<undefined>;
             }, undefined>, undefined>;
         }, undefined>, undefined>, readonly []>;
+        /** Valid custom field attribute names from the partner's categorized fields */
+        readonly customFieldAttributes: v.OptionalSchema<v.ArraySchema<v.StringSchema<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) */
@@ -473,6 +501,10 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly unsubscribe: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
         /** Disable modules panel in the editor */
         readonly modulesDisabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /** Enable Liquid template syntax */
+        readonly liquidSyntax: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /** Enable autosave (2-min interval + tab-hide). User toggles on/off from the header. */
+        readonly autosave: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Block configuration */
     readonly blocks: v.OptionalSchema<v.ObjectSchema<{

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, CallbacksSchema, DynamicContentSchema, EmailHeaderSchema, CompilerRuleSchema, ReplaceRuleSchema, RegexRuleSchema, RemoveRuleSchema, CustomRuleSchema, DefaultBlockTypeSchema, CustomBlockTypeSchema, ExternalValidationHandler } from './schemas';
+import type { GuidoConfigSchema, IdentitySchema, PartnerSchema, TemplateSchema, EditorSchema, UISchema, FeaturesSchema, BlocksSchema, CompilerSchema, CallbacksSchema, DynamicContentSchema, EmailHeaderSchema, CompilerRuleSchema, ReplaceRuleSchema, RegexRuleSchema, RemoveRuleSchema, CustomRuleSchema, DefaultBlockTypeSchema, CustomBlockTypeSchema, FallbackFontSchema, ExternalValidationHandler } from './schemas';
 import type * as v from 'valibot';
 /**
  * Complete validated Guido configuration.
@@ -29,6 +29,8 @@ export type GuidoConfig = v.InferOutput<typeof GuidoConfigSchema>;
 export type IdentityConfig = v.InferOutput<typeof IdentitySchema>;
 /** Partner configuration (name, productType, messageType, username) */
 export type PartnerConfig = v.InferOutput<typeof PartnerSchema>;
+/** Fallback font settings for backend size calculation alignment */
+export type FallbackFont = v.InferOutput<typeof FallbackFontSchema>;
 /** Template configuration (html, css, dynamic content, unsubscribe pages) */
 export type TemplateConfig = v.InferOutput<typeof TemplateSchema>;
 /** Editor configuration (locale, translations, migration date, email header) */

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

@@ -44,7 +44,6 @@ export interface TooltipOptions {
         x: number;
         y: number;
     };
-    preventXss?: boolean;
 }
 export type TextValueObject = {
     text: string;

package/dist/src/@types/save-as-template.d.ts

@@ -26,4 +26,5 @@ export interface CreateTemplateRequest {
     unsubscriptionPreferencePages: number[];
     unsubscriptionPreferencePageStatus: boolean;
     isGuido: boolean;
+    template_engine: number;
 }

package/dist/src/components/organisms/AutoSaveController.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/AutoSaveToggle.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/composables/useActionsApi.d.ts

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

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

@@ -0,0 +1,3 @@
+type SaveSilent = () => unknown;
+export declare const useAutoSave: (saveSilent: SaveSilent) => void;
+export {};

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

@@ -17,6 +17,10 @@ export declare const useConfig: () => {
             productType: 60 | 49 | 97;
             messageType: 1 | 2;
             username: string;
+            fallbackFont?: {
+                name: string;
+                family: string;
+            } | undefined;
         };
         template: {
             html: string;
@@ -30,6 +34,7 @@ export declare const useConfig: () => {
                     value: string;
                 } | undefined;
             }[];
+            customFieldAttributes: string[];
             selectedUnsubscribePages: number[];
             forceRecreate: boolean;
         };
@@ -56,6 +61,8 @@ export declare const useConfig: () => {
             displayConditions: boolean;
             unsubscribe: boolean;
             modulesDisabled: boolean;
+            liquidSyntax: boolean;
+            autosave: boolean;
         };
         blocks: {
             excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
@@ -108,6 +115,10 @@ export declare const useConfig: () => {
         productType: 60 | 49 | 97;
         messageType: 1 | 2;
         username: string;
+        fallbackFont?: {
+            name: string;
+            family: string;
+        } | undefined;
     } | null>;
     template: import("vue").ComputedRef<{
         html: string;
@@ -121,6 +132,7 @@ export declare const useConfig: () => {
                 value: string;
             } | undefined;
         }[];
+        customFieldAttributes: string[];
         selectedUnsubscribePages: number[];
         forceRecreate: boolean;
     } | null>;
@@ -147,6 +159,8 @@ export declare const useConfig: () => {
         displayConditions: boolean;
         unsubscribe: boolean;
         modulesDisabled: boolean;
+        liquidSyntax: boolean;
+        autosave: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{
         excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];

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

@@ -0,0 +1,11 @@
+/**
+ * Injects the hosted FullStory bridge script into the Stripo editor iframe.
+ *
+ * The bridge script's origin is allowlisted via Stripo's
+ * `allowedScriptSourceDomains` in useStripo, so the iframe's CSP permits
+ * the load. The bundled script itself handles reading FS config from the
+ * parent window and booting the FullStory queue stub inside the iframe.
+ */
+export declare const useFullStoryBridge: () => {
+    injectFullStory: () => void;
+};

package/dist/src/composables/validators/useLiquidValidator.d.ts

@@ -0,0 +1,3 @@
+export declare const useLiquidValidator: () => {
+    validateLiquidSyntax: (compiledHtml: string) => Promise<boolean>;
+};

package/dist/src/config/compiler/liquidCompilerRules.d.ts

@@ -0,0 +1,2 @@
+import type { CompilerRule } from '@@/Types/html-compiler';
+export declare const liquidCompilerRules: CompilerRule[];

package/dist/src/config/compiler/utils/recommendationCompilerUtils.d.ts

@@ -6,7 +6,7 @@
  * @param alignment - Currency alignment from block config: 'before' or 'after'
  * @returns Formatted price string with currency variable in correct position
  */
-export declare function formatPriceVariable(campaignId: string, productIndex: number, attribute: string, alignment: string): string;
+export declare function formatPriceVariable(campaignId: string, productIndex: number, attribute: string, alignment: string, prefix?: string): string;
 /**
  * Transforms recommendation block HTML by replacing product data with
  * template variables.

package/dist/src/enums/extensions/recommendationBlock.d.ts

@@ -3,6 +3,9 @@ import type { RecommendationFeedItem } from '@@/Types/recommendation';
 export declare const URLS: {
     RECOMMENDATION_API_URL: string;
 };
+export declare const QUERY_PARAMS: {
+    CLIENT_ID: string;
+};
 export declare const RecommendationFeedSourceMaps: RecommendationFeedItem[];
 export declare const PriceAttributes: string[];
 export declare const currencyLocationMaps: TextValueObject[];

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

@@ -1,3 +1,5 @@
+export declare const COUPON_PLACEHOLDER_DEFAULT = "{@COUPON_CODE}";
+export declare const COUPON_PLACEHOLDER_LIQUID = "{{ins_coupon_code}}";
 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/controlIds.d.ts

@@ -63,5 +63,6 @@ export declare enum RecommendationControlId {
     CUSTOM_ATTR_PADDINGS = "recommendation-block-custom-attr-paddings-control",
     CUSTOM_ATTR_SIZE = "recommendation-block-custom-attr-size-control",
     CUSTOM_ATTR_STYLE = "recommendation-block-custom-attr-style-control",
+    CUSTOM_ATTR_TEXT_TRIM = "recommendation-block-custom-attr-text-trim-control",
     SYNC_INFO_MESSAGE = "recommendation-block-sync-info-message"
 }

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

@@ -8,6 +8,6 @@
  */
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
-export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, } from './selectors';
+export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
 export { LAYOUT_VALUES, LAYOUT_OPTIONS, DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, DEFAULT_MOBILE_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, MAX_MOBILE_PRODUCTS_PER_ROW, MIN_MOBILE_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, DEFAULT_MOBILE_COLUMN_SPACING, DEFAULT_MOBILE_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
 export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

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

@@ -50,3 +50,8 @@ export declare const ATTR_CUSTOM_PREFIX = "customAttr:";
 export declare const ATTR_DATA_CUSTOM_ATTRIBUTES = "data-custom-attributes";
 /** HTML attribute on <td> elements identifying the product attribute for compiler template variable generation */
 export declare const ATTR_PRODUCT_ATTR = "product-attr";
+/**
+ * Default attribute names that are already represented by built-in composition toggle items.
+ * Used to exclude these from the custom attribute dropdown to prevent duplication with toggles.
+ */
+export declare const BUILT_IN_DEFAULT_ATTRIBUTES: Set<string>;

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

@@ -170,6 +170,11 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      * When filterList changes (e.g. after async fetch), re-renders dropdowns with new options.
      */
     private _subscribeToStoreChanges;
+    /**
+     * Returns filters eligible for the custom attribute dropdown,
+     * excluding default attributes already covered by built-in toggle items.
+     */
+    private _getAddableFilters;
     /**
      * Looks up the display name for an attribute from the store's filterList.
      * Falls back to Title Case conversion of the snake_case attribute name.

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

@@ -13,10 +13,12 @@
  * product cards — changing "brand" color won't affect "rating_star" color.
  */
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CustomAttributeTextTrimControl } from './textTrim';
 /**
  * Grouped Custom Attribute Controls
  * Use this object for cleaner imports in extension.ts
  */
+export { CustomAttributeTextTrimControl } from './textTrim';
 export declare const CustomAttributeControls: {
     readonly align: {
         new (): {
@@ -102,4 +104,5 @@ export declare const CustomAttributeControls: {
             isVisible(_node: ImmutableHtmlNode): boolean;
         };
     };
+    readonly textTrim: typeof CustomAttributeTextTrimControl;
 };

package/dist/src/extensions/Blocks/Recommendation/controls/customAttribute/textTrim.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Custom Attribute Text Trim Control
+ *
+ * Per-attribute text trimming for custom product attributes.
+ * Unlike NameTextTrimControl which applies to ALL product names globally,
+ * this control is scoped to a specific custom attribute type via the
+ * `product-attr` HTML attribute — changing text-trim on "brand" won't
+ * affect "rating_star".
+ *
+ * CSS rules are shared with NameTextTrimControl via shared/textTrimCssRules.ts.
+ */
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+/**
+ * Control for enabling/disabling text trimming on individual custom attributes.
+ * Scoped per attribute type using the `product-attr` HTML attribute.
+ */
+export declare class CustomAttributeTextTrimControl extends CommonControl {
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    _getCurrentTrimState(): boolean;
+    /**
+     * Finds all custom attribute elements of the same type as the current node.
+     *
+     * Similar to getCustomAttrTargetNodes in customAttribute/index.ts, but adapted
+     * for CommonControl lifecycle where currentNode is a class property (not a
+     * parameter from Stripo's getTargetNodes override).
+     */
+    _getTargetElements(): ImmutableHtmlNode[];
+    _onTextTrimChange(enabled: boolean): void;
+    _listenToFormUpdates(): void;
+}

package/dist/src/extensions/Blocks/Recommendation/controls/name/textTrim.d.ts

@@ -1,9 +1,9 @@
-import { ImmutableCssNode, ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { CommonControl } from '../../../common-control';
 /**
- * Control for enabling/disabling text trimming on product names
+ * Control for enabling/disabling text trimming on product names.
  * When enabled, adds a CSS class that applies text-overflow: ellipsis
- * and injects the required CSS rules into the document stylesheet
+ * and injects the required CSS rules into the document stylesheet.
  */
 export declare class NameTextTrimControl extends CommonControl {
     getId(): string;
@@ -12,23 +12,6 @@ export declare class NameTextTrimControl extends CommonControl {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _setFormValues(): void;
     _getCurrentTrimState(): boolean;
-    /**
-     * Finds an existing CSS rule in the document stylesheet by exact query
-     * @param query - The CSS query to search for (uses Stripo's CSS query syntax)
-     * @returns The CSS rule node if found, undefined otherwise
-     */
-    _findCssRule(query: string): ImmutableCssNode | undefined;
-    /**
-     * Finds the .text-trim-enabled p rule by searching all text-trim rules and comparing selectors
-     * This is needed because Stripo's CSS query syntax interprets spaces as path separators
-     * @returns true if the rule exists
-     */
-    _hasParagraphRule(): boolean;
-    /**
-     * Ensures the text-trim CSS rules exist in the document stylesheet
-     * Only adds rules if they don't already exist (prevents duplicates across multiple blocks)
-     */
-    _ensureCssRulesExist(): void;
     _onTextTrimChange(enabled: boolean): void;
     _listenToFormUpdates(): void;
 }

package/dist/src/extensions/Blocks/Recommendation/controls/shared/textTrimCssRules.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared Text Trim CSS Rule Management
+ *
+ * Extracted from NameTextTrimControl to be reused by CustomAttributeTextTrimControl.
+ * Follows the same pattern as controls/mobileLayout/cssRules.ts — standalone
+ * functions that accept an API parameter, importable by any control class.
+ *
+ * The CSS rules are document-scoped (shared across all recommendation blocks).
+ * Once injected, they persist until the template is closed.
+ */
+import type { ImmutableCssNode } from '@stripoinc/ui-editor-extensions';
+import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
+export declare const CSS_CLASS_TEXT_TRIM = "text-trim-enabled";
+interface CssCapableApi {
+    getDocumentRootCssNode: () => ImmutableCssNode | null;
+    getDocumentModifier: () => {
+        modifyCss: (node: ImmutableCssNode) => {
+            appendRule: (rule: string) => void;
+        };
+        apply: (desc: ModificationDescription) => void;
+    };
+}
+/**
+ * Ensures the text-trim CSS rules exist in the document stylesheet.
+ * Only adds rules if they don't already exist (prevents duplicates across blocks).
+ * Calls getDocumentRootCssNode once and passes it to both checks.
+ */
+export declare function ensureTextTrimCssRulesExist(api: CssCapableApi): void;
+export {};

package/dist/src/extensions/Blocks/Recommendation/templates/grid/template.d.ts

@@ -1,4 +1,4 @@
-import type { RecommendationProduct } from '@@/Types/recommendation';
+import type { FiltersResponse, RecommendationProduct } from '@@/Types/recommendation';
 import { type ElementRenderer } from '../utils';
 /**
  * Generates attribute-aligned product rows for grid layout.
@@ -9,7 +9,7 @@ import { type ElementRenderer } from '../utils';
  * @param composition - Array defining order of card elements
  * @returns HTML string for attribute-aligned rows
  */
-export declare function prepareGridAttributeRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[]): string;
+export declare function prepareGridAttributeRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[], filterList?: FiltersResponse): string;
 /**
  * Prepares grid product rows with attribute-aligned structure
  * Groups products into rows, then generates attribute-aligned HTML for each group
@@ -19,7 +19,7 @@ export declare function prepareGridAttributeRows(products: RecommendationProduct
  * @param composition - Array defining order of card elements
  * @returns HTML string for all product rows
  */
-export declare function prepareGridProductRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[]): string;
+export declare function prepareGridProductRows(products: RecommendationProduct[], productsPerRow: number, elementRenderer: ElementRenderer, composition?: string[], filterList?: FiltersResponse): string;
 /**
  * Prepares grid product rows with attribute-aligned structure.
  * Uses row-based rendering where each attribute type forms a single row across all products.
@@ -28,6 +28,6 @@ export declare function prepareGridProductRows(products: RecommendationProduct[]
  * @param composition - Array defining element order
  * @returns HTML string for product rows
  */
-export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[]): string;
+export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[], filterList?: FiltersResponse): string;
 export declare function getDefaultTemplate(recommendationId?: number): string;
 export declare function generateBlockTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: string[], mobileProductsPerRow?: number): string;

package/dist/src/extensions/Blocks/Recommendation/templates/list/template.d.ts

@@ -1,4 +1,4 @@
-import type { RecommendationProduct } from '@@/Types/recommendation';
+import type { FiltersResponse, RecommendationProduct } from '@@/Types/recommendation';
 /**
  * Generates a list product card with 3-column layout
  * Uses buildElementRenderer to render Image, Info content, and Button
@@ -11,7 +11,7 @@ import type { RecommendationProduct } from '@@/Types/recommendation';
  * @param composition - Array defining order of card elements
  * @returns HTML string for a single product card row
  */
-export declare function getListProductCard(product: RecommendationProduct, composition?: string[]): string;
+export declare function getListProductCard(product: RecommendationProduct, composition?: string[], filterList?: FiltersResponse): string;
 /**
  * Prepares list product rows
  * Each product is a full-width row with 3-column layout
@@ -19,6 +19,6 @@ export declare function getListProductCard(product: RecommendationProduct, compo
  * @param composition - Array defining order of card elements
  * @returns HTML string for product rows
  */
-export declare function prepareProductRows(products: RecommendationProduct[], composition?: string[]): string;
+export declare function prepareProductRows(products: RecommendationProduct[], composition?: string[], filterList?: FiltersResponse): string;
 export declare function getDefaultTemplate(): string;
 export declare function generateBlockTemplate(products: RecommendationProduct[], title?: string, composition?: string[]): string;