@jay-framework/wix-stores 0.15.1 → 0.15.5

package/dist/contracts/product-search.jay-contract

@@ -168,6 +168,11 @@ tags:
                 dataType: boolean
                 elementType: HTMLInputElement
                 description: Category checkbox
+
+              - tag: categoryUrl
+                type: data
+                dataType: string
+                description: Deep-link URL to this category's dedicated page
       
       # Availability filter (fast+interactive)
       - tag: inStockOnly
@@ -175,7 +180,69 @@ tags:
         dataType: boolean
         elementType: HTMLInputElement
         description: Show only in-stock products checkbox
-        
+
+      # Option-based filters (e.g., Color, Size)
+      - tag: optionFilters
+        type: sub-contract
+        repeated: true
+        trackBy: optionId
+        phase: fast+interactive
+        description: Filter by product options (e.g., Color, Size)
+        tags:
+          - tag: optionId
+            type: data
+            dataType: string
+            description: Customization ID
+
+          - tag: optionName
+            type: data
+            dataType: string
+            description: Option display name (e.g., Color, Size)
+
+          - tag: optionRenderType
+            type: variant
+            dataType: enum (TEXT_CHOICES | SWATCH_CHOICES)
+            description: How to render the option choices
+
+          - tag: choices
+            type: sub-contract
+            repeated: true
+            trackBy: choiceId
+            description: Available choices for this option
+            tags:
+              - tag: choiceId
+                type: data
+                dataType: string
+                description: Choice ID
+
+              - tag: choiceName
+                type: data
+                dataType: string
+                description: Choice display name (e.g., Red, Large)
+
+              - tag: colorCode
+                type: data
+                dataType: string
+                description: HEX color code (for swatch rendering)
+
+              - tag: productCount
+                type: data
+                dataType: number
+                phase: fast+interactive
+                description: Number of products with this choice in current results
+
+              - tag: isSelected
+                type: [data, interactive]
+                dataType: boolean
+                elementType: HTMLInputElement
+                description: Checkbox to toggle this choice filter
+
+              - tag: isDisabled
+                type: data
+                dataType: boolean
+                phase: fast+interactive
+                description: Whether this choice has no matching products (count=0)
+
       - tag: clearFilters
         type: interactive
         elementType: HTMLButtonElement
@@ -250,3 +317,69 @@ tags:
         elementType: HTMLButtonElement
         description: Button to use this suggestion
 
+  # Category header — always populated via fallback chain (subcategory → category → defaultCategory)
+  - tag: categoryHeader
+    type: sub-contract
+    description: Active category information for the page header
+    tags:
+      - {tag: name, type: data, dataType: string, description: Category display name}
+      - {tag: description, type: data, dataType: string, description: Category plain text description}
+      - {tag: imageUrl, type: data, dataType: string, description: Category main image URL}
+      - {tag: hasImage, type: variant, dataType: boolean, description: Whether category has an image}
+      - {tag: productCount, type: data, dataType: number, description: Number of products in category}
+
+      - tag: breadcrumbs
+        type: sub-contract
+        repeated: true
+        trackBy: categoryId
+        description: Breadcrumb trail from root to current category
+        tags:
+          - {tag: categoryId, type: data, dataType: string, description: Category GUID}
+          - {tag: name, type: data, dataType: string, description: Category name}
+          - {tag: slug, type: data, dataType: string, description: Category slug}
+          - {tag: url, type: data, dataType: string, description: Full URL path for breadcrumb navigation}
+
+      - tag: seoData
+        type: sub-contract
+        description: Category SEO metadata
+        tags:
+          - tag: tags
+            type: sub-contract
+            repeated: true
+            trackBy: position
+            description: SEO tag information
+            tags:
+              - {tag: position, type: data, dataType: string, description: Tag position as two digit string}
+              - {tag: type, type: data, dataType: string, description: SEO tag type}
+              - tag: props
+                type: sub-contract
+                repeated: true
+                trackBy: key
+                description: Key-value pair of SEO properties
+                tags:
+                  - {tag: key, type: data, dataType: string}
+                  - {tag: value, type: data, dataType: string}
+              - tag: meta
+                type: sub-contract
+                repeated: true
+                trackBy: key
+                description: SEO tag metadata
+                tags:
+                  - {tag: key, type: data, dataType: string}
+                  - {tag: value, type: data, dataType: string}
+              - {tag: children, type: data, dataType: string, description: SEO tag inner content}
+          - tag: settings
+            type: sub-contract
+            description: SEO general settings
+            tags:
+              - {tag: preventAutoRedirect, type: data, dataType: boolean, description: Whether auto-redirect from old URL is enabled}
+              - tag: keywords
+                type: sub-contract
+                repeated: true
+                trackBy: term
+                description: User-selected keyword terms
+                tags:
+                  - {tag: term, type: data, dataType: string, description: Keyword value}
+                  - {tag: isMain, type: data, dataType: boolean, description: Whether this is the main focus keyword}
+                  - {tag: origin, type: data, dataType: string, description: Source that added the keyword}
+

package/dist/contracts/product-search.jay-contract.d.ts

@@ -22,17 +22,40 @@ export interface CategoryOfCategoryFilterOfFilterOfProductSearchViewState {
   categoryId: string,
   categoryName: string,
   categorySlug: string,
-  isSelected: boolean
+  isSelected: boolean,
+  categoryUrl: string
 }
 
 export interface CategoryFilterOfFilterOfProductSearchViewState {
   categories: Array<CategoryOfCategoryFilterOfFilterOfProductSearchViewState>
 }
 
+export enum OptionRenderType {
+  TEXT_CHOICES,
+  SWATCH_CHOICES
+}
+
+export interface ChoiceOfOptionFilterOfFilterOfProductSearchViewState {
+  choiceId: string,
+  choiceName: string,
+  colorCode: string,
+  productCount: number,
+  isSelected: boolean,
+  isDisabled: boolean
+}
+
+export interface OptionFilterOfFilterOfProductSearchViewState {
+  optionId: string,
+  optionName: string,
+  optionRenderType: OptionRenderType,
+  choices: Array<ChoiceOfOptionFilterOfFilterOfProductSearchViewState>
+}
+
 export interface FilterOfProductSearchViewState {
   priceRange: PriceRangeOfFilterOfProductSearchViewState,
   categoryFilter: CategoryFilterOfFilterOfProductSearchViewState,
-  inStockOnly: boolean
+  inStockOnly: boolean,
+  optionFilters: Array<OptionFilterOfFilterOfProductSearchViewState>
 }
 
 export enum CurrentSort {
@@ -53,6 +76,57 @@ export interface SuggestionOfProductSearchViewState {
   suggestionText: string
 }
 
+export interface BreadcrumbOfCategoryHeaderOfProductSearchViewState {
+  categoryId: string,
+  name: string,
+  slug: string,
+  url: string
+}
+
+export interface PropOfTagOfSeoDatumOfCategoryHeaderOfProductSearchViewState {
+  key: string,
+  value: string
+}
+
+export interface MetaOfTagOfSeoDatumOfCategoryHeaderOfProductSearchViewState {
+  key: string,
+  value: string
+}
+
+export interface TagOfSeoDatumOfCategoryHeaderOfProductSearchViewState {
+  position: string,
+  type: string,
+  props: Array<PropOfTagOfSeoDatumOfCategoryHeaderOfProductSearchViewState>,
+  meta: Array<MetaOfTagOfSeoDatumOfCategoryHeaderOfProductSearchViewState>,
+  children: string
+}
+
+export interface KeywordOfSettingOfSeoDatumOfCategoryHeaderOfProductSearchViewState {
+  term: string,
+  isMain: boolean,
+  origin: string
+}
+
+export interface SettingOfSeoDatumOfCategoryHeaderOfProductSearchViewState {
+  preventAutoRedirect: boolean,
+  keywords: Array<KeywordOfSettingOfSeoDatumOfCategoryHeaderOfProductSearchViewState>
+}
+
+export interface SeoDatumOfCategoryHeaderOfProductSearchViewState {
+  tags: Array<TagOfSeoDatumOfCategoryHeaderOfProductSearchViewState>,
+  settings: SettingOfSeoDatumOfCategoryHeaderOfProductSearchViewState
+}
+
+export interface CategoryHeaderOfProductSearchViewState {
+  name: string,
+  description: string,
+  imageUrl: string,
+  hasImage: boolean,
+  productCount: number,
+  breadcrumbs: Array<BreadcrumbOfCategoryHeaderOfProductSearchViewState>,
+  seoData: SeoDatumOfCategoryHeaderOfProductSearchViewState
+}
+
 export interface ProductSearchViewState {
   searchExpression: string,
   searchFields: string,
@@ -69,15 +143,17 @@ export interface ProductSearchViewState {
   loadedCount: number,
   totalCount: number,
   hasSuggestions: boolean,
-  suggestions: Array<SuggestionOfProductSearchViewState>
+  suggestions: Array<SuggestionOfProductSearchViewState>,
+  categoryHeader: CategoryHeaderOfProductSearchViewState
 }
 
 export type ProductSearchSlowViewState = Pick<ProductSearchViewState, 'searchFields' | 'fuzzySearch' | 'emptyStateMessage'> & {
     filters: {
     categoryFilter: {
-    categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'categoryName' | 'categorySlug'>>;
+    categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'categoryName' | 'categorySlug' | 'categoryUrl'>>;
 };
 };
+    categoryHeader: ProductSearchViewState['categoryHeader'];
 };
 
 export type ProductSearchFastViewState = Pick<ProductSearchViewState, 'searchExpression' | 'isSearching' | 'hasSearched' | 'resultCount' | 'hasResults' | 'hasMore' | 'loadedCount' | 'totalCount' | 'hasSuggestions'> & {
@@ -87,6 +163,7 @@ export type ProductSearchFastViewState = 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]>;
@@ -99,6 +176,7 @@ export type ProductSearchInteractiveViewState = Pick<ProductSearchViewState, 'se
     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]>;
@@ -125,6 +203,11 @@ export interface ProductSearchRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {
@@ -156,6 +239,11 @@ export interface ProductSearchRepeatedRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {