@wix/headless-stores 0.0.55 → 0.0.57

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3,12 +3,16 @@ import { useService } from '@wix/services-manager-react';
3
3
  import React from 'react';
4
4
  import { ProductsListServiceDefinition } from '../services/products-list-service.js';
5
5
  import * as CoreProductList from './core/ProductList.js';
6
+ import * as CoreProductListPagination from './core/ProductListPagination.js';
6
7
  import * as Product from './Product.js';
8
+ import { AsChildSlot } from '@wix/headless-utils/react';
7
9
  var TestIds;
8
10
  (function (TestIds) {
9
11
  TestIds["productListRoot"] = "product-list-root";
10
12
  TestIds["productListProducts"] = "product-list-products";
11
13
  TestIds["productListItem"] = "product-list-item";
14
+ TestIds["productListLoadMore"] = "product-list-load-more";
15
+ TestIds["productListTotalsDisplayed"] = "product-list-totals-displayed";
12
16
  })(TestIds || (TestIds = {}));
13
17
  /**
14
18
  * Root component that provides the ProductList service context for rendering product lists.
@@ -154,3 +158,49 @@ export const ProductRepeater = React.forwardRef((props, _ref) => {
154
158
  return null;
155
159
  return (_jsx(_Fragment, { children: products.map((product) => (_jsx(Product.Root, { product: product, "data-testid": TestIds.productListItem, "data-product-id": product._id, "data-product-available": true, children: children }, product._id))) }));
156
160
  });
161
+ /**
162
+ * Displays a button to load more products. Not rendered if infiniteScroll is false or no products are left to load.
163
+ * Follows the architecture rules - does not support asChild as it's a simple trigger component.
164
+ *
165
+ * @component
166
+ * @example
167
+ * ```tsx
168
+ * <ProductList.LoadMoreTrigger asChild>
169
+ * <button>Load More</button>
170
+ * </ProductList.LoadMoreTrigger>
171
+ * ```
172
+ */
173
+ export const LoadMoreTrigger = React.forwardRef((props, ref) => {
174
+ const { asChild, children, className } = props;
175
+ return (_jsx(CoreProductListPagination.LoadMoreTrigger, { children: ({ loadMore, hasMoreProducts, isLoading }) => {
176
+ // Don't render if no more products to load
177
+ if (!hasMoreProducts)
178
+ return null;
179
+ const handleClick = () => loadMore(10);
180
+ return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, onClick: handleClick, disabled: isLoading, "data-testid": TestIds.productListLoadMore, customElement: children, children: _jsx("button", { children: children }) }));
181
+ } }));
182
+ });
183
+ /**
184
+ * Displays the number of products currently displayed.
185
+ *
186
+ * @component
187
+ * @example
188
+ * ```tsx
189
+ * <ProductList.TotalsDisplayed />
190
+ * // or with asChild
191
+ * <ProductList.TotalsDisplayed asChild>
192
+ * <strong />
193
+ * </ProductList.TotalsDisplayed>
194
+ * // or with render function
195
+ * <ProductList.TotalsDisplayed asChild>
196
+ * {({ displayedProducts }, ref) => <strong ref={ref}>{displayedProducts}</strong>}
197
+ * </ProductList.TotalsDisplayed>
198
+ * ```
199
+ */
200
+ export const TotalsDisplayed = React.forwardRef((props, ref) => {
201
+ const { asChild, children, className } = props;
202
+ const productsListService = useService(ProductsListServiceDefinition);
203
+ const products = productsListService.products.get();
204
+ const displayedProducts = products.length;
205
+ return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.productListTotalsDisplayed, "data-displayed": displayedProducts, customElement: children, customElementProps: { displayedProducts }, content: displayedProducts, children: _jsx("span", { children: displayedProducts }) }));
206
+ });
@@ -3,7 +3,7 @@ import { useService, WixServices } from '@wix/services-manager-react';
3
3
  import { SelectedVariantServiceDefinition, SelectedVariantService, } from '../../services/selected-variant-service.js';
4
4
  import { ProductModifiersServiceDefinition } from '../../services/product-modifiers-service.js';
5
5
  import { createServicesMap } from '@wix/services-manager';
6
- import { Checkout } from '@wix/headless-ecom/react';
6
+ import { CheckoutCore } from '@wix/headless-ecom/react';
7
7
  import { CheckoutServiceDefinition, CurrentCartServiceDefinition, } from '@wix/headless-ecom/services';
8
8
  /**
9
9
  * Root component that provides the SelectedVariant service context to its children.
@@ -254,7 +254,7 @@ export function Actions(props) {
254
254
  error,
255
255
  };
256
256
  if (checkoutService) {
257
- return (_jsx(Checkout.Trigger, { children: ({ createCheckout, isLoading: checkoutLoading, error: checkoutError, }) => props.children({
257
+ return (_jsx(CheckoutCore.Trigger, { children: ({ createCheckout, isLoading: checkoutLoading, error: checkoutError, }) => props.children({
258
258
  ...commonProps,
259
259
  isLoading: isLoading || checkoutLoading,
260
260
  error: error || checkoutError,
@@ -9,6 +9,7 @@ export interface RenderChildrenParams<THTMLElement = HTMLElement, TProps = any>
9
9
  props: TProps;
10
10
  /** Ref to forward to the rendered element */
11
11
  ref: React.Ref<THTMLElement>;
12
+ content?: string | null;
12
13
  }
13
14
  /**
14
15
  * Utility function to handle children rendering.
@@ -38,4 +39,4 @@ export interface RenderChildrenParams<THTMLElement = HTMLElement, TProps = any>
38
39
  * });
39
40
  * ```
40
41
  */
41
- export declare function renderChildren<THTMLElement = HTMLElement, TProps = any>({ children, props, ref, }: RenderChildrenParams<THTMLElement, TProps>): React.ReactNode | null;
42
+ export declare function renderChildren<THTMLElement = HTMLElement, TProps = any>({ children, props, ref, content, }: RenderChildrenParams<THTMLElement, TProps>): React.ReactNode | null;
@@ -27,13 +27,16 @@ import React from 'react';
27
27
  * });
28
28
  * ```
29
29
  */
30
- export function renderChildren({ children, props, ref, }) {
30
+ export function renderChildren({ children, props, ref, content, }) {
31
31
  // Early return if no children provided
32
32
  if (!children)
33
33
  return null;
34
34
  // Handle React element pattern
35
35
  if (React.isValidElement(children)) {
36
- return children;
36
+ return React.cloneElement(children, {
37
+ ref,
38
+ ...(content ? { children: content } : {}),
39
+ });
37
40
  }
38
41
  // Handle render function pattern
39
42
  if (typeof children === 'function') {
@@ -25,6 +25,7 @@ export interface CategoryTriggerProps {
25
25
  category: Category;
26
26
  isSelected: boolean;
27
27
  onSelect: () => void;
28
+ setIsSelected: (isSelected: boolean) => void;
28
29
  }>;
29
30
  /** Callback when category is selected */
30
31
  onSelect?: (category: Category) => void;
@@ -1,10 +1,9 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
2
  import React from 'react';
3
- import { Slot } from '@radix-ui/react-slot';
4
3
  import * as CoreCategory from './core/Category.js';
5
4
  import { CategoryServiceDefinition, } from '../services/category-service.js';
6
5
  import { useService } from '@wix/services-manager-react';
7
- import { renderChildren } from '../utils/renderChildren.js';
6
+ import { AsChildSlot } from '@wix/headless-utils/react';
8
7
  var TestIds;
9
8
  (function (TestIds) {
10
9
  TestIds["categoryItem"] = "category-item";
@@ -76,19 +75,18 @@ export const Trigger = React.forwardRef((props, ref) => {
76
75
  const categoryService = useService(CategoryServiceDefinition);
77
76
  const category = categoryService.category.get();
78
77
  const isSelected = categoryService.isSelected.get();
78
+ const setIsSelected = (isSelected) => categoryService.isSelected.set(isSelected);
79
79
  const handleSelect = () => {
80
80
  if (onSelect) {
81
81
  onSelect(category);
82
82
  }
83
83
  };
84
- const Comp = asChild && children ? Slot : 'button';
85
- return (_jsx(Comp, { ref: ref, className: className, onClick: handleSelect, "data-testid": TestIds.categoryTrigger, "data-selected": isSelected ? 'true' : 'false', children: asChild && children
86
- ? renderChildren({
87
- children,
88
- props: { category, isSelected, onSelect: handleSelect },
89
- ref,
90
- })
91
- : category.name }));
84
+ return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, onClick: handleSelect, "data-testid": TestIds.categoryTrigger, "data-selected": isSelected ? 'true' : 'false', customElement: children, customElementProps: {
85
+ category,
86
+ isSelected,
87
+ onSelect: handleSelect,
88
+ setIsSelected,
89
+ }, content: category.name, children: _jsx("button", { children: category.name }) }));
92
90
  });
93
91
  /**
94
92
  * Displays the category name or label.
@@ -121,10 +119,7 @@ export const Label = React.forwardRef((props, ref) => {
121
119
  const category = categoryService.category.get();
122
120
  const isSelected = categoryService.isSelected.get();
123
121
  return (_jsx(CoreCategory.Name, { children: ({ name }) => {
124
- const Comp = asChild && children ? Slot : 'span';
125
- return (_jsx(Comp, { ref: ref, className: className, "data-testid": TestIds.categoryLabel, "data-selected": isSelected ? 'true' : 'false', children: asChild && children
126
- ? renderChildren({ children, props: { name, category }, ref })
127
- : name }));
122
+ return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.categoryLabel, "data-selected": isSelected ? 'true' : 'false', customElement: children, customElementProps: { name, category }, content: name, children: _jsx("span", { children: name }) }));
128
123
  } }));
129
124
  });
130
125
  /**
@@ -158,10 +153,7 @@ export const ID = React.forwardRef((props, ref) => {
158
153
  const category = categoryService.category.get();
159
154
  const isSelected = categoryService.isSelected.get();
160
155
  const id = category._id || '';
161
- const Comp = asChild && children ? Slot : 'span';
162
- return (_jsx(Comp, { ref: ref, className: className || 'sr-only', "data-testid": TestIds.categoryId, "data-selected": isSelected ? 'true' : 'false', children: asChild && children
163
- ? renderChildren({ children, props: { id, category }, ref })
164
- : id }));
156
+ return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className || 'sr-only', "data-testid": TestIds.categoryId, "data-selected": isSelected ? 'true' : 'false', customElement: children, customElementProps: { id, category }, content: id, children: _jsx("span", { children: id }) }));
165
157
  });
166
158
  /**
167
159
  * Provides access to the full category data for advanced use cases.
@@ -190,8 +182,5 @@ export const Raw = React.forwardRef((props, ref) => {
190
182
  const categoryService = useService(CategoryServiceDefinition);
191
183
  const category = categoryService.category.get();
192
184
  const isSelected = categoryService.isSelected.get();
193
- const Comp = asChild && children ? Slot : 'span';
194
- return (_jsx(Comp, { ref: ref, className: className || 'sr-only', "data-testid": TestIds.categoryRaw, "data-selected": isSelected ? 'true' : 'false', children: asChild && children
195
- ? renderChildren({ children, props: { category, isSelected }, ref })
196
- : JSON.stringify(category) }));
185
+ return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className || 'sr-only', "data-testid": TestIds.categoryRaw, "data-selected": isSelected ? 'true' : 'false', customElement: children, customElementProps: { category, isSelected }, children: _jsx("span", { children: JSON.stringify(category) }) }));
197
186
  });
@@ -1,8 +1,8 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import React from 'react';
3
- import { Slot } from '@radix-ui/react-slot';
4
3
  import * as CoreCategoryList from './core/CategoryList.js';
5
4
  import * as Category from './Category.js';
5
+ import { AsChildSlot } from '@wix/headless-utils/react';
6
6
  var TestIds;
7
7
  (function (TestIds) {
8
8
  TestIds["categoryListRoot"] = "category-list";
@@ -56,8 +56,7 @@ export function Root(props) {
56
56
  */
57
57
  export const Loading = React.forwardRef((props, ref) => {
58
58
  const { asChild, children, className } = props;
59
- const Comp = asChild && children ? Slot : 'h1';
60
- return (_jsx(CoreCategoryList.Loading, { children: _jsx(Comp, { className: className, ref: ref, children: "Loading..." }) }));
59
+ return (_jsx(CoreCategoryList.Loading, { children: _jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, children: _jsx("h1", { children: "Loading..." }) }) }));
61
60
  });
62
61
  /**
63
62
  * Repeats for each category in the list, providing individual category context.
@@ -1,6 +1,5 @@
1
1
  import type { V3Product } from '@wix/auto_sdk_stores_products-v-3';
2
2
  import React from 'react';
3
- import { type AsChildProps } from '../utils/index.js';
4
3
  import { AsContent } from './types.js';
5
4
  /**
6
5
  * Context for sharing variant options state between components
@@ -56,9 +55,15 @@ export declare function Root(props: ProductRootProps): React.ReactNode;
56
55
  /**
57
56
  * Props for Product Name component
58
57
  */
59
- export interface NameProps extends AsChildProps<{
60
- name: string;
61
- }> {
58
+ export interface NameProps {
59
+ /** Whether to render as a child component */
60
+ asChild?: boolean;
61
+ /** Custom render function when using asChild */
62
+ children?: React.ReactNode | React.ForwardRefRenderFunction<HTMLElement, {
63
+ name: string;
64
+ }> | React.ForwardRefExoticComponent<any>;
65
+ /** CSS classes to apply to the default element */
66
+ className?: string;
62
67
  }
63
68
  /**
64
69
  * Displays the product name with customizable rendering following the documented API.
@@ -88,9 +93,15 @@ export declare const Name: React.ForwardRefExoticComponent<NameProps & React.Ref
88
93
  /**
89
94
  * Props for Product Description component
90
95
  */
91
- export interface DescriptionProps extends AsChildProps<{
92
- description: string;
93
- }> {
96
+ export interface DescriptionProps {
97
+ /** Whether to render as a child component */
98
+ asChild?: boolean;
99
+ /** Custom render function when using asChild */
100
+ children?: React.ReactNode | React.ForwardRefRenderFunction<HTMLElement, {
101
+ description: string;
102
+ }> | React.ForwardRefExoticComponent<any>;
103
+ /** CSS classes to apply to the default element */
104
+ className?: string;
94
105
  /** Format of the description content */
95
106
  as?: `${AsContent}`;
96
107
  }
@@ -121,10 +132,16 @@ export declare const Description: React.ForwardRefExoticComponent<DescriptionPro
121
132
  /**
122
133
  * Props for Product Price component
123
134
  */
124
- export interface PriceProps extends AsChildProps<{
125
- price: string;
126
- formattedPrice: string;
127
- }> {
135
+ export interface PriceProps {
136
+ /** Whether to render as a child component */
137
+ asChild?: boolean;
138
+ /** Custom render function when using asChild */
139
+ children?: React.ReactNode | React.ForwardRefRenderFunction<HTMLElement, {
140
+ price: string;
141
+ formattedPrice: string;
142
+ }> | React.ForwardRefExoticComponent<any>;
143
+ /** CSS classes to apply to the default element */
144
+ className?: string;
128
145
  }
129
146
  /**
130
147
  * Displays the current product price with customizable rendering following the documented API.
@@ -154,10 +171,16 @@ export declare const Price: React.ForwardRefExoticComponent<PriceProps & React.R
154
171
  /**
155
172
  * Props for Product CompareAtPrice component
156
173
  */
157
- export interface CompareAtPriceProps extends AsChildProps<{
158
- price: string;
159
- formattedPrice: string;
160
- }> {
174
+ export interface CompareAtPriceProps {
175
+ /** Whether to render as a child component */
176
+ asChild?: boolean;
177
+ /** Custom render function when using asChild */
178
+ children?: React.ReactNode | React.ForwardRefRenderFunction<HTMLElement, {
179
+ price: string;
180
+ formattedPrice: string;
181
+ }> | React.ForwardRefExoticComponent<any>;
182
+ /** CSS classes to apply to the default element */
183
+ className?: string;
161
184
  }
162
185
  /**
163
186
  * Displays the compare-at (original) price when on sale with customizable rendering following the documented API.
@@ -192,9 +215,15 @@ export declare const CompareAtPrice: React.ForwardRefExoticComponent<CompareAtPr
192
215
  * Props for Slug component
193
216
  * @interface SlugProps
194
217
  */
195
- export interface SlugProps extends AsChildProps<{
196
- slug: string;
197
- }> {
218
+ export interface SlugProps {
219
+ /** Whether to render as a child component */
220
+ asChild?: boolean;
221
+ /** Custom render function when using asChild */
222
+ children?: React.ReactNode | React.ForwardRefRenderFunction<HTMLElement, {
223
+ slug: string;
224
+ }> | React.ForwardRefExoticComponent<any>;
225
+ /** CSS classes to apply to the default element */
226
+ className?: string;
198
227
  }
199
228
  /**
200
229
  * Product Slug component that displays the product's slug
@@ -222,9 +251,15 @@ export declare const Slug: React.ForwardRefExoticComponent<SlugProps & React.Ref
222
251
  /**
223
252
  * Props for Product Raw component
224
253
  */
225
- export interface RawProps extends AsChildProps<{
226
- product: V3Product;
227
- }> {
254
+ export interface RawProps {
255
+ /** Whether to render as a child component */
256
+ asChild?: boolean;
257
+ /** Custom render function when using asChild */
258
+ children?: React.ReactNode | React.ForwardRefRenderFunction<HTMLElement, {
259
+ product: V3Product;
260
+ }> | React.ForwardRefExoticComponent<any>;
261
+ /** CSS classes to apply to the default element */
262
+ className?: string;
228
263
  }
229
264
  /**
230
265
  * Provides access to the raw product data for advanced use cases.
@@ -249,9 +284,13 @@ export declare const Raw: React.ForwardRefExoticComponent<RawProps & React.RefAt
249
284
  /**
250
285
  * Props for Product Variants container
251
286
  */
252
- export interface VariantsProps extends AsChildProps<{
253
- hasOptions: boolean;
254
- }> {
287
+ export interface VariantsProps {
288
+ /** Whether to render as a child component */
289
+ asChild?: boolean;
290
+ /** Custom render function when using asChild */
291
+ children: React.ReactNode;
292
+ /** CSS classes to apply to the default element */
293
+ className?: string;
255
294
  }
256
295
  /**
257
296
  * Container for product variant selection system.
@@ -331,7 +370,7 @@ export interface VariantOptionsProps {
331
370
  * </Product.VariantOptions>
332
371
  * ```
333
372
  */
334
- export declare const VariantOptions: React.ForwardRefExoticComponent<VariantOptionsProps & React.RefAttributes<HTMLElement>>;
373
+ export declare const VariantOptions: React.ForwardRefExoticComponent<VariantOptionsProps & React.RefAttributes<HTMLDivElement>>;
335
374
  /**
336
375
  * Props for Product VariantOptionRepeater component
337
376
  */
@@ -347,9 +386,13 @@ export declare const VariantOptionRepeater: React.ForwardRefExoticComponent<Vari
347
386
  /**
348
387
  * Props for Product Modifiers container
349
388
  */
350
- export interface ModifiersProps extends AsChildProps<{
351
- hasModifiers: boolean;
352
- }> {
389
+ export interface ModifiersProps {
390
+ /** Whether to render as a child component */
391
+ asChild?: boolean;
392
+ /** Custom render function when using asChild */
393
+ children: React.ReactNode;
394
+ /** CSS classes to apply to the default element */
395
+ className?: string;
353
396
  }
354
397
  /**
355
398
  * Container for product modifier system.
@@ -432,7 +475,7 @@ export interface ModifierOptionsProps {
432
475
  * </Product.ModifierOptions>
433
476
  * ```
434
477
  */
435
- export declare const ModifierOptions: React.ForwardRefExoticComponent<ModifierOptionsProps & React.RefAttributes<HTMLElement>>;
478
+ export declare const ModifierOptions: React.ForwardRefExoticComponent<ModifierOptionsProps & React.RefAttributes<HTMLDivElement>>;
436
479
  /**
437
480
  * Props for Product ModifierOptionRepeater component
438
481
  */
@@ -485,7 +528,7 @@ export interface ProductMediaGalleryProps {
485
528
  * </Product.MediaGallery>
486
529
  * ```
487
530
  */
488
- export declare const ProductMediaGallery: React.ForwardRefExoticComponent<ProductMediaGalleryProps & React.RefAttributes<HTMLElement>>;
531
+ export declare const ProductMediaGallery: React.ForwardRefExoticComponent<ProductMediaGalleryProps & React.RefAttributes<HTMLDivElement>>;
489
532
  /**
490
533
  * Alias for ProductMediaGallery to match the documented API
491
534
  */