@propeller-commerce/propeller-v2-react-ui 0.15.11 → 0.16.0

package/CHANGELOG.md

@@ -8,6 +8,52 @@ once it reaches 1.0. Until then (the `0.x` line) the public API may change
 between minor versions; breaking changes are called out below and in
 [MIGRATION.md](./MIGRATION.md).
 
+## [0.16.0] - 2026-08-12
+
+### Fixed
+
+- **Localized names and slugs ignored the storefront language (PWP-936 /
+  PWP-940).** A localized array carries one entry per authored language in
+  catalog order, so `names[0]` / `slugs[0]` is the catalog's DEFAULT language,
+  not the storefront's. Thirteen sites read index 0 unconditionally while
+  eleven others resolved by language correctly. Now all of them go through
+  `getLocalizedValue`, which prefers the active language and falls back to any
+  translation that has a value:
+  - `ClusterOptions` — option group and option product names (PWP-936)
+  - `FavoriteListItem`, `FavoriteListDetails` — product and cluster names
+  - `ItemsOverview` — item, bundle-leader, bundle-item and child-option names
+  - `ProductBundles` — bundle item names
+  - `OrderItemCard` — item name, child-item names, and **the cluster/product
+    slugs used to build the item's link**
+  - `SearchBar` — **the slug used to build each autosuggest result's link**
+
+  The three slug sites are the ones that actually broke: they emitted
+  default-language URLs on every non-default locale.
+- **`useCart` never adopted a cart id that arrived after mount (PWP-938 /
+  PWP-937).** The id was seeded once with `useState(options.cartId || '')` and
+  only reassigned from the hook's own cart-creation path, so a component that
+  mounted before the cart resolved held `''` permanently. `CartIconAndSidebar`
+  renders in the header on the first paint of every page, so its "Request
+  authorization" button rendered enabled, fired, and returned `err('No cart')`
+  with nothing sent — the reported "cannot submit purchase request". The id is
+  now derived from the prop on every render. `processCart` was affected the
+  same way.
+
+### Changed
+
+- **BREAKING (behavioural, hosts should act):** `OrderItemCard` gains a
+  `language` prop. The component is exported from the RSC-safe `/pure` entry
+  and reads no context by design, so a host that renders it directly must pass
+  `language` or it keeps resolving in the catalog's default language.
+  `OrderBonusItems` forwards its own resolved language automatically.
+- `ClusterOptions` resolves `language` from `<PropellerProvider>` via
+  `useInfraProps`, like the other catalog components. Passing it explicitly
+  still wins.
+- The favorites list's add-product button default now reads "Add product to
+  favorite list" instead of "Add product directly to this wishlist" (PWP-939).
+  Hosts that translate `FavoriteListDetails.addProductDirectly` should update
+  their own copy — "favorite list" is the agreed term, not "wishlist".
+
 ## [0.15.11] - 2026-08-11
 
 ### Fixed

package/dist/index.cjs

@@ -738,7 +738,8 @@ function useCart(options) {
   const { graphqlClient, user, companyId, configuration, onCartCreated } = options;
   const language = options.language || configuration?.language || "NL";
   const [cart, setCart] = React6.useState(null);
-  const [cartId, setCartId] = React6.useState(options.cartId || "");
+  const [createdCartId, setCreatedCartId] = React6.useState("");
+  const cartId = options.cartId || createdCartId;
   const [loading, setLoading] = React6.useState(false);
   const [error, setError] = React6.useState(null);
   const notesTimers = React6.useRef({});
@@ -774,13 +775,13 @@ function useCart(options) {
       imageVariantFilters: configuration?.imageVariantFiltersSmall,
       onCartCreated: (c) => {
         setCart(c);
-        setCartId(c.cartId);
+        setCreatedCartId(c.cartId);
         onCartCreated?.(c);
       }
     };
     const resolved = await initCart(config);
     setCart(resolved);
-    setCartId(resolved.cartId);
+    setCreatedCartId(resolved.cartId);
     return resolved;
   }, [graphqlClient, user, companyId, language, configuration, onCartCreated]);
   const addItem = React6.useCallback(async (opts) => {
@@ -795,7 +796,7 @@ function useCart(options) {
       if (opts.onAddToCart) {
         const resultCart2 = opts.onAddToCart(opts.product, opts.cluster?.clusterId, opts.quantity, childItemInputs, opts.notes, opts.price);
         setCart(resultCart2);
-        setCartId(resultCart2.cartId);
+        setCreatedCartId(resultCart2.cartId);
         const addedItem2 = resultCart2.items?.find((i) => i.productId === opts.product.productId) ?? null;
         opts.afterAddToCart?.(resultCart2, addedItem2);
         return propellerV2CoreUi.ok({ cart: resultCart2, item: addedItem2 });
@@ -816,7 +817,7 @@ function useCart(options) {
         imageVariantFilters: configuration?.imageVariantFiltersSmall
       });
       setCart(resultCart);
-      setCartId(resultCart.cartId);
+      setCreatedCartId(resultCart.cartId);
       const addedItem = resultCart.items?.find((i) => i.productId === opts.product.productId) ?? null;
       opts.afterAddToCart?.(resultCart, addedItem);
       return propellerV2CoreUi.ok({ cart: resultCart, item: addedItem });
@@ -10815,8 +10816,8 @@ var ClusterInfo_default = ClusterInfo;
 function formatPrice9(price, currency) {
   return propellerV2CoreUi.formatPrice(price, { symbol: currency });
 }
-function getProductName2(product) {
-  return product.names?.[0]?.value || `Product ${product.productId}`;
+function getProductName2(product, language) {
+  return propellerV2CoreUi.getLocalizedValue(product.names, language, `Product ${product.productId}`);
 }
 function getProductImageUrl4(product) {
   const media = product.media;
@@ -10826,9 +10827,11 @@ function getProductImageUrl4(product) {
   }
   return "";
 }
-function ClusterOptions(props) {
+function ClusterOptions(rawProps) {
+  const props = useInfraProps(rawProps);
   const [selectedProductIds, setSelectedProductIds] = React6.useState({});
   function getOptionsForRender() {
+    const language = props.language;
     const options = props.options || [];
     const sel = selectedProductIds;
     const hidePrices = propellerV2CoreUi.isContentHidden(props.portalMode, props.user);
@@ -10838,7 +10841,7 @@ function ClusterOptions(props) {
       const products = (option.products || []).map((p) => ({
         productId: p.productId,
         productIdStr: p.productId.toString(),
-        label: hidePrices ? getProductName2(p) : `${getProductName2(p)} \u2014 ${formatPrice9(p.price?.gross || 0, props.currency ?? "\u20AC")}`
+        label: hidePrices ? getProductName2(p, language) : `${getProductName2(p, language)} \u2014 ${formatPrice9(p.price?.gross || 0, props.currency ?? "\u20AC")}`
       }));
       let previewImageUrl = "";
       let previewName = "";
@@ -10849,7 +10852,7 @@ function ClusterOptions(props) {
         );
         if (selectedProduct) {
           previewImageUrl = getProductImageUrl4(selectedProduct);
-          previewName = getProductName2(selectedProduct);
+          previewName = getProductName2(selectedProduct, language);
           previewPrice = hidePrices ? "" : formatPrice9(selectedProduct.price?.gross || 0, props.currency ?? "\u20AC");
         }
       }
@@ -10857,7 +10860,7 @@ function ClusterOptions(props) {
       return {
         id: option.id,
         idStr,
-        name: option.names?.[0]?.value || `Option ${option.id}`,
+        name: propellerV2CoreUi.getLocalizedValue(option.names, language, `Option ${option.id}`),
         isRequired,
         selectedProductId,
         hasSelection: !!selectedProductId,
@@ -11325,7 +11328,8 @@ function FavoriteListItem(rawProps) {
   const isProduct = "productId" in props.item;
   const product = props.item;
   const cluster = props.item;
-  const name = isProduct ? product?.names?.[0]?.value || "Product" : cluster?.names?.[0]?.value || cluster?.defaultProduct?.names?.[0]?.value || "Cluster";
+  const nameLanguage = props.language;
+  const name = isProduct ? propellerV2CoreUi.getLocalizedValue(product?.names, nameLanguage, "Product") : propellerV2CoreUi.getLocalizedValue(cluster?.names, nameLanguage, "") || propellerV2CoreUi.getLocalizedValue(cluster?.defaultProduct?.names, nameLanguage, "Cluster");
   const sku = isProduct ? product?.sku || "" : cluster?.sku || cluster?.defaultProduct?.sku || "";
   const imageUrl = isProduct ? product?.media?.images?.items?.[0]?.imageVariants?.[0]?.url || "" : cluster?.defaultProduct?.media?.images?.items?.[0]?.imageVariants?.[0]?.url || "";
   const itemUrl = isProduct ? props.configuration?.urls?.getProductUrl?.(props.item) || "" : props.configuration?.urls?.getClusterUrl?.(props.item) || "";
@@ -11759,9 +11763,10 @@ function FavoriteListDetails(rawProps) {
     }
   }
   function getSearchItemName(item) {
-    if ("productId" in item) return item.names?.[0]?.value || "Product";
+    const language = props.language;
+    if ("productId" in item) return propellerV2CoreUi.getLocalizedValue(item.names, language, "Product");
     const cluster = item;
-    return cluster.names?.[0]?.value || cluster.defaultProduct?.names?.[0]?.value || "Cluster";
+    return propellerV2CoreUi.getLocalizedValue(cluster.names, language, "") || propellerV2CoreUi.getLocalizedValue(cluster.defaultProduct?.names, language, "Cluster");
   }
   function getSearchItemSku(item) {
     if ("productId" in item) return item.sku || "";
@@ -12004,7 +12009,7 @@ function FavoriteListDetails(rawProps) {
           type: "button",
           className: "propeller-favorite-list-details__add-btn inline-flex items-center justify-center rounded-control bg-secondary px-4 py-2 text-sm font-medium text-secondary-foreground transition-colors hover:bg-secondary/90",
           onClick: () => setShowAddModal(true),
-          children: propellerV2CoreUi.getLabel(props.labels, "addProductDirectly", "Add product directly to this wishlist")
+          children: propellerV2CoreUi.getLabel(props.labels, "addProductDirectly", "Add product to favorite list")
         }
       ) }),
       allItems.length === 0 ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-favorite-list-details__empty border border-border rounded-container p-12 text-center space-y-4", children: [
@@ -12880,8 +12885,8 @@ function GridTitleWithProvider(rawProps) {
   return /* @__PURE__ */ jsxRuntime.jsx(GridTitle_default, { ...props });
 }
 var GridTitleWithProvider_default = GridTitleWithProvider;
-function getItemName(item) {
-  return item.product?.names?.[0]?.value || "Product";
+function getItemName(item, language) {
+  return propellerV2CoreUi.getLocalizedValue(item.product?.names, language, "Product");
 }
 function getItemImageUrl(item) {
   const url = item.product?.media?.images?.items?.[0]?.imageVariants?.[0]?.url;
@@ -12902,6 +12907,7 @@ function getBundleNonLeaders(item) {
 }
 function ItemsOverview(rawProps) {
   const props = useInfraProps(rawProps);
+  const language = props.language;
   const useTax = !!props.includeTax;
   const containerClass = props.itemsOverviewContainerClass || "cart-items-overview";
   const itemNameClickable = props.itemNameClickable !== void 0 ? props.itemNameClickable : true;
@@ -12963,7 +12969,7 @@ function ItemsOverview(rawProps) {
               {
                 className: "propeller-items-overview__item-image w-full h-full object-contain p-1.5",
                 src: getItemImageUrl(item),
-                alt: getItemName(item)
+                alt: getItemName(item, language)
               }
             ) : /* @__PURE__ */ jsxRuntime.jsx(
               "svg",
@@ -12991,7 +12997,7 @@ function ItemsOverview(rawProps) {
                 ] }),
                 /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-items-overview__item-bundle mt-1.5 space-y-1 border-l-2 border-secondary/10 pl-2", children: [
                   leader ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-items-overview__item-bundle-leader flex justify-between items-center text-xs", children: [
-                    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-medium text-foreground", children: leader.product.names?.[0]?.value || "Product" }),
+                    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-medium text-foreground", children: propellerV2CoreUi.getLocalizedValue(leader.product.names, language, "Product") }),
                     money(bundlePrice(leader.price)) ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-muted-foreground whitespace-nowrap ml-2", children: money(bundlePrice(leader.price)) }) : null
                   ] }) : null,
                   getBundleNonLeaders(item).map((bundleItem, idx) => /* @__PURE__ */ jsxRuntime.jsxs(
@@ -12999,7 +13005,7 @@ function ItemsOverview(rawProps) {
                     {
                       className: "propeller-items-overview__item-bundle-item flex justify-between items-center text-xs text-muted-foreground",
                       children: [
-                        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1", children: bundleItem.product?.names?.[0]?.value || "Product" }),
+                        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1", children: propellerV2CoreUi.getLocalizedValue(bundleItem.product?.names, language, "Product") }),
                         money(bundlePrice(bundleItem.price)) ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-foreground-subtle whitespace-nowrap ml-2", children: money(bundlePrice(bundleItem.price)) }) : null
                       ]
                     },
@@ -13020,9 +13026,9 @@ function ItemsOverview(rawProps) {
                     {
                       className: "propeller-items-overview__item-title font-medium text-sm leading-tight cursor-pointer hover:text-secondary transition-colors line-clamp-2",
                       onClick: () => handleItemNameClick(item),
-                      children: getItemName(item)
+                      children: getItemName(item, language)
                     }
-                  ) : /* @__PURE__ */ jsxRuntime.jsx("p", { className: "propeller-items-overview__item-title font-medium text-sm leading-tight line-clamp-2", children: getItemName(item) }),
+                  ) : /* @__PURE__ */ jsxRuntime.jsx("p", { className: "propeller-items-overview__item-title font-medium text-sm leading-tight line-clamp-2", children: getItemName(item, language) }),
                   showPrice ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "propeller-items-overview__item-price font-semibold text-sm text-foreground whitespace-nowrap", children: formatItemPrice(lineTotal(item)) }) : null
                 ] }),
                 showSku && itemSku ? /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "propeller-items-overview__item-sku text-xs text-muted-foreground mt-0.5", children: [
@@ -13038,7 +13044,7 @@ function ItemsOverview(rawProps) {
                   {
                     className: "propeller-items-overview__item-option flex justify-between items-center text-xs text-muted-foreground",
                     children: [
-                      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1", children: child.product?.names?.[0]?.value || "Option" }),
+                      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1", children: propellerV2CoreUi.getLocalizedValue(child.product?.names, language, "Option") }),
                       /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-foreground-subtle whitespace-nowrap ml-2", children: formatItemPrice(lineTotal(child)) })
                     ]
                   },
@@ -13516,22 +13522,22 @@ function OrderActions(rawProps) {
   );
 }
 var OrderActions_default = OrderActions;
-function getProductName3(orderItem) {
-  return orderItem?.product?.names?.[0]?.value || orderItem?.name || "Unknown Product";
+function getProductName3(orderItem, language) {
+  return propellerV2CoreUi.getLocalizedValue(orderItem?.product?.names, language, "") || orderItem?.name || "Unknown Product";
 }
-function getClusterUrl(orderItem) {
+function getClusterUrl(orderItem, language) {
   const cluster = orderItem?.product?.cluster;
   if (!cluster) return "";
   const id = cluster.clusterId;
-  const slug = cluster.slugs?.[0]?.value || "";
+  const slug = propellerV2CoreUi.getLocalizedValue(cluster.slugs, language, "");
   if (!id || !slug) return "";
   return `/cluster/${id}/${slug}`;
 }
-function getProductUrl(orderItem) {
-  const cu = getClusterUrl(orderItem);
+function getProductUrl(orderItem, language) {
+  const cu = getClusterUrl(orderItem, language);
   if (cu) return cu;
   const id = orderItem?.product?.productId;
-  const slug = orderItem?.product?.slugs?.[0]?.value || "";
+  const slug = propellerV2CoreUi.getLocalizedValue(orderItem?.product?.slugs, language, "");
   if (id && slug) return `/product/${id}/${slug}`;
   return "";
 }
@@ -13546,10 +13552,10 @@ function OrderItemCard(props) {
   const showDiscount = props.showDiscount !== void 0 ? props.showDiscount : false;
   const showStockComponent = props.showStockComponent !== void 0 ? props.showStockComponent : false;
   const showItemNotes = props.showItemNotes !== void 0 ? props.showItemNotes : false;
-  const productName = getProductName3(item);
+  const productName = getProductName3(item, props.language);
   const productSku = item?.product?.sku || item?.sku || "";
   const productImage = item?.product?.media?.images?.items?.[0]?.imageVariants?.[0]?.url || "";
-  const productUrl = getProductUrl(item);
+  const productUrl = getProductUrl(item, props.language);
   const quantity = item?.quantity || 0;
   const priceTotal = item?.priceTotal || 0;
   const discount = item?.discount || 0;
@@ -13664,7 +13670,7 @@ function OrderItemCard(props) {
         className: "propeller-order-item-card__child-row border-0",
         "data-child": "true",
         children: [
-          /* @__PURE__ */ jsxRuntime.jsx("td", { className: "propeller-order-item-card__cell propeller-order-item-card__cell--product px-6 py-2 pl-28", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "propeller-order-item-card__child-title text-sm text-muted-foreground", children: child.product?.names?.[0]?.value || child.name || "Unknown" }) }),
+          /* @__PURE__ */ jsxRuntime.jsx("td", { className: "propeller-order-item-card__cell propeller-order-item-card__cell--product px-6 py-2 pl-28", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "propeller-order-item-card__child-title text-sm text-muted-foreground", children: propellerV2CoreUi.getLocalizedValue(child.product?.names, props.language, "") || child.name || "Unknown" }) }),
           showQuantity ? /* @__PURE__ */ jsxRuntime.jsx("td", { className: "propeller-order-item-card__cell propeller-order-item-card__cell--quantity px-6 py-2 text-center text-sm text-muted-foreground", children: child.quantity || 0 }) : null,
           showDiscount ? /* @__PURE__ */ jsxRuntime.jsx("td", { className: "propeller-order-item-card__cell propeller-order-item-card__cell--discount px-6 py-2 text-right text-sm text-muted-foreground" }) : null,
           showPrice ? /* @__PURE__ */ jsxRuntime.jsx("td", { className: "propeller-order-item-card__cell propeller-order-item-card__cell--price px-6 py-2 text-right whitespace-nowrap text-sm text-muted-foreground", children: formatItemPrice(child.priceTotal || 0) }) : null
@@ -13688,7 +13694,8 @@ function OrderBonusItems(rawProps) {
       {
         orderItem: item,
         titleLinkable: false,
-        currency: props.currency
+        currency: props.currency,
+        language: props.language
       },
       item.id
     )) }) })
@@ -15059,11 +15066,12 @@ function getItemPrice(item, includeTax) {
 function getProductImage(product) {
   return product?.media?.images?.items?.[0]?.imageVariants?.[0]?.url || "";
 }
-function getProductName4(product) {
-  return product?.names?.[0]?.value || "";
+function getProductName4(product, language) {
+  return propellerV2CoreUi.getLocalizedValue(product?.names, language, "");
 }
 function ProductBundles(rawProps) {
   const props = useInfraProps(rawProps);
+  const language = props.language;
   const currencySymbol = props.currency ?? "\u20AC";
   const money = (value) => propellerV2CoreUi.formatPrice(value, { symbol: currencySymbol });
   const [isMounted, setIsMounted] = React6.useState(false);
@@ -15202,10 +15210,10 @@ function ProductBundles(rawProps) {
                       {
                         className: "propeller-product-bundles__item-image w-full h-full object-contain p-2",
                         src: getProductImage(item.product),
-                        alt: getProductName4(item.product)
+                        alt: getProductName4(item.product, language)
                       }
                     ) : null }),
-                    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "propeller-product-bundles__item-name text-sm font-medium text-muted-foreground leading-tight mb-1", children: getProductName4(item.product) || "Product " + item.productId }),
+                    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "propeller-product-bundles__item-name text-sm font-medium text-muted-foreground leading-tight mb-1", children: getProductName4(item.product, language) || "Product " + item.productId }),
                     !hidePrices && item.price ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-product-bundles__item-price text-sm font-semibold text-foreground", children: [
                       money(getItemPrice(item, includeTax)),
                       /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-normal text-muted-foreground ml-1", children: includeTax ? propellerV2CoreUi.getLabel(props.labels, "inclTax", "incl. VAT") : propellerV2CoreUi.getLabel(props.labels, "exclTax", "excl. VAT") })
@@ -15405,7 +15413,7 @@ function ProductBundles(rawProps) {
             {
               className: "propeller-product-bundles__modal-child flex justify-between items-center text-xs text-muted-foreground",
               children: [
-                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1", children: getProductName4(item.product) || "Product" }),
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1", children: getProductName4(item.product, language) || "Product" }),
                 !hidePrices && item.price ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-foreground-subtle whitespace-nowrap ml-2", children: money(getItemPrice(item, includeTax)) }) : null
               ]
             },
@@ -18620,7 +18628,7 @@ function mapToSearchBarResult(item, language) {
   const isCluster = "clusterId" in item;
   const displayItem = isCluster ? item.defaultProduct : item;
   const id = isCluster ? item.clusterId : item.productId;
-  const slug = item.slugs?.[0]?.value || "";
+  const slug = propellerV2CoreUi.getLocalizedValue(item.slugs, language, "");
   const url = isCluster ? "/cluster/" + id + "/" + slug : "/product/" + id + "/" + slug;
   const priceNet = displayItem?.price?.net || 0;
   const priceGross = displayItem?.price?.gross || 0;