@wix/headless-stores 0.0.76 → 0.0.78

package/dist/react/core/CategoryList.js

@@ -1,11 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
 import { useService, WixServices } from '@wix/services-manager-react';
 import { createServicesMap } from '@wix/services-manager';
 import { CategoriesListService, CategoriesListServiceDefinition, } from '../../services/categories-list-service.js';
-import { Root as CategoryRoot } from './Category.js';
 /**
  * Root component that provides the CategoryList service context to its children.
  * This component sets up the necessary services for managing categories list state.
+ * Optionally connects to ProductList filtering when connectToProductFilter is enabled.
  *
  * @order 1
  * @component
@@ -15,7 +16,10 @@ import { Root as CategoryRoot } from './Category.js';
  *
  * function CategoriesPage() {
  *   return (
- *     <CategoryList.Root categoriesListConfig={{ collectionId: 'my-collection' }}>
+ *     <CategoryList.Root
+ *       categoriesListConfig={{ categories: myCategories }}
+ *       connectToProductFilter={true}
+ *     >
  *       <CategoryList.ItemContent>
  *         {({ category }) => (
  *           <div key={category._id}>
@@ -29,7 +33,8 @@ import { Root as CategoryRoot } from './Category.js';
  * ```
  */
 export function Root(props) {
-    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(CategoriesListServiceDefinition, CategoriesListService, props.categoriesListConfig), children: props.children }));
+    const { categoriesListConfig, children } = props;
+    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(CategoriesListServiceDefinition, CategoriesListService, categoriesListConfig), children: children }));
 }
 /**
  * Component that renders content when the categories list is empty.
@@ -166,7 +171,7 @@ export function ItemContent(props) {
     if (isLoading.get() || error.get() || categoriesValue.length === 0) {
         return null;
     }
-    return categoriesValue.map((category) => (_jsx(CategoryRoot, { categoryServiceConfig: { category }, children: typeof props.children === 'function'
+    return categoriesValue.map((category) => (_jsx(React.Fragment, { children: typeof props.children === 'function'
             ? props.children({
                 category,
             })

package/dist/react/core/ProductListFilters.d.ts

@@ -50,7 +50,7 @@ export interface ResetTriggerRenderProps {
 export declare function ResetTrigger(props: ResetTriggerProps): ReactNode;
 export interface CategoryFilterRenderProps {
     selectedCategory: Category | null;
-    setSelectedCategory: (category: Category) => void;
+    setSelectedCategory: (category: Category | null) => void;
 }
 export interface CategoryFilterProps {
     /** Content to display (can be a render function receiving category data or ReactNode) */

package/dist/react/index.d.ts

@@ -1,5 +1,4 @@
 export * as CategoryListCore from './core/CategoryList.js';
-export * as CategoryCore from './core/Category.js';
 export * as ProductCore from './core/Product.js';
 export * as ProductModifiers from './core/ProductModifiers.js';
 export * as ProductListCore from './core/ProductList.js';

package/dist/react/index.js

@@ -1,5 +1,4 @@
 export * as CategoryListCore from './core/CategoryList.js';
-export * as CategoryCore from './core/Category.js';
 export * as ProductCore from './core/Product.js';
 export * as ProductModifiers from './core/ProductModifiers.js';
 export * as ProductListCore from './core/ProductList.js';

package/dist/services/categories-list-service.d.ts

@@ -1,5 +1,6 @@
 import { type Signal } from '@wix/services-definitions/core-services/signals';
-import { type Category } from './category-service.js';
+import { categories } from '@wix/categories';
+export type Category = categories.Category;
 /**
  * Configuration interface for the Categories List service.
  * Contains the initial categories data that will be loaded into the service.

package/dist/services/index.d.ts

@@ -1,4 +1,3 @@
-export { CategoryService, CategoryServiceDefinition, loadCategoryServiceConfig, CategoryServiceConfig, Category, } from './category-service.js';
 export { CategoriesListService, CategoriesListServiceDefinition, loadCategoriesListServiceConfig, CategoriesListServiceConfig, } from './categories-list-service.js';
 export { ProductModifiersService, ProductModifiersServiceDefinition, } from './product-modifiers-service.js';
 export { ProductService, ProductServiceDefinition, loadProductServiceConfig, } from './product-service.js';

package/dist/services/index.js

@@ -1,4 +1,3 @@
-export { CategoryService, CategoryServiceDefinition, loadCategoryServiceConfig, } from './category-service.js';
 export { CategoriesListService, CategoriesListServiceDefinition, loadCategoriesListServiceConfig, } from './categories-list-service.js';
 export { ProductModifiersService, ProductModifiersServiceDefinition, } from './product-modifiers-service.js';
 export { ProductService, ProductServiceDefinition, loadProductServiceConfig, } from './product-service.js';

package/dist/services/products-list-service.d.ts

@@ -1,6 +1,7 @@
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
 import { customizationsV3, productsV3 } from '@wix/stores';
-import { type Category } from './category-service.js';
+import { categories } from '@wix/categories';
+type Category = categories.Category;
 export declare const DEFAULT_QUERY_LIMIT = 100;
 import { SortType } from './../enums/sort-enums.js';
 export { SortType } from './../enums/sort-enums.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-stores",
-  "version": "0.0.76",
+  "version": "0.0.78",
   "type": "module",
   "scripts": {
     "prebuild": "cd ../media && yarn build && cd ../ecom && yarn build",
@@ -63,7 +63,7 @@
     "@wix/ecom": "^1.0.1278",
     "@wix/essentials": "^0.1.24",
     "@wix/headless-components": "0.0.12",
-    "@wix/headless-ecom": "0.0.24",
+    "@wix/headless-ecom": "0.0.25",
     "@wix/headless-media": "0.0.11",
     "@wix/headless-utils": "0.0.3",
     "@wix/redirects": "^1.0.83",

package/cjs/dist/react/core/Category.d.ts

@@ -1,98 +0,0 @@
-import { type CategoryServiceConfig } from '../../services/category-service.js';
-export interface RootProps {
-    children: React.ReactNode;
-    categoryServiceConfig: CategoryServiceConfig;
-}
-/**
- * Root component that provides the Category service context to its children.
- * This component sets up the necessary services for managing category state.
- *
- * @order 1
- * @component
- * @example
- * ```tsx
- * import { CategoryCore } from '@wix/stores/components';
- *
- * function CategoryPage() {
- *   return (
- *     <Category.Root categoryServiceConfig={{ category: myCategory }}>
- *       <Category.Name>
- *         {({ name }) => <h1>{name}</h1>}
- *       </Category.Name>
- *       <Category.Slug>
- *         {({ slug }) => <p>Slug: {slug}</p>}
- *       </Category.Slug>
- *     </Category.Root>
- *   );
- * }
- * ```
- */
-export declare function Root(props: RootProps): React.ReactNode;
-/**
- * Props for Name headless component
- */
-export interface NameProps {
-    /** Content to display (can be a render function receiving name data or ReactNode) */
-    children: ((props: NameRenderProps) => React.ReactNode) | React.ReactNode;
-}
-/**
- * Render props for Name component
- */
-export interface NameRenderProps {
-    /** Category name */
-    name: string;
-}
-/**
- * Headless component for category name display
- *
- * @component
- * @example
- * ```tsx
- * import { CategoryCore } from '@wix/stores/components';
- *
- * function CategoryHeader() {
- *   return (
- *     <Category.Name>
- *       {({ name }) => (
- *         <h1 className="category-title">{name}</h1>
- *       )}
- *     </Category.Name>
- *   );
- * }
- * ```
- */
-export declare function Name(props: NameProps): import("react").ReactNode;
-/**
- * Props for Slug headless component
- */
-export interface SlugProps {
-    /** Content to display (can be a render function receiving slug data or ReactNode) */
-    children: ((props: SlugRenderProps) => React.ReactNode) | React.ReactNode;
-}
-/**
- * Render props for Slug component
- */
-export interface SlugRenderProps {
-    /** Category slug */
-    slug: string;
-}
-/**
- * Headless component for category slug display
- *
- * @component
- * @example
- * ```tsx
- * import { CategoryCore } from '@wix/stores/components';
- *
- * function CategoryInfo() {
- *   return (
- *     <Category.Slug>
- *       {({ slug }) => (
- *         <p className="category-slug">Category slug: {slug}</p>
- *       )}
- *     </Category.Slug>
- *   );
- * }
- * ```
- */
-export declare function Slug(props: SlugProps): import("react").ReactNode;

package/cjs/dist/react/core/Category.js

@@ -1,81 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { createServicesMap } from '@wix/services-manager';
-import { useService, WixServices } from '@wix/services-manager-react';
-import { CategoryService, CategoryServiceDefinition, } from '../../services/category-service.js';
-/**
- * Root component that provides the Category service context to its children.
- * This component sets up the necessary services for managing category state.
- *
- * @order 1
- * @component
- * @example
- * ```tsx
- * import { CategoryCore } from '@wix/stores/components';
- *
- * function CategoryPage() {
- *   return (
- *     <Category.Root categoryServiceConfig={{ category: myCategory }}>
- *       <Category.Name>
- *         {({ name }) => <h1>{name}</h1>}
- *       </Category.Name>
- *       <Category.Slug>
- *         {({ slug }) => <p>Slug: {slug}</p>}
- *       </Category.Slug>
- *     </Category.Root>
- *   );
- * }
- * ```
- */
-export function Root(props) {
-    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(CategoryServiceDefinition, CategoryService, props.categoryServiceConfig), children: props.children }));
-}
-/**
- * Headless component for category name display
- *
- * @component
- * @example
- * ```tsx
- * import { CategoryCore } from '@wix/stores/components';
- *
- * function CategoryHeader() {
- *   return (
- *     <Category.Name>
- *       {({ name }) => (
- *         <h1 className="category-title">{name}</h1>
- *       )}
- *     </Category.Name>
- *   );
- * }
- * ```
- */
-export function Name(props) {
-    const categoryService = useService(CategoryServiceDefinition);
-    return typeof props.children === 'function'
-        ? props.children({ name: categoryService.category.get().name })
-        : props.children;
-}
-/**
- * Headless component for category slug display
- *
- * @component
- * @example
- * ```tsx
- * import { CategoryCore } from '@wix/stores/components';
- *
- * function CategoryInfo() {
- *   return (
- *     <Category.Slug>
- *       {({ slug }) => (
- *         <p className="category-slug">Category slug: {slug}</p>
- *       )}
- *     </Category.Slug>
- *   );
- * }
- * ```
- */
-export function Slug(props) {
-    const categoryService = useService(CategoryServiceDefinition);
-    return typeof props.children === 'function'
-        ? props.children({ slug: categoryService.category.get().slug })
-        : props.children;
-}

package/cjs/dist/services/category-service.d.ts

@@ -1,161 +0,0 @@
-import { categories } from '@wix/categories';
-import { type Signal } from '@wix/services-definitions/core-services/signals';
-/**
- * Type representing a category from the Wix Categories API.
- * This type is used to define the structure of category objects in the service.
- *
- * @type Category
- */
-export type Category = categories.Category;
-export interface CategoryServiceAPI {
-    /** Reactive signal containing the current category data */
-    category: Signal<Category>;
-    /** Reactive signal indicating if a category is currently selected */
-    isSelected: Signal<boolean>;
-}
-/**
- * Service definition for the Category service.
- * This defines the reactive API contract for managing a single product category.
- *
- * @constant
- */
-export declare const CategoryServiceDefinition: string & {
-    __api: CategoryServiceAPI;
-    __config: {};
-    isServiceDefinition?: boolean;
-} & CategoryServiceAPI;
-/**
- * Configuration interface for the Category service.
- * Contains the initial category data that will be loaded into the service.
- *
- * @interface CategoryServiceConfig
- */
-export type CategoryServiceConfig = {
-    /** The category object to initialize the service with */
-    category: Category;
-    /** Whether the category is currently selected */
-    isSelected?: boolean;
-};
-/**
- * Implementation of the Category service that manages reactive category data.
- * This service provides a signal for category data and maintains it in a reactive state.
- * The service is initialized with pre-loaded category data.
- *
- * @example
- * ```tsx
- * import { CategoryService, CategoryServiceDefinition } from '@wix/stores/services';
- * import { useService } from '@wix/services-manager-react';
- *
- * function CategoryComponent({ categoryConfig }) {
- *   return (
- *     <ServiceProvider services={createServicesMap([
- *       [CategoryServiceDefinition, CategoryService.withConfig(categoryConfig)]
- *     ])}>
- *       <CategoryDisplay />
- *     </ServiceProvider>
- *   );
- * }
- *
- * function CategoryDisplay() {
- *   const categoryService = useService(CategoryServiceDefinition);
- *   const category = categoryService.category.get();
- *
- *   return (
- *     <div>
- *       <h1>{category.name}</h1>
- *       <p>{category.description}</p>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare const CategoryService: import("@wix/services-definitions").ServiceFactory<string & {
-    __api: CategoryServiceAPI;
-    __config: {};
-    isServiceDefinition?: boolean;
-} & CategoryServiceAPI, CategoryServiceConfig>;
-/**
- * Loads category service configuration from the Wix Categories API for SSR initialization.
- * This function is designed to be used during Server-Side Rendering (SSR) to preload
- * a specific category by slug that will be used to configure the CategoryService.
- *
- * @param {string} slug - The category slug to load
- * @returns {Promise} Promise that resolves to either success with config or not-found result
- *
- * @example
- * ```astro
- * ---
- * // Astro page example - pages/category/[slug].astro
- * import { loadCategoryServiceConfig } from '@wix/stores/services';
- * import { Category } from '@wix/stores/components/react';
- *
- * // Get category slug from URL params
- * const { slug } = Astro.params;
- *
- * // Load category data during SSR
- * const categoryResult = await loadCategoryServiceConfig(slug);
- *
- * // Handle not found case
- * if (categoryResult.type === 'not-found') {
- *   return Astro.redirect('/404');
- * }
- * ---
- *
- * <Category.Root categoryConfig={categoryResult.config}>
- *   <Category.Name>
- *     {({ name }) => <h1>{name}</h1>}
- *   </Category.Name>
- * </Category.Root>
- * ```
- *
- * @example
- * ```tsx
- * // Next.js page example - pages/category/[slug].tsx
- * import { GetServerSideProps } from 'next';
- * import { loadCategoryServiceConfig } from '@wix/stores/services';
- * import { Category } from '@wix/stores/components/react';
- *
- * interface CategoryPageProps {
- *   categoryConfig: Awaited<ReturnType<typeof loadCategoryServiceConfig>>['config'];
- * }
- *
- * export const getServerSideProps: GetServerSideProps<CategoryPageProps> = async ({ params }) => {
- *   const slug = params?.slug as string;
- *
- *   // Load category data during SSR
- *   const categoryResult = await loadCategoryServiceConfig(slug);
- *
- *   // Handle not found case
- *   if (categoryResult.type === 'not-found') {
- *     return {
- *       notFound: true,
- *     };
- *   }
- *
- *   return {
- *     props: {
- *       categoryConfig: categoryResult.config,
- *     },
- *   };
- * };
- *
- * export default function CategoryPage({ categoryConfig }: CategoryPageProps) {
- *   return (
- *     <Category.Root categoryConfig={categoryConfig}>
- *       <Category.Name>
- *         {({ name }) => <h1>{name}</h1>}
- *       </Category.Name>
- *     </Category.Root>
- *   );
- * }
- * ```
- */
-export declare function loadCategoryServiceConfig(slug: string): Promise<{
-    /** Type "success" means that the category was found and the config is valid */
-    type: 'success';
-    /** The category config containing the loaded category data */
-    config: CategoryServiceConfig;
-} | {
-    /** Type "not-found" means that the category was not found */
-    type: 'not-found';
-}>;

package/cjs/dist/services/category-service.js

@@ -1,149 +0,0 @@
-import { defineService, implementService } from '@wix/services-definitions';
-import { categories } from '@wix/categories';
-import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-/**
- * Service definition for the Category service.
- * This defines the reactive API contract for managing a single product category.
- *
- * @constant
- */
-export const CategoryServiceDefinition = defineService('category');
-/**
- * Implementation of the Category service that manages reactive category data.
- * This service provides a signal for category data and maintains it in a reactive state.
- * The service is initialized with pre-loaded category data.
- *
- * @example
- * ```tsx
- * import { CategoryService, CategoryServiceDefinition } from '@wix/stores/services';
- * import { useService } from '@wix/services-manager-react';
- *
- * function CategoryComponent({ categoryConfig }) {
- *   return (
- *     <ServiceProvider services={createServicesMap([
- *       [CategoryServiceDefinition, CategoryService.withConfig(categoryConfig)]
- *     ])}>
- *       <CategoryDisplay />
- *     </ServiceProvider>
- *   );
- * }
- *
- * function CategoryDisplay() {
- *   const categoryService = useService(CategoryServiceDefinition);
- *   const category = categoryService.category.get();
- *
- *   return (
- *     <div>
- *       <h1>{category.name}</h1>
- *       <p>{category.description}</p>
- *     </div>
- *   );
- * }
- * ```
- */
-export const CategoryService = implementService.withConfig()(CategoryServiceDefinition, ({ getService, config }) => {
-    const signalsService = getService(SignalsServiceDefinition);
-    const categorySignal = signalsService.signal(config.category);
-    const isSelectedSignal = signalsService.signal(config.isSelected ?? false);
-    return {
-        category: categorySignal,
-        isSelected: isSelectedSignal,
-    };
-});
-/**
- * Loads category service configuration from the Wix Categories API for SSR initialization.
- * This function is designed to be used during Server-Side Rendering (SSR) to preload
- * a specific category by slug that will be used to configure the CategoryService.
- *
- * @param {string} slug - The category slug to load
- * @returns {Promise} Promise that resolves to either success with config or not-found result
- *
- * @example
- * ```astro
- * ---
- * // Astro page example - pages/category/[slug].astro
- * import { loadCategoryServiceConfig } from '@wix/stores/services';
- * import { Category } from '@wix/stores/components/react';
- *
- * // Get category slug from URL params
- * const { slug } = Astro.params;
- *
- * // Load category data during SSR
- * const categoryResult = await loadCategoryServiceConfig(slug);
- *
- * // Handle not found case
- * if (categoryResult.type === 'not-found') {
- *   return Astro.redirect('/404');
- * }
- * ---
- *
- * <Category.Root categoryConfig={categoryResult.config}>
- *   <Category.Name>
- *     {({ name }) => <h1>{name}</h1>}
- *   </Category.Name>
- * </Category.Root>
- * ```
- *
- * @example
- * ```tsx
- * // Next.js page example - pages/category/[slug].tsx
- * import { GetServerSideProps } from 'next';
- * import { loadCategoryServiceConfig } from '@wix/stores/services';
- * import { Category } from '@wix/stores/components/react';
- *
- * interface CategoryPageProps {
- *   categoryConfig: Awaited<ReturnType<typeof loadCategoryServiceConfig>>['config'];
- * }
- *
- * export const getServerSideProps: GetServerSideProps<CategoryPageProps> = async ({ params }) => {
- *   const slug = params?.slug as string;
- *
- *   // Load category data during SSR
- *   const categoryResult = await loadCategoryServiceConfig(slug);
- *
- *   // Handle not found case
- *   if (categoryResult.type === 'not-found') {
- *     return {
- *       notFound: true,
- *     };
- *   }
- *
- *   return {
- *     props: {
- *       categoryConfig: categoryResult.config,
- *     },
- *   };
- * };
- *
- * export default function CategoryPage({ categoryConfig }: CategoryPageProps) {
- *   return (
- *     <Category.Root categoryConfig={categoryConfig}>
- *       <Category.Name>
- *         {({ name }) => <h1>{name}</h1>}
- *       </Category.Name>
- *     </Category.Root>
- *   );
- * }
- * ```
- */
-export async function loadCategoryServiceConfig(slug) {
-    const category = await categories
-        .queryCategories({
-        treeReference: {
-            appNamespace: '@wix/stores',
-        },
-    })
-        .eq('slug', slug)
-        .find();
-    if (category.items.length === 0) {
-        return {
-            type: 'not-found',
-        };
-    }
-    return {
-        type: 'success',
-        config: {
-            category: category.items[0],
-        },
-    };
-}