@jay-framework/wix-stores 0.15.5 → 0.16.0

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

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

@@ -254,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>

package/dist/index.client.js

@@ -301,6 +301,7 @@ function ProductPageInteractive(props, refs, viewStateSignals, fastCarryForward,
         quantity: quantity()
       },
       actionsEnabled: computedActionsEnabled,
+      isAddingToCart,
       options,
       modifiers,
       mediaGallery: interactiveMedia,

package/dist/index.d.ts

@@ -560,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
  */
@@ -710,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,
@@ -759,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'> & {
@@ -773,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'> & {
@@ -787,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'> & {
@@ -904,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
  *
@@ -929,15 +898,15 @@ 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>>;
 };
 
 /**
@@ -1021,4 +990,4 @@ declare function setupWixStores(ctx: PluginSetupContext): Promise<PluginSetupRes
  */
 declare function generateWixStoresReferences(ctx: PluginReferencesContext): Promise<PluginReferencesResult>;
 
-export { type CategoryTree, type GetProductBySlugInput, type ProductPageParams, type ProductSearchParams, 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 };

package/dist/index.js

@@ -238,12 +238,16 @@ function buildProductUrl(urls, tree, slug, mainCategoryId) {
 function buildCategoryUrl(urls, tree, categorySlug, categoryId) {
   if (!urls.category) return null;
   let url = urls.category;
-  url = url.replace("{category}", categorySlug);
   if (url.includes("{prefix}")) {
     const prefixSlug = findRootCategorySlug(categoryId, tree);
     if (!prefixSlug) return null;
     url = url.replace("{prefix}", prefixSlug);
+    const isRoot = tree.rootIds.has(categoryId);
+    url = url.replace("{category}", isRoot ? "" : categorySlug);
+  } else {
+    url = url.replace("{category}", categorySlug);
   }
+  url = url.replace(/\/\/+/g, "/").replace(/\/+$/, "/");
   return url.includes("{") ? null : url;
 }
 function mapAvailabilityStatus(status) {
@@ -835,7 +839,7 @@ const EMPTY_CATEGORY_HEADER = {
   breadcrumbs: [],
   seoData: { tags: [], settings: { preventAutoRedirect: false, keywords: [] } }
 };
-async function findCategoryBySlug(categoriesClient, slug) {
+async function findCategoryBySlug$1(categoriesClient, slug) {
   const result = await categoriesClient.queryCategories({ treeReference: { appNamespace: "@wix/stores" } }).eq("slug", slug).eq("visible", true).limit(1).find();
   return result.items?.[0] ?? null;
 }
@@ -849,15 +853,23 @@ async function loadCategoryDetails(categoriesClient, categoryId) {
 async function buildCategoryHeader(wixStoreService, category, categoryUrlTemplate) {
   const details = await loadCategoryDetails(wixStoreService.categories, category._id);
   const cat = details || category;
-  const imageUrl = cat.image || "";
+  const imageUrl = cat.image ? formatWixMediaUrl("", cat.image) : "";
   const description = cat.description || "";
   const categoryTree = await wixStoreService.getCategoryTree();
-  const breadcrumbs = (cat.breadcrumbsInfo?.breadcrumbs || []).map((b) => ({
-    categoryId: b.categoryId,
-    name: b.categoryName,
-    slug: b.categorySlug,
-    url: categoryUrlTemplate ? buildCategoryUrl(wixStoreService.urls, categoryTree, b.categorySlug, b.categoryId) : ""
-  }));
+  const breadcrumbs = [
+    ...(cat.breadcrumbsInfo?.breadcrumbs || []).map((b) => ({
+      categoryId: b.categoryId,
+      name: b.categoryName,
+      slug: b.categorySlug,
+      url: categoryUrlTemplate ? buildCategoryUrl(wixStoreService.urls, categoryTree, b.categorySlug, b.categoryId) : ""
+    })),
+    {
+      categoryId: cat._id || "",
+      name: cat.name || "",
+      slug: cat.slug || "",
+      url: categoryUrlTemplate ? buildCategoryUrl(wixStoreService.urls, categoryTree, cat.slug || "", cat._id || "") : ""
+    }
+  ];
   const seoData = cat.seoData ? {
     tags: (cat.seoData.tags || []).map((tag, index) => ({
       position: index.toString().padStart(2, "0"),
@@ -897,7 +909,7 @@ async function buildCategoryHeader(wixStoreService, category, categoryUrlTemplat
         header = { ...header, description: parent.description };
       }
       if (!header.imageUrl) {
-        const parentImage = parent.image || "";
+        const parentImage = parent.image ? formatWixMediaUrl("", parent.image) : "";
         if (parentImage) {
           header = { ...header, imageUrl: parentImage, hasImage: true };
         }
@@ -914,13 +926,13 @@ async function renderSlowlyChanging$2(props, wixStores) {
   let activeCategory = null;
   let baseCategoryId = null;
   if (subcategorySlug) {
-    activeCategory = await findCategoryBySlug(wixStores.categories, subcategorySlug);
+    activeCategory = await findCategoryBySlug$1(wixStores.categories, subcategorySlug);
     baseCategoryId = activeCategory?._id ?? null;
   } else if (categorySlug) {
-    activeCategory = await findCategoryBySlug(wixStores.categories, categorySlug);
+    activeCategory = await findCategoryBySlug$1(wixStores.categories, categorySlug);
     baseCategoryId = activeCategory?._id ?? null;
   } else if (defaultCategorySlug) {
-    activeCategory = await findCategoryBySlug(wixStores.categories, defaultCategorySlug);
+    activeCategory = await findCategoryBySlug$1(wixStores.categories, defaultCategorySlug);
   }
   const tree = await wixStores.getCategoryTree();
   const categoryHeader = activeCategory ? await buildCategoryHeader(wixStores, activeCategory, wixStores.urls.category) : EMPTY_CATEGORY_HEADER;
@@ -1188,24 +1200,25 @@ function mapInfoSections(infoSections) {
     uniqueName: infoSection.uniqueName || ""
   }));
 }
-function mapSeoData(seoData) {
-  return {
-    tags: seoData?.tags?.map((tag, index) => ({
-      position: index.toString().padStart(2, "0"),
-      type: tag.type,
-      props: Object.entries(tag.props || {}).map(([key, value]) => ({ key, value })),
-      meta: Object.entries(tag.meta || {}).map(([key, value]) => ({ key, value })),
-      children: tag.children
-    })),
-    settings: {
-      preventAutoRedirect: seoData?.settings?.preventAutoRedirect || false,
-      keywords: seoData?.settings?.keywords.map((keyword) => ({
-        isMain: keyword.isMain,
-        origin: keyword.origin,
-        term: keyword.term
-      }))
+function mapSeoHeadTags(seoData) {
+  if (!seoData)
+    return [];
+  const headTags = (seoData.tags || []).map((tag) => ({
+    tag: tag.type || "meta",
+    attrs: Object.fromEntries(Object.entries(tag.props || {}).map(([key, value]) => [key, value])),
+    children: tag.children || void 0
+  }));
+  const keywords = seoData.settings?.keywords;
+  if (keywords?.length) {
+    const terms = keywords.map((k) => k.term).filter(Boolean);
+    if (terms.length) {
+      headTags.push({
+        tag: "meta",
+        attrs: { name: "keywords", content: terms.join(", ") }
+      });
     }
-  };
+  }
+  return headTags;
 }
 function mapMediaType(mediaType) {
   if (mediaType === "VIDEO")
@@ -1214,12 +1227,19 @@ function mapMediaType(mediaType) {
     return MediaType.IMAGE;
 }
 function mapMedia(media) {
-  const mainMediaType = mapMediaType(media.main.mediaType);
+  const main = media?.main;
+  if (!main) {
+    return {
+      selectedMedia: { url: "", mediaType: MediaType.IMAGE, thumbnail_50x50: "" },
+      availableMedia: []
+    };
+  }
+  const mainMediaType = mapMediaType(main.mediaType);
   return {
     selectedMedia: {
-      url: formatWixMediaUrl(media.main._id, media.main.url),
+      url: formatWixMediaUrl(main._id, main.url),
       mediaType: mainMediaType,
-      thumbnail_50x50: formatWixMediaUrl(media.main._id, media.main.url, { w: 50, h: 50 })
+      thumbnail_50x50: formatWixMediaUrl(main._id, main.url, { w: 50, h: 50 })
     },
     availableMedia: media.itemsInfo?.items?.map((item) => ({
       mediaId: item._id,
@@ -1228,7 +1248,7 @@ function mapMedia(media) {
         mediaType: item.mediaType === "IMAGE" ? MediaType.IMAGE : MediaType.VIDEO,
         thumbnail_50x50: formatWixMediaUrl(item._id, item.url, { w: 50, h: 50 })
       },
-      selected: item._id === media.main._id ? Selected.selected : Selected.notSelected
+      selected: item._id === main._id ? Selected.selected : Selected.notSelected
     })) ?? []
   };
 }
@@ -1343,9 +1363,9 @@ async function renderSlowlyChanging$1(props, wixStores) {
         productType: mapProductType(productType),
         options: mapOptionsToSlowVS(options),
         infoSections: mapInfoSections(infoSections),
-        modifiers: mapModifiersToSlowVS(modifiers),
-        seoData: mapSeoData(seoData)
+        modifiers: mapModifiersToSlowVS(modifiers)
       },
+      headTags: mapSeoHeadTags(seoData),
       carryForward: {
         productId: _id,
         mediaGallery: mapMedia(media),
@@ -1355,7 +1375,7 @@ async function renderSlowlyChanging$1(props, wixStores) {
         price: actualPriceRange?.minValue?.formattedAmount || "",
         strikethroughPrice: actualPriceRange?.minValue?.amount !== product.compareAtPriceRange?.minValue?.amount ? compareAtPriceRange?.minValue?.formattedAmount || "" : "",
         pricePerUnit: physicalProperties?.pricePerUnitRange?.minValue?.description,
-        stockStatus: inventory?.availabilityStatus === "IN_STOCK" ? StockStatus.IN_STOCK : StockStatus.OUT_OF_STOCK,
+        stockStatus: inventory?.availabilityStatus === "IN_STOCK" || inventory?.availabilityStatus === "PARTIALLY_OUT_OF_STOCK" ? StockStatus.IN_STOCK : StockStatus.OUT_OF_STOCK,
         variants: mapVariants(variantsInfo)
       }
     };
@@ -1363,17 +1383,45 @@ async function renderSlowlyChanging$1(props, wixStores) {
 }
 async function renderFastChanging(props, slowCarryForward, wixStores) {
   const Pipeline = RenderPipeline.for();
+  const { variants } = slowCarryForward;
+  const defaultVariant = variants.find((v) => v.inventoryStatus === StockStatus.IN_STOCK) || variants[0];
+  const options = slowCarryForward.options.map((option) => {
+    const variantChoice = defaultVariant.choices.find((c) => c.optionChoiceIds.optionId === option._id);
+    if (!variantChoice)
+      return option;
+    return {
+      ...option,
+      choices: option.choices.map((choice) => ({
+        ...choice,
+        isSelected: choice.choiceId === variantChoice.optionChoiceIds.choiceId
+      }))
+    };
+  });
+  let mediaGallery = slowCarryForward.mediaGallery;
+  if (defaultVariant.mediaId) {
+    const mediaIndex = mediaGallery.availableMedia.findIndex((m) => m.mediaId === defaultVariant.mediaId);
+    if (mediaIndex >= 0) {
+      mediaGallery = {
+        selectedMedia: mediaGallery.availableMedia[mediaIndex].media,
+        availableMedia: mediaGallery.availableMedia.map((m, i) => ({
+          ...m,
+          selected: i === mediaIndex ? Selected.selected : Selected.notSelected
+        }))
+      };
+    }
+  }
   const isInStock = slowCarryForward.stockStatus === StockStatus.IN_STOCK;
   return Pipeline.ok({
-    actionsEnabled: isInStock,
-    options: slowCarryForward.options,
+    actionsEnabled: isInStock && defaultVariant.inventoryStatus === StockStatus.IN_STOCK,
+    options,
     modifiers: slowCarryForward.modifiers,
-    mediaGallery: slowCarryForward.mediaGallery,
-    sku: slowCarryForward.variants[0].sku,
-    price: slowCarryForward.variants[0].price,
+    mediaGallery,
+    sku: defaultVariant.sku,
+    price: defaultVariant.price,
     pricePerUnit: slowCarryForward.pricePerUnit || "",
-    stockStatus: slowCarryForward.stockStatus,
-    strikethroughPrice: slowCarryForward.variants[0].strikethroughPrice,
+    stockStatus: defaultVariant.inventoryStatus,
+    strikethroughPrice: defaultVariant.strikethroughPrice,
+    isAddingToCart: false,
     quantity: { quantity: 1 }
   }).toPhaseOutput((viewState) => ({
     viewState,
@@ -1384,14 +1432,28 @@ async function renderFastChanging(props, slowCarryForward, wixStores) {
   }));
 }
 const productPage = makeJayStackComponent().withProps().withServices(WIX_STORES_SERVICE_MARKER).withLoadParams(loadProductParams).withSlowlyRender(renderSlowlyChanging$1).withFastRender(renderFastChanging);
+async function findCategoryBySlug(categoriesClient, slug) {
+  const result = await categoriesClient.queryCategories({ treeReference: { appNamespace: "@wix/stores" } }).eq("slug", slug).eq("visible", true).limit(1).find();
+  return result.items?.[0] ?? null;
+}
 async function renderSlowlyChanging(props, wixStores) {
   const Pipeline = RenderPipeline.for();
+  const parentCategorySlug = props.parentCategory ?? wixStores.defaultCategory;
+  let parentCategoryId = null;
+  if (parentCategorySlug) {
+    const parentCat = await findCategoryBySlug(wixStores.categories, parentCategorySlug);
+    parentCategoryId = parentCat?._id ?? null;
+  }
   return Pipeline.try(async () => {
-    const result = await wixStores.categories.queryCategories({
+    let query = wixStores.categories.queryCategories({
       treeReference: {
         appNamespace: "@wix/stores"
       }
-    }).eq("visible", true).find();
+    }).eq("visible", true);
+    if (parentCategoryId) {
+      query = query.eq("parentCategory.id", parentCategoryId);
+    }
+    const result = await query.find();
     return result.items || [];
   }).recover((error) => {
     console.error("Failed to load categories:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-stores",
-  "version": "0.15.5",
+  "version": "0.16.0",
   "type": "module",
   "description": "Wix Stores API client for Jay Framework",
   "license": "Apache-2.0",
@@ -22,8 +22,9 @@
     "./get-variant-stock.jay-action": "./dist/actions/get-variant-stock.jay-action"
   },
   "scripts": {
-    "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types",
+    "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types && npm run validate",
     "definitions": "jay-cli definitions lib",
+    "validate": "jay-stack-cli validate-plugin",
     "build:client": "vite build",
     "build:server": "vite build --ssr",
     "build:copy-contract": "mkdir -p dist/contracts && cp lib/contracts/*.jay-contract* dist/contracts/ && mkdir -p dist/actions && cp lib/actions/*.jay-action dist/actions/",
@@ -34,16 +35,16 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.15.5",
-    "@jay-framework/fullstack-component": "^0.15.5",
-    "@jay-framework/reactive": "^0.15.5",
-    "@jay-framework/runtime": "^0.15.5",
-    "@jay-framework/secure": "^0.15.5",
-    "@jay-framework/stack-client-runtime": "^0.15.5",
-    "@jay-framework/stack-server-runtime": "^0.15.5",
-    "@jay-framework/wix-cart": "^0.15.5",
-    "@jay-framework/wix-server-client": "^0.15.5",
-    "@jay-framework/wix-utils": "^0.15.5",
+    "@jay-framework/component": "^0.16.0",
+    "@jay-framework/fullstack-component": "^0.16.0",
+    "@jay-framework/reactive": "^0.16.0",
+    "@jay-framework/runtime": "^0.16.0",
+    "@jay-framework/secure": "^0.16.0",
+    "@jay-framework/stack-client-runtime": "^0.16.0",
+    "@jay-framework/stack-server-runtime": "^0.16.0",
+    "@jay-framework/wix-cart": "^0.16.0",
+    "@jay-framework/wix-server-client": "^0.16.0",
+    "@jay-framework/wix-utils": "^0.16.0",
     "@wix/categories": "^1.0.185",
     "@wix/sdk": "^1.21.5",
     "@wix/sdk-runtime": "^1.0.11",
@@ -54,9 +55,10 @@
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.15.5",
-    "@jay-framework/jay-cli": "^0.15.5",
-    "@jay-framework/vite-plugin": "^0.15.5",
+    "@jay-framework/compiler-jay-stack": "^0.16.0",
+    "@jay-framework/jay-cli": "^0.16.0",
+    "@jay-framework/jay-stack-cli": "^0.16.0",
+    "@jay-framework/vite-plugin": "^0.16.0",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",
     "tslib": "^2.6.2",

package/plugin.yaml

@@ -27,8 +27,15 @@ actions:
   - name: getVariantStock
     action: get-variant-stock.jay-action
 
-# Plugin initialization uses makeJayInit pattern in lib/init.ts
-# Export name defaults to 'init'
+services:
+  - name: wix-stores
+    marker: WIX_STORES_SERVICE_MARKER
+    description: Wix Stores Catalog V3 API (products, categories, inventory, customizations) with lazy-loaded caching
+
+contexts:
+  - name: wix-stores
+    marker: WIX_STORES_CONTEXT
+    description: Client-side stores access with product variant resolution and delegated cart operations
 
 setup:
   handler: setupWixStores

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

@@ -1,193 +0,0 @@
-name: category-page
-tags:
-  # Category/Collection information (from Wix Stores Collection API)
-  - tag: _id
-    type: data
-    dataType: string
-    description: Collection GUID
-    
-  - tag: name
-    type: data
-    dataType: string
-    required: true
-    description: Collection name
-    
-  - tag: description
-    type: data
-    dataType: string
-    description: Collection description
-    
-  - tag: slug
-    type: data
-    dataType: string
-    description: Collection slug
-    
-  - tag: visible
-    type: data
-    dataType: boolean
-    description: Collection visibility (impacts dynamic pages only)
-    
-  - tag: numberOfProducts
-    type: data
-    dataType: number
-    description: Number of products in the collection
-    
-  # Media (from Wix Stores Collection API)
-  - tag: media
-    type: sub-contract
-    description: Media items associated with this collection
-    tags:
-      - tag: mainMedia
-        type: sub-contract
-        description: Primary media for the collection
-        tags:
-          - tag: _id
-            type: data
-            dataType: string
-            description: Media GUID
-            
-          - tag: url
-            type: data
-            dataType: string
-            description: Media URL
-            
-          - tag: altText
-            type: data
-            dataType: string
-            description: Media alt text
-            
-          - tag: mediaType
-            type: data
-            dataType: enum (IMAGE | VIDEO | AUDIO | DOCUMENT | ZIP)
-            description: Media item type
-            
-      - tag: items
-        type: sub-contract
-        repeated: true
-        trackBy: _id
-        description: All media items
-        tags:
-          - tag: _id
-            type: data
-            dataType: string
-            description: Media GUID
-            
-          - tag: url
-            type: data
-            dataType: string
-            description: Media URL
-            
-          - tag: altText
-            type: data
-            dataType: string
-            description: Media alt text
-            
-          - tag: title
-            type: data
-            dataType: string
-            description: Media item title
-            
-          - tag: mediaType
-            type: data
-            dataType: enum (IMAGE | VIDEO | AUDIO | DOCUMENT | ZIP)
-            description: Media item type
-            
-          - tag: thumbnail
-            type: sub-contract
-            description: Media thumbnail
-            tags:
-              - tag: url
-                type: data
-                dataType: string
-                description: Thumbnail URL
-                
-              - tag: width
-                type: data
-                dataType: number
-                description: Thumbnail width in pixels
-                
-              - tag: height
-                type: data
-                dataType: number
-                description: Thumbnail height in pixels
-                
-              - tag: format
-                type: data
-                dataType: string
-                description: Media format (mp4, png, etc.)
-    
-  # Breadcrumbs navigation
-  - tag: breadcrumbs
-    type: sub-contract
-    repeated: true
-    trackBy: categoryId
-    description: Breadcrumb navigation path
-    tags:
-      - tag: categoryId
-        type: data
-        dataType: string
-        description: Category GUID
-        
-      - tag: categoryName
-        type: data
-        dataType: string
-        description: Category name in breadcrumb
-        
-      - tag: categorySlug
-        type: data
-        dataType: string
-        description: Category slug for link
-        
-      - tag: categoryLink
-        type: interactive
-        elementType: HTMLAnchorElement
-        description: Link to category
-  
-  # Initial products (SSR - loaded in slow phase)
-  - tag: products
-    type: sub-contract
-    repeated: true
-    trackBy: _id
-    description: Initial products in this category (rendered server-side)
-    link: ./product-card
-    
-  # Additional products (loaded on client via "load more")
-  - tag: loadedProducts
-    type: sub-contract
-    repeated: true
-    trackBy: _id
-    phase: fast+interactive
-    description: Additional products loaded on the client
-    link: ./product-card
-    
-  # Load more functionality
-  - tag: hasMore
-    type: variant
-    dataType: boolean
-    phase: fast+interactive
-    description: Whether there are more products to load
-    
-  - tag: loadMoreButton
-    type: interactive
-    elementType: HTMLButtonElement
-    description: Button to load more products
-    
-  - tag: loadedCount
-    type: data
-    dataType: number
-    phase: fast+interactive
-    description: Number of products currently loaded
-  
-  # Loading state
-  - tag: isLoading
-    type: variant
-    dataType: boolean
-    phase: fast+interactive
-    description: Whether products are currently loading
-    
-  # Empty state
-  - tag: hasProducts
-    type: variant
-    dataType: boolean
-    phase: fast+interactive
-    description: Whether category has any products

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

@@ -1,133 +0,0 @@
-import {HTMLElementCollectionProxy, HTMLElementProxy, JayContract} from "@jay-framework/runtime";
-import {ProductCardViewState, ProductCardRefs, ProductCardRepeatedRefs} from "./product-card.jay-contract";
-
-export enum MediaType {
-  IMAGE,
-  VIDEO,
-  AUDIO,
-  DOCUMENT,
-  ZIP
-}
-
-export interface MainMediaOfMediaOfCategoryPageViewState {
-  _id: string,
-  url: string,
-  altText: string,
-  mediaType: MediaType
-}
-
-export enum MediaType {
-  IMAGE,
-  VIDEO,
-  AUDIO,
-  DOCUMENT,
-  ZIP
-}
-
-export interface ThumbnailOfItemOfMediaOfCategoryPageViewState {
-  url: string,
-  width: number,
-  height: number,
-  format: string
-}
-
-export interface ItemOfMediaOfCategoryPageViewState {
-  _id: string,
-  url: string,
-  altText: string,
-  title: string,
-  mediaType: MediaType,
-  thumbnail: ThumbnailOfItemOfMediaOfCategoryPageViewState
-}
-
-export interface MediaOfCategoryPageViewState {
-  mainMedia: MainMediaOfMediaOfCategoryPageViewState,
-  items: Array<ItemOfMediaOfCategoryPageViewState>
-}
-
-export interface BreadcrumbOfCategoryPageViewState {
-  categoryId: string,
-  categoryName: string,
-  categorySlug: string
-}
-
-export interface CategoryPageViewState {
-  _id: string,
-  name: string,
-  description: string,
-  slug: string,
-  visible: boolean,
-  numberOfProducts: number,
-  media: MediaOfCategoryPageViewState,
-  breadcrumbs: Array<BreadcrumbOfCategoryPageViewState>,
-  products: Array<ProductCardViewState>,
-  loadedProducts: Array<ProductCardViewState>,
-  hasMore: boolean,
-  loadedCount: number,
-  isLoading: boolean,
-  hasProducts: boolean
-}
-
-export type CategoryPageSlowViewState = Pick<CategoryPageViewState, '_id' | 'name' | 'description' | 'slug' | 'visible' | 'numberOfProducts'> & {
-    media: CategoryPageViewState['media'];
-    breadcrumbs: Array<CategoryPageViewState['breadcrumbs'][number]>;
-    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'name' | 'slug' | 'productUrl' | 'categoryPrefix' | 'hasDiscount' | 'hasRibbon' | 'productType' | 'quickAddType'> & {
-    mainMedia: CategoryPageViewState['products'][number]['mainMedia'];
-    thumbnail: CategoryPageViewState['products'][number]['thumbnail'];
-    inventory: CategoryPageViewState['products'][number]['inventory'];
-    ribbon: CategoryPageViewState['products'][number]['ribbon'];
-    brand: CategoryPageViewState['products'][number]['brand'];
-    quickOption: Pick<CategoryPageViewState['products'][number]['quickOption'], '_id' | 'name' | 'optionRenderType'> & {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['quickOption']['choices'][number], 'choiceId' | 'name' | 'choiceType' | 'colorCode'>>;
-};
-    secondQuickOption: Pick<CategoryPageViewState['products'][number]['secondQuickOption'], '_id' | 'name' | 'optionRenderType'> & {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['secondQuickOption']['choices'][number], 'choiceId' | 'name' | 'choiceType' | 'colorCode'>>;
-};
-}>;
-};
-
-export type CategoryPageFastViewState = Pick<CategoryPageViewState, 'hasMore' | 'loadedCount' | 'isLoading' | 'hasProducts'> & {
-    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'price' | 'strikethroughPrice' | 'isAddingToCart'> & {
-    quickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['quickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-    secondQuickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['secondQuickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-}>;
-    loadedProducts: Array<CategoryPageViewState['loadedProducts'][number]>;
-};
-
-export type CategoryPageInteractiveViewState = Pick<CategoryPageViewState, 'hasMore' | 'loadedCount' | 'isLoading' | 'hasProducts'> & {
-    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'price' | 'strikethroughPrice' | 'isAddingToCart'> & {
-    quickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['quickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-    secondQuickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['secondQuickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-}>;
-    loadedProducts: Array<CategoryPageViewState['loadedProducts'][number]>;
-};
-
-
-export interface CategoryPageRefs {
-  loadMoreButton: HTMLElementProxy<CategoryPageViewState, HTMLButtonElement>,
-  breadcrumbs: {
-    categoryLink: HTMLElementCollectionProxy<BreadcrumbOfCategoryPageViewState, HTMLAnchorElement>
-  },
-  products: ProductCardRepeatedRefs,
-  loadedProducts: ProductCardRepeatedRefs
-}
-
-
-export interface CategoryPageRepeatedRefs {
-  loadMoreButton: HTMLElementCollectionProxy<CategoryPageViewState, HTMLButtonElement>,
-  breadcrumbs: {
-    categoryLink: HTMLElementCollectionProxy<BreadcrumbOfCategoryPageViewState, HTMLAnchorElement>
-  },
-  products: ProductCardRepeatedRefs,
-  loadedProducts: ProductCardRepeatedRefs
-}
-
-export type CategoryPageContract = JayContract<CategoryPageViewState, CategoryPageRefs, CategoryPageSlowViewState, CategoryPageFastViewState, CategoryPageInteractiveViewState>