@wix/headless-stores 0.0.77 → 0.0.79

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],
-        },
-    };
-}

package/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/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;
-}