@jay-framework/wix-stores-v1 0.15.0

package/dist/index.d.ts

@@ -0,0 +1,1037 @@
+import { getCurrentCartClient, CartState } from '@jay-framework/wix-cart';
+export { AddToCartOptions, CartIndicatorState, CartLineItem, CartState, CartSummary, WIX_CART_CONTEXT, WIX_CART_SERVICE, WixCartContext, WixCartService, cartIndicator, cartPage, provideWixCartContext, provideWixCartService } from '@jay-framework/wix-cart';
+import * as _jay_framework_fullstack_component from '@jay-framework/fullstack-component';
+import { Signals, PageProps, UrlParams } from '@jay-framework/fullstack-component';
+import { WixClient } from '@wix/sdk';
+import { products, collections, inventory } from '@wix/stores';
+import { BuildDescriptors } from '@wix/sdk-types';
+import * as _jay_framework_runtime from '@jay-framework/runtime';
+import { HTMLElementCollectionProxy, HTMLElementProxy } from '@jay-framework/runtime';
+import { Getter } from '@jay-framework/reactive';
+import * as _jay_framework_component from '@jay-framework/component';
+
+/**
+ * Wix Store V1 API Client Factories
+ *
+ * These functions create singleton instances of Wix Catalog V1 API clients.
+ * Used by both the server service and client context.
+ *
+ * Key difference from V3:
+ * - Uses `products` module instead of `productsV3`
+ * - Uses `collections` module instead of `@wix/categories`
+ *
+ * Note: Cart client is provided by @jay-framework/wix-cart package.
+ */
+
+/**
+ * Get a configured Wix Stores Products client (Catalog V1) (singleton)
+ *
+ * The Products API (V1) is the original Wix Stores catalog API.
+ *
+ * @returns Products client instance from @wix/stores
+ * @see https://dev.wix.com/docs/sdk/backend-modules/stores/products/introduction
+ */
+declare function getProductsClient(wixClient: WixClient): BuildDescriptors<typeof products, {}>;
+/**
+ * Get a configured Wix Stores Collections client (singleton)
+ *
+ * The Collections API allows you to manage product Collections in your Wix store.
+ * Note: V3 uses @wix/categories instead.
+ *
+ * @returns Collections client instance from @wix/stores
+ * @see https://dev.wix.com/docs/sdk/backend-modules/stores/collections/introduction
+ */
+declare function getCollectionsClient(wixClient: WixClient): BuildDescriptors<typeof collections, {}>;
+/**
+ * Get a configured Wix Stores Inventory client (singleton)
+ *
+ * The Inventory API allows you to manage product inventory in your Wix store.
+ *
+ * @returns Inventory client instance from @wix/stores
+ * @see https://dev.wix.com/docs/sdk/backend-modules/stores/inventory/introduction
+ */
+declare function getInventoryClient(wixClient: WixClient): BuildDescriptors<typeof inventory, {}>;
+
+interface WixStoresV1Service {
+    products: ReturnType<typeof getProductsClient>;
+    collections: ReturnType<typeof getCollectionsClient>;
+    inventory: ReturnType<typeof getInventoryClient>;
+    /** @deprecated Use WIX_CART_SERVICE from @jay-framework/wix-cart instead */
+    cart: ReturnType<typeof getCurrentCartClient>;
+}
+/**
+ * Server service marker for Wix Stores V1.
+ * Use with `.withServices(WIX_STORES_V1_SERVICE_MARKER)` in component definitions.
+ */
+declare const WIX_STORES_V1_SERVICE_MARKER: _jay_framework_fullstack_component.ServiceMarker<WixStoresV1Service>;
+/**
+ * Creates, registers, and returns a Wix Stores V1 service instance.
+ * Called during server initialization.
+ */
+declare function provideWixStoresV1Service(wixClient: WixClient): WixStoresV1Service;
+
+declare enum OptionRenderType$1 {
+  TEXT_CHOICES,
+  COLOR_SWATCH_CHOICES
+}
+
+declare enum ChoiceType$1 {
+  CHOICE_TEXT,
+  ONE_COLOR
+}
+
+interface ChoiceOfProductOptionsViewState {
+  choiceId: string,
+  name: string,
+  choiceType: ChoiceType$1,
+  colorCode: string,
+  inStock: boolean,
+  variantId: string,
+  isSelected: boolean
+}
+
+interface ProductOptionsViewState {
+  _id: string,
+  name: string,
+  optionRenderType: OptionRenderType$1,
+  choices: Array<ChoiceOfProductOptionsViewState>
+}
+
+
+interface ProductOptionsRepeatedRefs {
+  choices: {
+    choiceButton: HTMLElementCollectionProxy<ChoiceOfProductOptionsViewState, HTMLButtonElement>
+  }
+}
+
+declare enum MediaType$2 {
+  IMAGE,
+  VIDEO
+}
+
+interface MainMediaOfProductCardViewState {
+  url: string,
+  altText: string,
+  mediaType: MediaType$2
+}
+
+interface ThumbnailOfProductCardViewState {
+  url: string,
+  altText: string,
+  width: number,
+  height: number
+}
+
+declare enum AvailabilityStatus {
+  IN_STOCK,
+  OUT_OF_STOCK,
+  PARTIALLY_OUT_OF_STOCK
+}
+
+declare enum PreorderStatus {
+  ENABLED,
+  DISABLED,
+  PARTIALLY_ENABLED
+}
+
+interface InventoryOfProductCardViewState {
+  availabilityStatus: AvailabilityStatus,
+  preorderStatus: PreorderStatus
+}
+
+interface RibbonOfProductCardViewState {
+  _id: string,
+  name: string
+}
+
+interface BrandOfProductCardViewState {
+  _id: string,
+  name: string
+}
+
+declare enum ProductType$1 {
+  PHYSICAL,
+  DIGITAL
+}
+
+declare enum QuickAddType {
+  SIMPLE,
+  SINGLE_OPTION,
+  NEEDS_CONFIGURATION
+}
+
+interface ProductCardViewState {
+  _id: string,
+  name: string,
+  slug: string,
+  productUrl: string,
+  mainMedia: MainMediaOfProductCardViewState,
+  thumbnail: ThumbnailOfProductCardViewState,
+  price: string,
+  strikethroughPrice: string,
+  hasDiscount: boolean,
+  inventory: InventoryOfProductCardViewState,
+  ribbon: RibbonOfProductCardViewState,
+  hasRibbon: boolean,
+  brand: BrandOfProductCardViewState,
+  productType: ProductType$1,
+  isAddingToCart: boolean,
+  quickAddType: QuickAddType,
+  quickOption: ProductOptionsViewState
+}
+
+
+interface ProductCardRepeatedRefs {
+  productLink: HTMLElementCollectionProxy<ProductCardViewState, HTMLAnchorElement>,
+  addToCartButton: HTMLElementCollectionProxy<ProductCardViewState, HTMLButtonElement>,
+  viewOptionsButton: HTMLElementCollectionProxy<ProductCardViewState, HTMLButtonElement>,
+  quickOption: ProductOptionsRepeatedRefs
+}
+
+/**
+ * Wix Stores Catalog V1 Product Mapping Utilities
+ *
+ * Maps Wix Stores Catalog V1 product responses to view state contracts.
+ *
+ * Key V1 vs V3 differences handled here:
+ * - V1 prices are numbers (289), V3 are strings ("120")
+ * - V1 has price.formatted.price, V3 doesn't include formatted in response
+ * - V1 uses stock.inStock/inventoryStatus, V3 uses inventory.availabilityStatus
+ * - V1 media URLs are complete, V3 uses wix:image:// URIs
+ * - V1 uses productOptions[], V3 uses options[]
+ *
+ * Reference: wix/exploration/query-products-catalog-v1/output/individual/*.json
+ */
+
+interface V1Collection {
+    _id?: string;
+    name?: string;
+    slug?: string;
+    description?: string;
+    media?: {
+        mainMedia?: {
+            image?: {
+                url: string;
+            };
+        };
+    };
+    numberOfProducts?: number;
+}
+interface CollectionViewState {
+    _id: string;
+    name: string;
+    slug: string;
+    description: string;
+    imageUrl: string;
+    productCount: number;
+}
+
+/**
+ * Configuration passed from server to client for Wix Stores V1.
+ */
+interface WixStoresV1InitData {
+    /** Enable client-side cart operations */
+    enableClientCart: boolean;
+    /** Enable client-side search */
+    enableClientSearch: boolean;
+}
+/**
+ * Reactive cart indicator state.
+ */
+interface ReactiveCartIndicator {
+    itemCount: Getter<number>;
+    hasItems: Getter<boolean>;
+}
+/**
+ * Result of a cart operation that modifies items.
+ */
+interface CartOperationResult {
+    cartState: CartState;
+}
+/**
+ * Client-side Wix Stores V1 context interface.
+ */
+interface WixStoresV1Context {
+    cartIndicator: ReactiveCartIndicator;
+    refreshCartIndicator(): Promise<void>;
+    getEstimatedCart(): Promise<CartState>;
+    addToCart(productId: string, quantity?: number, variantId?: string): Promise<CartOperationResult>;
+    removeLineItems(lineItemIds: string[]): Promise<CartOperationResult>;
+    updateLineItemQuantity(lineItemId: string, quantity: number): Promise<CartOperationResult>;
+    clearCart(): Promise<void>;
+    applyCoupon(couponCode: string): Promise<CartOperationResult>;
+    removeCoupon(): Promise<CartOperationResult>;
+    loadMoreCollectionProducts(collectionId: string, page: number, pageSize: number): Promise<{
+        products: ProductCardViewState[];
+        hasMore: boolean;
+        totalProducts: number;
+    }>;
+    getCollections(): Promise<CollectionViewState[]>;
+}
+/**
+ * Context marker for client-side Wix Stores V1 operations.
+ */
+declare const WIX_STORES_V1_CONTEXT: _jay_framework_runtime.ContextMarker<WixStoresV1Context>;
+
+/**
+ * Sort options for product search
+ */
+type ProductSortField = 'relevance' | 'price_asc' | 'price_desc' | 'name_asc' | 'name_desc' | 'newest';
+/**
+ * Product search filters
+ */
+interface ProductSearchFilters {
+    /** Minimum price filter */
+    minPrice?: number;
+    /** Maximum price filter */
+    maxPrice?: number;
+    /** Filter by collection IDs (V1 uses collections, not categories) */
+    collectionIds?: string[];
+}
+/**
+ * Input for searchProducts action
+ */
+interface SearchProductsInput {
+    /** Search query text */
+    query: string;
+    /** Filters to apply */
+    filters?: ProductSearchFilters;
+    /** Sort order */
+    sortBy?: ProductSortField;
+    /** Page number for pagination (1-based) */
+    page?: number;
+    /** Items per page (default: 12) */
+    pageSize?: number;
+}
+/**
+ * Price range bucket for filter UI
+ */
+interface PriceRangeBucket {
+    rangeId: string;
+    label: string;
+    minValue: number | null;
+    maxValue: number | null;
+    isSelected: boolean;
+}
+/**
+ * Price aggregation data for filter UI
+ */
+interface PriceAggregationData {
+    /** Minimum price across all products */
+    minBound: number;
+    /** Maximum price across all products */
+    maxBound: number;
+    /** Computed price range buckets */
+    ranges: PriceRangeBucket[];
+}
+/**
+ * Output for searchProducts action
+ */
+interface SearchProductsOutput {
+    /** List of matching products */
+    products: ProductCardViewState[];
+    /** Total number of matching products */
+    totalCount: number;
+    /** Current page number */
+    currentPage: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Whether there are more results */
+    hasMore: boolean;
+    /** Price aggregation data (bounds and computed ranges) */
+    priceAggregation: PriceAggregationData;
+}
+/**
+ * Input for getProductBySlug action
+ */
+interface GetProductBySlugInput {
+    /** Product URL slug */
+    slug: string;
+}
+/**
+ * Search products using the Wix Stores Catalog V1 queryProducts API.
+ *
+ * V1 uses skip-based pagination and query builder syntax.
+ *
+ * Server-side filtering/sorting:
+ * - name: startsWith() for text search
+ * - collectionIds: hasSome() for collection filtering
+ * - priceData.price: ge()/le() for price range filtering
+ * - Sorting: ascending()/descending() on price, name, lastUpdated
+ *
+ * Also fetches min/max prices in parallel for price range filter UI.
+ *
+ * @see https://dev.wix.com/docs/sdk/backend-modules/stores/products/query-products
+ *
+ * @example
+ * ```typescript
+ * const results = await searchProducts({
+ *     query: 'whisky',
+ *     filters: { minPrice: 50, maxPrice: 200 },
+ *     sortBy: 'price_asc',
+ *     pageSize: 12,
+ *     page: 1
+ * });
+ * // results.priceAggregation = {
+ * //   minBound: 25,
+ * //   maxBound: 500,
+ * //   ranges: [
+ * //     { rangeId: 'all', label: 'Show all', minValue: null, maxValue: null, isSelected: true },
+ * //     { rangeId: '0-100', label: '$0 - $100', minValue: 0, maxValue: 100, isSelected: false },
+ * //     { rangeId: '100-200', label: '$100 - $200', ... },
+ * //     ...
+ * //   ]
+ * // }
+ * ```
+ */
+declare const searchProducts: _jay_framework_fullstack_component.JayAction<SearchProductsInput, SearchProductsOutput> & _jay_framework_fullstack_component.JayActionDefinition<SearchProductsInput, SearchProductsOutput, [WixStoresV1Service]>;
+/**
+ * Get a single product by its URL slug.
+ *
+ * @example
+ * ```typescript
+ * const product = await getProductBySlug({ slug: 'peat-s-beast-px-finish-54-1' });
+ * ```
+ */
+declare const getProductBySlug: _jay_framework_fullstack_component.JayAction<GetProductBySlugInput, ProductCardViewState> & _jay_framework_fullstack_component.JayActionDefinition<GetProductBySlugInput, ProductCardViewState, [WixStoresV1Service]>;
+/**
+ * Get available collections for filtering.
+ * V1 uses collections instead of categories.
+ *
+ * @example
+ * ```typescript
+ * const collections = await getCollections();
+ * ```
+ */
+declare const getCollections: _jay_framework_fullstack_component.JayAction<Record<string, never>, CollectionViewState[]> & _jay_framework_fullstack_component.JayActionDefinition<Record<string, never>, CollectionViewState[], [WixStoresV1Service]>;
+
+declare enum MediaType$1 {
+  IMAGE,
+  VIDEO
+}
+
+interface MediaViewState {
+  url: string,
+  mediaType: MediaType$1,
+  thumbnail_50x50: string
+}
+
+interface MediaRefs {}
+
+declare enum Selected {
+  selected,
+  notSelected
+}
+
+interface AvailableMediaOfMediaGalleryViewState {
+  mediaId: string,
+  media: MediaViewState,
+  selected: Selected
+}
+
+interface MediaGalleryViewState {
+  selectedMedia: MediaViewState,
+  availableMedia: Array<AvailableMediaOfMediaGalleryViewState>
+}
+
+
+interface MediaGalleryRefs {
+  selectedMedia: MediaRefs,
+  availableMedia: {
+    selected: HTMLElementCollectionProxy<AvailableMediaOfMediaGalleryViewState, HTMLImageElement | HTMLDivElement>,
+    media: MediaRefs
+  }
+}
+
+declare enum ProductType {
+  PHYSICAL,
+  DIGITAL
+}
+
+declare enum StockStatus {
+  OUT_OF_STOCK,
+  IN_STOCK
+}
+
+interface QuantityOfProductPageViewState {
+  quantity: number
+}
+
+declare enum OptionRenderType {
+  TEXT_CHOICES,
+  COLOR_SWATCH_CHOICES
+}
+
+interface ChoiceOfOptionOfProductPageViewState {
+  choiceId: string,
+  choiceType: ChoiceType,
+  name: string,
+  colorCode: string,
+  inStock: boolean,
+  isSelected: boolean
+}
+
+interface OptionOfProductPageViewState {
+  _id: string,
+  name: string,
+  optionRenderType: OptionRenderType,
+  textChoiceSelection: string,
+  choices: Array<ChoiceOfOptionOfProductPageViewState>
+}
+
+interface InfoSectionOfProductPageViewState {
+  _id: string,
+  title: string,
+  plainDescription: string
+}
+
+declare enum ModifierType {
+  TEXT_CHOICES,
+  COLOR_SWATCH_CHOICES,
+  FREE_TEXT
+}
+
+declare enum ChoiceType {
+  CHOICE_TEXT,
+  ONE_COLOR
+}
+
+declare enum ChoiceType {
+  CHOICE_TEXT,
+  ONE_COLOR
+}
+
+interface ChoiceOfModifierOfProductPageViewState {
+  choiceId: string,
+  choiceType: ChoiceType,
+  name: string,
+  colorCode: string,
+  isSelected: boolean
+}
+
+interface ModifierOfProductPageViewState {
+  _id: string,
+  name: string,
+  modifierType: ModifierType,
+  textModifierSelection: string,
+  textInputLength: number,
+  textInputRequired: boolean,
+  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,
+  mediaGallery: MediaGalleryViewState,
+  description: string,
+  brand: string,
+  ribbon: string,
+  productType: ProductType,
+  sku: string,
+  price: string,
+  strikethroughPrice: string,
+  pricePerUnit: string,
+  stockStatus: StockStatus,
+  quantity: QuantityOfProductPageViewState,
+  actionsEnabled: boolean,
+  options: Array<OptionOfProductPageViewState>,
+  infoSections: Array<InfoSectionOfProductPageViewState>,
+  modifiers: Array<ModifierOfProductPageViewState>,
+  seoData: SeoDatumOfProductPageViewState
+}
+
+type ProductPageSlowViewState = Pick<ProductPageViewState, '_id' | 'productName' | 'description' | 'brand' | 'ribbon' | 'productType'> & {
+    options: Array<Pick<ProductPageViewState['options'][number], '_id' | 'name' | 'optionRenderType'> & {
+    choices: Array<Pick<ProductPageViewState['options'][number]['choices'][number], 'choiceId' | 'choiceType' | 'name' | 'colorCode' | 'inStock'>>;
+}>;
+    infoSections: Array<ProductPageViewState['infoSections'][number]>;
+    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'> & {
+    mediaGallery: ProductPageViewState['mediaGallery'];
+    quantity: ProductPageViewState['quantity'];
+    options: Array<Pick<ProductPageViewState['options'][number], '_id' | 'textChoiceSelection'> & {
+    choices: Array<Pick<ProductPageViewState['options'][number]['choices'][number], 'choiceId' | 'isSelected'>>;
+}>;
+    modifiers: Array<Pick<ProductPageViewState['modifiers'][number], '_id' | 'textModifierSelection'> & {
+    choices: Array<Pick<ProductPageViewState['modifiers'][number]['choices'][number], 'choiceId' | 'isSelected'>>;
+}>;
+};
+
+type ProductPageInteractiveViewState = Pick<ProductPageViewState, 'sku' | 'price' | 'strikethroughPrice' | 'pricePerUnit' | 'stockStatus' | 'actionsEnabled'> & {
+    mediaGallery: ProductPageViewState['mediaGallery'];
+    quantity: ProductPageViewState['quantity'];
+    options: Array<Pick<ProductPageViewState['options'][number], '_id' | 'textChoiceSelection'> & {
+    choices: Array<Pick<ProductPageViewState['options'][number]['choices'][number], 'choiceId' | 'isSelected'>>;
+}>;
+    modifiers: Array<Pick<ProductPageViewState['modifiers'][number], '_id' | 'textModifierSelection'> & {
+    choices: Array<Pick<ProductPageViewState['modifiers'][number]['choices'][number], 'choiceId' | 'isSelected'>>;
+}>;
+};
+
+
+interface ProductPageRefs {
+  addToCartButton: HTMLElementProxy<ProductPageViewState, HTMLButtonElement>,
+  buyNowButton: HTMLElementProxy<ProductPageViewState, HTMLButtonElement>,
+  mediaGallery: MediaGalleryRefs,
+  quantity: {
+    decrementButton: HTMLElementProxy<QuantityOfProductPageViewState, HTMLButtonElement>,
+    incrementButton: HTMLElementProxy<QuantityOfProductPageViewState, HTMLButtonElement>,
+    quantity: HTMLElementProxy<QuantityOfProductPageViewState, HTMLInputElement>
+  },
+  options: {
+    textChoice: HTMLElementCollectionProxy<OptionOfProductPageViewState, HTMLSelectElement>,
+    choices: {
+      choiceButton: HTMLElementCollectionProxy<ChoiceOfOptionOfProductPageViewState, HTMLButtonElement>
+    }
+  },
+  modifiers: {
+    textModifier: HTMLElementCollectionProxy<ModifierOfProductPageViewState, HTMLSelectElement>,
+    textInput: HTMLElementCollectionProxy<ModifierOfProductPageViewState, HTMLInputElement | HTMLAreaElement>,
+    choices: {
+      choiceButton: HTMLElementCollectionProxy<ChoiceOfModifierOfProductPageViewState, HTMLButtonElement>
+    }
+  }
+}
+
+/**
+ * URL parameters for product page routes
+ */
+interface ProductPageParams extends UrlParams {
+    slug: string;
+}
+interface InteractiveVariant {
+    _id: string;
+    sku: string;
+    price: string;
+    strikethroughPrice: string;
+    choices: Record<string, string>;
+    inventoryStatus: StockStatus;
+}
+interface ProductSlowCarryForward {
+    productId: string;
+    mediaGallery: MediaGalleryViewState;
+    options: ProductPageFastViewState['options'];
+    pricePerUnit: string;
+    stockStatus: StockStatus;
+    variants: InteractiveVariant[];
+}
+interface ProductFastCarryForward {
+    productId: string;
+    variants: InteractiveVariant[];
+}
+/**
+ * Product Page Component (V1)
+ *
+ * A complete headless product page using Wix Catalog V1 API.
+ */
+declare const productPage: _jay_framework_fullstack_component.JayStackComponentDefinition<ProductPageRefs, ProductPageSlowViewState, ProductPageFastViewState, ProductPageInteractiveViewState, [ProductSlowCarryForward, WixStoresV1Service], [Signals<ProductPageFastViewState>, ProductFastCarryForward, WixStoresV1Context], PageProps & ProductPageParams, ProductPageParams, _jay_framework_component.JayComponentCore<PageProps & ProductPageParams, ProductPageInteractiveViewState>>;
+
+interface RangeOfPriceRangeOfFilterOfProductSearchViewState {
+  rangeId: string,
+  label: string,
+  minValue: number,
+  maxValue: number,
+  isSelected: boolean
+}
+
+interface PriceRangeOfFilterOfProductSearchViewState {
+  minPrice: number,
+  maxPrice: number,
+  minBound: number,
+  maxBound: number,
+  ranges: Array<RangeOfPriceRangeOfFilterOfProductSearchViewState>
+}
+
+interface CategoryOfCategoryFilterOfFilterOfProductSearchViewState {
+  categoryId: string,
+  categoryName: string,
+  categorySlug: string,
+  isSelected: boolean
+}
+
+interface CategoryFilterOfFilterOfProductSearchViewState {
+  categories: Array<CategoryOfCategoryFilterOfFilterOfProductSearchViewState>
+}
+
+interface FilterOfProductSearchViewState {
+  priceRange: PriceRangeOfFilterOfProductSearchViewState,
+  categoryFilter: CategoryFilterOfFilterOfProductSearchViewState
+}
+
+declare enum CurrentSort {
+  relevance,
+  priceAsc,
+  priceDesc,
+  newest,
+  nameAsc,
+  nameDesc
+}
+
+interface SortByOfProductSearchViewState {
+  currentSort: CurrentSort
+}
+
+interface SuggestionOfProductSearchViewState {
+  suggestionId: string,
+  suggestionText: string
+}
+
+interface ProductSearchViewState {
+  searchExpression: string,
+  searchFields: string,
+  fuzzySearch: boolean,
+  isSearching: boolean,
+  hasSearched: boolean,
+  searchResults: Array<ProductCardViewState>,
+  resultCount: number,
+  hasResults: boolean,
+  emptyStateMessage: string,
+  filters: FilterOfProductSearchViewState,
+  sortBy: SortByOfProductSearchViewState,
+  hasMore: boolean,
+  loadedCount: number,
+  totalCount: number,
+  hasSuggestions: boolean,
+  suggestions: Array<SuggestionOfProductSearchViewState>
+}
+
+type ProductSearchSlowViewState = Pick<ProductSearchViewState, 'searchFields' | 'fuzzySearch' | 'emptyStateMessage'> & {
+    filters: {
+    categoryFilter: {
+    categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'categoryName' | 'categorySlug'>>;
+};
+};
+};
+
+type ProductSearchFastViewState = Pick<ProductSearchViewState, 'searchExpression' | 'isSearching' | 'hasSearched' | 'resultCount' | 'hasResults' | 'hasMore' | 'loadedCount' | 'totalCount' | 'hasSuggestions'> & {
+    searchResults: Array<ProductSearchViewState['searchResults'][number]>;
+    filters: {
+    priceRange: ProductSearchViewState['filters']['priceRange'];
+    categoryFilter: {
+    categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
+};
+};
+    sortBy: ProductSearchViewState['sortBy'];
+    suggestions: Array<ProductSearchViewState['suggestions'][number]>;
+};
+
+type ProductSearchInteractiveViewState = Pick<ProductSearchViewState, 'searchExpression' | 'isSearching' | 'hasSearched' | 'resultCount' | 'hasResults' | 'hasMore' | 'loadedCount' | 'totalCount' | 'hasSuggestions'> & {
+    searchResults: Array<ProductSearchViewState['searchResults'][number]>;
+    filters: {
+    priceRange: ProductSearchViewState['filters']['priceRange'];
+    categoryFilter: {
+    categories: Array<Pick<ProductSearchViewState['filters']['categoryFilter']['categories'][number], 'categoryId' | 'isSelected'>>;
+};
+};
+    sortBy: ProductSearchViewState['sortBy'];
+    suggestions: Array<ProductSearchViewState['suggestions'][number]>;
+};
+
+
+interface ProductSearchRefs {
+  searchExpression: HTMLElementProxy<ProductSearchViewState, HTMLInputElement>,
+  searchButton: HTMLElementProxy<ProductSearchViewState, HTMLButtonElement>,
+  clearSearchButton: HTMLElementProxy<ProductSearchViewState, HTMLButtonElement>,
+  loadMoreButton: HTMLElementProxy<ProductSearchViewState, HTMLButtonElement>,
+  searchResults: ProductCardRepeatedRefs,
+  filters: {
+    clearFilters: HTMLElementProxy<FilterOfProductSearchViewState, HTMLButtonElement>,
+    priceRange: {
+      minPrice: HTMLElementProxy<PriceRangeOfFilterOfProductSearchViewState, HTMLInputElement>,
+      maxPrice: HTMLElementProxy<PriceRangeOfFilterOfProductSearchViewState, HTMLInputElement>,
+      ranges: {
+        isSelected: HTMLElementCollectionProxy<RangeOfPriceRangeOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
+    },
+    categoryFilter: {
+      categories: {
+        isSelected: HTMLElementCollectionProxy<CategoryOfCategoryFilterOfFilterOfProductSearchViewState, HTMLInputElement>
+      }
+    }
+  },
+  sortBy: {
+    sortDropdown: HTMLElementProxy<SortByOfProductSearchViewState, HTMLSelectElement>
+  },
+  suggestions: {
+    suggestionButton: HTMLElementCollectionProxy<SuggestionOfProductSearchViewState, HTMLButtonElement>
+  }
+}
+
+/**
+ * Collection info for filtering (V1 uses collections, not categories)
+ */
+type CollectionInfos = ProductSearchSlowViewState['filters']['categoryFilter']['categories'];
+interface SearchSlowCarryForward {
+    searchFields: string;
+    fuzzySearch: boolean;
+    collections: CollectionInfos;
+}
+interface SearchFastCarryForward {
+    searchFields: string;
+    fuzzySearch: boolean;
+    collections: CollectionInfos;
+}
+/**
+ * Product Search Component (V1)
+ *
+ * A complete headless product search using Wix Catalog V1 API.
+ * Uses collections for filtering and page-based pagination.
+ */
+declare const productSearch: _jay_framework_fullstack_component.JayStackComponentDefinition<ProductSearchRefs, ProductSearchSlowViewState, ProductSearchFastViewState, ProductSearchInteractiveViewState, [SearchSlowCarryForward, WixStoresV1Service], [Signals<ProductSearchFastViewState>, SearchFastCarryForward, WixStoresV1Context], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, ProductSearchInteractiveViewState>>;
+
+interface CategoryOfCategoryListViewState {
+  _id: string,
+  name: string,
+  slug: string,
+  description: string,
+  productCount: number,
+  imageUrl: string,
+  hasImage: boolean
+}
+
+interface CategoryListViewState {
+  categories: Array<CategoryOfCategoryListViewState>,
+  hasCategories: boolean
+}
+
+type CategoryListSlowViewState = Pick<CategoryListViewState, 'hasCategories'> & {
+    categories: Array<CategoryListViewState['categories'][number]>;
+};
+
+type CategoryListFastViewState = {};
+
+type CategoryListInteractiveViewState = {};
+
+
+interface CategoryListRefs {
+  categories: {
+    categoryLink: HTMLElementCollectionProxy<CategoryOfCategoryListViewState, HTMLAnchorElement>
+  }
+}
+
+/**
+ * Collection List Component (V1)
+ *
+ * A headless component that displays a grid of store collections.
+ * Uses the same contract as category-list for template compatibility.
+ *
+ * Usage:
+ * ```html
+ * <script type="application/jay-headless"
+ *         plugin="@jay-framework/wix-stores-v1"
+ *         contract="category-list"
+ *         key="collectionList"
+ * ></script>
+ *
+ * <div class="collections-grid">
+ *   <article forEach="collectionList.categories" trackBy="_id">
+ *     <a href="/collections/{slug}" ref="collectionList.categories.categoryLink">
+ *       <img src="{imageUrl}" alt="{name}" />
+ *       <h2>{name}</h2>
+ *       <span>{productCount} products</span>
+ *     </a>
+ *   </article>
+ * </div>
+ * ```
+ */
+declare const collectionList: _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresV1Service], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & {
+    withFastRender<NewCarryForward extends object>(fastRender: _jay_framework_fullstack_component.RenderFast<[Record<string, never>, WixStoresV1Service], PageProps, CategoryListFastViewState, NewCarryForward>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresV1Service], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & {
+        withClientDefaults(fn: (props: PageProps) => {
+            viewState: CategoryListFastViewState;
+            carryForward?: any;
+        }): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresV1Service], [_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>, WixStoresV1Service], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, 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>, WixStoresV1Service], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>;
+};
+declare const categoryList: _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresV1Service], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & {
+    withFastRender<NewCarryForward extends object>(fastRender: _jay_framework_fullstack_component.RenderFast<[Record<string, never>, WixStoresV1Service], PageProps, CategoryListFastViewState, NewCarryForward>): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresV1Service], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>> & {
+        withClientDefaults(fn: (props: PageProps) => {
+            viewState: CategoryListFastViewState;
+            carryForward?: any;
+        }): _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryListRefs, CategoryListSlowViewState, CategoryListFastViewState, CategoryListInteractiveViewState, [Record<string, never>, WixStoresV1Service], [_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>, WixStoresV1Service], [_jay_framework_fullstack_component.Signals<CategoryListFastViewState>, NewCarryForward], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, 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>, WixStoresV1Service], [], PageProps, {}, _jay_framework_component.JayComponentCore<PageProps, CategoryListInteractiveViewState>>;
+};
+
+interface MainMediaOfMediaOfCategoryPageViewState {
+  _id: string,
+  url: string,
+  altText: string,
+  mediaType: MediaType
+}
+
+declare enum MediaType {
+  IMAGE,
+  VIDEO,
+  AUDIO,
+  DOCUMENT,
+  ZIP
+}
+
+declare enum MediaType {
+  IMAGE,
+  VIDEO,
+  AUDIO,
+  DOCUMENT,
+  ZIP
+}
+
+interface ThumbnailOfItemOfMediaOfCategoryPageViewState {
+  url: string,
+  width: number,
+  height: number,
+  format: string
+}
+
+interface ItemOfMediaOfCategoryPageViewState {
+  _id: string,
+  url: string,
+  altText: string,
+  title: string,
+  mediaType: MediaType,
+  thumbnail: ThumbnailOfItemOfMediaOfCategoryPageViewState
+}
+
+interface MediaOfCategoryPageViewState {
+  mainMedia: MainMediaOfMediaOfCategoryPageViewState,
+  items: Array<ItemOfMediaOfCategoryPageViewState>
+}
+
+interface BreadcrumbOfCategoryPageViewState {
+  categoryId: string,
+  categoryName: string,
+  categorySlug: string
+}
+
+interface CategoryPageViewState {
+  _id: string,
+  name: string,
+  description: string,
+  slug: string,
+  visible: boolean,
+  numberOfProducts: number,
+  hasImage: boolean,
+  media: MediaOfCategoryPageViewState,
+  breadcrumbs: Array<BreadcrumbOfCategoryPageViewState>,
+  products: Array<ProductCardViewState>,
+  loadedProducts: Array<ProductCardViewState>,
+  hasMore: boolean,
+  loadedCount: number,
+  isLoading: boolean,
+  hasProducts: boolean
+}
+
+type CategoryPageSlowViewState = Pick<CategoryPageViewState, '_id' | 'name' | 'description' | 'slug' | 'visible' | 'numberOfProducts' | 'hasImage'> & {
+    media: CategoryPageViewState['media'];
+    breadcrumbs: Array<CategoryPageViewState['breadcrumbs'][number]>;
+    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'name' | 'slug' | 'productUrl' | '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' | 'variantId'>>;
+};
+}>;
+};
+
+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'>>;
+};
+}>;
+    loadedProducts: Array<CategoryPageViewState['loadedProducts'][number]>;
+};
+
+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'>>;
+};
+}>;
+    loadedProducts: Array<CategoryPageViewState['loadedProducts'][number]>;
+};
+
+
+interface CategoryPageRefs {
+  loadMoreButton: HTMLElementProxy<CategoryPageViewState, HTMLButtonElement>,
+  breadcrumbs: {
+    categoryLink: HTMLElementCollectionProxy<BreadcrumbOfCategoryPageViewState, HTMLAnchorElement>
+  },
+  products: ProductCardRepeatedRefs,
+  loadedProducts: ProductCardRepeatedRefs
+}
+
+/**
+ * URL parameters for collection page routes
+ */
+interface CollectionPageParams extends UrlParams {
+    slug: string;
+}
+interface CollectionSlowCarryForward {
+    collectionId: string;
+    collectionSlug: string;
+    totalProducts: number;
+    products: ProductCardViewState[];
+    currentOffset: number;
+}
+interface CollectionFastCarryForward {
+    collectionId: string;
+    totalProducts: number;
+    currentOffset: number;
+}
+/**
+ * Collection Page Component (V1)
+ *
+ * A headless collection page using Wix Catalog V1 API.
+ * Uses the same contract as category-page for template compatibility.
+ */
+declare const collectionPage: _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryPageRefs, CategoryPageSlowViewState, CategoryPageFastViewState, CategoryPageInteractiveViewState, [CollectionSlowCarryForward, WixStoresV1Service], [Signals<CategoryPageFastViewState>, CollectionFastCarryForward, WixStoresV1Context], PageProps & CollectionPageParams, CollectionPageParams, _jay_framework_component.JayComponentCore<PageProps & CollectionPageParams, CategoryPageInteractiveViewState>>;
+declare const categoryPage: _jay_framework_fullstack_component.JayStackComponentDefinition<CategoryPageRefs, CategoryPageSlowViewState, CategoryPageFastViewState, CategoryPageInteractiveViewState, [CollectionSlowCarryForward, WixStoresV1Service], [Signals<CategoryPageFastViewState>, CollectionFastCarryForward, WixStoresV1Context], PageProps & CollectionPageParams, CollectionPageParams, _jay_framework_component.JayComponentCore<PageProps & CollectionPageParams, CategoryPageInteractiveViewState>>;
+
+declare const init: _jay_framework_fullstack_component.JayInit<WixStoresV1InitData>;
+
+export { type CollectionPageParams, type CollectionViewState, type GetProductBySlugInput, type PriceAggregationData, type PriceRangeBucket, type ProductPageParams, type ProductSearchFilters, type ProductSortField, type SearchProductsInput, type SearchProductsOutput, type V1Collection, WIX_STORES_V1_CONTEXT, WIX_STORES_V1_SERVICE_MARKER, type WixStoresV1Context, type WixStoresV1InitData, type WixStoresV1Service, categoryList, categoryPage, collectionList, collectionPage, getCollections, getProductBySlug, init, productPage, productSearch, provideWixStoresV1Service, searchProducts };