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

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,8 @@ 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>;
 }, undefined>;
 /**
  * Default block types available in Stripo
@@ -401,6 +418,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 +446,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 +499,8 @@ 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>;
     }, 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/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,7 @@ export declare const useConfig: () => {
             displayConditions: boolean;
             unsubscribe: boolean;
             modulesDisabled: boolean;
+            liquidSyntax: 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 +114,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 +131,7 @@ export declare const useConfig: () => {
                 value: string;
             } | undefined;
         }[];
+        customFieldAttributes: string[];
         selectedUnsubscribePages: number[];
         forceRecreate: boolean;
     } | null>;
@@ -147,6 +158,7 @@ export declare const useConfig: () => {
         displayConditions: boolean;
         unsubscribe: boolean;
         modulesDisabled: boolean;
+        liquidSyntax: 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/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/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/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;

package/dist/src/extensions/Blocks/Recommendation/templates/utils.d.ts

@@ -1,15 +1,29 @@
-import type { RecommendationProduct } from '@@/Types/recommendation';
+import type { FiltersResponse, RecommendationProduct } from '@@/Types/recommendation';
 import { 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 '../constants';
 /**
  * Converts a snake_case attribute name to Title Case display name.
  * e.g., "rating_star" → "Rating Star"
  */
 export declare function toDisplayName(attrName: string): string;
+/**
+ * Checks whether an attribute is a default (top-level) product attribute
+ * vs a custom product attribute (nested under `product_attributes`).
+ * Returns false when filterList is empty or the attribute is not found.
+ */
+export declare function isDefaultAttribute(attrName: string, filterList: FiltersResponse): boolean;
+/**
+ * Resolves the `product-attr` HTML attribute value based on attribute type from the filter list.
+ * - Default attributes → attribute name directly (e.g., "brand") → compiles to `{{1_0_brand}}`
+ * - Product attributes → "product_attribute.<name>" (e.g., "product_attribute.rating_star")
+ */
+export declare function resolveProductAttrValue(attrName: string, filterList: FiltersResponse): string;
 /**
  * Callback that generates the cell HTML for a custom product attribute.
  * Layout-specific: grid returns `<td>…`, list returns `<tr><td>…</td></tr>`.
+ * @param productAttrValue - The resolved `product-attr` value (e.g., "brand" or "product_attribute.rating_star")
+ * @param content - The display content for the cell
  */
-export type CustomCellHtmlGetter = (attrName: string, content: string) => string;
+export type CustomCellHtmlGetter = (productAttrValue: string, content: string) => string;
 /**
  * Symbol key for embedding custom attribute HTML in an ElementRenderer.
  * Grid and list renderers store their custom-attribute cell template under this key
@@ -28,8 +42,9 @@ export declare const CUSTOM_CELL_HTML: unique symbol;
  * alongside built-in ones, so template code can use a uniform lookup for all attributes.
  * @param baseRenderer - The built-in element renderer (grid or list), must include a [CUSTOM_CELL_HTML] entry
  * @param composition - Array of attribute keys including `customAttr:*` entries
+ * @param filterList - Filter list from the store, used to determine attribute type for correct product-attr resolution
  */
-export declare function buildElementRenderer(baseRenderer: ElementRenderer, composition: string[]): ElementRenderer;
+export declare function buildElementRenderer(baseRenderer: ElementRenderer, composition: string[], filterList?: FiltersResponse): ElementRenderer;
 export type Orientation = 'list' | 'grid';
 /**
  * Options for prepareProductRows unified function
@@ -41,6 +56,8 @@ export interface PrepareProductRowsOptions {
     mobileProductsPerRow?: number;
     /** Array defining order of card elements */
     composition?: string[];
+    /** Filter list for attribute type resolution (default vs product attributes) */
+    filterList?: FiltersResponse;
 }
 /**
  * Element renderer interface for product card elements.

package/dist/src/extensions/Blocks/Recommendation/utils/tagName.d.ts

@@ -15,7 +15,7 @@ export interface NodeWithGetStyle {
 }
 /** Interface for nodes with parent method */
 export interface NodeWithParent {
-    parent: () => ImmutableHtmlNode | undefined;
+    parent: () => ImmutableHtmlNode | null;
 }
 /**
  * Type guard to check if a node has getStyle method
@@ -38,13 +38,13 @@ export declare function isTdNode(node: unknown): node is ImmutableHtmlNode & Nod
  * @param property - The CSS property name
  * @returns The style value or null if not accessible
  */
-export declare function safeGetStyle(node: ImmutableHtmlNode | null | undefined, property: string): string | null | undefined;
+export declare function safeGetStyle(node: ImmutableHtmlNode | null, property: string): string | null | undefined;
 /**
  * Safely retrieves the parent element of a node
  * @param node - The node to get the parent from
  * @returns The parent node or null if not accessible
  */
-export declare function safeGetParent(node: ImmutableHtmlNode | null | undefined): ImmutableHtmlNode | null;
+export declare function safeGetParent(node: ImmutableHtmlNode | null): ImmutableHtmlNode | null;
 /**
  * Safely retrieves the tag name from a node.
  * Handles both standard DOM tagName property and Stripo's getTagName() method.

package/dist/src/services/templateLibraryApi.d.ts

@@ -3,5 +3,5 @@ export declare const useTemplateLibraryApi: () => {
     getCategories: () => Promise<Category[]>;
     checkTemplateNameAvailability: (value: string) => Promise<boolean>;
     createCategory: (category: string) => Promise<string>;
-    createTemplate: () => Promise<void>;
+    createTemplate: () => Promise<boolean>;
 };