@propeller-commerce/propeller-v2-react-ui 0.14.0 → 0.15.1

package/dist/index.d.cts

@@ -1396,11 +1396,13 @@ interface UseProductSearchOptions {
     /** Upper price bound filter. */
     priceFilterMax?: number;
     /**
-     * Stock buckets to filter by. Empty, unset, or both buckets sends no stock
-     * filter. Filtering happens server-side, so `itemsFound` and the page count
+     * Stock selection to filter by. `'all'` or unset sends no stock filter.
+     * Filtering happens server-side, so `itemsFound` and the page count
      * describe the filtered set.
      */
-    availability?: Availability[];
+    availability?: Availability;
+    /** Minimum stock quantity for the `'in-stock'` selection. */
+    minStock?: number;
     /** Sort field; overrides the internal sort state when set. */
     sortField?: string;
     /** Sort direction (`'ASC'` / `'DESC'`); overrides internal state when set. */
@@ -4635,12 +4637,14 @@ interface GridFiltersProps {
      */
     showAvailabilityFilter?: boolean;
     /**
-     * Currently active availability buckets (URL-driven). Seeds the checkboxes
-     * on the first render so a restored filtered URL renders them ticked.
+     * Currently active availability selection (URL-driven). Seeds the toggle
+     * on the first render so a restored filtered URL renders it correctly.
      */
-    activeAvailability?: Availability[];
-    /** Called whenever an availability checkbox is toggled. */
-    onAvailabilityChange?: (sel: Availability[]) => void;
+    activeAvailability?: Availability;
+    /** Currently active minimum stock quantity (URL-driven). Undefined means the minimum. */
+    activeMinStock?: number;
+    /** Called on every toggle or stepper change with both values. */
+    onAvailabilityChange?: (sel: Availability, minStock: number) => void;
     /**
      * When true, all checkboxes and price inputs are disabled.
      * Wire to ProductGrid's `onLoadingChange` to block rapid re-clicks while a fetch is in flight.
@@ -4826,15 +4830,14 @@ interface GridToolbarProps {
      */
     onPriceFilterRemove?: () => void;
     /**
-     * Currently active availability (stock) filter selections.
-     * Renders one removable chip per selected bucket.
+     * Currently active availability (stock) selection.
+     * Renders a single removable chip when set to `'in-stock'`.
      */
-    availability?: Availability[];
-    /**
-     * Called when an availability filter badge × is clicked.
-     * Receives the specific bucket to remove.
-     */
-    onAvailabilityFilterRemove?: (value: Availability) => void;
+    availability?: Availability;
+    /** Currently active minimum stock quantity, shown on the chip above the default. */
+    minStock?: number;
+    /** Called when the availability filter badge × is clicked. */
+    onAvailabilityFilterRemove?: () => void;
     /**
      * Called when "Clear All" is clicked.
      */
@@ -6233,10 +6236,12 @@ interface ProductGridProps {
     /**  * Active price range lower bound from the FiltersSidebar `onPriceChange`.  * Triggers a re-fetch when changed.  */ priceFilterMin?: number;
     /**  * Active price range upper bound from the FiltersSidebar `onPriceChange`.  * Triggers a re-fetch when changed.  */ priceFilterMax?: number;
     /**
-     * Active stock buckets from the filters sidebar. Triggers a re-fetch when
-     * changed. Empty or both buckets means no stock filter.
+     * Active stock selection from the filters sidebar. Triggers a re-fetch when
+     * changed. `'all'` or undefined means no stock filter.
      */
-    availability?: Availability[];
+    availability?: Availability;
+    /** Minimum stock quantity for the `'in-stock'` selection. Defaults to the minimum threshold. */
+    minStock?: number;
     /**  * Called when sort state changes internally (for syncing a sibling toolbar).  */ onSortChange?: (field: string, order: string) => void;
     /**  * Called after each internal data fetch with the min/max price of the  * current product set — use to populate a price range slider in the parent.  */ onPriceBoundsChange?: (min: number, max: number) => void;
     /**  * Called after each fetch with the total number of products found —  * use to display a result count in the parent toolbar.  */ onItemsFoundChange?: (count: number) => void;

package/dist/index.d.ts

@@ -1396,11 +1396,13 @@ interface UseProductSearchOptions {
     /** Upper price bound filter. */
     priceFilterMax?: number;
     /**
-     * Stock buckets to filter by. Empty, unset, or both buckets sends no stock
-     * filter. Filtering happens server-side, so `itemsFound` and the page count
+     * Stock selection to filter by. `'all'` or unset sends no stock filter.
+     * Filtering happens server-side, so `itemsFound` and the page count
      * describe the filtered set.
      */
-    availability?: Availability[];
+    availability?: Availability;
+    /** Minimum stock quantity for the `'in-stock'` selection. */
+    minStock?: number;
     /** Sort field; overrides the internal sort state when set. */
     sortField?: string;
     /** Sort direction (`'ASC'` / `'DESC'`); overrides internal state when set. */
@@ -4635,12 +4637,14 @@ interface GridFiltersProps {
      */
     showAvailabilityFilter?: boolean;
     /**
-     * Currently active availability buckets (URL-driven). Seeds the checkboxes
-     * on the first render so a restored filtered URL renders them ticked.
+     * Currently active availability selection (URL-driven). Seeds the toggle
+     * on the first render so a restored filtered URL renders it correctly.
      */
-    activeAvailability?: Availability[];
-    /** Called whenever an availability checkbox is toggled. */
-    onAvailabilityChange?: (sel: Availability[]) => void;
+    activeAvailability?: Availability;
+    /** Currently active minimum stock quantity (URL-driven). Undefined means the minimum. */
+    activeMinStock?: number;
+    /** Called on every toggle or stepper change with both values. */
+    onAvailabilityChange?: (sel: Availability, minStock: number) => void;
     /**
      * When true, all checkboxes and price inputs are disabled.
      * Wire to ProductGrid's `onLoadingChange` to block rapid re-clicks while a fetch is in flight.
@@ -4826,15 +4830,14 @@ interface GridToolbarProps {
      */
     onPriceFilterRemove?: () => void;
     /**
-     * Currently active availability (stock) filter selections.
-     * Renders one removable chip per selected bucket.
+     * Currently active availability (stock) selection.
+     * Renders a single removable chip when set to `'in-stock'`.
      */
-    availability?: Availability[];
-    /**
-     * Called when an availability filter badge × is clicked.
-     * Receives the specific bucket to remove.
-     */
-    onAvailabilityFilterRemove?: (value: Availability) => void;
+    availability?: Availability;
+    /** Currently active minimum stock quantity, shown on the chip above the default. */
+    minStock?: number;
+    /** Called when the availability filter badge × is clicked. */
+    onAvailabilityFilterRemove?: () => void;
     /**
      * Called when "Clear All" is clicked.
      */
@@ -6233,10 +6236,12 @@ interface ProductGridProps {
     /**  * Active price range lower bound from the FiltersSidebar `onPriceChange`.  * Triggers a re-fetch when changed.  */ priceFilterMin?: number;
     /**  * Active price range upper bound from the FiltersSidebar `onPriceChange`.  * Triggers a re-fetch when changed.  */ priceFilterMax?: number;
     /**
-     * Active stock buckets from the filters sidebar. Triggers a re-fetch when
-     * changed. Empty or both buckets means no stock filter.
+     * Active stock selection from the filters sidebar. Triggers a re-fetch when
+     * changed. `'all'` or undefined means no stock filter.
      */
-    availability?: Availability[];
+    availability?: Availability;
+    /** Minimum stock quantity for the `'in-stock'` selection. Defaults to the minimum threshold. */
+    minStock?: number;
     /**  * Called when sort state changes internally (for syncing a sibling toolbar).  */ onSortChange?: (field: string, order: string) => void;
     /**  * Called after each internal data fetch with the min/max price of the  * current product set — use to populate a price range slider in the parent.  */ onPriceBoundsChange?: (min: number, max: number) => void;
     /**  * Called after each fetch with the total number of products found —  * use to display a result count in the parent toolbar.  */ onItemsFoundChange?: (count: number) => void;

package/dist/index.js

@@ -1,5 +1,5 @@
 "use client";
-import { getLabel, getLocalizedValue, formatPrice, getClusterSku, getClusterImageUrl, isContentHidden, getProductSku, getProductImageUrl, createServices, err, ok, formatSurcharge, deriveUserMode, isContact, isCustomer, getAddresses, attributeNameMatches, getAttributeDisplayName, filterProductsBySelections, extractAttributeValues, buildInventoryFilter, getLanguageString, collectAttributeValues, getCountryName } from '@propeller-commerce/propeller-v2-core-ui';
+import { getLabel, getLocalizedValue, formatPrice, getClusterSku, getClusterImageUrl, isContentHidden, getProductSku, getProductImageUrl, createServices, err, ok, formatSurcharge, deriveUserMode, isContact, isCustomer, getAddresses, attributeNameMatches, getAttributeDisplayName, filterProductsBySelections, extractAttributeValues, buildInventoryFilter, MIN_STOCK_THRESHOLD, getLanguageString, collectAttributeValues, getCountryName } from '@propeller-commerce/propeller-v2-core-ui';
 export * from '@propeller-commerce/propeller-v2-core-ui';
 import * as React6 from 'react';
 import { createContext, useState, useRef, useMemo, useCallback, useContext, useEffect } from 'react';
@@ -2242,7 +2242,8 @@ function useProductSearch(options) {
       JSON.stringify(options.textFilters ?? []),
       options.priceFilterMin ?? "",
       options.priceFilterMax ?? "",
-      JSON.stringify(options.availability ?? [])
+      options.availability ?? "",
+      options.minStock ?? ""
     ].join("|");
     if (inflightFetches2.has(inflightKey)) {
       fetchIdRef.current--;
@@ -2284,7 +2285,7 @@ function useProductSearch(options) {
         }
       ] : [];
       const priceFilter = options.priceFilterMin !== void 0 || options.priceFilterMax !== void 0 ? { from: options.priceFilterMin ?? 0, to: options.priceFilterMax ?? 999999 } : void 0;
-      const inventoryFilter = buildInventoryFilter(options.availability);
+      const inventoryFilter = buildInventoryFilter(options.availability, options.minStock);
       const userId = options.user && "contactId" in options.user ? options.user.contactId : options.user && "customerId" in options.user ? options.user.customerId : void 0;
       const contactId = options.user && "contactId" in options.user ? options.user.contactId : void 0;
       const customerId = options.user && "customerId" in options.user ? options.user.customerId : void 0;
@@ -2385,6 +2386,7 @@ function useProductSearch(options) {
     options.priceFilterMin,
     options.priceFilterMax,
     options.availability,
+    options.minStock,
     options.sortField,
     options.sortOrder,
     options.companyId,
@@ -2424,7 +2426,7 @@ function useProductSearch(options) {
           const userId = options.user && "contactId" in options.user ? options.user.contactId : options.user && "customerId" in options.user ? options.user.customerId : void 0;
           const contactId = options.user && "contactId" in options.user ? options.user.contactId : void 0;
           const customerId = options.user && "customerId" in options.user ? options.user.customerId : void 0;
-          const inventoryFilter = buildInventoryFilter(options.availability);
+          const inventoryFilter = buildInventoryFilter(options.availability, options.minStock);
           const categoryProductSearchInput = {
             language,
             page: 1,
@@ -2517,6 +2519,7 @@ function useProductSearch(options) {
     options.priceFilterMin,
     options.priceFilterMax,
     options.availability,
+    options.minStock,
     options.sortField,
     options.sortOrder,
     pageSize,
@@ -9040,6 +9043,7 @@ function ProductGrid(rawProps) {
     priceFilterMin: props.priceFilterMin,
     priceFilterMax: props.priceFilterMax,
     availability: props.availability,
+    minStock: props.minStock,
     sortField: props.sortField,
     sortOrder: props.sortOrder,
     pageSize: props.pageSize,
@@ -9343,7 +9347,13 @@ function GridFilters(rawProps) {
   const [appliedMin, setAppliedMin] = useState(() => void 0);
   const [appliedMax, setAppliedMax] = useState(() => void 0);
   const [availability, setAvailability] = useState(
-    () => [...props.activeAvailability || []]
+    () => props.activeAvailability || "all"
+  );
+  const [minStock, setMinStock] = useState(
+    () => props.activeMinStock ?? MIN_STOCK_THRESHOLD
+  );
+  const [minStockInput, setMinStockInput] = useState(
+    () => String(props.activeMinStock ?? MIN_STOCK_THRESHOLD)
   );
   function showPriceFilter() {
     const mode = props.portalMode || "open";
@@ -9398,13 +9408,28 @@ function GridFilters(rawProps) {
     props.onFilterChange(filter, value);
     if (props.getSelectedFilters) props.getSelectedFilters();
   }
-  function handleAvailabilityToggle(value, checked) {
-    const next = checked ? [...availability, value] : availability.filter((v) => v !== value);
-    setAvailability(next);
+  function handleAvailabilityChange(value) {
+    const nextMinStock = value === "all" ? MIN_STOCK_THRESHOLD : minStock;
+    setAvailability(value);
+    setMinStock(nextMinStock);
+    setMinStockInput(String(nextMinStock));
+    setIsPending(true);
+    if (props.onAvailabilityChange) props.onAvailabilityChange(value, nextMinStock);
+    if (props.getSelectedFilters) props.getSelectedFilters();
+  }
+  function handleMinStockChange(value) {
+    const n = Math.max(Math.floor(value) || MIN_STOCK_THRESHOLD, MIN_STOCK_THRESHOLD);
+    setMinStock(n);
+    setMinStockInput(String(n));
+    if (n === minStock) return;
     setIsPending(true);
-    if (props.onAvailabilityChange) props.onAvailabilityChange(next);
+    if (props.onAvailabilityChange) props.onAvailabilityChange(availability, n);
     if (props.getSelectedFilters) props.getSelectedFilters();
   }
+  function commitMinStockInput() {
+    const parsed = parseInt(minStockInput, 10);
+    handleMinStockChange(isNaN(parsed) ? MIN_STOCK_THRESHOLD : parsed);
+  }
   function handleMinChange(value) {
     const n = value > currentMax ? currentMax : value;
     setCurrentMin(n);
@@ -9442,7 +9467,7 @@ function GridFilters(rawProps) {
   function getCount(option) {
     const c = option?.count || 0;
     const ca = option?.countActive || 0;
-    return c === 0 && ca > 0 ? ca : c;
+    return ca > 0 ? ca : c;
   }
   function getMinBound() {
     return props.priceMin || 0;
@@ -9478,7 +9503,9 @@ function GridFilters(rawProps) {
     setCurrentMin(props.priceMin || 0);
     setCurrentMax(props.priceMax || 9999);
     setExpandedFilters({});
-    setAvailability([]);
+    setAvailability("all");
+    setMinStock(MIN_STOCK_THRESHOLD);
+    setMinStockInput(String(MIN_STOCK_THRESHOLD));
   }, [props.clearSignal, props.priceMin, props.priceMax]);
   useEffect(() => {
     if (!props.activeTextFilters) return;
@@ -9486,8 +9513,10 @@ function GridFilters(rawProps) {
   }, [props.activeTextFilters]);
   useEffect(() => {
     if (!props.activeAvailability) return;
-    setAvailability([...props.activeAvailability]);
-  }, [props.activeAvailability]);
+    setAvailability(props.activeAvailability);
+    setMinStock(props.activeMinStock ?? MIN_STOCK_THRESHOLD);
+    setMinStockInput(String(props.activeMinStock ?? MIN_STOCK_THRESHOLD));
+  }, [props.activeAvailability, props.activeMinStock]);
   useEffect(() => {
     if (props.activePriceMin === void 0 && props.activePriceMax === void 0) {
       setCurrentMin(props.priceMin || 0);
@@ -9590,34 +9619,76 @@ function GridFilters(rawProps) {
         showAvailability() ? /* @__PURE__ */ jsxs(Fragment, { children: [
           /* @__PURE__ */ jsxs("div", { className: "propeller-grid-filters__availability space-y-3", children: [
             /* @__PURE__ */ jsx("h3", { className: "propeller-grid-filters__availability-title text-xs font-semibold uppercase tracking-wide text-muted-foreground", children: getLabel(props.labels, "availability", "Availability") }),
-            /* @__PURE__ */ jsxs("div", { className: "propeller-grid-filters__availability-options space-y-1.5", children: [
-              /* @__PURE__ */ jsxs("label", { className: "propeller-grid-filters__option flex items-center gap-2 cursor-pointer group", children: [
+            /* @__PURE__ */ jsxs("div", { className: "propeller-grid-filters__availability-toggle inline-flex h-8 w-full rounded-control border border-input overflow-hidden", children: [
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  className: `propeller-grid-filters__availability-option flex-1 text-xs font-medium transition-colors ${availability === "all" ? "bg-secondary text-secondary-foreground" : "bg-transparent text-muted-foreground hover:text-foreground"}`,
+                  "aria-pressed": availability === "all",
+                  disabled: !!props.isLoading,
+                  onClick: () => handleAvailabilityChange("all"),
+                  children: getLabel(props.labels, "allProducts", "All products")
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  className: `propeller-grid-filters__availability-option flex-1 text-xs font-medium transition-colors ${availability === "in-stock" ? "bg-secondary text-secondary-foreground" : "bg-transparent text-muted-foreground hover:text-foreground"}`,
+                  "aria-pressed": availability === "in-stock",
+                  disabled: !!props.isLoading,
+                  onClick: () => handleAvailabilityChange("in-stock"),
+                  children: getLabel(props.labels, "inStock", "In stock")
+                }
+              )
+            ] }),
+            availability === "in-stock" ? /* @__PURE__ */ jsxs("div", { className: "propeller-grid-filters__availability-quantity flex items-center gap-2 text-sm text-muted-foreground", children: [
+              /* @__PURE__ */ jsx("span", { children: getLabel(props.labels, "atLeast", "at least") }),
+              /* @__PURE__ */ jsxs("div", { className: "propeller-grid-filters__availability-stepper inline-flex items-center h-8 rounded-control border border-input bg-card overflow-hidden focus-within:ring-1 focus-within:ring-secondary", children: [
                 /* @__PURE__ */ jsx(
-                  "input",
+                  "button",
                   {
-                    type: "checkbox",
-                    className: "propeller-grid-filters__checkbox h-4 w-4 rounded border-input text-secondary focus:ring-secondary cursor-pointer flex-shrink-0",
-                    checked: availability.includes("in-stock"),
-                    disabled: !!props.isLoading,
-                    onChange: (e) => handleAvailabilityToggle("in-stock", e.target.checked)
+                    type: "button",
+                    className: "propeller-grid-filters__quantity-decrease h-full w-8 flex items-center justify-center text-muted-foreground disabled:opacity-40 disabled:cursor-not-allowed hover:bg-accent hover:text-foreground transition-colors",
+                    "aria-label": getLabel(props.labels, "quantityDecrease", "Decrease quantity"),
+                    disabled: !!props.isLoading || minStock <= MIN_STOCK_THRESHOLD,
+                    onClick: () => handleMinStockChange(minStock - 1),
+                    children: "\u2212"
                   }
                 ),
-                /* @__PURE__ */ jsx("span", { className: "propeller-grid-filters__option-label flex-1 text-sm text-muted-foreground leading-none select-none group-hover:text-foreground", children: getLabel(props.labels, "inStock", "In stock") })
-              ] }),
-              /* @__PURE__ */ jsxs("label", { className: "propeller-grid-filters__option flex items-center gap-2 cursor-pointer group", children: [
                 /* @__PURE__ */ jsx(
                   "input",
                   {
-                    type: "checkbox",
-                    className: "propeller-grid-filters__checkbox h-4 w-4 rounded border-input text-secondary focus:ring-secondary cursor-pointer flex-shrink-0",
-                    checked: availability.includes("out-of-stock"),
+                    type: "number",
+                    inputMode: "numeric",
+                    className: "propeller-grid-filters__availability-quantity-input w-10 h-full px-0 text-center font-medium text-foreground bg-transparent border-0 focus:outline-none focus:ring-0 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none",
+                    "aria-label": getLabel(props.labels, "atLeast", "at least"),
+                    min: MIN_STOCK_THRESHOLD,
+                    step: 1,
+                    value: minStockInput,
                     disabled: !!props.isLoading,
-                    onChange: (e) => handleAvailabilityToggle("out-of-stock", e.target.checked)
+                    onChange: (e) => setMinStockInput(e.target.value),
+                    onBlur: () => commitMinStockInput(),
+                    onKeyDown: (e) => {
+                      if (e.key === "Enter") e.target.blur();
+                    }
                   }
                 ),
-                /* @__PURE__ */ jsx("span", { className: "propeller-grid-filters__option-label flex-1 text-sm text-muted-foreground leading-none select-none group-hover:text-foreground", children: getLabel(props.labels, "outOfStock", "Out of stock") })
-              ] })
-            ] })
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "propeller-grid-filters__quantity-increase h-full w-8 flex items-center justify-center text-muted-foreground disabled:opacity-40 disabled:cursor-not-allowed hover:bg-accent hover:text-foreground transition-colors",
+                    "aria-label": getLabel(props.labels, "quantityIncrease", "Increase quantity"),
+                    disabled: !!props.isLoading,
+                    onClick: () => handleMinStockChange(minStock + 1),
+                    children: "+"
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsx("span", { children: getLabel(props.labels, "pcs", "pcs") })
+            ] }) : null
           ] }),
           /* @__PURE__ */ jsx("div", { className: "propeller-grid-filters__divider h-px bg-border-subtle" })
         ] }) : null,
@@ -9797,7 +9868,6 @@ var DEFAULT_LABELS = {
   perPage: " per page",
   price: "Price",
   inStock: "In stock",
-  outOfStock: "Out of stock",
   switchToList: "Switch to list view",
   switchToGrid: "Switch to grid view"
 };
@@ -9826,7 +9896,7 @@ function GridToolbar(rawProps) {
     const text = props.activeTextFilters || {};
     const hasText = Object.keys(text).some((k) => (text[k] || []).length > 0);
     const hasPrice = props.priceFilterMin !== void 0 || props.priceFilterMax !== void 0;
-    const hasAvailability = (props.availability || []).length > 0;
+    const hasAvailability = props.availability === "in-stock";
     return hasText || hasPrice || hasAvailability;
   }
   function getActiveFilterBadges() {
@@ -9845,8 +9915,10 @@ function GridToolbar(rawProps) {
   function isPriceSortDisabled() {
     return isContentHidden(props.portalMode, props.user);
   }
-  function getAvailabilityLabel(value) {
-    return value === "in-stock" ? getLabel56("inStock") : getLabel56("outOfStock");
+  function getAvailabilityLabel() {
+    const qty = props.minStock;
+    if (qty !== void 0 && qty > MIN_STOCK_THRESHOLD) return `${getLabel56("inStock")}: ${qty}+`;
+    return getLabel56("inStock");
   }
   function handleSortFieldChange(field) {
     setCurrentSortField(field);
@@ -10021,20 +10093,19 @@ function GridToolbar(rawProps) {
               ]
             }
           ) : null,
-          (props.availability || []).map((value) => /* @__PURE__ */ jsxs(
+          props.availability === "in-stock" ? /* @__PURE__ */ jsxs(
             "span",
             {
               className: "propeller-grid-toolbar__filter-badge propeller-grid-toolbar__filter-badge--availability inline-flex items-center gap-1 cursor-pointer px-2.5 py-0.5 rounded-full text-xs font-semibold border border-input bg-background hover:bg-primary hover:text-primary-foreground hover:border-primary transition-colors",
               onClick: (event) => {
-                if (props.onAvailabilityFilterRemove) props.onAvailabilityFilterRemove(value);
+                if (props.onAvailabilityFilterRemove) props.onAvailabilityFilterRemove();
               },
               children: [
-                getAvailabilityLabel(value),
+                getAvailabilityLabel(),
                 /* @__PURE__ */ jsx("span", { className: "propeller-grid-toolbar__filter-badge-remove", children: "\xD7" })
               ]
-            },
-            value
-          )),
+            }
+          ) : null,
           getActiveFilterBadges()?.map((badge) => /* @__PURE__ */ jsxs(
             "span",
             {