@zohofinance/commerce 2.0.0 → 2.2.0

package/ts-dist/mocks/global-objects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-objects.d.ts","sourceRoot":"","sources":["../../src/mocks/global-objects.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,aAw0fpB,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"global-objects.d.ts","sourceRoot":"","sources":["../../src/mocks/global-objects.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,aAy0fpB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/ts-dist/mocks/global-objects.js

@@ -182,6 +182,7 @@ const globalObjects = {
             show_zoho_powered_by: false,
             is_product_filters_enabled: false,
             is_sorting_enabled: false,
+            is_product_reviews_enabled: true,
             search_box_enabled: false,
             is_footer_enabled: false,
             product_specifications_enabled: false,

package/ts-dist/mocks/init-theme/i18n/en.schema.json

@@ -43,7 +43,8 @@
           "default": "Shop Now"
         },
         "cta_url": {
-          "label": "Button URL"
+          "label": "Button URL",
+          "default": "Shop"
         }
       }
     },

package/ts-dist/mocks/init-theme/sections/footer.liquid

@@ -6,6 +6,8 @@
 
 {% schema %}
 {
-  "name": "t:sections.footer.name"
+  "name": "t:sections.footer.name",
+  "available_in": { "templates": ["footer-group"] },
+  "presets": [{ "name": "t:sections.footer.name" }]
 }
 {% endschema %}

package/ts-dist/mocks/init-theme/sections/header-topbar.liquid

@@ -23,6 +23,7 @@
 {% schema %}
 {
   "name": "t:sections.header_topbar.name",
+  "available_in": { "templates": ["header-group"] },
   "settings": [
     {
       "type": "select",
@@ -47,6 +48,7 @@
         }
       ]
     }
-  ]
+  ],
+  "presets": [{ "name": "t:sections.header_topbar.name" }]
 }
 {% endschema %}

package/ts-dist/mocks/init-theme/sections/product-collection.liquid

@@ -25,6 +25,7 @@
 {% schema %}
 {
   "name": "t:sections.product_collection.name",
+  "available_in": { "templates": ["index", "collection", "category"] },
   "settings": [
     {
       "type": "collection",
@@ -38,6 +39,7 @@
       "type": "zc_theme__section-heading",
       "name": "Section Heading"
     }
-  ]
+  ],
+  "presets": [{ "name": "t:sections.product_collection.name" }]
 }
 {% endschema %}

package/ts-dist/mocks/init-theme/sections/promo-banner.liquid

@@ -50,7 +50,11 @@
     {
       "type": "url",
       "id": "cta_url",
-      "label": "t:sections.promo_banner.settings.cta_url.label"
+      "label": "t:sections.promo_banner.settings.cta_url.label",
+      "default": {
+        "display_name": "t:sections.promo_banner.settings.cta_url.default",
+        "handle": "collections/all-products"
+      }
     }
   ],
   "blocks": [

package/ts-dist/mocks/reviews.d.ts

@@ -0,0 +1,6 @@
+type ProductReviews = {
+    [key: string]: any;
+};
+declare const reviews: ProductReviews;
+export default reviews;
+//# sourceMappingURL=reviews.d.ts.map

package/ts-dist/mocks/reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../src/mocks/reviews.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAIF,QAAA,MAAM,OAAO,EAAE,cAkDd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/ts-dist/mocks/reviews.js

@@ -0,0 +1,52 @@
+// Mirrors the live /products/:product_id/reviews response so a theme renders the
+// same markup with or without --storeUrl.
+const reviews = {
+    is_reviewed: false,
+    allow_registered_only: false,
+    is_logged_in: false,
+    is_review_enabled: true,
+    reviews: [
+        {
+            id: '8858475000000094101',
+            user_name: 'Arun Kumar',
+            rating: 5,
+            title: 'Excellent build quality',
+            content: 'The product arrived well packed and works exactly as described. Battery life is great and the finish feels premium.',
+            last_modified_time: '14 June 2026'
+        },
+        {
+            id: '8858475000000094102',
+            user_name: 'Divya Raman',
+            rating: 4,
+            title: 'Good value for the price',
+            content: 'Happy with the purchase overall. Setup was simple and the sound quality is clear, though the case scratches easily.',
+            last_modified_time: '02 June 2026'
+        }
+    ],
+    user_review: null,
+    is_captcha_enabled: false,
+    average_rating: 4.5,
+    rating_stats: {
+        star_5_percentage: 50,
+        star_5_count: 1,
+        overall_average: 4.5,
+        star_4_percentage: 50,
+        star_4_count: 1,
+        star_3_percentage: 0,
+        star_3_count: 0,
+        star_2_percentage: 0,
+        star_2_count: 0,
+        star_1_percentage: 0,
+        star_1_count: 0,
+        total_reviews: 2
+    },
+    page_context: {
+        per_page: 10,
+        items_count: '2',
+        total_pages: 1,
+        current_page: 1,
+        page_param: 'page'
+    },
+    is_purchased: false
+};
+export default reviews;

package/ts-dist/routes/storefront-routes.js

@@ -126,7 +126,7 @@ export const STOREFRONT_ROUTES = [
     }
 ];
 export function resolveApiPath(route, params) {
-    return route.apiPath.replace(/:([a-z_]+)/gi, (_, key) => params[key] ?? '');
+    return route.apiPath.replace(/:([a-z_]+)/gi, (_, key) => encodeURIComponent(params[key] ?? ''));
 }
 export function pageTemplateExists(pageTemplate) {
     return fs.existsSync(path.join(process.cwd(), 'pages', `${pageTemplate}.json`));

package/ts-dist/utils/api-handler.d.ts

@@ -13,6 +13,7 @@ export declare class APIHandler {
         useMock: boolean;
         baseURL?: string;
     }): Promise<APIHandler>;
+    get cookieHeader(): string;
     fetch(requestUrl: string): Promise<Record<string, unknown>>;
     getMockCartData(): Record<string, unknown>;
     getMockSaveForLaterData(): Record<string, unknown>[];
@@ -27,7 +28,11 @@ export declare class APIHandler {
     wishlistAction(method: 'POST' | 'DELETE', query: string, body?: Record<string, unknown>): Promise<any>;
     getQuote(): Promise<any>;
     getProductRecommendations(productId: string): Promise<any>;
-    getProductReviews(productId: string): Promise<any>;
+    getProductReviews(productId: string, query?: string): Promise<{
+        [key: string]: any;
+    }>;
+    submitProductReview(method: 'POST' | 'PUT', productId: string, data: Record<string, unknown>): Promise<unknown>;
+    getReviewForEdit(productId: string): Promise<unknown>;
     bulkAddToCart(data: Record<string, unknown>): Promise<any>;
     saveForLater(method: 'PUT' | 'DELETE', query: string): Promise<unknown>;
     moveToCart(query: string): Promise<unknown>;

package/ts-dist/utils/api-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-handler.d.ts","sourceRoot":"","sources":["../../src/utils/api-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-handler.d.ts","sourceRoot":"","sources":["../../src/utils/api-handler.ts"],"names":[],"mappings":"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"}

package/ts-dist/utils/api-handler.js

@@ -9,6 +9,7 @@ import blog from '../mocks/blog.js';
 import category from '../mocks/category.js';
 import categories from '../mocks/categories.js';
 import globalObjectsMock from '../mocks/global-objects.js';
+import productReviews from '../mocks/reviews.js';
 function mockJson(data) {
     return {
         json: async () => data
@@ -20,6 +21,30 @@ function withPageTitle(data, title) {
         page_title: title
     };
 }
+function rewriteStoreUrls(value, origin) {
+    if (!origin)
+        return value;
+    if (typeof value === 'string') {
+        if (value === origin)
+            return '/';
+        if (value.startsWith(origin) &&
+            /^[/?#]/.test(value.slice(origin.length))) {
+            return value.slice(origin.length);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => rewriteStoreUrls(item, origin));
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = rewriteStoreUrls(v, origin);
+        }
+        return out;
+    }
+    return value;
+}
 export class APIHandler {
     useMock;
     cookies = [];
@@ -37,23 +62,41 @@ export class APIHandler {
         }
         return handler;
     }
+    // Stores cookies by name so a refreshed session replaces the old one instead
+    // of piling up duplicates.
+    #storeCookies(response) {
+        const setCookies = typeof response.headers.getSetCookie === 'function'
+            ? response.headers.getSetCookie()
+            : (response.headers.get('set-cookie') ?? '')
+                .split(/,(?=\s*[^;,=\s]+=)/)
+                .filter(Boolean);
+        for (const cookie of setCookies) {
+            const pair = cookie.split(';')[0].trim();
+            const name = pair.split('=')[0];
+            if (!name)
+                continue;
+            this.cookies = this.cookies.filter((existing) => existing.split('=')[0] !== name);
+            this.cookies.push(pair);
+        }
+    }
+    get cookieHeader() {
+        return this.cookies.join('; ');
+    }
     async #cookieSetter() {
         try {
             const response = await fetch(`${this.baseURL}/home?format=json`);
-            const setCookieHeader = response.headers.get('set-cookie');
-            setCookieHeader?.split(',').forEach((cookie) => {
-                this.cookies.push(cookie.split(';')[0]);
-            });
+            this.#storeCookies(response);
         }
         catch (e) {
             console.warn('Could not establish store session cookies.', e);
         }
     }
     async #makeRequest(requestUrl) {
-        const response = await fetch(`${this.baseURL}${requestUrl}?format=json`, {
+        const separator = requestUrl.includes('?') ? '&' : '?';
+        const response = await fetch(`${this.baseURL}${requestUrl}${separator}format=json`, {
             method: 'GET',
             headers: {
-                Cookie: this.cookies.join(';')
+                Cookie: this.cookieHeader
             }
         });
         return response;
@@ -95,8 +138,9 @@ export class APIHandler {
             });
         }
         if (requestUrl.match(/^\/products\/[^/]+/)) {
-            const productHandle = requestUrl.split('/').pop();
-            const product = products.find((item) => item.handle === productHandle || item.id === productHandle);
+            const productHandle = decodeURIComponent(requestUrl.split('?')[0].split('/').pop() ?? '');
+            // Unknown handles fall back to the first mock product so the PDP still renders.
+            const product = products.find((item) => item.handle === productHandle || item.id === productHandle) ?? products[0];
             return mockJson({
                 product,
                 page_title: product?.title ?? 'Product'
@@ -150,17 +194,25 @@ export class APIHandler {
         try {
             let response;
             if (this.useMock) {
-                response = this.#makeMockRequest(requestUrl);
+                response = this.#makeMockRequest(requestUrl.split('?')[0]);
             }
             else {
                 response = await this.#makeRequest(requestUrl);
             }
             if (response instanceof Response) {
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch data from ${requestUrl} (${response.status})`);
+                    const detail = (await response.text().catch(() => ''))
+                        .trim()
+                        .slice(0, 300);
+                    throw new Error(`Failed to fetch data from ${requestUrl} (${response.status})${detail ? `: ${detail}` : ''}`);
                 }
             }
-            const json = (await response.json());
+            let json = (await response.json());
+            // Live responses carry absolute store URLs (menu items, product links...).
+            // Make them relative so navigation stays on the local dev server.
+            if (!this.useMock && this.baseURL) {
+                json = rewriteStoreUrls(json, this.baseURL);
+            }
             if (json.staticAssetsUrl) {
                 json.staticAssetsUrl = '/assets';
             }
@@ -178,7 +230,7 @@ export class APIHandler {
         const requestConfig = {
             method: reqMethod,
             headers: {
-                Cookie: this.cookies.join(';')
+                Cookie: this.cookieHeader
             }
         };
         if (reqMethod === 'DELETE') {
@@ -196,10 +248,7 @@ export class APIHandler {
             requestConfig.body = formData;
         }
         const result = await fetch(requestUrl, requestConfig);
-        const setCookieHeader = result.headers.get('set-cookie');
-        setCookieHeader?.split(',').forEach((cookie) => {
-            this.cookies.push(cookie.split(';')[0]);
-        });
+        this.#storeCookies(result);
         return result.json();
     }
     #findVariantInProducts(variantId) {
@@ -252,17 +301,14 @@ export class APIHandler {
     }
     async #proxyRequest(method, path, body = null, query = '') {
         const url = `${this.baseURL}${path}${query ? `?${query}` : ''}`;
-        const headers = { Cookie: this.cookies.join(';') };
+        const headers = { Cookie: this.cookieHeader };
         const init = { method, headers };
         if (body !== null && method !== 'GET' && method !== 'DELETE') {
             headers['Content-Type'] = 'application/json';
             init.body = JSON.stringify(body);
         }
         const res = await fetch(url, init);
-        const setCookieHeader = res.headers.get('set-cookie');
-        setCookieHeader?.split(',').forEach((cookie) => {
-            this.cookies.push(cookie.split(';')[0]);
-        });
+        this.#storeCookies(res);
         return res.json();
     }
     async addToCart(data) {
@@ -343,7 +389,7 @@ export class APIHandler {
             return this.#computeMockCart();
         }
         const res = await fetch(`${this.baseURL}/storefront/api/v1/cart`, {
-            headers: { Cookie: this.cookies.join(';') }
+            headers: { Cookie: this.cookieHeader }
         });
         return res.json();
     }
@@ -371,7 +417,7 @@ export class APIHandler {
             ];
         }
         const res = await fetch(`${this.baseURL}/storefront/api/v1/currencies`, {
-            headers: { Cookie: this.cookies.join(';') }
+            headers: { Cookie: this.cookieHeader }
         });
         return res.json();
     }
@@ -379,7 +425,7 @@ export class APIHandler {
         if (this.useMock) {
             return { code: 0, message: 'success' };
         }
-        const res = await fetch(`${this.baseURL}/updatecurrency?currency_code=${encodeURIComponent(currencyCode)}`, { method: 'PUT', headers: { Cookie: this.cookies.join(';') } });
+        const res = await fetch(`${this.baseURL}/updatecurrency?currency_code=${encodeURIComponent(currencyCode)}`, { method: 'PUT', headers: { Cookie: this.cookieHeader } });
         return res.json();
     }
     async getPortalUser() {
@@ -387,7 +433,7 @@ export class APIHandler {
             return { current_user: null };
         }
         const res = await fetch(`${this.baseURL}/portal/user`, {
-            headers: { Cookie: this.cookies.join(';') }
+            headers: { Cookie: this.cookieHeader }
         });
         return res.json();
     }
@@ -395,7 +441,7 @@ export class APIHandler {
         if (this.useMock) {
             return { variants: {} };
         }
-        const res = await fetch(`${this.baseURL}/wishlists/wishlist-enabled?variant_ids=${encodeURIComponent(variantIds)}`, { headers: { Cookie: this.cookies.join(';') } });
+        const res = await fetch(`${this.baseURL}/wishlists/wishlist-enabled?variant_ids=${encodeURIComponent(variantIds)}`, { headers: { Cookie: this.cookieHeader } });
         return res.json();
     }
     async wishlistAction(method, query, body) {
@@ -415,7 +461,7 @@ export class APIHandler {
         }
         const res = await fetch(url, {
             method,
-            headers: { Cookie: this.cookies.join(';') },
+            headers: { Cookie: this.cookieHeader },
             body: fetchBody
         });
         return res.json();
@@ -425,7 +471,7 @@ export class APIHandler {
             return { code: 0, quote: null };
         }
         const res = await fetch(`${this.baseURL}/storefront/api/v1/quote`, {
-            headers: { Cookie: this.cookies.join(';') }
+            headers: { Cookie: this.cookieHeader }
         });
         return res.json();
     }
@@ -434,18 +480,28 @@ export class APIHandler {
             return { recommendations: [], sections: {} };
         }
         const res = await fetch(`${this.baseURL}/products/${productId}/recommendations`, {
-            headers: { Cookie: this.cookies.join(';') }
+            headers: { Cookie: this.cookieHeader }
         });
         return res.json();
     }
-    async getProductReviews(productId) {
+    async getProductReviews(productId, query = '') {
         if (this.useMock) {
-            return { reviews: [], page_context: { total_count: 0 } };
+            return { ...productReviews };
         }
-        const res = await fetch(`${this.baseURL}/products/${productId}/reviews`, {
-            headers: { Cookie: this.cookies.join(';') }
-        });
-        return res.json();
+        const response = await this.#proxyRequest('GET', `/products/${encodeURIComponent(productId)}/reviews`, null, query);
+        return rewriteStoreUrls(response, this.baseURL ?? '');
+    }
+    async submitProductReview(method, productId, data) {
+        if (this.useMock) {
+            return { code: 0, message: 'Review submitted' };
+        }
+        return this.#proxyRequest(method, `/products/${encodeURIComponent(productId)}/reviews`, data);
+    }
+    async getReviewForEdit(productId) {
+        if (this.useMock) {
+            return { code: 0, rating: 0, title: '', content: '' };
+        }
+        return this.#proxyRequest('GET', `/editreview/${encodeURIComponent(productId)}`);
     }
     async bulkAddToCart(data) {
         if (this.useMock) {

package/ts-dist/utils/editor-attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-attributes.d.ts","sourceRoot":"","sources":["../../src/utils/editor-attributes.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAUR;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR"}
+{"version":3,"file":"editor-attributes.d.ts","sourceRoot":"","sources":["../../src/utils/editor-attributes.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CASR;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAWR"}

package/ts-dist/utils/editor-attributes.js

@@ -2,10 +2,9 @@ export function buildSectionComponentAttr(sectionType, sectionKey, jsonType, dis
     return JSON.stringify({
         id: `section_${sectionKey}`,
         'data-zcommerce-section-id': '',
-        'data-zcommerce-component-name': sectionType,
+        'data-zcommerce-component-name': displayName || sectionType,
         'data-zcommerce-component-key': `section_${sectionKey}`,
         'data-zcommerce-json-type': jsonType,
-        'data-zcommerce-display-name': displayName || sectionType,
         settingid: `setting_section_${sectionType}`
     });
 }
@@ -14,10 +13,9 @@ export function buildBlockZcommerceAttributes(blockType, blockKey, sectionKey, j
     const attrJson = JSON.stringify({
         id,
         'data-zcommerce-section-id': `section_${sectionKey}`,
-        'data-zcommerce-component-name': blockType,
+        'data-zcommerce-component-name': displayName || blockType,
         'data-zcommerce-component-key': id,
         'data-zcommerce-json-type': jsonType,
-        'data-zcommerce-display-name': displayName || blockType,
         settingid: `setting_block_${blockType}`
     }).replace(/'/g, ''');
     return `data-zcommerce-component='${attrJson}'`;

package/ts-dist/utils/error-report.d.ts

@@ -1,5 +1,5 @@
 import type { ErrorTraceType } from 'types/common';
-import type { ThemeValidationResult, ValidationIssue } from './theme-validation.js';
+import { type ThemeValidationResult, type ValidationIssue } from './theme-validation.js';
 export type DevErrorKind = 'compilation' | 'validation' | 'runtime';
 export type DevErrorReport = {
     kind: DevErrorKind;

package/ts-dist/utils/error-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-report.d.ts","sourceRoot":"","sources":["../../src/utils/error-report.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AA4CF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,SAAgB,GAClB,MAAM,CAoCR;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,eAAe,EAAE,MAAM,EACvB,GAAG,SAAgB,GAClB,MAAM,CAwCR;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,GAAG,SAAgB,GAClB,MAAM,CAeR;AA2BD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,SAAgB,GAClB,cAAc,CAahB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,SAAgB,GAClB,cAAc,CAOhB;AAID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}
+{"version":3,"file":"error-report.d.ts","sourceRoot":"","sources":["../../src/utils/error-report.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EAGrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AA0EF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,SAAgB,GAClB,MAAM,CA4CR;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,eAAe,EAAE,MAAM,EACvB,GAAG,SAAgB,GAClB,MAAM,CAwCR;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,GAAG,SAAgB,GAClB,MAAM,CAeR;AA8CD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,SAAgB,GAClB,cAAc,CAchB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,SAAgB,GAClB,cAAc,CAOhB;AAID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/ts-dist/utils/error-report.js

@@ -3,10 +3,14 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import { Liquid } from 'liquidjs';
 import { escapeExpression } from './escape-expression.js';
+import { validationErrors } from './theme-validation.js';
 const CATEGORY_LABELS = {
     translation: 'Missing translation keys',
     json: 'Invalid JSON files',
-    schema: 'Invalid section/block schema settings',
+    schema: 'Invalid section/block schemas',
+    page: 'Invalid page or section-group JSON',
+    liquid: 'Liquid references the engine cannot render',
+    theme_settings: 'Invalid theme settings',
     asset_size: 'Oversized assets',
     required_file: 'Missing required files'
 };
@@ -25,7 +29,10 @@ const FIX_HINTS = {
         'Resolve each listed issue before previewing the theme.',
         'Required files: `layouts/theme.liquid`, `i18n/en.json`, `i18n/en.schema.json`.',
         'Every `"t:..."` key used in the theme must exist in `i18n/en.schema.json` or `i18n/en.json` depending on where the key is used.',
-        'Settings of type select, collection, category, menu, or blog need a valid `default` object.',
+        'Required files also include `settings/schema.json` and `settings/theme.json`.',
+        'Section and block schemas must use engine setting types. select, radio, url, menu, collection, category, product, blog, image_picker, and media_picker need a structured `default`.',
+        'Page JSON `order` entries must exist in `sections`, each section `type` must have a liquid file, and every `block_order` entry must exist and be allowed by that schema.',
+        'Do not use `{% paginate %}`, `{% form %}`, `{% stylesheet %}`, or `{% include %}`. Snippet, section, and section-group names must match real files.',
         'Files in `assets/` must be under 1 MB each.'
     ],
     runtime: [
@@ -40,19 +47,39 @@ function encodeMarkdown(markdown) {
 function buildFixSection(kind) {
     return FIX_HINTS[kind].map((hint) => `- ${hint}`).join('\n');
 }
+/** Groups identical problems (ignoring array indices) so each is stated once. */
+function groupByMessage(issues) {
+    const groups = new Map();
+    for (const issue of issues) {
+        const key = issue.message.replace(/\[\d+\]/g, '[]');
+        const where = issue.message.match(/^(\S*\[\d+\]\S*)\s/)?.[1];
+        const group = groups.get(key) ?? { message: key, entries: [] };
+        if (!group.entries.some((e) => e.file === issue.file && e.where === where)) {
+            group.entries.push({ file: issue.file, where });
+        }
+        groups.set(key, group);
+    }
+    return [...groups.values()];
+}
 export function buildValidationMarkdown(result, cwd = process.cwd()) {
+    const blockingIssues = validationErrors(result.issues);
     const grouped = new Map();
-    for (const issue of result.issues) {
+    for (const issue of blockingIssues) {
         const list = grouped.get(issue.category) ?? [];
         list.push(issue);
         grouped.set(issue.category, list);
     }
     const issueSections = [];
     for (const [category, issues] of grouped) {
-        issueSections.push(`### ${CATEGORY_LABELS[category]}`);
-        for (const issue of issues) {
-            const location = issue.file ? ` — \`${issue.file}\`` : '';
-            issueSections.push(`- ${issue.message}${location}`);
+        issueSections.push(`### ${CATEGORY_LABELS[category]} (${issues.length})`);
+        for (const group of groupByMessage(issues)) {
+            issueSections.push(`- **${group.message}** — ${group.entries.length} file${group.entries.length === 1 ? '' : 's'}`);
+            for (const entry of group.entries) {
+                if (entry.file) {
+                    const where = entry.where ? ` (\`${entry.where}\`)` : '';
+                    issueSections.push(`  - \`${entry.file}\`${where}`);
+                }
+            }
         }
         issueSections.push('');
     }
@@ -60,7 +87,7 @@ export function buildValidationMarkdown(result, cwd = process.cwd()) {
         '# Zoho Commerce Theme CLI — Validation error',
         '',
         '## Summary',
-        `Theme validation failed with **${result.issues.length}** issue(s) in \`${cwd}\`.`,
+        `Theme validation failed with **${blockingIssues.length}** issue(s) in \`${cwd}\`.`,
         '',
         '## Issues',
         ...issueSections,
@@ -118,26 +145,39 @@ function groupValidationIssues(issues) {
     }
     const htmlParts = [];
     for (const [category, categoryIssues] of grouped) {
-        htmlParts.push(`<h3>${CATEGORY_LABELS[category]}</h3><ul>`);
-        for (const issue of categoryIssues) {
-            const fileLink = issue.file
-                ? ` <a href="#" data-file="${escapeExpression(issue.file)}" class="open-file-link">${escapeExpression(issue.file)}</a>`
+        htmlParts.push(`<h3>${CATEGORY_LABELS[category]} <span class="issue-count">${categoryIssues.length}</span></h3>`);
+        for (const group of groupByMessage(categoryIssues)) {
+            const files = group.entries.filter((entry) => entry.file);
+            const count = files.length > 0
+                ? `<span class="issue-files-count">${files.length} file${files.length === 1 ? '' : 's'}</span>`
                 : '';
-            htmlParts.push(`<li>${escapeExpression(issue.message)}${fileLink}</li>`);
+            htmlParts.push(`<div class="issue-group"><div class="issue-message">${escapeExpression(group.message)}${count}</div>`);
+            if (files.length > 0) {
+                htmlParts.push('<ul class="issue-files">');
+                for (const entry of files) {
+                    const file = escapeExpression(entry.file ?? '');
+                    const where = entry.where
+                        ? ` <span class="issue-where">${escapeExpression(entry.where)}</span>`
+                        : '';
+                    htmlParts.push(`<li><a href="#" data-file="${file}" class="open-file-link">${file}</a>${where}</li>`);
+                }
+                htmlParts.push('</ul>');
+            }
+            htmlParts.push('</div>');
         }
-        htmlParts.push('</ul>');
     }
     return htmlParts.join('\n');
 }
 export function buildValidationErrorReport(result, cwd = process.cwd()) {
+    const blockingIssues = validationErrors(result.issues);
     return {
         kind: 'validation',
-        title: result.issues.length === 1
+        title: blockingIssues.length === 1
             ? '1 validation issue found'
-            : `${result.issues.length} validation issues found`,
+            : `${blockingIssues.length} validation issues found`,
         summary: 'Resolve the issues below to continue previewing this theme. The development server is running, but pages are blocked until validation passes.',
-        issues: result.issues,
-        context: groupValidationIssues(result.issues),
+        issues: blockingIssues,
+        context: groupValidationIssues(blockingIssues),
         markdown: buildValidationMarkdown(result, cwd)
     };
 }

package/ts-dist/utils/load-theme-globals.d.ts

@@ -1,3 +1,3 @@
-export declare function loadThemeGlobals(): Record<string, unknown>;
+export declare function loadThemeGlobals(live?: boolean): Record<string, unknown>;
 export declare function mergePageData(globals: Record<string, unknown>, pageData: Record<string, unknown>): Record<string, unknown>;
 //# sourceMappingURL=load-theme-globals.d.ts.map