@propeller-commerce/propeller-v2-react-ui 0.4.16 → 0.4.18

package/CHANGELOG.md

@@ -8,6 +8,32 @@ 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.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
+
+- `ProductCard` / `ProductGrid`: new `belowName?: (product: Product) => ReactNode`
+  render prop. Renders arbitrary host-supplied content directly below the
+  product name (and above the short description / price) in both the grid and
+  row layouts, without forking the card — e.g. package descriptions or custom
+  badges. On `ProductGrid` it cascades to every card via `ProductGridConfig`;
+  on `ProductCard` it can also be set per-card (explicit prop wins over grid
+  context). Also exposed as the `<ProductCard.BelowName>` compound subcomponent.
+
 ## [0.4.16] - 2026-07-09
 
 ### Added

package/dist/index.cjs

@@ -13322,7 +13322,8 @@ var RESOLVE_SPEC2 = {
   addToCartComponent: { grid: "addToCartComponent" },
   imageComponent: { grid: "imageComponent" },
   badgesComponent: { grid: "badgesComponent" },
-  favoriteComponent: { grid: "favoriteComponent" }
+  favoriteComponent: { grid: "favoriteComponent" },
+  belowName: { grid: "belowName" }
 };
 var ProductCardContext = React6.createContext(null);
 function useProductCard() {
@@ -13403,6 +13404,7 @@ function ProductCardRoot(rawProps) {
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "propeller-product-card__body flex flex-1 flex-row items-center gap-4 px-4 py-2 min-w-0", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-0.5 flex-1 min-w-0", children: [
             props.showSku !== false && sku ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardSku, {}) : null,
             props.showName !== false ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardName, { linkable: true }) : null,
+            /* @__PURE__ */ jsxRuntime.jsx(ProductCardBelowName, {}),
             textLabelValues.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardTextLabels, {}) : null,
             props.showManufacturer && manufacturer ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardManufacturer, {}) : null,
             props.showShortDescription && shortDescription ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardShortDescription, {}) : null
@@ -13418,6 +13420,7 @@ function ProductCardRoot(rawProps) {
           /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-product-card__body flex flex-1 flex-col gap-1.5 p-3 sm:gap-2 sm:p-4", children: [
             props.showSku !== false && sku ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardSku, {}) : null,
             props.showName !== false ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardName, { linkable: true }) : null,
+            /* @__PURE__ */ jsxRuntime.jsx(ProductCardBelowName, {}),
             textLabelValues.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardTextLabels, {}) : null,
             props.showStock && !!product.inventory ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "hidden md:block", children: /* @__PURE__ */ jsxRuntime.jsx(ProductCardStock, {}) }) : null,
             props.showManufacturer && manufacturer ? /* @__PURE__ */ jsxRuntime.jsx(ProductCardManufacturer, {}) : null,
@@ -13600,6 +13603,13 @@ function ProductCardStock(props) {
     }
   );
 }
+function ProductCardBelowName() {
+  const { product, resolved } = useProductCard();
+  if (!resolved.belowName) return null;
+  const content = resolved.belowName(product);
+  if (content == null || content === false) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "propeller-product-card__below-name", children: content });
+}
 function ProductCardPrice(props) {
   const { product, derived, resolved } = useProductCard();
   if (!product?.price) return null;
@@ -13678,6 +13688,7 @@ ProductCard.Badges = ProductCardBadges;
 ProductCard.Favorite = ProductCardFavorite;
 ProductCard.Name = ProductCardName;
 ProductCard.Sku = ProductCardSku;
+ProductCard.BelowName = ProductCardBelowName;
 ProductCard.ShortDescription = ProductCardShortDescription;
 ProductCard.Manufacturer = ProductCardManufacturer;
 ProductCard.TextLabels = ProductCardTextLabels;
@@ -14060,7 +14071,8 @@ function ProductGrid(rawProps) {
     badgesComponent: props.badgesComponent,
     favoriteComponent: props.favoriteComponent,
     productCardComponent: props.productCardComponent,
-    clusterCardComponent: props.clusterCardComponent
+    clusterCardComponent: props.clusterCardComponent,
+    belowName: props.belowName
   };
   if (rawProps.children !== void 0) {
     const compoundCtx = {
@@ -15103,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 || ""}`,
@@ -15112,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 });
@@ -15340,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(