@jay-framework/wix-stores 0.15.4 → 0.15.6

package/dist/index.client.js

@@ -301,6 +301,7 @@ function ProductPageInteractive(props, refs, viewStateSignals, fastCarryForward,
         quantity: quantity()
       },
       actionsEnabled: computedActionsEnabled,
+      isAddingToCart,
       options,
       modifiers,
       mediaGallery: interactiveMedia,
@@ -313,6 +314,11 @@ function ProductPageInteractive(props, refs, viewStateSignals, fastCarryForward,
   };
 }
 const productPage = makeJayStackComponent().withProps().withContexts(WIX_STORES_CONTEXT).withInteractive(ProductPageInteractive);
+var OptionRenderType = /* @__PURE__ */ ((OptionRenderType2) => {
+  OptionRenderType2[OptionRenderType2["TEXT_CHOICES"] = 0] = "TEXT_CHOICES";
+  OptionRenderType2[OptionRenderType2["SWATCH_CHOICES"] = 1] = "SWATCH_CHOICES";
+  return OptionRenderType2;
+})(OptionRenderType || {});
 var CurrentSort = /* @__PURE__ */ ((CurrentSort2) => {
   CurrentSort2[CurrentSort2["relevance"] = 0] = "relevance";
   CurrentSort2[CurrentSort2["priceAsc"] = 1] = "priceAsc";
@@ -369,6 +375,15 @@ function updateUrlFilters(searchTerm, filters, sort, categories) {
   }
   if (filters.inStockOnly)
     params.set("inStock", "1");
+  const optSegments = [];
+  for (const opt of filters.optionFilters || []) {
+    const selected = opt.choices.filter((c) => c.isSelected).map((c) => encodeURIComponent(c.choiceName));
+    if (selected.length > 0) {
+      optSegments.push(`${encodeURIComponent(opt.optionName)}:${selected.join(",")}`);
+    }
+  }
+  if (optSegments.length > 0)
+    params.set("opt", optSegments.join(";"));
   if (sort !== CurrentSort.relevance) {
     const sortNames = {
       [CurrentSort.priceAsc]: "priceAsc",
@@ -384,6 +399,30 @@ function updateUrlFilters(searchTerm, filters, sort, categories) {
   const query = params.toString();
   window.history.replaceState(null, "", query ? `?${query}` : window.location.pathname);
 }
+function buildOptionFiltersViewState(baseOptionFilters, filteredResult, optionSelections) {
+  const filteredChoiceCounts = /* @__PURE__ */ new Map();
+  for (const opt of filteredResult.optionFilters || []) {
+    for (const ch of opt.choices) {
+      filteredChoiceCounts.set(ch.choiceName.toLowerCase(), ch.productCount);
+    }
+  }
+  return baseOptionFilters.map((opt) => ({
+    optionId: opt.optionId,
+    optionName: opt.optionName,
+    optionRenderType: opt.optionRenderType === "SWATCH_CHOICES" ? OptionRenderType.SWATCH_CHOICES : OptionRenderType.TEXT_CHOICES,
+    choices: opt.choices.map((ch) => {
+      const count = filteredChoiceCounts.get(ch.choiceName.toLowerCase()) ?? 0;
+      return {
+        choiceId: ch.choiceId,
+        choiceName: ch.choiceName,
+        colorCode: ch.colorCode,
+        productCount: count,
+        isSelected: optionSelections.get(opt.optionName)?.has(ch.choiceName) ?? false,
+        isDisabled: count === 0
+      };
+    })
+  }));
+}
 function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForward, storesContext) {
   const baseCategoryId = fastCarryForward.baseCategoryId;
   const variantStockCache = {};
@@ -394,19 +433,41 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
   let debounceTimeout = null;
   let searchVersion = 0;
   const DEBOUNCE_MS = 300;
+  const [latestSearchResult, setLatestSearchResult] = createSignal(null);
+  const mergedFilters = createMemo(() => {
+    const f = filters();
+    const result = latestSearchResult();
+    if (!result)
+      return f;
+    const selections = /* @__PURE__ */ new Map();
+    for (const opt of f.optionFilters || []) {
+      const selected = opt.choices.filter((c) => c.isSelected).map((c) => c.choiceName);
+      if (selected.length > 0)
+        selections.set(opt.optionName, new Set(selected));
+    }
+    return {
+      ...f,
+      optionFilters: buildOptionFiltersViewState(fastCarryForward.baseOptionFilters, result, selections)
+    };
+  });
   const performSearch = async (version, searchTerm, currentFilters, currentSort) => {
     setIsSearching(true);
     setHasSearched(true);
     try {
       const userSelectedCategoryIds = currentFilters.categoryFilter.categories.filter((c) => c.isSelected).map((c) => c.categoryId);
       const categoryIds = baseCategoryId ? [baseCategoryId, ...userSelectedCategoryIds] : userSelectedCategoryIds;
+      const activeOptionFilters = (currentFilters.optionFilters || []).map((opt) => ({
+        optionName: opt.optionName,
+        choiceNames: opt.choices.filter((c) => c.isSelected).map((c) => c.choiceName)
+      })).filter((o) => o.choiceNames.length > 0);
       const result = await searchProducts({
         query: searchTerm || "",
         filters: {
           minPrice: currentFilters.priceRange.minPrice || void 0,
           maxPrice: currentFilters.priceRange.maxPrice || void 0,
           categoryIds,
-          inStockOnly: currentFilters.inStockOnly
+          inStockOnly: currentFilters.inStockOnly,
+          optionFilters: activeOptionFilters.length > 0 ? activeOptionFilters : void 0
         },
         sortBy: mapSortToAction(currentSort),
         // No cursor = start from beginning
@@ -421,6 +482,7 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       setLoadedCount(result.products.length);
       setHasMore(result.hasMore);
       setHasResults(result.products.length > 0);
+      setLatestSearchResult(result);
       currentCursor = result.nextCursor;
       updateUrlFilters(searchTerm, currentFilters, currentSort, fastCarryForward.categories);
     } catch (error) {
@@ -443,13 +505,18 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       const searchTerm = submittedSearchTerm();
       const userSelectedCategoryIds = currentFilters.categoryFilter.categories.filter((c) => c.isSelected).map((c) => c.categoryId);
       const categoryIds = baseCategoryId ? [baseCategoryId, ...userSelectedCategoryIds] : userSelectedCategoryIds;
+      const activeOptionFilters = (currentFilters.optionFilters || []).map((opt) => ({
+        optionName: opt.optionName,
+        choiceNames: opt.choices.filter((c) => c.isSelected).map((c) => c.choiceName)
+      })).filter((o) => o.choiceNames.length > 0);
       const result = await searchProducts({
         query: searchTerm || "",
         filters: {
           minPrice: currentFilters.priceRange.minPrice || void 0,
           maxPrice: currentFilters.priceRange.maxPrice || void 0,
           categoryIds,
-          inStockOnly: currentFilters.inStockOnly
+          inStockOnly: currentFilters.inStockOnly,
+          optionFilters: activeOptionFilters.length > 0 ? activeOptionFilters : void 0
         },
         sortBy: mapSortToAction(currentSort),
         cursor: currentCursor,
@@ -564,6 +631,24 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
     const isChecked = event.target.checked;
     setFilters(patch(filters(), [{ op: REPLACE, path: ["inStockOnly"], value: isChecked }]));
   });
+  refs.filters.optionFilters.choices.isSelected.oninput(({ event, coordinate }) => {
+    const [optionId, choiceId] = coordinate;
+    const currentFilters = filters();
+    const optionIndex = currentFilters.optionFilters.findIndex((o) => o.optionId === optionId);
+    if (optionIndex === -1)
+      return;
+    const choiceIndex = currentFilters.optionFilters[optionIndex].choices.findIndex((c) => c.choiceId === choiceId);
+    if (choiceIndex === -1)
+      return;
+    const isChecked = event.target.checked;
+    setFilters(patch(currentFilters, [
+      {
+        op: REPLACE,
+        path: ["optionFilters", optionIndex, "choices", choiceIndex, "isSelected"],
+        value: isChecked
+      }
+    ]));
+  });
   refs.filters.clearFilters.onclick(() => {
     const currentFilters = filters();
     const clearedCategories = currentFilters.categoryFilter.categories.map((cat) => ({
@@ -575,6 +660,10 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       isSelected: i === 0
       // First one is "Show all"
     }));
+    const clearedOptionFilters = (currentFilters.optionFilters || []).map((opt) => ({
+      ...opt,
+      choices: opt.choices.map((ch) => ({ ...ch, isSelected: false }))
+    }));
     setFilters({
       priceRange: {
         minPrice: 0,
@@ -584,7 +673,8 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
         ranges: clearedRanges
       },
       categoryFilter: { categories: clearedCategories },
-      inStockOnly: false
+      inStockOnly: false,
+      optionFilters: clearedOptionFilters
     });
   });
   refs.loadMoreButton.onclick(() => {
@@ -617,48 +707,48 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       ]));
     }
   });
+  const variantStockLoading = /* @__PURE__ */ new Set();
   const loadVariantStock = async (productId) => {
-    if (variantStockCache[productId])
-      return;
-    const stockMap = await getVariantStock({ productId });
-    variantStockCache[productId] = stockMap;
-    const currentResults = searchResults();
-    const productIndex = currentResults.findIndex((p) => p._id === productId);
-    if (productIndex === -1)
-      return;
-    const product = currentResults[productIndex];
-    if (product.quickAddType !== QuickAddType.COLOR_AND_TEXT_OPTIONS)
+    if (variantStockCache[productId] || variantStockLoading.has(productId))
       return;
-    const selectedColor = product.quickOption?.choices?.find((c) => c.isSelected);
-    const textChoices = product.secondQuickOption?.choices;
-    if (!selectedColor || !textChoices)
-      return;
-    const colorStock = stockMap[selectedColor.choiceId];
-    const updatedTextChoices = textChoices.map((c) => ({
-      ...c,
-      inStock: colorStock?.[c.choiceId] ?? false
-    }));
-    setSearchResults(patch(searchResults(), [
-      {
-        op: REPLACE,
-        path: [productIndex, "secondQuickOption", "choices"],
-        value: updatedTextChoices
-      }
-    ]));
+    variantStockLoading.add(productId);
+    try {
+      const currentResults = searchResults();
+      const productIndex = currentResults.findIndex((p) => p._id === productId);
+      if (productIndex === -1)
+        return;
+      const product = currentResults[productIndex];
+      if (product?.quickAddType !== QuickAddType.COLOR_AND_TEXT_OPTIONS)
+        return;
+      const stockMap = await getVariantStock({ productId });
+      variantStockCache[productId] = stockMap;
+      const selectedColor = product.quickOption?.choices?.find((c) => c.isSelected);
+      const textChoices = product.secondQuickOption?.choices;
+      if (!selectedColor || !textChoices)
+        return;
+      const colorStock = stockMap[selectedColor.choiceId];
+      const updatedTextChoices = textChoices.map((c) => ({
+        ...c,
+        inStock: colorStock?.[c.choiceId] ?? false
+      }));
+      setSearchResults(patch(searchResults(), [
+        {
+          op: REPLACE,
+          path: [productIndex, "secondQuickOption", "choices"],
+          value: updatedTextChoices
+        }
+      ]));
+    } finally {
+      variantStockLoading.delete(productId);
+    }
   };
   refs.searchResults.productLink.onmouseenter(({ coordinate }) => {
     const [productId] = coordinate;
-    const product = searchResults().find((p) => p._id === productId);
-    if (product?.quickAddType === QuickAddType.COLOR_AND_TEXT_OPTIONS) {
-      loadVariantStock(productId);
-    }
+    loadVariantStock(productId);
   });
   refs.searchResults.quickOption.choices.choiceButton.onmouseenter(({ coordinate }) => {
     const [productId] = coordinate;
-    const product = searchResults().find((p) => p._id === productId);
-    if (product?.quickAddType === QuickAddType.COLOR_AND_TEXT_OPTIONS) {
-      loadVariantStock(productId);
-    }
+    loadVariantStock(productId);
   });
   refs.searchResults.quickOption.choices.choiceButton.onclick(async ({ coordinate }) => {
     const [productId, choiceId] = coordinate;
@@ -763,6 +853,10 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       ]));
     }
   });
+  refs.searchResults.secondQuickOption.choices.choiceButton.onmouseenter(({ coordinate }) => {
+    const [productId] = coordinate;
+    loadVariantStock(productId);
+  });
   refs.searchResults.viewOptionsButton.onclick(({ coordinate }) => {
     const [productId] = coordinate;
     const product = searchResults().find((p) => p._id === productId);
@@ -780,7 +874,7 @@ function ProductSearchInteractive(props, refs, viewStateSignals, fastCarryForwar
       hasResults: hasResults(),
       hasSuggestions: hasSuggestions(),
       suggestions: suggestions(),
-      filters: filters(),
+      filters: mergedFilters(),
       sortBy: sortBy(),
       hasMore: hasMore(),
       loadedCount: loadedCount(),

package/dist/index.d.ts

@@ -7,14 +7,14 @@ import * as _jay_framework_runtime from '@jay-framework/runtime';
 import { HTMLElementCollectionProxy, HTMLElementProxy } from '@jay-framework/runtime';
 import { WixClient } from '@wix/sdk';
 import { BuildDescriptors } from '@wix/sdk-types';
-import { productsV3, inventoryItemsV3 } from '@wix/stores';
+import { productsV3, inventoryItemsV3, customizationsV3 } from '@wix/stores';
 import { categories } from '@wix/categories';
-import { currentCart } from '@wix/ecom';
+import { Customization } from '@wix/auto_sdk_stores_customizations-v-3';
 import { Getter } from '@jay-framework/reactive';
 import { OptionChoice } from '@wix/auto_sdk_stores_products-v-3';
 import { PluginSetupContext, PluginSetupResult, PluginReferencesContext, PluginReferencesResult } from '@jay-framework/stack-server-runtime';
 
-declare enum OptionRenderType$1 {
+declare enum OptionRenderType$2 {
   TEXT_CHOICES,
   COLOR_SWATCH_CHOICES
 }
@@ -36,7 +36,7 @@ interface ChoiceOfProductOptionsViewState {
 interface ProductOptionsViewState {
   _id: string,
   name: string,
-  optionRenderType: OptionRenderType$1,
+  optionRenderType: OptionRenderType$2,
   choices: Array<ChoiceOfProductOptionsViewState>
 }
 
@@ -164,10 +164,32 @@ interface CategoryFilterOfFilterOfProductSearchViewState {
   categories: Array<CategoryOfCategoryFilterOfFilterOfProductSearchViewState>
 }
 
+declare enum OptionRenderType$1 {
+  TEXT_CHOICES,
+  SWATCH_CHOICES
+}
+
+interface ChoiceOfOptionFilterOfFilterOfProductSearchViewState {
+  choiceId: string,
+  choiceName: string,
+  colorCode: string,
+  productCount: number,
+  isSelected: boolean,
+  isDisabled: boolean
+}
+
+interface OptionFilterOfFilterOfProductSearchViewState {
+  optionId: string,
+  optionName: string,
+  optionRenderType: OptionRenderType$1,
+  choices: Array<ChoiceOfOptionFilterOfFilterOfProductSearchViewState>
+}
+
 interface FilterOfProductSearchViewState {
   priceRange: PriceRangeOfFilterOfProductSearchViewState,
   categoryFilter: CategoryFilterOfFilterOfProductSearchViewState,
-  inStockOnly: boolean
+  inStockOnly: boolean,
+  optionFilters: Array<OptionFilterOfFilterOfProductSearchViewState>
 }
 
 declare enum CurrentSort {
@@ -275,6 +297,7 @@ type ProductSearchFastViewState = Pick<ProductSearchViewState, 'searchExpression
     categoryFilter: {
     categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
 };
+    optionFilters: Array<ProductSearchViewState['filters']['optionFilters'][number]>;
 };
     sortBy: ProductSearchViewState['sortBy'];
     suggestions: Array<ProductSearchViewState['suggestions'][number]>;
@@ -287,6 +310,7 @@ type ProductSearchInteractiveViewState = Pick<ProductSearchViewState, 'searchExp
     categoryFilter: {
     categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
 };
+    optionFilters: Array<ProductSearchViewState['filters']['optionFilters'][number]>;
 };
     sortBy: ProductSearchViewState['sortBy'];
     suggestions: Array<ProductSearchViewState['suggestions'][number]>;
@@ -313,6 +337,11 @@ interface ProductSearchRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {
@@ -390,14 +419,15 @@ interface WixStoresService {
     products: BuildDescriptors<typeof productsV3, {}>;
     categories: BuildDescriptors<typeof categories, {}>;
     inventory: BuildDescriptors<typeof inventoryItemsV3, {}>;
-    /** @deprecated Use WIX_CART_SERVICE from @jay-framework/wix-cart instead */
-    cart: BuildDescriptors<typeof currentCart, {}>;
+    customizations: BuildDescriptors<typeof customizationsV3, {}>;
     /** URL templates for building canonical links */
     urls: UrlTemplates;
     /** Slug of the fallback category for pages without category context */
     defaultCategory: string | null;
     /** Get the cached category tree. Lazily built on first call. */
     getCategoryTree(): Promise<CategoryTree>;
+    /** Get cached product customizations (options with choices). Lazily loaded. */
+    getCustomizations(): Promise<Customization[]>;
 }
 /**
  * Server service marker for Wix Stores.
@@ -473,6 +503,53 @@ interface WixStoresContext {
  */
 declare const WIX_STORES_CONTEXT: _jay_framework_runtime.ContextMarker<WixStoresContext>;
 
+interface SearchProductsInput {
+  query: string;
+  filters?: {
+    inStockOnly?: boolean;
+    minPrice?: number;
+    maxPrice?: number;
+    categoryIds?: Array<string>;
+    optionFilters?: Array<{
+        optionName: string;
+        choiceNames: Array<string>;
+      }>;
+  };
+  sortBy?: 'relevance' | 'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'newest';
+  cursor?: string;
+  pageSize?: number;
+}
+
+interface SearchProductsOutput {
+  products: Array<ProductCardViewState>;
+  totalCount: number;
+  nextCursor?: string;
+  hasMore: boolean;
+  priceAggregation?: {
+    minBound: number;
+    maxBound: number;
+    ranges: Array<{
+        rangeId: string;
+        label: string;
+        minValue?: number;
+        maxValue?: number;
+        productCount: number;
+        isSelected: boolean;
+      }>;
+  };
+  optionFilters?: Array<{
+      optionId: string;
+      optionName: string;
+      optionRenderType: 'TEXT_CHOICES' | 'SWATCH_CHOICES';
+      choices: Array<{
+          choiceId: string;
+          choiceName: string;
+          colorCode: string;
+          productCount: number;
+        }>;
+    }>;
+}
+
 /**
  * URL parameters for product search routes.
  * Supports: category (prefix slug), subcategory (sub-category slug).
@@ -483,10 +560,6 @@ interface ProductSearchParams extends UrlParams {
     /** Sub-category slug (e.g., 'shirts'). Further scopes within the category. */
     subcategory?: string;
 }
-/**
- * Search sort options
- */
-type SearchSortOption = 'relevance' | 'priceAsc' | 'priceDesc' | 'newest' | 'nameAsc' | 'nameDesc';
 /**
  * Category info carried forward from slow to fast phase
  */
@@ -500,6 +573,10 @@ interface SearchSlowCarryForward {
     categories: CategoryInfos;
     /** Root category ID when scoped to a category prefix (always applied, hidden from UI) */
     baseCategoryId: string | null;
+    /** Pre-loaded product results from slow phase (used when no query params) */
+    preloadedResult: SearchProductsOutput | null;
+    /** Base option filters from unfiltered search (static list, counts updated per search) */
+    baseOptionFilters: SearchProductsOutput['optionFilters'];
 }
 /**
  * Data carried forward from fast rendering to interactive phase
@@ -510,6 +587,8 @@ interface SearchFastCarryForward {
     categories: CategoryInfos;
     /** Root category ID when scoped to a category prefix (always applied, hidden from UI) */
     baseCategoryId: string | null;
+    /** Base option filters from unfiltered search (static list structure) */
+    baseOptionFilters: SearchProductsOutput['optionFilters'];
 }
 declare const productSearch: _jay_framework_fullstack_component.JayStackComponentDefinition<ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState, [SearchSlowCarryForward, WixStoresService], [Signals<ProductSearchFastViewState>, SearchFastCarryForward, WixStoresContext], PageProps & ProductSearchParams, ProductSearchParams, _jay_framework_component.JayComponentCore<PageProps & ProductSearchParams, ProductSearchInteractiveViewState>>;
 
@@ -627,40 +706,6 @@ interface ModifierOfProductPageViewState {
   choices: Array<ChoiceOfModifierOfProductPageViewState>
 }
 
-interface PropOfTagOfSeoDatumOfProductPageViewState {
-  key: string,
-  value: string
-}
-
-interface MetaOfTagOfSeoDatumOfProductPageViewState {
-  key: string,
-  value: string
-}
-
-interface TagOfSeoDatumOfProductPageViewState {
-  position: string,
-  type: string,
-  props: Array<PropOfTagOfSeoDatumOfProductPageViewState>,
-  meta: Array<MetaOfTagOfSeoDatumOfProductPageViewState>,
-  children: string
-}
-
-interface KeywordOfSettingOfSeoDatumOfProductPageViewState {
-  term: string,
-  isMain: boolean,
-  origin: string
-}
-
-interface SettingOfSeoDatumOfProductPageViewState {
-  preventAutoRedirect: boolean,
-  keywords: Array<KeywordOfSettingOfSeoDatumOfProductPageViewState>
-}
-
-interface SeoDatumOfProductPageViewState {
-  tags: Array<TagOfSeoDatumOfProductPageViewState>,
-  settings: SettingOfSeoDatumOfProductPageViewState
-}
-
 interface ProductPageViewState {
   _id: string,
   productName: string,
@@ -676,10 +721,10 @@ interface ProductPageViewState {
   stockStatus: StockStatus,
   quantity: QuantityOfProductPageViewState,
   actionsEnabled: boolean,
+  isAddingToCart: boolean,
   options: Array<OptionOfProductPageViewState>,
   infoSections: Array<InfoSectionOfProductPageViewState>,
-  modifiers: Array<ModifierOfProductPageViewState>,
-  seoData: SeoDatumOfProductPageViewState
+  modifiers: Array<ModifierOfProductPageViewState>
 }
 
 type ProductPageSlowViewState = Pick<ProductPageViewState, '_id' | 'productName' | 'description' | 'brand' | 'ribbon' | 'productType'> & {
@@ -690,10 +735,9 @@ type ProductPageSlowViewState = Pick<ProductPageViewState, '_id' | 'productName'
     modifiers: Array<Pick<ProductPageViewState['modifiers'][number], '_id' | 'name' | 'modifierType' | 'textInputLength' | 'textInputRequired'> & {
     choices: Array<Pick<ProductPageViewState['modifiers'][number]['choices'][number], 'choiceId' | 'choiceType' | 'name' | 'colorCode'>>;
 }>;
-    seoData: ProductPageViewState['seoData'];
 };
 
-type ProductPageFastViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled'> & {
+type ProductPageFastViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled' | 'isAddingToCart'> & {
     mediaGallery: ProductPageViewState['mediaGallery'];
     quantity: ProductPageViewState['quantity'];
     options: Array<Pick<ProductPageViewState['options'][number], '_id' | 'textChoiceSelection'> & {
@@ -704,7 +748,7 @@ type ProductPageFastViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'st
 }>;
 };
 
-type ProductPageInteractiveViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled'> & {
+type ProductPageInteractiveViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled' | 'isAddingToCart'> & {
     mediaGallery: ProductPageViewState['mediaGallery'];
     quantity: ProductPageViewState['quantity'];
     options: Array<Pick<ProductPageViewState['options'][number], '_id' | 'textChoiceSelection'> & {
@@ -821,6 +865,14 @@ interface CategoryListRefs {
   }
 }
 
+/**
+ * URL parameters for category list.
+ * Supports optional parentCategory to scope the list to direct children.
+ */
+interface CategoryListParams extends UrlParams {
+    /** Parent category slug. When set, only direct children of this category are shown. */
+    parentCategory?: string;
+}
 /**
  * Category List Full-Stack Component
  *
@@ -846,86 +898,17 @@ interface CategoryListRefs {
  * </div>
  * ```
  */
-declare const categoryList: _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & {
-    withFastRender<NewCarryForward extends object>(fastRender: _jay_framework_fullstack_component.RenderFast<[Record<string, never>, WixStoresService], PageProps, CategoryListFastViewState, NewCarryForward>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & {
-        withClientDefaults(fn: (props: PageProps) => {
+declare const categoryList: _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [], PageProps & CategoryListParams, {}, _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>> & {
+    withFastRender<NewCarryForward extends object>(fastRender: _jay_framework_fullstack_component.RenderFast<[Record<string, never>, WixStoresService], PageProps & CategoryListParams, CategoryListFastViewState, NewCarryForward>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps & CategoryListParams, {}, _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>> & {
+        withClientDefaults(fn: (props: PageProps & CategoryListParams) => {
             viewState: CategoryListFastViewState;
             carryForward?: any;
-        }): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & /*elided*/ any;
-        withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps, CategoryListRefs, CategoryListInteractiveViewState, [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>;
+        }): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps & CategoryListParams, {}, _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>> & /*elided*/ any;
+        withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps & CategoryListParams, CategoryListRefs, CategoryListInteractiveViewState, [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps & CategoryListParams, {}, _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>>;
     };
-    withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps, CategoryListRefs, CategoryListInteractiveViewState, [], _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>;
+    withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps & CategoryListParams, CategoryListRefs, CategoryListInteractiveViewState, [], _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresService], [], PageProps & CategoryListParams, {}, _jay_framework_component.JayComponentCore<PageProps & CategoryListParams, CategoryListInteractiveViewState>>;
 };
 
-/**
- * Sort options for product search
- */
-type ProductSortField = 'relevance' | 'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'newest';
-/**
- * Product search filters
- */
-interface ProductSearchFilters {
-    /** Only show products in stock */
-    inStockOnly?: boolean;
-    /** Minimum price filter */
-    minPrice?: number;
-    /** Maximum price filter */
-    maxPrice?: number;
-    /** Filter by category IDs */
-    categoryIds?: string[];
-}
-/**
- * Price range bucket for aggregation
- */
-interface PriceRangeBucket {
-    rangeId: string;
-    label: string;
-    minValue: number | null;
-    maxValue: number | null;
-    productCount: number;
-    isSelected: boolean;
-}
-/**
- * Price aggregation data from search
- */
-interface PriceAggregationData {
-    /** Minimum price across all products */
-    minBound: number;
-    /** Maximum price across all products */
-    maxBound: number;
-    /** Price range buckets with product counts */
-    ranges: PriceRangeBucket[];
-}
-/**
- * Input for searchProducts action
- */
-interface SearchProductsInput {
-    /** Search query text */
-    query: string;
-    /** Filters to apply */
-    filters?: ProductSearchFilters;
-    /** Sort order */
-    sortBy?: ProductSortField;
-    /** Cursor for pagination (from previous response's nextCursor) */
-    cursor?: string;
-    /** Items per page (default: 12) */
-    pageSize?: number;
-}
-/**
- * Output for searchProducts action
- */
-interface SearchProductsOutput {
-    /** List of matching products */
-    products: ProductCardViewState[];
-    /** Total number of matching products */
-    totalCount: number;
-    /** Cursor for next page (null if no more results) */
-    nextCursor: string | null;
-    /** Whether there are more results */
-    hasMore: boolean;
-    /** Price aggregation data (bounds and ranges) */
-    priceAggregation?: PriceAggregationData;
-}
 /**
  * Input for getProductBySlug action
  */
@@ -1007,4 +990,4 @@ declare function setupWixStores(ctx: PluginSetupContext): Promise<PluginSetupRes
  */
 declare function generateWixStoresReferences(ctx: PluginReferencesContext): Promise<PluginReferencesResult>;
 
-export { type CategoryTree, type GetProductBySlugInput, type PriceAggregationData, type PriceRangeBucket, type ProductPageParams, type ProductSearchFilters, type ProductSearchParams, type ProductSortField, type SearchProductsInput, type SearchProductsOutput, type SearchSortOption, WIX_STORES_CONTEXT, WIX_STORES_SERVICE_MARKER, type WixStoresContext, type WixStoresInitData, type WixStoresService, type WixStoresServiceOptions, buildCategoryUrl, buildProductUrl, categoryList, findCategoryImage, findRootCategoryId, findRootCategorySlug, generateWixStoresReferences, getCategories, getProductBySlug, getVariantStock, init, productPage, productSearch, provideWixStoresService, searchProducts, setupWixStores };
+export { type CategoryListParams, type CategoryTree, type GetProductBySlugInput, type ProductPageParams, type ProductSearchParams, WIX_STORES_CONTEXT, WIX_STORES_SERVICE_MARKER, type WixStoresContext, type WixStoresInitData, type WixStoresService, type WixStoresServiceOptions, buildCategoryUrl, buildProductUrl, categoryList, findCategoryImage, findRootCategoryId, findRootCategorySlug, generateWixStoresReferences, getCategories, getProductBySlug, getVariantStock, init, productPage, productSearch, provideWixStoresService, searchProducts, setupWixStores };