@useinsider/guido 2.1.0-beta.7d0f92a → 2.1.0-beta.7ffef92

package/dist/services/recommendationApi.js

@@ -1,7 +1,7 @@
-import { useHttp as a } from "../composables/useHttp.js";
-import { URLS as s } from "../enums/extensions/recommendationBlock.js";
-const u = () => {
-  const { get: o } = a();
+import { useHttp as c } from "../composables/useHttp.js";
+import { URLS as m } from "../enums/extensions/recommendationBlock.js";
+const f = () => {
+  const { get: o } = c();
   return {
     fetchRecommendationCreateData: async () => {
       try {
@@ -18,13 +18,15 @@ const u = () => {
         throw console.error("fetchRecommendationFilters error:", e), e;
       }
     },
-    fetchRecommendationProducts: async (e, c) => {
+    fetchRecommendationProducts: async (e, a) => {
       var n;
       try {
-        const t = decodeURIComponent(new URLSearchParams(Object.entries(c)).toString());
+        const t = decodeURIComponent(new URLSearchParams(Object.entries(a)).toString());
         console.debug("🏁 Recommendation API Query:", t);
-        const r = await o(
-          `${s.RECOMMENDATION_API_URL}/v2/${e}?${t}`
+        const { get: s } = c({
+          headers: {}
+        }), r = await s(
+          `${m.RECOMMENDATION_API_URL}/v2/${e}?${t}`
         );
         return ((n = r == null ? void 0 : r.data) == null ? void 0 : n.data) ?? [];
       } catch (t) {
@@ -34,5 +36,5 @@ const u = () => {
   };
 };
 export {
-  u as useRecommendationApi
+  f as useRecommendationApi
 };

package/dist/services/stripoApi.js

@@ -1,44 +1,47 @@
-import { useHttp as m } from "../composables/useHttp.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 } = i();
+import { useHttp as l } from "../composables/useHttp.js";
+import { useToaster as u } from "../composables/useToaster.js";
+import { MAX_DEFAULT_TEMPLATE_ID as d } from "../enums/defaults.js";
+import f from "../static/templates/empty/index.html.js";
+import g from "../static/templates/empty/style.css.js";
+const D = () => {
+  const { get: o } = l(), { handleError: a } = u();
   return {
     getToken: async () => {
       try {
-        const t = Number(localStorage.getItem("ins-guido-test-instance")), { data: e } = await r(`/stripo/get-user-token?test=${t}`);
+        const t = Number(localStorage.getItem("ins-guido-test-instance")), { data: e } = await o(`/stripo/get-user-token?test=${t}`);
         return e.body.token;
       } catch (t) {
-        return o(t, "Failed to fetch token"), "";
+        return a(t, "Failed to fetch token"), "";
       }
     },
     getCustomFonts: async () => {
       try {
-        const { data: t = [] } = await r("/stripo/get-partner-custom-fonts");
+        const { data: t = [] } = await o("/stripo/get-partner-custom-fonts");
         return t.map((e) => ({
           ...e,
           active: !0
         }));
       } catch (t) {
-        return o(t, "Failed to fetch custom fonts"), [];
+        return a(t, "Failed to fetch custom fonts"), [];
       }
     },
     getDefaultTemplate: async () => {
       const t = {
-        html: "",
-        css: ""
+        html: f,
+        css: g
       };
       try {
-        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;
+        const e = new URLSearchParams(window.location.search), c = e.get("default-template"), p = e.get("master"), s = c ? parseInt(c) : 0, m = s >= 1 && s <= d ? s : 0;
+        if (!m && !p)
+          return t;
+        const i = `/stripo/default-template/${m}`, { data: n } = await o(i), r = typeof n == "string" ? JSON.parse(n) : n;
+        return !r || typeof r != "object" || !("html" in r) || !("css" in r) ? t : r;
       } catch (e) {
-        return o(e, "Failed to fetch default template"), t;
+        return a(e, "Failed to fetch default template"), t;
       }
     }
   };
 };
 export {
-  y as useStripoApi
+  D as useStripoApi
 };

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

@@ -129,6 +129,10 @@ export declare const EditorSchema: v.ObjectSchema<{
         readonly senderName: "";
         readonly subject: "";
     }>;
+    /** Folder name for user-saved modules (used by Stripo plugin panel for path construction) */
+    readonly savedModulesFolderName: v.OptionalSchema<v.StringSchema<undefined>, "savedModules">;
+    /** Folder name for default/prebuilt modules (used by Stripo plugin panel for path construction) */
+    readonly defaultModulesFolderName: v.OptionalSchema<v.StringSchema<undefined>, "defaultModules">;
 }, undefined>;
 /**
  * UI configuration - visual elements and layout
@@ -441,6 +445,10 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
             readonly senderName: "";
             readonly subject: "";
         }>;
+        /** Folder name for user-saved modules (used by Stripo plugin panel for path construction) */
+        readonly savedModulesFolderName: v.OptionalSchema<v.StringSchema<undefined>, "savedModules">;
+        /** Folder name for default/prebuilt modules (used by Stripo plugin panel for path construction) */
+        readonly defaultModulesFolderName: v.OptionalSchema<v.StringSchema<undefined>, "defaultModules">;
     }, undefined>, {}>;
     /** UI configuration */
     readonly ui: v.OptionalSchema<v.ObjectSchema<{

package/dist/src/components/organisms/extensions/recommendation/FilterItem.vue.d.ts

@@ -3,6 +3,7 @@ type __VLS_Props = {
     filter: Filter;
     index: number;
     hasLogicAdapter?: boolean;
+    submitted: boolean;
 };
 declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {
     "delete-filter": (filter: Filter) => void;

package/dist/src/components/organisms/extensions/recommendation/Filters.vue.d.ts

@@ -1,2 +1,16 @@
-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<{}>>, {}>;
+type __VLS_Props = {
+    submitted: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {
+    switchToGroup: (groupId: number) => void;
+}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;
 export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -41,6 +41,8 @@ export declare const useConfig: () => {
                 senderName: string;
                 subject: string;
             };
+            savedModulesFolderName: string;
+            defaultModulesFolderName: string;
         };
         ui: {
             showHeader: boolean;
@@ -130,6 +132,8 @@ export declare const useConfig: () => {
             senderName: string;
             subject: string;
         };
+        savedModulesFolderName: string;
+        defaultModulesFolderName: string;
     } | null>;
     ui: import("vue").ComputedRef<{
         showHeader: boolean;

package/dist/src/enums/defaults.d.ts

@@ -9,3 +9,7 @@ export declare const TemplateTypes: {
 export declare const EditorType: number;
 export declare const MAX_DEFAULT_TEMPLATE_ID = 13;
 export declare const ProductIds: Record<string, number>;
+export declare const ModuleFolderDefaults: {
+    readonly SAVED_MODULES: "savedModules";
+    readonly DEFAULT_MODULES: "defaultModules";
+};

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

@@ -8,6 +8,6 @@
  */
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
-export { CONTAINER_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, } from './selectors';
-export { LAYOUT_VALUES, LAYOUT_OPTIONS, DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
+export { CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_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, } 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, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
 export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, } from './defaultConfig';

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

@@ -23,6 +23,12 @@ export declare const MIN_PRODUCT_COUNT = 1;
 export declare const MAX_PRODUCTS_PER_ROW = 4;
 /** Minimum number of products per row in grid layout */
 export declare const MIN_PRODUCTS_PER_ROW = 1;
+/** Default number of products per row on mobile */
+export declare const DEFAULT_MOBILE_CARDS_IN_ROW = 1;
+/** Maximum products per row on mobile */
+export declare const MAX_MOBILE_PRODUCTS_PER_ROW = 2;
+/** Minimum products per row on mobile */
+export declare const MIN_MOBILE_PRODUCTS_PER_ROW = 1;
 /** Default column spacing between product cards (5px on each side = 10px total) */
 export declare const DEFAULT_COLUMN_SPACING = 10;
 /** Default row spacing between product rows */

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

@@ -6,6 +6,10 @@
  * Used across controls to target elements within the recommendation block
  */
 export declare const CONTAINER_SELECTOR = ".ins-recommendation-product-container";
+/** Desktop product container selector */
+export declare const DESKTOP_CONTAINER_SELECTOR = ".ins-recommendation-desktop-container";
+/** Mobile product container selector */
+export declare const MOBILE_CONTAINER_SELECTOR = ".ins-recommendation-mobile-container";
 /**
  * Currency HTML attributes set on the block element
  * These are read by the HTML compiler at runtime to format prices

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

@@ -16,7 +16,6 @@ export * from './utils';
 export declare class RecommendationBlockControl extends CommonControl {
     private store;
     private storeUnsubscription;
-    private initializedBlocks;
     private algorithmControl;
     private localeControl;
     private currencyControl;
@@ -38,6 +37,18 @@ export declare class RecommendationBlockControl extends CommonControl {
      * Each sub-control manages its own form values and event listeners
      */
     _initializeSubControls(): void;
+    /**
+     * Syncs persisted node config into the Pinia store's block state.
+     *
+     * setCurrentBlock() creates a default entry (USD, en_US, mostPopular).
+     * For saved templates, the real config lives in the node (e.g., TRY, tr_TR).
+     * This method reads it and patches the store so fetchRecommendationProducts()
+     * uses the correct values.
+     *
+     * Uses triggerRefetch: false because the fetch hasn't happened yet —
+     * values are being prepared for the upcoming initial fetch.
+     */
+    private _syncNodeConfigToStore;
     /**
      * Fetches initial data for a block (filters, algorithms, products).
      * Shared by onRender() and onTemplateNodeUpdated() to avoid duplication.
@@ -65,4 +76,9 @@ export declare class RecommendationBlockControl extends CommonControl {
      * (e.g., fetchRecommendationCreateData setting preferred currency).
      */
     _listenStateUpdates(): void;
+    /**
+     * Persists the current filter state from Pinia store to the Stripo node config.
+     * This ensures filters survive template save/reload cycles.
+     */
+    private _persistFiltersToNodeConfig;
 }

package/dist/src/extensions/Blocks/Recommendation/controls/main/productLayout.d.ts

@@ -3,9 +3,13 @@
  *
  * Handles product display configuration:
  * - Number of products to show
- * - Products per row (hidden for list layout)
+ * - Products per row on desktop (hidden for list layout)
+ * - Products per row on mobile (hidden for list layout)
  * - Triggers product row regeneration on changes
  *
+ * Desktop/mobile counters swap visibility based on editor mode
+ * (detected via Stripo's EditorStatePropertyType.previewDeviceMode).
+ *
  * Configuration is stored via node config (persists with template).
  */
 import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
@@ -13,6 +17,7 @@ import { CommonControl } from '../../../common-control';
 export declare const PRODUCT_LAYOUT_CONTROL_ID = "recommendation-product-layout-control";
 /**
  * Control for configuring product count and layout density
+ * Includes both desktop and mobile "products per row" counters
  */
 export declare class ProductLayoutControl extends CommonControl {
     private store;
@@ -24,13 +29,26 @@ export declare class ProductLayoutControl extends CommonControl {
     onDestroy(): void;
     _setFormValues(): void;
     /**
-     * Updates "Products in One Row" visibility based on layout orientation
-     * This control is hidden for list layout (products always take full width)
-     * Reads from node config first, falls back to DOM
+     * Checks if the editor is currently in mobile preview mode
+     * using Stripo's EditorStatePropertyType API.
+     */
+    _isMobileMode(): boolean;
+    /**
+     * Updates counter visibility based on layout orientation and editor mode.
+     * - List layout: hide both counters (products always full-width)
+     * - Grid + desktop mode: show desktop counter, hide mobile counter
+     * - Grid + mobile mode: show mobile counter, hide desktop counter
      */
     _updateProductsInRowVisibility(): void;
+    /**
+     * Subscribes to editor preview mode changes via Stripo API.
+     * When the user switches between desktop/mobile preview, toggles
+     * which "Products in One Row" counter is visible.
+     */
+    _subscribeToEditorModeChanges(): void;
     _onProductCountChange(value: string): void;
     _onProductsInRowChange(value: number): void;
+    _onMobileCardsInRowChange(value: number): void;
     _regenerateProductRows(): void;
     _debouncedRegenerateProductRows: import("@vueuse/shared").PromisifyFn<() => void>;
     _listenToFormUpdates(): void;

package/dist/src/extensions/Blocks/Recommendation/controls/main/utils.d.ts

@@ -58,8 +58,15 @@ export interface RegenerateProductRowsOptions {
     layout?: Orientation;
 }
 /**
- * Regenerates product rows based on current store configuration
- * Reads products, layout, and composition from store/DOM and rebuilds the HTML
+ * Regenerates only the mobile product container rows.
+ * Used when mobile-specific settings change (mobileCardsInRow)
+ * or when the desktop container is regenerated (to keep both in sync).
+ */
+export declare function regenerateMobileProductRows(options: Omit<RegenerateProductRowsOptions, 'afterRegenerate'>): void;
+/**
+ * Regenerates product rows in the desktop container based on current store configuration.
+ * Also regenerates the mobile container to keep both in sync.
+ * Reads products, layout, and composition from store/DOM and rebuilds the HTML.
  * @param options - Configuration options for regeneration
  */
 export declare function regenerateProductRows(options: RegenerateProductRowsOptions): void;

package/dist/src/extensions/Blocks/Recommendation/controls/mobileLayout/cssRules.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CSS rules for mobile grid layout visibility switching
+ *
+ * Follows the modifyCss pattern from textTrim control.
+ * Rules are injected into the document's stylesheet via modifyCss
+ * so they appear in the compiled HTML export.
+ */
+import type { ImmutableCssNode } from '@stripoinc/ui-editor-extensions';
+import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
+/** CSS class for desktop product container */
+export declare const CSS_CLASS_DESKTOP_CONTAINER = "ins-recommendation-desktop-container";
+/** CSS class for mobile product container */
+export declare const CSS_CLASS_MOBILE_CONTAINER = "ins-recommendation-mobile-container";
+interface CssModifierApi {
+    getDocumentRootCssNode: () => ImmutableCssNode | null;
+    getDocumentModifier: () => {
+        modifyCss: (node: ImmutableCssNode) => {
+            appendRule: (rule: string) => void;
+        };
+        apply: (desc: ModificationDescription) => void;
+    };
+}
+/**
+ * Ensures mobile layout CSS rules exist in the document stylesheet.
+ * Only adds rules if they don't already exist (prevents duplicates across multiple blocks).
+ * Follows the same pattern as textTrim's _ensureCssRulesExist().
+ */
+export declare function ensureMobileCssRulesExist(api: CssModifierApi): void;
+export {};

package/dist/src/extensions/Blocks/Recommendation/store/recommendation.d.ts

@@ -29,6 +29,10 @@ interface PerBlockState {
     filterStatus: boolean;
     filterSelectionDrawerStatus: boolean;
     filterGroup: number;
+    /** Whether initial API data (filters, algorithms, products) has been fetched for this block */
+    isInitialized: boolean;
+    /** Snapshot of filters taken when the drawer opens, used to revert on cancel */
+    filterSnapshot: Filter[] | null;
 }
 interface StoreState {
     recommendationCampaignUrls: Record<string, string>;
@@ -123,7 +127,9 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
         configVersion: number;
     } & import("pinia").PiniaCustomStateProperties<StoreState>): number;
     hasFilters(): boolean;
+    hasValidFilters(): boolean;
     getFilterGroupCount(): number;
+    getUniqueFilterGroups(): number[];
     getActivePredictiveAlgorithms: (state: {
         recommendationCampaignUrls: Record<string, string>;
         activePredictiveAlgorithms: number[];
@@ -189,6 +195,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
      * Resets currentRecommendationId if it was the deleted block.
      */
     removeBlockState(id: number): void;
+    /**
+     * Marks a block as initialized (initial API data has been fetched).
+     * Automatically cleaned up when removeBlockState deletes the block entry.
+     */
+    markBlockInitialized(id: number): void;
     /**
      * Patches the current block's recommendationConfigs.
      * Replaces `store.$patch({ recommendationConfigs: { ... } })` pattern.
@@ -196,19 +207,31 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
     patchCurrentBlockConfig(updates: Partial<PerBlockConfigs>, options?: {
         triggerRefetch?: boolean;
     }): void;
+    /**
+     * Creates a filter with the first available attribute and operator pre-selected.
+     */
+    createDefaultFilter(filterGroup: number, filterNumber: number): Filter;
     /**
      * Opens the filter selection drawer for the current block.
-     * If no filters exist, initializes with a default empty filter
+     * Saves a snapshot of current filters for cancel/revert.
+     * If no filters exist, initializes with a default filter
      * so the user has a starting point for input.
      */
     openFilterDrawer(): void;
     /**
-     * Closes the filter selection drawer for the current block
+     * Closes the filter selection drawer for the current block.
+     * Called after successful apply — discards the snapshot.
      */
     closeFilterDrawer(): void;
+    /**
+     * Cancels the filter selection drawer and reverts filters
+     * to the snapshot taken when the drawer was opened.
+     */
+    cancelFilterDrawer(): void;
     fetchRecommendationCreateData(): Promise<void>;
     fetchRecommendationFilters(): Promise<void>;
     addFilterGroup(filterGroup: number): void;
+    deleteFilterGroup(groupId: number): void;
     updateFilter(updatedFilter: Filter): void;
     deleteFilter(filter: Filter): void;
     addFilter(filter: Filter): void;

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

@@ -30,4 +30,4 @@ export declare function prepareGridProductRows(products: RecommendationProduct[]
  */
 export declare function prepareProductRows(products: RecommendationProduct[], productsPerRow: number, composition?: string[]): string;
 export declare function getDefaultTemplate(recommendationId?: number): string;
-export declare function generateBlockTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: string[]): string;
+export declare function generateBlockTemplate(products: RecommendationProduct[], productsPerRow: number, title?: string, composition?: string[], mobileProductsPerRow?: number): string;

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

@@ -24,12 +24,14 @@ export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefault
 export declare function prepareProductRows(products: RecommendationProduct[], layout: Orientation, options?: PrepareProductRowsOptions): string;
 /**
  * Generates the default template for a given layout.
+ * Includes both desktop and mobile product containers for grid layouts.
  * @param layout - The layout orientation ('list' or 'grid')
  * @returns Complete HTML template with default products
  */
 export declare function getDefaultTemplate(layout?: Orientation): string;
 /**
  * Generates a complete block template with custom products.
+ * Includes both desktop and mobile product containers for grid layouts.
  * @param products - Array of products to display
  * @param layout - The layout orientation ('list' or 'grid')
  * @param title - Title for the block

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

@@ -7,6 +7,8 @@ export type Orientation = 'list' | 'grid';
 export interface PrepareProductRowsOptions {
     /** Number of products per row (only for grid layout, defaults to 3) */
     productsPerRow?: number;
+    /** Number of products per row on mobile (only for grid layout, defaults to 1) */
+    mobileProductsPerRow?: number;
     /** Array defining order of card elements */
     composition?: string[];
 }
@@ -44,14 +46,21 @@ export declare const PLACEHOLDER_IMAGE = "https://email-static.useinsider.com/st
  * @returns Sanitized HTTPS URL or placeholder
  */
 export declare function sanitizeImageUrl(url: string | undefined | null): string;
-export declare function getDefaultProducts(): RecommendationProduct[];
+export declare function getDefaultProducts(count?: number): RecommendationProduct[];
 /**
  * Creates the block template wrapper HTML for recommendation blocks.
- * The template includes title placeholder and product container.
+ * The template includes title placeholder and both desktop/mobile product containers.
+ *
+ * The dual-container approach generates two `ins-recommendation-product-container` tables:
+ * - Desktop container: visible by default, hidden on mobile via CSS media query
+ * - Mobile container: hidden by default (`display: none`), shown on mobile
+ *
+ * Both share the `.ins-recommendation-product-container` class so existing selectors
+ * (spacing, background color, compiler rules) apply automatically to both.
  * @param layout - The layout orientation ('list' or 'grid')
  * @param instanceClass - Optional instance-specific class (e.g., 'ins-recommendation-v3-block-1')
  *   for CSS scoping per block instance. Must be included in the initial template HTML because
  *   Stripo's Angular rendering manages the class attribute and overwrites dynamic setAttribute changes.
- * @returns HTML template string with {-{-TITLE-}-} and {-{-PRODUCT_ROWS-}-} placeholders
+ * @returns HTML template string with {-{-TITLE-}-}, {-{-PRODUCT_ROWS-}-}, and {-{-MOBILE_PRODUCT_ROWS-}-} placeholders
  */
 export declare function createBlockTemplate(layout?: Orientation, instanceClass?: string): string;

package/dist/src/extensions/Blocks/Recommendation/types/nodeConfig.d.ts

@@ -92,6 +92,12 @@ export interface RecommendationNodeConfig {
      * Number of products per row (grid layout only)
      */
     cardsInRow: number;
+    /**
+     * Number of products per row on mobile (grid layout only)
+     * Only applicable when layout is 'grid'
+     * @default 1
+     */
+    mobileCardsInRow: number;
     /**
      * Horizontal spacing between product cards in pixels (grid layout only)
      */

package/dist/src/extensions/Blocks/Recommendation/validation/filterSchema.d.ts

@@ -0,0 +1,15 @@
+import type { Filter } from '@@/Types/recommendation';
+import * as v from 'valibot';
+export declare const FilterSchema: v.ObjectSchema<{
+    readonly type: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly attribute: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly operator: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly innerGroupOperator: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly outerGroupOperator: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly filterGroup: v.NumberSchema<undefined>;
+    readonly filterNumber: v.NumberSchema<undefined>;
+    readonly isValid: v.BooleanSchema<undefined>;
+}, undefined>;
+export declare function isFilterValid(filter: Filter): boolean;
+export declare function getInvalidFilterFields(filter: Filter): Set<string>;

package/dist/src/extensions/ModulesTabIcons/extension.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@stripoinc/ui-editor-extensions").Extension;
+export default _default;