@jay-framework/wix-stores 0.15.4 → 0.15.6

package/dist/actions/get-variant-stock.jay-action

@@ -0,0 +1,7 @@
+name: getVariantStock
+description: Get variant stock availability for a product with color + text options. Returns a map of colorChoiceId -> textChoiceId -> inStock.
+
+inputSchema:
+  productId: string
+
+outputSchema: record(record(boolean))

package/dist/actions/search-products.jay-action

@@ -11,6 +11,9 @@ inputSchema:
     minPrice?: number
     maxPrice?: number
     categoryIds?: string[]
+    optionFilters?:
+      - optionName: string
+        choiceNames: string[]
   sortBy?: enum(relevance | price_asc | price_desc | name_asc | name_desc | newest)
   cursor?: string
   pageSize?: number
@@ -31,3 +34,12 @@ outputSchema:
         maxValue?: number
         productCount: number
         isSelected: boolean
+  optionFilters?:
+    - optionId: string
+      optionName: string
+      optionRenderType: enum(TEXT_CHOICES | SWATCH_CHOICES)
+      choices:
+        - choiceId: string
+          choiceName: string
+          colorCode: string
+          productCount: number

package/dist/contracts/category-list.jay-contract

@@ -1,4 +1,9 @@
 name: category-list
+description: Displays a list of store categories. Use for category navigation grids and menus.
+props:
+  - name: parentCategory
+    type: string
+    description: Parent category slug. When set, only direct children of this category are shown. Falls back to defaultCategory from config.
 tags:
   # List of visible categories
   - tag: categories

package/dist/contracts/category-list.jay-contract.d.ts

@@ -37,4 +37,8 @@ export interface CategoryListRepeatedRefs {
   }
 }
 
-export type CategoryListContract = JayContract<CategoryListViewState, CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState>
+export interface CategoryListProps {
+  parentCategory?: string;
+}
+
+export type CategoryListContract = JayContract<CategoryListViewState, CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, CategoryListProps>

package/dist/contracts/media-gallery.jay-contract

@@ -1,4 +1,5 @@
 name: mediaGallery
+description: Image and video gallery with thumbnail navigation. Used as a sub-contract in product pages.
 tags:
   - tag: selectedMedia
     type: sub-contract

package/dist/contracts/media.jay-contract

@@ -1,4 +1,5 @@
 name: media
+description: Single media item with URL, type, and thumbnail. Used as a sub-contract in media galleries.
 tags:
   - {tag: url, type: data, dataType: string, description: Media Url}
   - {tag: mediaType, type: variant, dataType: "enum (IMAGE | VIDEO)", description: Media type}

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

@@ -1,4 +1,5 @@
 name: product-card
+description: Single product card with image, price, and quick-add options. Used as a sub-contract in product grids and search results.
 tags:
   # Product basic info (from Wix Stores Product API)
   - tag: _id

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

@@ -1,4 +1,8 @@
 name: product-page
+description: Full product detail page with variants, options, media gallery, and add-to-cart. Use for individual product pages.
+params:
+  slug: string
+  category: string?
 tags:
   - {tag: _id, type: data, dataType: string, description: Product GUID}
   - {tag: productName, type: data, dataType: string, required: true, description: Product name}
@@ -31,6 +35,7 @@ tags:
   - {tag: addToCartButton, type: interactive, elementType: HTMLButtonElement, required: true, description: Add product to cart button}
   - {tag: buyNowButton, type: interactive, elementType: HTMLButtonElement, required: true, description: Buy now button}
   - {tag: actionsEnabled, type: variant, dataType: boolean, phase: fast+interactive, description: should the add to cart and buy now buttons be enabled}
+  - {tag: isAddingToCart, type: variant, dataType: boolean, phase: fast+interactive, description: Whether an add-to-cart request is currently in progress}
 
   - tag: options
     type: sub-contract
@@ -97,55 +102,4 @@ tags:
           - {tag: isSelected, type: variant, dataType: boolean, phase: fast+interactive, description: Whether this choice is currently selected (UI state)}
           - {tag: choiceButton, type: interactive, elementType: HTMLButtonElement, description: Button to select this choice}
 
-  - tag: seoData
-    type: sub-contract
-    description: Product SEO data.
-    tags:
-      - tag: tags
-        type: sub-contract
-        repeated: true
-        trackBy: position
-        description: SEO tag information.
-        tags:
-          - {tag: position, type: data, dataType: string, description: the number of the tag, as two digit string.}
-          - {tag: type, type: data, dataType: string, description: SEO tag type.}
-          - tag: props
-            type: sub-contract
-            repeated: true
-            trackBy: key
-            description: A 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 the automatical redirect visits from the old URL to the new one is enabled.}
-          - tag: keywords
-            type: sub-contract
-            repeated: true
-            trackBy: term
-            description: User-selected keyword terms for a specific page.
-            tags:
-            - {tag: term, type: data, dataType: string, description: Keyword value.}
-            - {tag: isMain, type: data, dataType: boolean, description: Whether the keyword is the main focus keyword.}
-            - {tag: origin, type: data, dataType: string, description: The source that added the keyword terms to the SEO settings. }
+  # SEO data is injected into <head> via headTags (Design Log #127), not part of the contract view state.

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

@@ -77,40 +77,6 @@ export interface ModifierOfProductPageViewState {
   choices: Array<ChoiceOfModifierOfProductPageViewState>
 }
 
-export interface PropOfTagOfSeoDatumOfProductPageViewState {
-  key: string,
-  value: string
-}
-
-export interface MetaOfTagOfSeoDatumOfProductPageViewState {
-  key: string,
-  value: string
-}
-
-export interface TagOfSeoDatumOfProductPageViewState {
-  position: string,
-  type: string,
-  props: Array<PropOfTagOfSeoDatumOfProductPageViewState>,
-  meta: Array<MetaOfTagOfSeoDatumOfProductPageViewState>,
-  children: string
-}
-
-export interface KeywordOfSettingOfSeoDatumOfProductPageViewState {
-  term: string,
-  isMain: boolean,
-  origin: string
-}
-
-export interface SettingOfSeoDatumOfProductPageViewState {
-  preventAutoRedirect: boolean,
-  keywords: Array<KeywordOfSettingOfSeoDatumOfProductPageViewState>
-}
-
-export interface SeoDatumOfProductPageViewState {
-  tags: Array<TagOfSeoDatumOfProductPageViewState>,
-  settings: SettingOfSeoDatumOfProductPageViewState
-}
-
 export interface ProductPageViewState {
   _id: string,
   productName: string,
@@ -126,10 +92,10 @@ export interface ProductPageViewState {
   stockStatus: StockStatus,
   quantity: QuantityOfProductPageViewState,
   actionsEnabled: boolean,
+  isAddingToCart: boolean,
   options: Array<OptionOfProductPageViewState>,
   infoSections: Array<InfoSectionOfProductPageViewState>,
-  modifiers: Array<ModifierOfProductPageViewState>,
-  seoData: SeoDatumOfProductPageViewState
+  modifiers: Array<ModifierOfProductPageViewState>
 }
 
 export type ProductPageSlowViewState = Pick<ProductPageViewState, '_id' | 'productName' | 'description' | 'brand' | 'ribbon' | 'productType'> & {
@@ -140,10 +106,9 @@ export type ProductPageSlowViewState = Pick<ProductPageViewState, '_id' | 'produ
     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'];
 };
 
-export type ProductPageFastViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled'> & {
+export 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'> & {
@@ -154,7 +119,7 @@ export type ProductPageFastViewState = Pick<ProductPageViewState, 'sku' | 'price
 }>;
 };
 
-export type ProductPageInteractiveViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled'> & {
+export 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'> & {
@@ -215,4 +180,11 @@ export interface ProductPageRepeatedRefs {
   }
 }
 
+import { UrlParams } from '@jay-framework/fullstack-component';
+
+export interface ProductPageParams extends UrlParams {
+  slug: string;
+  category?: string;
+}
+
 export type ProductPageContract = JayContract<ProductPageViewState, ProductPageRefs, ProductPageSlowViewState, ProductPageFastViewState, ProductPageInteractiveViewState>

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

@@ -1,4 +1,15 @@
 name: product-search
+description: Product listing with filters, sorting, and pagination. Use for search results and category pages.
+props:
+  - name: category
+    type: string
+    description: Top-level category slug. Scopes search to this category.
+  - name: subcategory
+    type: string
+    description: Sub-category slug. Further scopes within the category.
+params:
+  category: string?
+  subcategory: string?
 tags:
   # Search input (matches Wix searchProducts search.search parameter)
   - tag: searchExpression
@@ -180,7 +191,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

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

@@ -30,10 +30,32 @@ 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 {
@@ -141,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]>;
@@ -153,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]>;
@@ -179,6 +203,11 @@ export interface ProductSearchRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {
@@ -210,6 +239,11 @@ export interface ProductSearchRepeatedRefs {
       categories: {
         isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
       }
+    },
+    optionFilters: {
+      choices: {
+        isSelected: HTMLElementCollectionProxy<ChoiceOfOptionFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
     }
   },
   sortBy: {
@@ -220,4 +254,16 @@ export interface ProductSearchRepeatedRefs {
   }
 }
 
-export type ProductSearchContract = JayContract<ProductSearchViewState, ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState>
+export interface ProductSearchProps {
+  category?: string;
+  subcategory?: string;
+}
+
+import { UrlParams } from '@jay-framework/fullstack-component';
+
+export interface ProductSearchParams extends UrlParams {
+  category?: string;
+  subcategory?: string;
+}
+
+export type ProductSearchContract = JayContract<ProductSearchViewState, ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState, ProductSearchProps>