@deneb-ui/ui 2.0.62 → 2.0.63

package/README.md

@@ -217,6 +217,12 @@ reactive `SiteDataProvider` catalog, retries `api.catalogUrl`, and renders safe
 loading, network-error, and not-found states. `usePlatformProductDetail()` is
 also exported for developers who need complete control of the page markup.
 
+If the template already has a native `/products/[id]` design, the stable page
+must reuse that renderer through `renderProduct` (or render the same component
+from `usePlatformProductDetail`). The validator rejects a generic stable page
+next to a different native detail layout because newly-created products would
+otherwise look different from products present at build time.
+
 ---
 
 ## Data Fetching & Backend Integration Hooks

package/dist/PlatformProductDetail.js

@@ -61,27 +61,53 @@ function findProduct(products, productId) {
     };
 }
 function normalizeProductForDetail(product, siteData) {
-    const image = (typeof product.featuredImage === 'string' && product.featuredImage) ||
-        (typeof product.imageUrl === 'string' && product.imageUrl) ||
-        (typeof product.image === 'string' && product.image) ||
+    const customData = (0, SiteDataProvider_1.isRecord)(product.customData) ? product.customData : {};
+    // Public catalog rows keep template-specific variants in customData. Flatten
+    // them for custom renderers while preserving explicit top-level fields.
+    const mergedProduct = {
+        ...customData,
+        ...product,
+    };
+    const name = (typeof mergedProduct.name === 'string' && mergedProduct.name) ||
+        (typeof mergedProduct.title === 'string' && mergedProduct.title) ||
+        undefined;
+    const image = (typeof mergedProduct.featuredImage === 'string' && mergedProduct.featuredImage) ||
+        (typeof mergedProduct.imageUrl === 'string' && mergedProduct.imageUrl) ||
+        (typeof mergedProduct.image === 'string' && mergedProduct.image) ||
         undefined;
-    const images = Array.isArray(product.gallery)
-        ? product.gallery
-        : Array.isArray(product.images)
-            ? product.images
-            : undefined;
+    const images = Array.isArray(mergedProduct.gallery)
+        ? mergedProduct.gallery
+        : Array.isArray(mergedProduct.images)
+            ? mergedProduct.images
+            : Array.isArray(mergedProduct.additionalImages)
+                ? mergedProduct.additionalImages.filter((value) => typeof value === 'string' && Boolean(value.trim()))
+                : undefined;
+    const compareAtPrice = mergedProduct.compareAtPrice ?? mergedProduct.originalPrice;
     const shop = (0, SiteDataProvider_1.isRecord)(siteData.shop) ? siteData.shop : {};
     const merchant = (0, SiteDataProvider_1.isRecord)(siteData.merchant) ? siteData.merchant : {};
-    const whatsappNumber = (typeof product.whatsappNumber === 'string' && product.whatsappNumber) ||
+    const whatsappNumber = (typeof mergedProduct.whatsappNumber === 'string' && mergedProduct.whatsappNumber) ||
         (typeof shop.whatsapp === 'string' && shop.whatsapp) ||
         (typeof shop.whatsappNumber === 'string' && shop.whatsappNumber) ||
         (typeof merchant.whatsapp === 'string' && merchant.whatsapp) ||
         undefined;
     return {
-        ...product,
-        ...(image && !product.featuredImage ? { featuredImage: image } : {}),
-        ...(images && !product.gallery ? { gallery: images } : {}),
-        ...(whatsappNumber && !product.whatsappNumber ? { whatsappNumber } : {}),
+        ...mergedProduct,
+        ...(name
+            ? {
+                name,
+                title: typeof mergedProduct.title === 'string' && mergedProduct.title
+                    ? mergedProduct.title
+                    : name,
+            }
+            : {}),
+        ...(image
+            ? { featuredImage: image, imageUrl: image, image }
+            : {}),
+        ...(images ? { gallery: images, images } : {}),
+        ...(compareAtPrice !== undefined
+            ? { compareAtPrice, originalPrice: compareAtPrice }
+            : {}),
+        ...(whatsappNumber ? { whatsappNumber } : {}),
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deneb-ui/ui",
-  "version": "2.0.62",
+  "version": "2.0.63",
   "description": "Visual-first React component library for editable commerce storefronts. Built for Next.js and Fivora.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -50,7 +50,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deneb-ui/core": "^2.0.62"
+    "@deneb-ui/core": "^2.0.63"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",