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

package/dist/index.d.cts

@@ -219,6 +219,13 @@ interface ProductGridConfig {
     clusterCardComponent?: ComponentType<{
         cluster: Cluster;
     } & Record<string, unknown>>;
+    /**
+     * Render arbitrary content directly below each card's product name. Receives
+     * the product; return `null`/`undefined` to render nothing. Lets hosts surface
+     * extra per-product info (e.g. package descriptions) across the whole grid
+     * without swapping the entire card.
+     */
+    belowName?: (product: Product) => ReactNode;
 }
 /**
  * Provider — ProductGrid wraps its card subtree with this so descendant
@@ -5193,6 +5200,14 @@ interface ProductCardProps {
     badgesComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.BadgesComponentProps>;
     /** Replaces the default favorite-toggle. Receives `FavoriteComponentProps`. */
     favoriteComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.FavoriteComponentProps>;
+    /**
+     * Render arbitrary content directly below the product name (and above the
+     * short description / price), in both the grid and row layouts. Receives the
+     * product so hosts can surface extra info — e.g. package descriptions, custom
+     * badges — without forking the card. Return `null`/`undefined` to render
+     * nothing for a given product.
+     */
+    belowName?: (product: Product) => React$1.ReactNode;
 }
 /**
  * Root of the `<ProductCard>` compound component. Renders either the
@@ -5270,6 +5285,10 @@ declare function ProductCardStock(props: {
     /** Show only the availability indicator. Defaults to context `showAvailability`. */
     showAvailability?: boolean;
 }): React$1.JSX.Element | null;
+/** Renders host-supplied content directly below the name, via the `belowName`
+ *  render prop (explicit or from grid context). Renders nothing when unset or
+ *  when the render prop returns a nullish value. */
+declare function ProductCardBelowName(): React$1.JSX.Element | null;
 /** Renders the product price via the embedded `ProductPrice` component, or
  *  the injected `priceComponent` from context when set. */
 declare function ProductCardPrice(props: {
@@ -5317,6 +5336,7 @@ type ProductCardComponent = typeof MemoizedRoot & {
     Favorite: typeof ProductCardFavorite;
     Name: typeof ProductCardName;
     Sku: typeof ProductCardSku;
+    BelowName: typeof ProductCardBelowName;
     ShortDescription: typeof ProductCardShortDescription;
     Manufacturer: typeof ProductCardManufacturer;
     TextLabels: typeof ProductCardTextLabels;
@@ -5583,6 +5603,14 @@ interface ProductGridProps {
     favoriteComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.FavoriteComponentProps>;
     productCardComponent?: React$1.ComponentType<ProductCardProps>;
     clusterCardComponent?: React$1.ComponentType<ClusterCardProps>;
+    /**
+     * Render arbitrary content directly below each card's product name (and above
+     * the short description / price). Receives the product; return `null` to
+     * render nothing. Cascades to every ProductCard via ProductGridConfig — lets
+     * hosts surface extra per-product info (e.g. package descriptions) without
+     * swapping the whole card.
+     */
+    belowName?: (product: Product) => React$1.ReactNode;
     beforeItem?: (item: Product | Cluster, index: number) => React$1.ReactNode;
     afterItem?: (item: Product | Cluster, index: number) => React$1.ReactNode;
 }

package/dist/index.d.ts

@@ -219,6 +219,13 @@ interface ProductGridConfig {
     clusterCardComponent?: ComponentType<{
         cluster: Cluster;
     } & Record<string, unknown>>;
+    /**
+     * Render arbitrary content directly below each card's product name. Receives
+     * the product; return `null`/`undefined` to render nothing. Lets hosts surface
+     * extra per-product info (e.g. package descriptions) across the whole grid
+     * without swapping the entire card.
+     */
+    belowName?: (product: Product) => ReactNode;
 }
 /**
  * Provider — ProductGrid wraps its card subtree with this so descendant
@@ -5193,6 +5200,14 @@ interface ProductCardProps {
     badgesComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.BadgesComponentProps>;
     /** Replaces the default favorite-toggle. Receives `FavoriteComponentProps`. */
     favoriteComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.FavoriteComponentProps>;
+    /**
+     * Render arbitrary content directly below the product name (and above the
+     * short description / price), in both the grid and row layouts. Receives the
+     * product so hosts can surface extra info — e.g. package descriptions, custom
+     * badges — without forking the card. Return `null`/`undefined` to render
+     * nothing for a given product.
+     */
+    belowName?: (product: Product) => React$1.ReactNode;
 }
 /**
  * Root of the `<ProductCard>` compound component. Renders either the
@@ -5270,6 +5285,10 @@ declare function ProductCardStock(props: {
     /** Show only the availability indicator. Defaults to context `showAvailability`. */
     showAvailability?: boolean;
 }): React$1.JSX.Element | null;
+/** Renders host-supplied content directly below the name, via the `belowName`
+ *  render prop (explicit or from grid context). Renders nothing when unset or
+ *  when the render prop returns a nullish value. */
+declare function ProductCardBelowName(): React$1.JSX.Element | null;
 /** Renders the product price via the embedded `ProductPrice` component, or
  *  the injected `priceComponent` from context when set. */
 declare function ProductCardPrice(props: {
@@ -5317,6 +5336,7 @@ type ProductCardComponent = typeof MemoizedRoot & {
     Favorite: typeof ProductCardFavorite;
     Name: typeof ProductCardName;
     Sku: typeof ProductCardSku;
+    BelowName: typeof ProductCardBelowName;
     ShortDescription: typeof ProductCardShortDescription;
     Manufacturer: typeof ProductCardManufacturer;
     TextLabels: typeof ProductCardTextLabels;
@@ -5583,6 +5603,14 @@ interface ProductGridProps {
     favoriteComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.FavoriteComponentProps>;
     productCardComponent?: React$1.ComponentType<ProductCardProps>;
     clusterCardComponent?: React$1.ComponentType<ClusterCardProps>;
+    /**
+     * Render arbitrary content directly below each card's product name (and above
+     * the short description / price). Receives the product; return `null` to
+     * render nothing. Cascades to every ProductCard via ProductGridConfig — lets
+     * hosts surface extra per-product info (e.g. package descriptions) without
+     * swapping the whole card.
+     */
+    belowName?: (product: Product) => React$1.ReactNode;
     beforeItem?: (item: Product | Cluster, index: number) => React$1.ReactNode;
     afterItem?: (item: Product | Cluster, index: number) => React$1.ReactNode;
 }

package/dist/index.js

@@ -13302,7 +13302,8 @@ var RESOLVE_SPEC2 = {
   addToCartComponent: { grid: "addToCartComponent" },
   imageComponent: { grid: "imageComponent" },
   badgesComponent: { grid: "badgesComponent" },
-  favoriteComponent: { grid: "favoriteComponent" }
+  favoriteComponent: { grid: "favoriteComponent" },
+  belowName: { grid: "belowName" }
 };
 var ProductCardContext = createContext(null);
 function useProductCard() {
@@ -13383,6 +13384,7 @@ function ProductCardRoot(rawProps) {
           /* @__PURE__ */ 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__ */ jsxs("div", { className: "flex flex-col gap-0.5 flex-1 min-w-0", children: [
             props.showSku !== false && sku ? /* @__PURE__ */ jsx(ProductCardSku, {}) : null,
             props.showName !== false ? /* @__PURE__ */ jsx(ProductCardName, { linkable: true }) : null,
+            /* @__PURE__ */ jsx(ProductCardBelowName, {}),
             textLabelValues.length > 0 ? /* @__PURE__ */ jsx(ProductCardTextLabels, {}) : null,
             props.showManufacturer && manufacturer ? /* @__PURE__ */ jsx(ProductCardManufacturer, {}) : null,
             props.showShortDescription && shortDescription ? /* @__PURE__ */ jsx(ProductCardShortDescription, {}) : null
@@ -13398,6 +13400,7 @@ function ProductCardRoot(rawProps) {
           /* @__PURE__ */ 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__ */ jsx(ProductCardSku, {}) : null,
             props.showName !== false ? /* @__PURE__ */ jsx(ProductCardName, { linkable: true }) : null,
+            /* @__PURE__ */ jsx(ProductCardBelowName, {}),
             textLabelValues.length > 0 ? /* @__PURE__ */ jsx(ProductCardTextLabels, {}) : null,
             props.showStock && !!product.inventory ? /* @__PURE__ */ jsx("div", { className: "hidden md:block", children: /* @__PURE__ */ jsx(ProductCardStock, {}) }) : null,
             props.showManufacturer && manufacturer ? /* @__PURE__ */ jsx(ProductCardManufacturer, {}) : null,
@@ -13580,6 +13583,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__ */ jsx("div", { className: "propeller-product-card__below-name", children: content });
+}
 function ProductCardPrice(props) {
   const { product, derived, resolved } = useProductCard();
   if (!product?.price) return null;
@@ -13658,6 +13668,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;
@@ -14040,7 +14051,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 = {