@propeller-commerce/propeller-v2-react-ui 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -8,6 +8,47 @@ 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.13.0] - 2026-08-05
+
+### Added
+
+- **Availability filter on `<GridFilters>`** — an opt-in section below the
+  price block with two checkboxes, In stock and Out of stock, wired to the
+  server-side stock filter the SDK exposes on `CategoryProductSearchInput`.
+  New props: `showAvailabilityFilter` (defaults `false`),
+  `activeAvailability` and `onAvailabilityChange`. Nothing selected sends no
+  filter, so the default listing is unchanged.
+
+  Selecting both buckets means "in stock or out of stock", which is every
+  product. The filter has no OR operator and the union is the unfiltered set
+  anyway, so both-selected sends no filter — the same as selecting neither.
+  The checkboxes stay ticked; only the request collapses.
+
+  The mapping lives in `propeller-v2-core-ui`'s `buildInventoryFilter`, so
+  this package never restates the operator semantics. Requires
+  `propeller-v2-core-ui` >= 0.5.0 and `propeller-sdk-v2` >= 0.15.0, where the
+  inventory filter was added.
+
+- **`availability` and `onAvailabilityFilterRemove` on `<GridToolbar>`** —
+  the active-filter row now renders one removable chip per selected bucket,
+  so a stock-filtered listing shows why its results are narrowed and can be
+  undone from the results area. One chip per bucket, matching the attribute
+  chips rather than the price chip which covers a whole range. The row's
+  active check accounts for availability, so it appears when availability is
+  the only active filter.
+
+- **`availability` on `<ProductGrid>`** — forwards the selection to
+  `useProductSearch`, which applies it to both the grid fetch and the
+  typeahead preview. Filtering only the grid would let the preview offer
+  products the grid then hides.
+
+### Changed
+
+- The availability section is hidden for anonymous visitors in a semi-closed
+  portal, the same rule the price filter already follows. Hosts should pass
+  their own "show stock" setting through `showAvailabilityFilter`: filtering
+  by stock reads as broken when the cards display no stock to filter on.
+
 ## [0.12.0] - 2026-07-31
 
 ### Added

package/dist/index.cjs

@@ -2261,7 +2261,8 @@ function useProductSearch(options) {
       userKey,
       JSON.stringify(options.textFilters ?? []),
       options.priceFilterMin ?? "",
-      options.priceFilterMax ?? ""
+      options.priceFilterMax ?? "",
+      JSON.stringify(options.availability ?? [])
     ].join("|");
     if (inflightFetches2.has(inflightKey)) {
       fetchIdRef.current--;
@@ -2303,6 +2304,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 = propellerV2CoreUi.buildInventoryFilter(options.availability);
       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;
@@ -2325,6 +2327,7 @@ function useProductSearch(options) {
         ...options.brand && { manufacturers: [options.brand] },
         ...options.textFilters?.length && { textFilters: options.textFilters },
         ...priceFilter && { price: priceFilter },
+        ...inventoryFilter && { inventory: inventoryFilter },
         ...sortInputs.length && { sortInputs },
         ...options.companyId && { companyId: options.companyId },
         ...userId !== void 0 && { userId },
@@ -2401,6 +2404,7 @@ function useProductSearch(options) {
     options.textFilters,
     options.priceFilterMin,
     options.priceFilterMax,
+    options.availability,
     options.sortField,
     options.sortOrder,
     options.companyId,
@@ -2440,6 +2444,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 = propellerV2CoreUi.buildInventoryFilter(options.availability);
           const categoryProductSearchInput = {
             language,
             page: 1,
@@ -2451,6 +2456,7 @@ function useProductSearch(options) {
               propellerSdkV2.ProductStatus.S
             ],
             hidden: false,
+            ...inventoryFilter && { inventory: inventoryFilter },
             term,
             searchFields: [
               {
@@ -2530,6 +2536,7 @@ function useProductSearch(options) {
     JSON.stringify(options.textFilters),
     options.priceFilterMin,
     options.priceFilterMax,
+    options.availability,
     options.sortField,
     options.sortOrder,
     pageSize,
@@ -9052,6 +9059,7 @@ function ProductGrid(rawProps) {
     textFilters: props.textFilters,
     priceFilterMin: props.priceFilterMin,
     priceFilterMax: props.priceFilterMax,
+    availability: props.availability,
     sortField: props.sortField,
     sortOrder: props.sortOrder,
     pageSize: props.pageSize,
@@ -9354,11 +9362,18 @@ function GridFilters(rawProps) {
   const [isPending, setIsPending] = React6.useState(() => false);
   const [appliedMin, setAppliedMin] = React6.useState(() => void 0);
   const [appliedMax, setAppliedMax] = React6.useState(() => void 0);
+  const [availability, setAvailability] = React6.useState(
+    () => [...props.activeAvailability || []]
+  );
   function showPriceFilter() {
     const mode = props.portalMode || "open";
     if (mode === "open") return true;
     return !!props.user;
   }
+  function showAvailability() {
+    if (!props.showAvailabilityFilter) return false;
+    return !propellerV2CoreUi.isContentHidden(props.portalMode, props.user);
+  }
   function getFilterName(filter) {
     return filter?.attributeDescription?.name || "";
   }
@@ -9403,6 +9418,13 @@ 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);
+    setIsPending(true);
+    if (props.onAvailabilityChange) props.onAvailabilityChange(next);
+    if (props.getSelectedFilters) props.getSelectedFilters();
+  }
   function handleMinChange(value) {
     const n = value > currentMax ? currentMax : value;
     setCurrentMin(n);
@@ -9476,11 +9498,16 @@ function GridFilters(rawProps) {
     setCurrentMin(props.priceMin || 0);
     setCurrentMax(props.priceMax || 9999);
     setExpandedFilters({});
+    setAvailability([]);
   }, [props.clearSignal, props.priceMin, props.priceMax]);
   React6.useEffect(() => {
     if (!props.activeTextFilters) return;
     setSelectedFilters(props.activeTextFilters);
   }, [props.activeTextFilters]);
+  React6.useEffect(() => {
+    if (!props.activeAvailability) return;
+    setAvailability([...props.activeAvailability]);
+  }, [props.activeAvailability]);
   React6.useEffect(() => {
     if (props.activePriceMin === void 0 && props.activePriceMax === void 0) {
       setCurrentMin(props.priceMin || 0);
@@ -9580,6 +9607,40 @@ function GridFilters(rawProps) {
           " ",
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "propeller-grid-filters__divider h-px bg-border-subtle" })
         ] }) : null,
+        showAvailability() ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-grid-filters__availability space-y-3", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "propeller-grid-filters__availability-title text-xs font-semibold uppercase tracking-wide text-muted-foreground", children: propellerV2CoreUi.getLabel(props.labels, "availability", "Availability") }),
+            /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-grid-filters__availability-options space-y-1.5", children: [
+              /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "propeller-grid-filters__option flex items-center gap-2 cursor-pointer group", children: [
+                /* @__PURE__ */ jsxRuntime.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("in-stock"),
+                    disabled: !!props.isLoading,
+                    onChange: (e) => handleAvailabilityToggle("in-stock", e.target.checked)
+                  }
+                ),
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "propeller-grid-filters__option-label flex-1 text-sm text-muted-foreground leading-none select-none group-hover:text-foreground", children: propellerV2CoreUi.getLabel(props.labels, "inStock", "In stock") })
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "propeller-grid-filters__option flex items-center gap-2 cursor-pointer group", children: [
+                /* @__PURE__ */ jsxRuntime.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"),
+                    disabled: !!props.isLoading,
+                    onChange: (e) => handleAvailabilityToggle("out-of-stock", e.target.checked)
+                  }
+                ),
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "propeller-grid-filters__option-label flex-1 text-sm text-muted-foreground leading-none select-none group-hover:text-foreground", children: propellerV2CoreUi.getLabel(props.labels, "outOfStock", "Out of stock") })
+              ] })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "propeller-grid-filters__divider h-px bg-border-subtle" })
+        ] }) : null,
         props.filters.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "propeller-grid-filters__empty text-sm text-foreground-subtle italic", children: propellerV2CoreUi.getLabel(props.labels, "noFiltersAvailable", "No filters available") }) : null,
         getFilteredFilters()?.map((filter) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "propeller-grid-filters__group border-b border-border-subtle pb-3 last:border-b-0", "data-expanded": isExpanded(getFilterName(filter)) ? "true" : "false", children: [
           /* @__PURE__ */ jsxRuntime.jsxs(
@@ -9755,6 +9816,8 @@ var DEFAULT_LABELS = {
   results: "results",
   perPage: " per page",
   price: "Price",
+  inStock: "In stock",
+  outOfStock: "Out of stock",
   switchToList: "Switch to list view",
   switchToGrid: "Switch to grid view"
 };
@@ -9783,7 +9846,8 @@ 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;
-    return hasText || hasPrice;
+    const hasAvailability = (props.availability || []).length > 0;
+    return hasText || hasPrice || hasAvailability;
   }
   function getActiveFilterBadges() {
     const text = props.activeTextFilters || {};
@@ -9801,6 +9865,9 @@ function GridToolbar(rawProps) {
   function isPriceSortDisabled() {
     return propellerV2CoreUi.isContentHidden(props.portalMode, props.user);
   }
+  function getAvailabilityLabel(value) {
+    return value === "in-stock" ? getLabel56("inStock") : getLabel56("outOfStock");
+  }
   function handleSortFieldChange(field) {
     setCurrentSortField(field);
     if (props.onSortChange) props.onSortChange(field, currentSortOrder);
@@ -9974,6 +10041,20 @@ function GridToolbar(rawProps) {
               ]
             }
           ) : null,
+          (props.availability || []).map((value) => /* @__PURE__ */ jsxRuntime.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);
+              },
+              children: [
+                getAvailabilityLabel(value),
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "propeller-grid-toolbar__filter-badge-remove", children: "\xD7" })
+              ]
+            },
+            value
+          )),
           getActiveFilterBadges()?.map((badge) => /* @__PURE__ */ jsxRuntime.jsxs(
             "span",
             {