@wix/headless-stores 0.0.84 → 0.0.86

package/cjs/dist/react/Product.d.ts

@@ -24,6 +24,14 @@ interface ModifiersContextValue {
  * Hook to access modifiers context
  */
 export declare function useModifiersContext(): ModifiersContextValue;
+/**
+ * Basic stock status type for product availability states
+ */
+export type BasicStockStatus = 'in-stock' | 'limited-stock' | 'out-of-stock';
+/**
+ * Extended stock status type including pre-order capability
+ */
+export type StockStatus = BasicStockStatus | 'can-pre-order';
 /**
  * Props for the Product root component following the documented API
  */
@@ -328,7 +336,7 @@ export interface StockProps {
     asChild?: boolean;
     /** Custom render function when using asChild */
     children?: AsChildChildren<{
-        status: 'in-stock' | 'limited-stock' | 'out-of-stock';
+        status: BasicStockStatus;
         label: string;
     }>;
     /** CSS classes to apply to the default element */
@@ -675,7 +683,7 @@ export interface ProductQuantitySubComponentProps {
 }
 /**
  * Product quantity selector component that integrates with the selected variant.
- * Provides quantity controls with stock validation and pre-order support.
+ * Provides quantity controls with stock validation and can-pre-order support.
  * Uses a compound component pattern with Root, Decrement, Input, Increment, and Raw sub-components.
  *
  * @component
@@ -737,7 +745,7 @@ export interface ProductQuantitySubComponentProps {
 export declare const ProductQuantity: React.ForwardRefExoticComponent<ProductQuantityProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Product Quantity Decrement component.
- * Automatically handles disabled state based on stock and pre-order settings.
+ * Automatically handles disabled state based on stock and can-pre-order settings.
  * Must be used within Product.Quantity.Root.
  *
  * @component
@@ -859,7 +867,7 @@ export declare const ProductActionAddToCart: React.ForwardRefExoticComponent<Pro
 export declare const ProductActionBuyNow: React.ForwardRefExoticComponent<ProductActionProps & React.RefAttributes<HTMLButtonElement>>;
 /**
  * Pre-Order action button component following the documented API.
- * Handles pre-order functionality when products are not in stock.
+ * Handles can-pre-order functionality when products are not in stock.
  */
 export declare const ProductActionPreOrder: React.ForwardRefExoticComponent<ProductActionProps & React.RefAttributes<HTMLButtonElement>>;
 /**
@@ -874,6 +882,80 @@ export declare const Action: {
     /** Pre-order action button */
     readonly PreOrder: React.ForwardRefExoticComponent<ProductActionProps & React.RefAttributes<HTMLButtonElement>>;
 };
+/**
+ * Props for ProductVariantStock component
+ */
+export interface ProductVariantStockProps {
+    /** Whether to render as a child component */
+    asChild?: boolean;
+    /** Custom render function when using asChild */
+    children?: AsChildChildren<{
+        status: StockStatus;
+        label: string;
+    }>;
+    /** CSS classes to apply to the default element */
+    className?: string;
+    /** Custom labels for different stock states */
+    labels?: {
+        /** Label for in stock state */
+        inStock?: string;
+        /** Label for limited stock state (when quantity is low) */
+        limitedStock?: string;
+        /** Label for out of stock state */
+        outOfStock?: string;
+        /** Label for can-pre-order state */
+        preOrder?: string;
+    };
+}
+/**
+ * Displays the selected variant stock status with customizable rendering and labels,
+ * including can-pre-order support. Similar to Product.Stock but for the selected variant.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <Product.ProductVariant.Stock
+ *   className="stock-indicator"
+ *   labels={{
+ *     inStock: 'In Stock',
+ *     limitedStock: 'Limited Stock',
+ *     outOfStock: 'Out of Stock',
+ *     preOrder: 'Available for Pre-order'
+ *   }}
+ * />
+ *
+ * // asChild with primitive
+ * <Product.ProductVariant.Stock asChild>
+ *   <div className="variant-stock-status" />
+ * </Product.ProductVariant.Stock>
+ *
+ * // asChild with react component
+ * <Product.ProductVariant.Stock
+ *   labels={{
+ *     inStock: 'Available',
+ *     limitedStock: 'Low Stock',
+ *     outOfStock: 'Sold Out',
+ *     preOrder: 'Pre-order Now'
+ *   }}
+ *   asChild
+ * >
+ *   {React.forwardRef(({status, label, ...props}, ref) => (
+ *     <div
+ *       ref={ref}
+ *       {...props}
+ *       className="flex items-center gap-2 data-[state='in-stock']:text-green-600 data-[state='limited-stock']:text-yellow-600 data-[state='out-of-stock']:text-red-600 data-[state='can-pre-order']:text-blue-600"
+ *     >
+ *       <div className="w-3 h-3 rounded-full data-[state='in-stock']:bg-green-500 data-[state='limited-stock']:bg-yellow-500 data-[state='out-of-stock']:bg-red-500 data-[state='can-pre-order']:bg-blue-500" />
+ *       <span className="text-sm font-medium">
+ *         {label}
+ *       </span>
+ *     </div>
+ *   ))}
+ * </Product.ProductVariant.Stock>
+ * ```
+ */
+export declare const ProductVariantStock: React.ForwardRefExoticComponent<ProductVariantStockProps & React.RefAttributes<HTMLElement>>;
 /**
  * Props for ProductVariantSKU component
  */
@@ -952,9 +1034,11 @@ export interface ProductVariantWeightProps {
 export declare const ProductVariantWeight: React.ForwardRefExoticComponent<ProductVariantWeightProps & React.RefAttributes<HTMLElement>>;
 /**
  * ProductVariant namespace containing product variant components
- * following the compound component pattern: Product.ProductVariant.SKU, Product.ProductVariant.Weight
+ * following the compound component pattern: Product.ProductVariant.Stock, Product.ProductVariant.SKU, Product.ProductVariant.Weight
  */
 export declare const ProductVariant: {
+    /** Product variant stock component */
+    readonly Stock: React.ForwardRefExoticComponent<ProductVariantStockProps & React.RefAttributes<HTMLElement>>;
     /** Product variant SKU component */
     readonly SKU: React.ForwardRefExoticComponent<ProductVariantSKUProps & React.RefAttributes<HTMLElement>>;
     /** Product variant weight component */

package/cjs/dist/react/Product.js

@@ -51,6 +51,7 @@ var TestIds;
     TestIds["productVariant"] = "product-variant";
     TestIds["productVariantSku"] = "product-variant-sku";
     TestIds["productVariantWeight"] = "product-variant-weight";
+    TestIds["productVariantStock"] = "product-variant-stock";
     TestIds["productModifiers"] = "product-modifiers";
     TestIds["productModifierOptions"] = "product-modifier-options";
     TestIds["productModifierOption"] = "product-modifier-option";
@@ -58,7 +59,7 @@ var TestIds;
     TestIds["productAddToCart"] = "product-add-to-cart";
     TestIds["productActionAddToCart"] = "product-action-add-to-cart";
     TestIds["productActionBuyNow"] = "product-action-buy-now";
-    TestIds["productActionPreOrder"] = "product-action-pre-order";
+    TestIds["productActionPreOrder"] = "product-action-can-pre-order";
     TestIds["productQuantity"] = "product-quantity";
     TestIds["productQuantityDecrement"] = "product-quantity-decrement";
     TestIds["productQuantityInput"] = "product-quantity-input";
@@ -691,7 +692,7 @@ export const ProductMediaGallery = React.forwardRef((props, ref) => {
 export { ProductMediaGallery as MediaGallery };
 /**
  * Product quantity selector component that integrates with the selected variant.
- * Provides quantity controls with stock validation and pre-order support.
+ * Provides quantity controls with stock validation and can-pre-order support.
  * Uses a compound component pattern with Root, Decrement, Input, Increment, and Raw sub-components.
  *
  * @component
@@ -768,7 +769,7 @@ export const ProductQuantity = React.forwardRef((props, ref) => {
 });
 /**
  * Product Quantity Decrement component.
- * Automatically handles disabled state based on stock and pre-order settings.
+ * Automatically handles disabled state based on stock and can-pre-order settings.
  * Must be used within Product.Quantity.Root.
  *
  * @component
@@ -916,7 +917,7 @@ export const ProductActionBuyNow = React.forwardRef((props, ref) => {
 });
 /**
  * Pre-Order action button component following the documented API.
- * Handles pre-order functionality when products are not in stock.
+ * Handles can-pre-order functionality when products are not in stock.
  */
 export const ProductActionPreOrder = React.forwardRef((props, ref) => {
     const { asChild, children, className, label, loadingState } = props;
@@ -949,6 +950,113 @@ export const Action = {
     /** Pre-order action button */
     PreOrder: ProductActionPreOrder,
 };
+/**
+ * Helper function to determine stock status and label based on availability and can-pre-order settings
+ */
+function getStockStatusMessage(inStock, isPreOrderEnabled, availabilityStatus, labels) {
+    // Pre-order takes precedence
+    if (isPreOrderEnabled && !inStock) {
+        return {
+            status: 'can-pre-order',
+            label: labels.preOrder,
+        };
+    }
+    // Handle stock status based on availability
+    if (inStock) {
+        switch (availabilityStatus) {
+            case InventoryAvailabilityStatus.IN_STOCK:
+                return {
+                    status: 'in-stock',
+                    label: labels.inStock,
+                };
+            case InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
+                return {
+                    status: 'limited-stock',
+                    label: labels.limitedStock,
+                };
+            default:
+                return {
+                    status: 'in-stock',
+                    label: labels.inStock,
+                };
+        }
+    }
+    return {
+        status: 'out-of-stock',
+        label: labels.outOfStock,
+    };
+}
+/**
+ * Displays the selected variant stock status with customizable rendering and labels,
+ * including can-pre-order support. Similar to Product.Stock but for the selected variant.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <Product.ProductVariant.Stock
+ *   className="stock-indicator"
+ *   labels={{
+ *     inStock: 'In Stock',
+ *     limitedStock: 'Limited Stock',
+ *     outOfStock: 'Out of Stock',
+ *     preOrder: 'Available for Pre-order'
+ *   }}
+ * />
+ *
+ * // asChild with primitive
+ * <Product.ProductVariant.Stock asChild>
+ *   <div className="variant-stock-status" />
+ * </Product.ProductVariant.Stock>
+ *
+ * // asChild with react component
+ * <Product.ProductVariant.Stock
+ *   labels={{
+ *     inStock: 'Available',
+ *     limitedStock: 'Low Stock',
+ *     outOfStock: 'Sold Out',
+ *     preOrder: 'Pre-order Now'
+ *   }}
+ *   asChild
+ * >
+ *   {React.forwardRef(({status, label, ...props}, ref) => (
+ *     <div
+ *       ref={ref}
+ *       {...props}
+ *       className="flex items-center gap-2 data-[state='in-stock']:text-green-600 data-[state='limited-stock']:text-yellow-600 data-[state='out-of-stock']:text-red-600 data-[state='can-pre-order']:text-blue-600"
+ *     >
+ *       <div className="w-3 h-3 rounded-full data-[state='in-stock']:bg-green-500 data-[state='limited-stock']:bg-yellow-500 data-[state='out-of-stock']:bg-red-500 data-[state='can-pre-order']:bg-blue-500" />
+ *       <span className="text-sm font-medium">
+ *         {label}
+ *       </span>
+ *     </div>
+ *   ))}
+ * </Product.ProductVariant.Stock>
+ * ```
+ */
+export const ProductVariantStock = React.forwardRef((props, ref) => {
+    const { asChild, children, className, labels } = props;
+    return (_jsx(ProductVariantSelector.Stock, { children: ({ inStock, isPreOrderEnabled, availabilityStatus, currentVariantId, }) => {
+            // Only render if we have a current variant selected
+            if (!currentVariantId && !availabilityStatus) {
+                return null;
+            }
+            // Default labels
+            const defaultLabels = {
+                inStock: 'In Stock',
+                limitedStock: 'Limited Stock',
+                outOfStock: 'Out of Stock',
+                preOrder: 'Available for Pre-order',
+            };
+            const finalLabels = { ...defaultLabels, ...labels };
+            // Get status and label using the helper function
+            const { status, label } = getStockStatusMessage(inStock, isPreOrderEnabled, availabilityStatus, finalLabels);
+            return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.productVariantStock, "data-state": status, customElement: children, customElementProps: {
+                    status,
+                    label,
+                }, content: label, children: _jsx("span", { children: label }) }));
+        } }));
+});
 /**
  * Displays the selected variant SKU with customizable rendering following the documented API.
  *
@@ -1019,9 +1127,11 @@ export const ProductVariantWeight = React.forwardRef((props, ref) => {
 });
 /**
  * ProductVariant namespace containing product variant components
- * following the compound component pattern: Product.ProductVariant.SKU, Product.ProductVariant.Weight
+ * following the compound component pattern: Product.ProductVariant.Stock, Product.ProductVariant.SKU, Product.ProductVariant.Weight
  */
 export const ProductVariant = {
+    /** Product variant stock component */
+    Stock: ProductVariantStock,
     /** Product variant SKU component */
     SKU: ProductVariantSKU,
     /** Product variant weight component */

package/dist/react/Product.d.ts

@@ -24,6 +24,14 @@ interface ModifiersContextValue {
  * Hook to access modifiers context
  */
 export declare function useModifiersContext(): ModifiersContextValue;
+/**
+ * Basic stock status type for product availability states
+ */
+export type BasicStockStatus = 'in-stock' | 'limited-stock' | 'out-of-stock';
+/**
+ * Extended stock status type including pre-order capability
+ */
+export type StockStatus = BasicStockStatus | 'can-pre-order';
 /**
  * Props for the Product root component following the documented API
  */
@@ -328,7 +336,7 @@ export interface StockProps {
     asChild?: boolean;
     /** Custom render function when using asChild */
     children?: AsChildChildren<{
-        status: 'in-stock' | 'limited-stock' | 'out-of-stock';
+        status: BasicStockStatus;
         label: string;
     }>;
     /** CSS classes to apply to the default element */
@@ -675,7 +683,7 @@ export interface ProductQuantitySubComponentProps {
 }
 /**
  * Product quantity selector component that integrates with the selected variant.
- * Provides quantity controls with stock validation and pre-order support.
+ * Provides quantity controls with stock validation and can-pre-order support.
  * Uses a compound component pattern with Root, Decrement, Input, Increment, and Raw sub-components.
  *
  * @component
@@ -737,7 +745,7 @@ export interface ProductQuantitySubComponentProps {
 export declare const ProductQuantity: React.ForwardRefExoticComponent<ProductQuantityProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Product Quantity Decrement component.
- * Automatically handles disabled state based on stock and pre-order settings.
+ * Automatically handles disabled state based on stock and can-pre-order settings.
  * Must be used within Product.Quantity.Root.
  *
  * @component
@@ -859,7 +867,7 @@ export declare const ProductActionAddToCart: React.ForwardRefExoticComponent<Pro
 export declare const ProductActionBuyNow: React.ForwardRefExoticComponent<ProductActionProps & React.RefAttributes<HTMLButtonElement>>;
 /**
  * Pre-Order action button component following the documented API.
- * Handles pre-order functionality when products are not in stock.
+ * Handles can-pre-order functionality when products are not in stock.
  */
 export declare const ProductActionPreOrder: React.ForwardRefExoticComponent<ProductActionProps & React.RefAttributes<HTMLButtonElement>>;
 /**
@@ -874,6 +882,80 @@ export declare const Action: {
     /** Pre-order action button */
     readonly PreOrder: React.ForwardRefExoticComponent<ProductActionProps & React.RefAttributes<HTMLButtonElement>>;
 };
+/**
+ * Props for ProductVariantStock component
+ */
+export interface ProductVariantStockProps {
+    /** Whether to render as a child component */
+    asChild?: boolean;
+    /** Custom render function when using asChild */
+    children?: AsChildChildren<{
+        status: StockStatus;
+        label: string;
+    }>;
+    /** CSS classes to apply to the default element */
+    className?: string;
+    /** Custom labels for different stock states */
+    labels?: {
+        /** Label for in stock state */
+        inStock?: string;
+        /** Label for limited stock state (when quantity is low) */
+        limitedStock?: string;
+        /** Label for out of stock state */
+        outOfStock?: string;
+        /** Label for can-pre-order state */
+        preOrder?: string;
+    };
+}
+/**
+ * Displays the selected variant stock status with customizable rendering and labels,
+ * including can-pre-order support. Similar to Product.Stock but for the selected variant.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <Product.ProductVariant.Stock
+ *   className="stock-indicator"
+ *   labels={{
+ *     inStock: 'In Stock',
+ *     limitedStock: 'Limited Stock',
+ *     outOfStock: 'Out of Stock',
+ *     preOrder: 'Available for Pre-order'
+ *   }}
+ * />
+ *
+ * // asChild with primitive
+ * <Product.ProductVariant.Stock asChild>
+ *   <div className="variant-stock-status" />
+ * </Product.ProductVariant.Stock>
+ *
+ * // asChild with react component
+ * <Product.ProductVariant.Stock
+ *   labels={{
+ *     inStock: 'Available',
+ *     limitedStock: 'Low Stock',
+ *     outOfStock: 'Sold Out',
+ *     preOrder: 'Pre-order Now'
+ *   }}
+ *   asChild
+ * >
+ *   {React.forwardRef(({status, label, ...props}, ref) => (
+ *     <div
+ *       ref={ref}
+ *       {...props}
+ *       className="flex items-center gap-2 data-[state='in-stock']:text-green-600 data-[state='limited-stock']:text-yellow-600 data-[state='out-of-stock']:text-red-600 data-[state='can-pre-order']:text-blue-600"
+ *     >
+ *       <div className="w-3 h-3 rounded-full data-[state='in-stock']:bg-green-500 data-[state='limited-stock']:bg-yellow-500 data-[state='out-of-stock']:bg-red-500 data-[state='can-pre-order']:bg-blue-500" />
+ *       <span className="text-sm font-medium">
+ *         {label}
+ *       </span>
+ *     </div>
+ *   ))}
+ * </Product.ProductVariant.Stock>
+ * ```
+ */
+export declare const ProductVariantStock: React.ForwardRefExoticComponent<ProductVariantStockProps & React.RefAttributes<HTMLElement>>;
 /**
  * Props for ProductVariantSKU component
  */
@@ -952,9 +1034,11 @@ export interface ProductVariantWeightProps {
 export declare const ProductVariantWeight: React.ForwardRefExoticComponent<ProductVariantWeightProps & React.RefAttributes<HTMLElement>>;
 /**
  * ProductVariant namespace containing product variant components
- * following the compound component pattern: Product.ProductVariant.SKU, Product.ProductVariant.Weight
+ * following the compound component pattern: Product.ProductVariant.Stock, Product.ProductVariant.SKU, Product.ProductVariant.Weight
  */
 export declare const ProductVariant: {
+    /** Product variant stock component */
+    readonly Stock: React.ForwardRefExoticComponent<ProductVariantStockProps & React.RefAttributes<HTMLElement>>;
     /** Product variant SKU component */
     readonly SKU: React.ForwardRefExoticComponent<ProductVariantSKUProps & React.RefAttributes<HTMLElement>>;
     /** Product variant weight component */

package/dist/react/Product.js

@@ -51,6 +51,7 @@ var TestIds;
     TestIds["productVariant"] = "product-variant";
     TestIds["productVariantSku"] = "product-variant-sku";
     TestIds["productVariantWeight"] = "product-variant-weight";
+    TestIds["productVariantStock"] = "product-variant-stock";
     TestIds["productModifiers"] = "product-modifiers";
     TestIds["productModifierOptions"] = "product-modifier-options";
     TestIds["productModifierOption"] = "product-modifier-option";
@@ -58,7 +59,7 @@ var TestIds;
     TestIds["productAddToCart"] = "product-add-to-cart";
     TestIds["productActionAddToCart"] = "product-action-add-to-cart";
     TestIds["productActionBuyNow"] = "product-action-buy-now";
-    TestIds["productActionPreOrder"] = "product-action-pre-order";
+    TestIds["productActionPreOrder"] = "product-action-can-pre-order";
     TestIds["productQuantity"] = "product-quantity";
     TestIds["productQuantityDecrement"] = "product-quantity-decrement";
     TestIds["productQuantityInput"] = "product-quantity-input";
@@ -691,7 +692,7 @@ export const ProductMediaGallery = React.forwardRef((props, ref) => {
 export { ProductMediaGallery as MediaGallery };
 /**
  * Product quantity selector component that integrates with the selected variant.
- * Provides quantity controls with stock validation and pre-order support.
+ * Provides quantity controls with stock validation and can-pre-order support.
  * Uses a compound component pattern with Root, Decrement, Input, Increment, and Raw sub-components.
  *
  * @component
@@ -768,7 +769,7 @@ export const ProductQuantity = React.forwardRef((props, ref) => {
 });
 /**
  * Product Quantity Decrement component.
- * Automatically handles disabled state based on stock and pre-order settings.
+ * Automatically handles disabled state based on stock and can-pre-order settings.
  * Must be used within Product.Quantity.Root.
  *
  * @component
@@ -916,7 +917,7 @@ export const ProductActionBuyNow = React.forwardRef((props, ref) => {
 });
 /**
  * Pre-Order action button component following the documented API.
- * Handles pre-order functionality when products are not in stock.
+ * Handles can-pre-order functionality when products are not in stock.
  */
 export const ProductActionPreOrder = React.forwardRef((props, ref) => {
     const { asChild, children, className, label, loadingState } = props;
@@ -949,6 +950,113 @@ export const Action = {
     /** Pre-order action button */
     PreOrder: ProductActionPreOrder,
 };
+/**
+ * Helper function to determine stock status and label based on availability and can-pre-order settings
+ */
+function getStockStatusMessage(inStock, isPreOrderEnabled, availabilityStatus, labels) {
+    // Pre-order takes precedence
+    if (isPreOrderEnabled && !inStock) {
+        return {
+            status: 'can-pre-order',
+            label: labels.preOrder,
+        };
+    }
+    // Handle stock status based on availability
+    if (inStock) {
+        switch (availabilityStatus) {
+            case InventoryAvailabilityStatus.IN_STOCK:
+                return {
+                    status: 'in-stock',
+                    label: labels.inStock,
+                };
+            case InventoryAvailabilityStatus.PARTIALLY_OUT_OF_STOCK:
+                return {
+                    status: 'limited-stock',
+                    label: labels.limitedStock,
+                };
+            default:
+                return {
+                    status: 'in-stock',
+                    label: labels.inStock,
+                };
+        }
+    }
+    return {
+        status: 'out-of-stock',
+        label: labels.outOfStock,
+    };
+}
+/**
+ * Displays the selected variant stock status with customizable rendering and labels,
+ * including can-pre-order support. Similar to Product.Stock but for the selected variant.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <Product.ProductVariant.Stock
+ *   className="stock-indicator"
+ *   labels={{
+ *     inStock: 'In Stock',
+ *     limitedStock: 'Limited Stock',
+ *     outOfStock: 'Out of Stock',
+ *     preOrder: 'Available for Pre-order'
+ *   }}
+ * />
+ *
+ * // asChild with primitive
+ * <Product.ProductVariant.Stock asChild>
+ *   <div className="variant-stock-status" />
+ * </Product.ProductVariant.Stock>
+ *
+ * // asChild with react component
+ * <Product.ProductVariant.Stock
+ *   labels={{
+ *     inStock: 'Available',
+ *     limitedStock: 'Low Stock',
+ *     outOfStock: 'Sold Out',
+ *     preOrder: 'Pre-order Now'
+ *   }}
+ *   asChild
+ * >
+ *   {React.forwardRef(({status, label, ...props}, ref) => (
+ *     <div
+ *       ref={ref}
+ *       {...props}
+ *       className="flex items-center gap-2 data-[state='in-stock']:text-green-600 data-[state='limited-stock']:text-yellow-600 data-[state='out-of-stock']:text-red-600 data-[state='can-pre-order']:text-blue-600"
+ *     >
+ *       <div className="w-3 h-3 rounded-full data-[state='in-stock']:bg-green-500 data-[state='limited-stock']:bg-yellow-500 data-[state='out-of-stock']:bg-red-500 data-[state='can-pre-order']:bg-blue-500" />
+ *       <span className="text-sm font-medium">
+ *         {label}
+ *       </span>
+ *     </div>
+ *   ))}
+ * </Product.ProductVariant.Stock>
+ * ```
+ */
+export const ProductVariantStock = React.forwardRef((props, ref) => {
+    const { asChild, children, className, labels } = props;
+    return (_jsx(ProductVariantSelector.Stock, { children: ({ inStock, isPreOrderEnabled, availabilityStatus, currentVariantId, }) => {
+            // Only render if we have a current variant selected
+            if (!currentVariantId && !availabilityStatus) {
+                return null;
+            }
+            // Default labels
+            const defaultLabels = {
+                inStock: 'In Stock',
+                limitedStock: 'Limited Stock',
+                outOfStock: 'Out of Stock',
+                preOrder: 'Available for Pre-order',
+            };
+            const finalLabels = { ...defaultLabels, ...labels };
+            // Get status and label using the helper function
+            const { status, label } = getStockStatusMessage(inStock, isPreOrderEnabled, availabilityStatus, finalLabels);
+            return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.productVariantStock, "data-state": status, customElement: children, customElementProps: {
+                    status,
+                    label,
+                }, content: label, children: _jsx("span", { children: label }) }));
+        } }));
+});
 /**
  * Displays the selected variant SKU with customizable rendering following the documented API.
  *
@@ -1019,9 +1127,11 @@ export const ProductVariantWeight = React.forwardRef((props, ref) => {
 });
 /**
  * ProductVariant namespace containing product variant components
- * following the compound component pattern: Product.ProductVariant.SKU, Product.ProductVariant.Weight
+ * following the compound component pattern: Product.ProductVariant.Stock, Product.ProductVariant.SKU, Product.ProductVariant.Weight
  */
 export const ProductVariant = {
+    /** Product variant stock component */
+    Stock: ProductVariantStock,
     /** Product variant SKU component */
     SKU: ProductVariantSKU,
     /** Product variant weight component */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-stores",
-  "version": "0.0.84",
+  "version": "0.0.86",
   "type": "module",
   "scripts": {
     "prebuild": "cd ../media && yarn build && cd ../ecom && yarn build",