@wix/headless-bookings 0.0.17 → 0.0.19

package/cjs/dist/react/core/booking/Booking.d.ts

@@ -3,7 +3,7 @@
  * Provides low-level access to BookingService via render props and service setup
  */
 import React from 'react';
-import { type BookingServiceConfig, type BookingItem, type Location, type BookingServiceActions } from '../../../services/booking/booking.js';
+import { type BookingServiceConfig, type ServiceSelection, type Location, type BookingServiceActions } from '../../../services/booking/booking.js';
 import type { FormValues } from '@wix/form-public';
 /**
  * Props for Booking.Root component
@@ -33,10 +33,9 @@ export declare function Root(props: RootProps): React.ReactNode;
  * Mirrors BookingServiceConfig structure with actions
  */
 export interface BookingData {
-    bookingItems: BookingItem[];
+    serviceSelections: ServiceSelection[];
     location: Location | null;
-    formValues: FormValues | null;
-    numberOfParticipants: number;
+    formSubmission: FormValues | null;
     actions: BookingServiceActions;
 }
 /**
@@ -53,9 +52,9 @@ export interface DataProps {
  * @example
  * ```tsx
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, numberOfParticipants, actions }) => (
- *     bookingItems.length > 0 ? (
- *       <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     serviceSelections.length > 0 ? (
+ *       <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *     ) : (
  *       <div>No services selected</div>
  *     )

package/cjs/dist/react/core/booking/Booking.js

@@ -28,9 +28,9 @@ export function Root(props) {
  * @example
  * ```tsx
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, numberOfParticipants, actions }) => (
- *     bookingItems.length > 0 ? (
- *       <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     serviceSelections.length > 0 ? (
+ *       <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *     ) : (
  *       <div>No services selected</div>
  *     )
@@ -41,16 +41,14 @@ export function Root(props) {
 export function Data(props) {
     const { children } = props;
     const bookingService = useService(BookingServiceDefinition);
-    const bookingItems = bookingService.bookingItems.get();
+    const serviceSelections = bookingService.serviceSelections.get();
     const location = bookingService.location.get();
-    const formValues = bookingService.formValues.get();
-    const numberOfParticipants = bookingService.numberOfParticipants.get();
+    const formSubmission = bookingService.formSubmission.get();
     const { actions } = bookingService;
     return children({
-        bookingItems,
+        serviceSelections,
         location,
-        formValues,
-        numberOfParticipants,
+        formSubmission,
         actions,
     });
 }

package/cjs/dist/react/time-slot-list/TimeSlotList.js

@@ -77,7 +77,7 @@ Root.displayName = 'TimeSlotList.Root';
  */
 const RootContent = React.forwardRef((props, ref) => {
     const { children, className, variant } = props;
-    return (_jsx(CoreTimeSlotList.ListData, { children: ({ timeSlots, hasMore, isLoading, loadMore }) => (_jsx(GenericList.Root, { items: timeSlots, loadMore: loadMore, hasMore: hasMore, isLoading: isLoading, className: className, ref: ref, "data-testid": TestIds.timeSlotListRoot, variant: variant, children: children })) }));
+    return (_jsx(CoreTimeSlotList.ListData, { children: ({ timeSlots, hasMore, isLoading, error, loadMore }) => (_jsx(GenericList.Root, { items: timeSlots, loadMore: loadMore, hasMore: hasMore, isLoading: isLoading, error: error, className: className, ref: ref, "data-testid": TestIds.timeSlotListRoot, variant: variant, children: children })) }));
 });
 RootContent.displayName = 'TimeSlotList.RootContent';
 /**

package/cjs/dist/services/booking/booking.d.ts

@@ -1,6 +1,6 @@
 /**
  * Booking Service - Global booking store
- * Manages booking flow state (selected services, time slot, location, form values)
+ * Manages booking flow state (selected services, time slot, location, form submission)
  * Persists across page navigation in SPA until page refresh
  */
 import { type Signal } from '@wix/services-definitions/core-services/signals';
@@ -8,9 +8,9 @@ import type { Service } from '@wix/auto_sdk_bookings_services';
 import type { Resource, EventInfo } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
 /**
- * Minimal time slot data for booking items
+ * Minimal time slot data for service selections
  */
-export interface BookingItemTimeSlot {
+export interface ServiceSelectionTimeSlot {
     startDate: string;
     endDate: string;
     totalCapacity?: number;
@@ -19,9 +19,9 @@ export interface BookingItemTimeSlot {
     eventInfo?: EventInfo;
 }
 /**
- * BookingItem contains the service AND its related selections
+ * ServiceSelection contains the service AND its related selections
  */
-export interface BookingItem {
+export interface ServiceSelection {
     /** Unique identifier for this booking instance (allows same service multiple times) */
     instanceId: string;
     /** The selected service */
@@ -29,7 +29,9 @@ export interface BookingItem {
     /** Selected resources (staff members, rooms, etc.) */
     resources: Resource[];
     /** Per-item time slot data */
-    timeSlot?: BookingItemTimeSlot;
+    timeSlot?: ServiceSelectionTimeSlot;
+    /** Number of participants for this service selection */
+    totalParticipants?: number;
 }
 export interface Location {
     id: string;
@@ -39,25 +41,24 @@ export interface Location {
  * BookingService actions - setters only, no API calls
  */
 export interface BookingServiceActions {
-    /** Clears all booking items and sets a single item (instanceId is auto-generated) */
-    setItem(item: Omit<BookingItem, 'instanceId'>): string;
+    /** Clears all service selections and sets a single item (instanceId is auto-generated) */
+    setItem(item: Omit<ServiceSelection, 'instanceId'>): string;
     /** Adds an item and returns the generated instanceId */
-    addItem(item: Omit<BookingItem, 'instanceId'>): string;
-    /** Updates a booking item. If no instanceId provided, updates the first item. */
-    updateItem(updates: Partial<Omit<BookingItem, 'instanceId'>>, instanceId?: string): void;
-    /** Removes a booking item. If no instanceId provided, removes the first item. */
+    addItem(item: Omit<ServiceSelection, 'instanceId'>): string;
+    /** Updates a service selection. If no instanceId provided, updates the first item. */
+    updateItem(updates: Partial<Omit<ServiceSelection, 'instanceId'>>, instanceId?: string): void;
+    /** Removes a service selection. If no instanceId provided, removes the first item. */
     removeItem(instanceId?: string): void;
-    /** Clears all booking items */
+    /** Clears all service selections */
     clearItems(): void;
-    /** Sets a resource by ID within a booking item. If no instanceId provided, uses the first item. */
+    /** Sets a resource by ID within a service selection. If no instanceId provided, uses the first item. */
     setResourceById(resourceId: string, resource: Resource, instanceId?: string): void;
-    /** Gets a resource by ID from a booking item. If no instanceId provided, uses the first item. */
+    /** Gets a resource by ID from a service selection. If no instanceId provided, uses the first item. */
     getResourceById(resourceId: string, instanceId?: string): Resource | undefined;
     setLocation(location: Location | null): void;
     clearLocation(): void;
-    setFormValues(values: FormValues | null): void;
-    clearFormValues(): void;
-    setNumberOfParticipants(count: number): void;
+    setFormSubmission(values: FormValues | null): void;
+    clearFormSubmission(): void;
     clearAll(): void;
 }
 /**
@@ -65,14 +66,12 @@ export interface BookingServiceActions {
  * Pure state management - no API calls
  */
 export interface BookingService {
-    /** Signal containing the booking items (services with their related data) */
-    bookingItems: Signal<BookingItem[]>;
+    /** Signal containing the service selections (services with their related data) */
+    serviceSelections: Signal<ServiceSelection[]>;
     /** Signal containing the selected location */
     location: Signal<Location | null>;
-    /** Signal containing the form values */
-    formValues: Signal<FormValues | null>;
-    /** Signal containing the number of participants */
-    numberOfParticipants: Signal<number>;
+    /** Signal containing the form submission */
+    formSubmission: Signal<FormValues | null>;
     /** Actions for modifying booking state */
     actions: BookingServiceActions;
 }
@@ -89,14 +88,12 @@ export declare const BookingServiceDefinition: string & {
  * Mirrors BookingService structure (without actions and Signal wrappers)
  */
 export interface BookingServiceConfig {
-    /** Optional initial booking items to pre-populate */
-    bookingItems?: BookingItem[];
+    /** Optional initial service selections to pre-populate */
+    serviceSelections?: ServiceSelection[];
     /** Optional initial location */
     location?: Location | null;
-    /** Optional initial form values */
-    formValues?: FormValues | null;
-    /** Optional initial number of participants (defaults to 1) */
-    numberOfParticipants?: number;
+    /** Optional initial form submission */
+    formSubmission?: FormValues | null;
 }
 /**
  * Implementation of BookingService
@@ -116,8 +113,8 @@ export interface BookingServiceConfig {
  *
  * // In any page - access booking data
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, actions }) => (
- *     <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *   )}
  * </Booking.Data>
  * ```

package/cjs/dist/services/booking/booking.js

@@ -1,6 +1,6 @@
 /**
  * Booking Service - Global booking store
- * Manages booking flow state (selected services, time slot, location, form values)
+ * Manages booking flow state (selected services, time slot, location, form submission)
  * Persists across page navigation in SPA until page refresh
  */
 import { defineService, implementService } from '@wix/services-definitions';
@@ -9,7 +9,7 @@ import { SignalsServiceDefinition, } from '@wix/services-definitions/core-servic
 // Types
 // ============================================================================
 /**
- * Generates a unique instance ID for booking items
+ * Generates a unique instance ID for service selections
  */
 function generateInstanceId() {
     return crypto.randomUUID();
@@ -39,8 +39,8 @@ export const BookingServiceDefinition = defineService('booking');
  *
  * // In any page - access booking data
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, actions }) => (
- *     <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *   )}
  * </Booking.Data>
  * ```
@@ -48,15 +48,14 @@ export const BookingServiceDefinition = defineService('booking');
 export const BookingService = implementService.withConfig()(BookingServiceDefinition, ({ getService, config }) => {
     const signalsService = getService(SignalsServiceDefinition);
     // Initialize signals with config values
-    // Ensure all initial booking items have instanceIds
-    const initialItemsWithIds = (config.bookingItems || []).map((item) => ({
+    // Ensure all initial service selections have instanceIds
+    const initialItemsWithIds = (config.serviceSelections || []).map((item) => ({
         ...item,
         instanceId: item.instanceId || generateInstanceId(),
     }));
-    const bookingItemsSignal = signalsService.signal(initialItemsWithIds);
+    const serviceSelectionsSignal = signalsService.signal(initialItemsWithIds);
     const locationSignal = signalsService.signal(config.location || null);
-    const formValuesSignal = signalsService.signal(config.formValues || null);
-    const numberOfParticipantsSignal = signalsService.signal(config.numberOfParticipants ?? 1);
+    const formSubmissionSignal = signalsService.signal(config.formSubmission || null);
     // ========================================================================
     // Actions Implementation
     // ========================================================================
@@ -68,43 +67,43 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
                 ...item,
                 instanceId,
             };
-            bookingItemsSignal.set([newItem]);
+            serviceSelectionsSignal.set([newItem]);
             return instanceId;
         },
         addItem(item) {
             const instanceId = generateInstanceId();
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             const newItem = {
                 ...item,
                 instanceId,
             };
-            bookingItemsSignal.set([...current, newItem]);
+            serviceSelectionsSignal.set([...current, newItem]);
             return instanceId;
         },
         updateItem(updates, instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             // If no instanceId provided, update the first item (index 0)
             const targetId = instanceId ?? current[0]?.instanceId;
             const updated = current.map((item) => item.instanceId === targetId ? { ...item, ...updates } : item);
-            bookingItemsSignal.set(updated);
+            serviceSelectionsSignal.set(updated);
         },
         removeItem(instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             if (!instanceId) {
                 // Remove first item if no instanceId provided
-                bookingItemsSignal.set(current.slice(1));
+                serviceSelectionsSignal.set(current.slice(1));
             }
             else {
                 const filtered = current.filter((item) => item.instanceId !== instanceId);
-                bookingItemsSignal.set(filtered);
+                serviceSelectionsSignal.set(filtered);
             }
         },
         clearItems() {
-            bookingItemsSignal.set([]);
+            serviceSelectionsSignal.set([]);
         },
         // Resource helpers
         setResourceById(resourceId, resource, instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             // If no instanceId provided, use the first item
             const targetId = instanceId ?? current[0]?.instanceId;
             if (!targetId)
@@ -123,10 +122,10 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
                 }
                 return { ...item, resources: newResources };
             });
-            bookingItemsSignal.set(updated);
+            serviceSelectionsSignal.set(updated);
         },
         getResourceById(resourceId, instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             // If no instanceId provided, use the first item
             const targetId = instanceId ?? current[0]?.instanceId;
             if (!targetId)
@@ -143,30 +142,24 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
         clearLocation() {
             locationSignal.set(null);
         },
-        // Form Values actions
-        setFormValues(values) {
-            formValuesSignal.set(values);
+        // Form Submission actions
+        setFormSubmission(values) {
+            formSubmissionSignal.set(values);
         },
-        clearFormValues() {
-            formValuesSignal.set(null);
-        },
-        // Number of Participants actions
-        setNumberOfParticipants(count) {
-            numberOfParticipantsSignal.set(count);
+        clearFormSubmission() {
+            formSubmissionSignal.set(null);
         },
         // Clear all
         clearAll() {
-            bookingItemsSignal.set([]);
+            serviceSelectionsSignal.set([]);
             locationSignal.set(null);
-            formValuesSignal.set(null);
-            numberOfParticipantsSignal.set(1);
+            formSubmissionSignal.set(null);
         },
     };
     return {
-        bookingItems: bookingItemsSignal,
+        serviceSelections: serviceSelectionsSignal,
         location: locationSignal,
-        formValues: formValuesSignal,
-        numberOfParticipants: numberOfParticipantsSignal,
+        formSubmission: formSubmissionSignal,
         actions,
     };
 });

package/cjs/dist/services/index.d.ts

@@ -3,6 +3,6 @@
  * Main export file for all service definitions and implementations
  */
 export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type ServiceServiceConfig, type ServiceActions, type ServicePaymentData, loadServiceServiceInitialData, type SuccessServiceServiceConfigResult, type NotFoundServiceServiceConfigResult, } from './service/service.js';
-export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type Location, type BookingServiceActions, } from './booking/booking.js';
+export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type Location, type BookingServiceActions, type ServiceSelection, type ServiceSelectionTimeSlot, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, type TimeSlot, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, type ServiceListServiceAPI, type ServiceListServiceConfig, type ServiceListFilters, type ServiceListActions, type QueryOptions, loadServiceListServiceInitialData, type SuccessServiceListServiceConfigResult, type ErrorServiceListServiceConfigResult, } from './service-list/service-list.js';

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

@@ -81,8 +81,8 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
         const currentService = serviceSignal.get();
         if (!currentService._id)
             return false;
-        const bookingItems = bookingService.bookingItems.get();
-        return bookingItems.some(({ service }) => service._id === currentService._id);
+        const serviceSelections = bookingService.serviceSelections.get();
+        return serviceSelections.some(({ service }) => service._id === currentService._id);
     });
     // requiresAvailability signal - true for APPOINTMENT and CLASS types
     const requiresAvailabilitySignal = signalsService.computed(() => {
@@ -201,8 +201,8 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
                 return;
             const currentService = serviceSignal.get();
             // Remove all instances of this service (by serviceId)
-            const bookingItems = bookingService.bookingItems.get();
-            const instancesToRemove = bookingItems
+            const serviceSelections = bookingService.serviceSelections.get();
+            const instancesToRemove = serviceSelections
                 .filter((s) => s.service._id === currentService._id)
                 .map((s) => s.instanceId);
             instancesToRemove.forEach((instanceId) => {

package/cjs/dist/services/time-slot-list/time-slot-list.js

@@ -80,7 +80,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     const getServices = () => {
         if (config.services?.length)
             return config.services;
-        return bookingService.bookingItems.get().map((s) => s.service);
+        return bookingService.serviceSelections.get().map((s) => s.service);
     };
     /**
      * Helper: Get filters from config or BookingService
@@ -88,7 +88,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     const getFilters = () => {
         // Get BookingService selections (these take priority)
         const location = bookingService.location.get();
-        const selections = bookingService.bookingItems.get();
+        const selections = bookingService.serviceSelections.get();
         const selectedStaffMemberIds = selections
             .map(({ resources }) => resources.map((r) => r._id))
             .flat();

package/dist/react/core/booking/Booking.d.ts

@@ -3,7 +3,7 @@
  * Provides low-level access to BookingService via render props and service setup
  */
 import React from 'react';
-import { type BookingServiceConfig, type BookingItem, type Location, type BookingServiceActions } from '../../../services/booking/booking.js';
+import { type BookingServiceConfig, type ServiceSelection, type Location, type BookingServiceActions } from '../../../services/booking/booking.js';
 import type { FormValues } from '@wix/form-public';
 /**
  * Props for Booking.Root component
@@ -33,10 +33,9 @@ export declare function Root(props: RootProps): React.ReactNode;
  * Mirrors BookingServiceConfig structure with actions
  */
 export interface BookingData {
-    bookingItems: BookingItem[];
+    serviceSelections: ServiceSelection[];
     location: Location | null;
-    formValues: FormValues | null;
-    numberOfParticipants: number;
+    formSubmission: FormValues | null;
     actions: BookingServiceActions;
 }
 /**
@@ -53,9 +52,9 @@ export interface DataProps {
  * @example
  * ```tsx
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, numberOfParticipants, actions }) => (
- *     bookingItems.length > 0 ? (
- *       <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     serviceSelections.length > 0 ? (
+ *       <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *     ) : (
  *       <div>No services selected</div>
  *     )

package/dist/react/core/booking/Booking.js

@@ -28,9 +28,9 @@ export function Root(props) {
  * @example
  * ```tsx
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, numberOfParticipants, actions }) => (
- *     bookingItems.length > 0 ? (
- *       <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     serviceSelections.length > 0 ? (
+ *       <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *     ) : (
  *       <div>No services selected</div>
  *     )
@@ -41,16 +41,14 @@ export function Root(props) {
 export function Data(props) {
     const { children } = props;
     const bookingService = useService(BookingServiceDefinition);
-    const bookingItems = bookingService.bookingItems.get();
+    const serviceSelections = bookingService.serviceSelections.get();
     const location = bookingService.location.get();
-    const formValues = bookingService.formValues.get();
-    const numberOfParticipants = bookingService.numberOfParticipants.get();
+    const formSubmission = bookingService.formSubmission.get();
     const { actions } = bookingService;
     return children({
-        bookingItems,
+        serviceSelections,
         location,
-        formValues,
-        numberOfParticipants,
+        formSubmission,
         actions,
     });
 }

package/dist/react/time-slot-list/TimeSlotList.js

@@ -77,7 +77,7 @@ Root.displayName = 'TimeSlotList.Root';
  */
 const RootContent = React.forwardRef((props, ref) => {
     const { children, className, variant } = props;
-    return (_jsx(CoreTimeSlotList.ListData, { children: ({ timeSlots, hasMore, isLoading, loadMore }) => (_jsx(GenericList.Root, { items: timeSlots, loadMore: loadMore, hasMore: hasMore, isLoading: isLoading, className: className, ref: ref, "data-testid": TestIds.timeSlotListRoot, variant: variant, children: children })) }));
+    return (_jsx(CoreTimeSlotList.ListData, { children: ({ timeSlots, hasMore, isLoading, error, loadMore }) => (_jsx(GenericList.Root, { items: timeSlots, loadMore: loadMore, hasMore: hasMore, isLoading: isLoading, error: error, className: className, ref: ref, "data-testid": TestIds.timeSlotListRoot, variant: variant, children: children })) }));
 });
 RootContent.displayName = 'TimeSlotList.RootContent';
 /**

package/dist/services/booking/booking.d.ts

@@ -1,6 +1,6 @@
 /**
  * Booking Service - Global booking store
- * Manages booking flow state (selected services, time slot, location, form values)
+ * Manages booking flow state (selected services, time slot, location, form submission)
  * Persists across page navigation in SPA until page refresh
  */
 import { type Signal } from '@wix/services-definitions/core-services/signals';
@@ -8,9 +8,9 @@ import type { Service } from '@wix/auto_sdk_bookings_services';
 import type { Resource, EventInfo } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
 /**
- * Minimal time slot data for booking items
+ * Minimal time slot data for service selections
  */
-export interface BookingItemTimeSlot {
+export interface ServiceSelectionTimeSlot {
     startDate: string;
     endDate: string;
     totalCapacity?: number;
@@ -19,9 +19,9 @@ export interface BookingItemTimeSlot {
     eventInfo?: EventInfo;
 }
 /**
- * BookingItem contains the service AND its related selections
+ * ServiceSelection contains the service AND its related selections
  */
-export interface BookingItem {
+export interface ServiceSelection {
     /** Unique identifier for this booking instance (allows same service multiple times) */
     instanceId: string;
     /** The selected service */
@@ -29,7 +29,9 @@ export interface BookingItem {
     /** Selected resources (staff members, rooms, etc.) */
     resources: Resource[];
     /** Per-item time slot data */
-    timeSlot?: BookingItemTimeSlot;
+    timeSlot?: ServiceSelectionTimeSlot;
+    /** Number of participants for this service selection */
+    totalParticipants?: number;
 }
 export interface Location {
     id: string;
@@ -39,25 +41,24 @@ export interface Location {
  * BookingService actions - setters only, no API calls
  */
 export interface BookingServiceActions {
-    /** Clears all booking items and sets a single item (instanceId is auto-generated) */
-    setItem(item: Omit<BookingItem, 'instanceId'>): string;
+    /** Clears all service selections and sets a single item (instanceId is auto-generated) */
+    setItem(item: Omit<ServiceSelection, 'instanceId'>): string;
     /** Adds an item and returns the generated instanceId */
-    addItem(item: Omit<BookingItem, 'instanceId'>): string;
-    /** Updates a booking item. If no instanceId provided, updates the first item. */
-    updateItem(updates: Partial<Omit<BookingItem, 'instanceId'>>, instanceId?: string): void;
-    /** Removes a booking item. If no instanceId provided, removes the first item. */
+    addItem(item: Omit<ServiceSelection, 'instanceId'>): string;
+    /** Updates a service selection. If no instanceId provided, updates the first item. */
+    updateItem(updates: Partial<Omit<ServiceSelection, 'instanceId'>>, instanceId?: string): void;
+    /** Removes a service selection. If no instanceId provided, removes the first item. */
     removeItem(instanceId?: string): void;
-    /** Clears all booking items */
+    /** Clears all service selections */
     clearItems(): void;
-    /** Sets a resource by ID within a booking item. If no instanceId provided, uses the first item. */
+    /** Sets a resource by ID within a service selection. If no instanceId provided, uses the first item. */
     setResourceById(resourceId: string, resource: Resource, instanceId?: string): void;
-    /** Gets a resource by ID from a booking item. If no instanceId provided, uses the first item. */
+    /** Gets a resource by ID from a service selection. If no instanceId provided, uses the first item. */
     getResourceById(resourceId: string, instanceId?: string): Resource | undefined;
     setLocation(location: Location | null): void;
     clearLocation(): void;
-    setFormValues(values: FormValues | null): void;
-    clearFormValues(): void;
-    setNumberOfParticipants(count: number): void;
+    setFormSubmission(values: FormValues | null): void;
+    clearFormSubmission(): void;
     clearAll(): void;
 }
 /**
@@ -65,14 +66,12 @@ export interface BookingServiceActions {
  * Pure state management - no API calls
  */
 export interface BookingService {
-    /** Signal containing the booking items (services with their related data) */
-    bookingItems: Signal<BookingItem[]>;
+    /** Signal containing the service selections (services with their related data) */
+    serviceSelections: Signal<ServiceSelection[]>;
     /** Signal containing the selected location */
     location: Signal<Location | null>;
-    /** Signal containing the form values */
-    formValues: Signal<FormValues | null>;
-    /** Signal containing the number of participants */
-    numberOfParticipants: Signal<number>;
+    /** Signal containing the form submission */
+    formSubmission: Signal<FormValues | null>;
     /** Actions for modifying booking state */
     actions: BookingServiceActions;
 }
@@ -89,14 +88,12 @@ export declare const BookingServiceDefinition: string & {
  * Mirrors BookingService structure (without actions and Signal wrappers)
  */
 export interface BookingServiceConfig {
-    /** Optional initial booking items to pre-populate */
-    bookingItems?: BookingItem[];
+    /** Optional initial service selections to pre-populate */
+    serviceSelections?: ServiceSelection[];
     /** Optional initial location */
     location?: Location | null;
-    /** Optional initial form values */
-    formValues?: FormValues | null;
-    /** Optional initial number of participants (defaults to 1) */
-    numberOfParticipants?: number;
+    /** Optional initial form submission */
+    formSubmission?: FormValues | null;
 }
 /**
  * Implementation of BookingService
@@ -116,8 +113,8 @@ export interface BookingServiceConfig {
  *
  * // In any page - access booking data
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, actions }) => (
- *     <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *   )}
  * </Booking.Data>
  * ```

package/dist/services/booking/booking.js

@@ -1,6 +1,6 @@
 /**
  * Booking Service - Global booking store
- * Manages booking flow state (selected services, time slot, location, form values)
+ * Manages booking flow state (selected services, time slot, location, form submission)
  * Persists across page navigation in SPA until page refresh
  */
 import { defineService, implementService } from '@wix/services-definitions';
@@ -9,7 +9,7 @@ import { SignalsServiceDefinition, } from '@wix/services-definitions/core-servic
 // Types
 // ============================================================================
 /**
- * Generates a unique instance ID for booking items
+ * Generates a unique instance ID for service selections
  */
 function generateInstanceId() {
     return crypto.randomUUID();
@@ -39,8 +39,8 @@ export const BookingServiceDefinition = defineService('booking');
  *
  * // In any page - access booking data
  * <Booking.Data>
- *   {({ bookingItems, location, formValues, actions }) => (
- *     <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
+ *   {({ serviceSelections, location, formSubmission, actions }) => (
+ *     <div>{serviceSelections.map(item => item.service.name).join(', ')}</div>
  *   )}
  * </Booking.Data>
  * ```
@@ -48,15 +48,14 @@ export const BookingServiceDefinition = defineService('booking');
 export const BookingService = implementService.withConfig()(BookingServiceDefinition, ({ getService, config }) => {
     const signalsService = getService(SignalsServiceDefinition);
     // Initialize signals with config values
-    // Ensure all initial booking items have instanceIds
-    const initialItemsWithIds = (config.bookingItems || []).map((item) => ({
+    // Ensure all initial service selections have instanceIds
+    const initialItemsWithIds = (config.serviceSelections || []).map((item) => ({
         ...item,
         instanceId: item.instanceId || generateInstanceId(),
     }));
-    const bookingItemsSignal = signalsService.signal(initialItemsWithIds);
+    const serviceSelectionsSignal = signalsService.signal(initialItemsWithIds);
     const locationSignal = signalsService.signal(config.location || null);
-    const formValuesSignal = signalsService.signal(config.formValues || null);
-    const numberOfParticipantsSignal = signalsService.signal(config.numberOfParticipants ?? 1);
+    const formSubmissionSignal = signalsService.signal(config.formSubmission || null);
     // ========================================================================
     // Actions Implementation
     // ========================================================================
@@ -68,43 +67,43 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
                 ...item,
                 instanceId,
             };
-            bookingItemsSignal.set([newItem]);
+            serviceSelectionsSignal.set([newItem]);
             return instanceId;
         },
         addItem(item) {
             const instanceId = generateInstanceId();
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             const newItem = {
                 ...item,
                 instanceId,
             };
-            bookingItemsSignal.set([...current, newItem]);
+            serviceSelectionsSignal.set([...current, newItem]);
             return instanceId;
         },
         updateItem(updates, instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             // If no instanceId provided, update the first item (index 0)
             const targetId = instanceId ?? current[0]?.instanceId;
             const updated = current.map((item) => item.instanceId === targetId ? { ...item, ...updates } : item);
-            bookingItemsSignal.set(updated);
+            serviceSelectionsSignal.set(updated);
         },
         removeItem(instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             if (!instanceId) {
                 // Remove first item if no instanceId provided
-                bookingItemsSignal.set(current.slice(1));
+                serviceSelectionsSignal.set(current.slice(1));
             }
             else {
                 const filtered = current.filter((item) => item.instanceId !== instanceId);
-                bookingItemsSignal.set(filtered);
+                serviceSelectionsSignal.set(filtered);
             }
         },
         clearItems() {
-            bookingItemsSignal.set([]);
+            serviceSelectionsSignal.set([]);
         },
         // Resource helpers
         setResourceById(resourceId, resource, instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             // If no instanceId provided, use the first item
             const targetId = instanceId ?? current[0]?.instanceId;
             if (!targetId)
@@ -123,10 +122,10 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
                 }
                 return { ...item, resources: newResources };
             });
-            bookingItemsSignal.set(updated);
+            serviceSelectionsSignal.set(updated);
         },
         getResourceById(resourceId, instanceId) {
-            const current = bookingItemsSignal.get();
+            const current = serviceSelectionsSignal.get();
             // If no instanceId provided, use the first item
             const targetId = instanceId ?? current[0]?.instanceId;
             if (!targetId)
@@ -143,30 +142,24 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
         clearLocation() {
             locationSignal.set(null);
         },
-        // Form Values actions
-        setFormValues(values) {
-            formValuesSignal.set(values);
+        // Form Submission actions
+        setFormSubmission(values) {
+            formSubmissionSignal.set(values);
         },
-        clearFormValues() {
-            formValuesSignal.set(null);
-        },
-        // Number of Participants actions
-        setNumberOfParticipants(count) {
-            numberOfParticipantsSignal.set(count);
+        clearFormSubmission() {
+            formSubmissionSignal.set(null);
         },
         // Clear all
         clearAll() {
-            bookingItemsSignal.set([]);
+            serviceSelectionsSignal.set([]);
             locationSignal.set(null);
-            formValuesSignal.set(null);
-            numberOfParticipantsSignal.set(1);
+            formSubmissionSignal.set(null);
         },
     };
     return {
-        bookingItems: bookingItemsSignal,
+        serviceSelections: serviceSelectionsSignal,
         location: locationSignal,
-        formValues: formValuesSignal,
-        numberOfParticipants: numberOfParticipantsSignal,
+        formSubmission: formSubmissionSignal,
         actions,
     };
 });

package/dist/services/index.d.ts

@@ -3,6 +3,6 @@
  * Main export file for all service definitions and implementations
  */
 export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type ServiceServiceConfig, type ServiceActions, type ServicePaymentData, loadServiceServiceInitialData, type SuccessServiceServiceConfigResult, type NotFoundServiceServiceConfigResult, } from './service/service.js';
-export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type Location, type BookingServiceActions, } from './booking/booking.js';
+export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type Location, type BookingServiceActions, type ServiceSelection, type ServiceSelectionTimeSlot, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, type TimeSlot, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, type ServiceListServiceAPI, type ServiceListServiceConfig, type ServiceListFilters, type ServiceListActions, type QueryOptions, loadServiceListServiceInitialData, type SuccessServiceListServiceConfigResult, type ErrorServiceListServiceConfigResult, } from './service-list/service-list.js';

package/dist/services/service/service.js

@@ -81,8 +81,8 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
         const currentService = serviceSignal.get();
         if (!currentService._id)
             return false;
-        const bookingItems = bookingService.bookingItems.get();
-        return bookingItems.some(({ service }) => service._id === currentService._id);
+        const serviceSelections = bookingService.serviceSelections.get();
+        return serviceSelections.some(({ service }) => service._id === currentService._id);
     });
     // requiresAvailability signal - true for APPOINTMENT and CLASS types
     const requiresAvailabilitySignal = signalsService.computed(() => {
@@ -201,8 +201,8 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
                 return;
             const currentService = serviceSignal.get();
             // Remove all instances of this service (by serviceId)
-            const bookingItems = bookingService.bookingItems.get();
-            const instancesToRemove = bookingItems
+            const serviceSelections = bookingService.serviceSelections.get();
+            const instancesToRemove = serviceSelections
                 .filter((s) => s.service._id === currentService._id)
                 .map((s) => s.instanceId);
             instancesToRemove.forEach((instanceId) => {

package/dist/services/time-slot-list/time-slot-list.js

@@ -80,7 +80,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     const getServices = () => {
         if (config.services?.length)
             return config.services;
-        return bookingService.bookingItems.get().map((s) => s.service);
+        return bookingService.serviceSelections.get().map((s) => s.service);
     };
     /**
      * Helper: Get filters from config or BookingService
@@ -88,7 +88,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     const getFilters = () => {
         // Get BookingService selections (these take priority)
         const location = bookingService.location.get();
-        const selections = bookingService.bookingItems.get();
+        const selections = bookingService.serviceSelections.get();
         const selectedStaffMemberIds = selections
             .map(({ resources }) => resources.map((r) => r._id))
             .flat();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -69,5 +69,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "8c910b633cde19227cb0209fec691701a57a7e53b577ee76971bfa2a"
+  "falconPackageHash": "2a71ca796bb480604700e6cc7fde7a950ba7f71c92a189dbd0a2375a"
 }