@propeller-commerce/propeller-v2-react-ui 0.4.17 → 0.4.19

package/CHANGELOG.md

@@ -8,6 +8,30 @@ 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.4.19] - 2026-07-10
+
+### Fixed
+
+- `CartItem` / `AddToCart`: product, bundle, cluster-option, and crossupsell
+  names now resolve for the active `language` (via `getLocalizedValue`) instead
+  of always taking `names[0]`. Cart lines, the add-to-cart modal, and the
+  "added to cart" toast previously showed the first localised name regardless of
+  the cart/page language.
+
+## [0.4.18] - 2026-07-10
+
+### Added
+
+- `ProductSpecifications`: new `beforeSpecs?` / `afterSpecs?` render-prop slots.
+  Each receives `{ layout: 'table' | 'list' }` and returns arbitrary content
+  injected at the start / end of the specifications — inside `<tbody>` for the
+  table layout (return a `<tr>`, e.g. a labelled "Unit of measure" row) or in
+  the list stack for the list layout (return a block). In grouped mode they
+  render once, above the first group / below the last. General replacement for
+  hardcoding extra rows; the existing `packageDescription` prop is unchanged.
+- `ProductTabs`: `specificationsBeforeSpecs?` / `specificationsAfterSpecs?`
+  passthrough props that forward to the specifications section's new slots.
+
 ## [0.4.17] - 2026-07-09
 
 ### Added

package/dist/index.cjs

@@ -3954,7 +3954,7 @@ function AddToCart(rawProps) {
   }
   function getModalName() {
     if (addedCartItem) {
-      return addedCartItem.product?.names?.[0]?.value || propellerV2CoreUi.getLocalizedValue(props.product?.names, props.language, "Product");
+      return propellerV2CoreUi.getLocalizedValue(addedCartItem.product?.names, props.language, "") || propellerV2CoreUi.getLocalizedValue(props.product?.names, props.language, "Product");
     }
     return propellerV2CoreUi.getLocalizedValue(props.product?.names, props.language, "Product");
   }
@@ -4307,7 +4307,7 @@ function AddToCart(rawProps) {
                 {
                   className: "propeller-add-to-cart__modal-child 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, props.language, "Option") }),
                     /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-foreground-subtle whitespace-nowrap ml-2", children: propellerV2CoreUi.formatPrice(
                       ((props.includeTax !== void 0 ? !!props.includeTax : includeTax) ? child.totalSumNet : child.totalSum) ?? 0,
                       { symbol: props.currency ?? "\u20AC" }
@@ -6060,7 +6060,7 @@ function CartItem(rawProps) {
   const minQuantity = getMinQuantity(props.cartItem.product);
   const step = getStep(props.cartItem.product);
   function getProductName5() {
-    return props.cartItem.product?.names?.[0]?.value || "Product";
+    return propellerV2CoreUi.getLocalizedValue(props.cartItem.product?.names, props.language, "Product");
   }
   function getProductUrl2() {
     if (props.configuration?.urls && props.cartItem.product) {
@@ -6111,7 +6111,7 @@ function CartItem(rawProps) {
     if (!items) return "";
     const leader = items.find((bi) => bi.isLeader === propellerSdkV2.YesNo.Y);
     if (!leader) return "";
-    return leader.product.names?.[0]?.value || "Product";
+    return propellerV2CoreUi.getLocalizedValue(leader.product.names, props.language, "Product");
   }
   function getBundleLeaderPrice() {
     const items = props.cartItem.bundle?.items;
@@ -6128,7 +6128,7 @@ function CartItem(rawProps) {
     return items.filter((bi) => bi.isLeader !== propellerSdkV2.YesNo.Y);
   }
   function getBundleItemName(bundleItem) {
-    return bundleItem.product.names?.[0]?.value || "Product";
+    return propellerV2CoreUi.getLocalizedValue(bundleItem.product.names, props.language, "Product");
   }
   function getBundleItemPrice(bundleItem) {
     const price = bundleItem.price?.net;
@@ -6137,7 +6137,7 @@ function CartItem(rawProps) {
   }
   function getCrossupsellName(item) {
     const product = item?.productTo || item?.clusterTo;
-    return product?.names?.[0]?.value || "Product";
+    return propellerV2CoreUi.getLocalizedValue(product?.names, props.language, "Product");
   }
   function getCrossupsellImageUrl(item) {
     const product = item?.productTo || item?.clusterTo;
@@ -6462,7 +6462,7 @@ function CartItemChildItems(props = {}) {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: props.className ?? "propeller-cart-item__options mt-3 space-y-1.5 border-l-2 border-border pl-3", children: [
     /* @__PURE__ */ jsxRuntime.jsx("p", { className: "propeller-cart-item__options-label text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-1", children: propellerV2CoreUi.getLabel(resolved.labels, "includedOptions", "Included Options:") }),
     (cartItem.childItems || []).map((child, idx) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-cart-item__option flex flex-wrap gap-x-2 text-sm text-muted-foreground", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-medium", children: child.product.names?.[0]?.value || "Option" }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-medium", children: propellerV2CoreUi.getLocalizedValue(child.product.names, resolved.language, "Option") }),
       /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-foreground-subtle hidden sm:inline", children: "-" }),
       /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-foreground-subtle text-xs self-center", children: child.product.sku }),
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex-1 border-b border-dotted border-border mx-1 mb-1" }),
@@ -15115,7 +15115,11 @@ function ProductSpecifications(rawProps) {
     if (!props.productId || !props.graphqlClient) return;
     fetchSpecs(props.productId);
   }, [props.productId]);
-  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: !loading && (hasPublicAttributes() || props.packageDescription) ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: /* @__PURE__ */ jsxRuntime.jsxs(
+  const layoutMode = props.layout === "list" ? "list" : "table";
+  const before = props.beforeSpecs?.({ layout: layoutMode });
+  const after = props.afterSpecs?.({ layout: layoutMode });
+  const hasSlotContent = before != null || after != null;
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: !loading && (hasPublicAttributes() || props.packageDescription || hasSlotContent) ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
       className: `propeller-product-specifications ${props.className || ""}`,
@@ -15124,26 +15128,38 @@ function ProductSpecifications(rawProps) {
       children: [
         props.packageDescription ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "propeller-product-specifications__package-description mb-4 text-sm text-muted-foreground", children: props.packageDescription }) : null,
         !props.grouping ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-          props.layout !== "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "overflow-hidden rounded-lg border border-border", children: /* @__PURE__ */ jsxRuntime.jsx("table", { className: "w-full text-sm", children: /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: "divide-y divide-border", children: getAttributes()?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { className: "propeller-product-specifications__row odd:bg-card even:bg-muted/20", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 font-medium text-foreground w-1/2", children: getAttributeLabel(attr) }),
-            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 text-muted-foreground", children: getAttributeValue(attr) })
-          ] }, i)) }) }) }) : null,
-          props.layout === "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-3", children: getAttributes()?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-0.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: getAttributeLabel(attr) }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-foreground", children: getAttributeValue(attr) })
-          ] }, i)) }) : null
+          props.layout !== "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "overflow-hidden rounded-lg border border-border", children: /* @__PURE__ */ jsxRuntime.jsx("table", { className: "w-full text-sm", children: /* @__PURE__ */ jsxRuntime.jsxs("tbody", { className: "divide-y divide-border", children: [
+            before,
+            getAttributes()?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { className: "propeller-product-specifications__row odd:bg-card even:bg-muted/20", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 font-medium text-foreground w-1/2", children: getAttributeLabel(attr) }),
+              /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 text-muted-foreground", children: getAttributeValue(attr) })
+            ] }, i)),
+            after
+          ] }) }) }) : null,
+          props.layout === "list" ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-3", children: [
+            before,
+            getAttributes()?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-0.5", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: getAttributeLabel(attr) }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-foreground", children: getAttributeValue(attr) })
+            ] }, i)),
+            after
+          ] }) : null
         ] }) : null,
-        !!props.grouping ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: getGroups()?.map((group) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-6", children: [
-          !!group ? /* @__PURE__ */ jsxRuntime.jsx("h4", { className: "text-sm font-semibold text-muted-foreground uppercase tracking-wide mb-2", children: group }) : null,
-          props.layout !== "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "overflow-hidden rounded-lg border border-border", children: /* @__PURE__ */ jsxRuntime.jsx("table", { className: "w-full text-sm", children: /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: "divide-y divide-border", children: getAttributesByGroup(group)?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { className: "propeller-product-specifications__row odd:bg-card even:bg-muted/20", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 font-medium text-foreground w-1/2", children: getAttributeLabel(attr) }),
-            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 text-muted-foreground", children: getAttributeValue(attr) })
-          ] }, i)) }) }) }) : null,
-          props.layout === "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-3", children: getAttributesByGroup(group)?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-0.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: getAttributeLabel(attr) }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-foreground", children: getAttributeValue(attr) })
-          ] }, i)) }) : null
-        ] }, group)) }) : null
+        !!props.grouping ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          before ? layoutMode === "table" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-6 overflow-hidden rounded-lg border border-border", children: /* @__PURE__ */ jsxRuntime.jsx("table", { className: "w-full text-sm", children: /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: "divide-y divide-border", children: before }) }) }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-6 space-y-3", children: before }) : null,
+          getGroups()?.map((group) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-6", children: [
+            !!group ? /* @__PURE__ */ jsxRuntime.jsx("h4", { className: "text-sm font-semibold text-muted-foreground uppercase tracking-wide mb-2", children: group }) : null,
+            props.layout !== "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "overflow-hidden rounded-lg border border-border", children: /* @__PURE__ */ jsxRuntime.jsx("table", { className: "w-full text-sm", children: /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: "divide-y divide-border", children: getAttributesByGroup(group)?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { className: "propeller-product-specifications__row odd:bg-card even:bg-muted/20", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 font-medium text-foreground w-1/2", children: getAttributeLabel(attr) }),
+              /* @__PURE__ */ jsxRuntime.jsx("td", { className: "px-4 py-2 text-muted-foreground", children: getAttributeValue(attr) })
+            ] }, i)) }) }) }) : null,
+            props.layout === "list" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-3", children: getAttributesByGroup(group)?.map((attr, i) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-0.5", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: getAttributeLabel(attr) }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-foreground", children: getAttributeValue(attr) })
+            ] }, i)) }) : null
+          ] }, group)),
+          after ? layoutMode === "table" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-6 overflow-hidden rounded-lg border border-border", children: /* @__PURE__ */ jsxRuntime.jsx("table", { className: "w-full text-sm", children: /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: "divide-y divide-border", children: after }) }) }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-3", children: after }) : null
+        ] }) : null
       ]
     }
   ) }) : null });
@@ -15352,7 +15368,9 @@ function ProductTabs(rawProps) {
                 language: props.language,
                 layout: props.specificationsLayout,
                 grouping: props.specificationsGrouping,
-                packageDescription: props.specificationsPackageDescription
+                packageDescription: props.specificationsPackageDescription,
+                beforeSpecs: props.specificationsBeforeSpecs,
+                afterSpecs: props.specificationsAfterSpecs
               }
             ) }) : null,
             isActive("downloads") && isTabVisible("downloads") ? /* @__PURE__ */ jsxRuntime.jsx(