@wix/headless-bookings 0.0.12 → 0.0.14

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

@@ -0,0 +1,199 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * TimeSlotList - High-level component for displaying time slot list information
+ * Provides components for displaying timezone and time slot data
+ */
+import React from 'react';
+import { GenericList } from '@wix/headless-components/react';
+import { AsChildSlot } from '@wix/headless-utils/react';
+import * as CoreTimeSlotList from '../core/time-slot-list/TimeSlotList.js';
+import { TimeSlotProvider, Info as CoreTimeSlotInfo, } from '../core/time-slot-list/TimeSlot.js';
+import { StartDate, EndDate, Duration, Actions as TimeSlotActions, Locations, LocationRepeater, Location, StaffMembers, StaffMemberRepeater, StaffMember, } from './TimeSlot.js';
+/**
+ * TimeSlot with required id field for GenericList
+ */
+var TestIds;
+(function (TestIds) {
+    TestIds["timeSlotListRoot"] = "time-slot-list-root";
+    TestIds["timeSlotListTimeSlots"] = "time-slot-list-time-slots";
+    TestIds["timeSlotListTimeSlot"] = "time-slot-list-time-slot";
+    TestIds["timeSlotListTimezone"] = "time-slot-list-timezone";
+    TestIds["timeSlotListLoadMore"] = "time-slot-list-load-more";
+})(TestIds || (TestIds = {}));
+/**
+ * Displays the current timezone with customizable rendering.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <TimeSlotList.Timezone className="text-sm text-gray-600" />
+ *
+ * // asChild with primitive
+ * <TimeSlotList.Timezone asChild>
+ *   <span className="font-medium" />
+ * </TimeSlotList.Timezone>
+ *
+ * // asChild with render function
+ * <TimeSlotList.Timezone asChild>
+ *   {({ timezone }) => (
+ *     <span className="text-sm">
+ *       Timezone: {timezone || 'Not set'}
+ *     </span>
+ *   )}
+ * </TimeSlotList.Timezone>
+ * ```
+ */
+export const Timezone = React.forwardRef((props, ref) => {
+    const { asChild, children, className } = props;
+    return (_jsx(CoreTimeSlotList.Timezone, { children: ({ timezone }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotListTimezone, customElement: children, customElementProps: { timezone }, children: _jsx("span", { children: timezone }) })) }));
+});
+Timezone.displayName = 'TimeSlotList.Timezone';
+/**
+ * Root component that provides the TimeSlotList service context.
+ *
+ * @order 1
+ * @component
+ * @example
+ * ```tsx
+ * import { TimeSlotList } from '@wix/bookings/components';
+ *
+ * function TimeSlotsPage({ config }) {
+ *   return (
+ *     <TimeSlotList.Root config={config}>
+ *       <TimeSlotList.TimeSlots>
+ *         <TimeSlotList.TimeSlotRepeater>
+ *           {children}
+ *         </TimeSlotList.TimeSlotRepeater>
+ *       </TimeSlotList.TimeSlots>
+ *     </TimeSlotList.Root>
+ *   );
+ * }
+ * ```
+ */
+export const Root = React.forwardRef((props, ref) => {
+    const { children, config, className, variant } = props;
+    return (_jsx(CoreTimeSlotList.Root, { config: config, children: _jsx(RootContent, { className: className, ref: ref, variant: variant, children: children }) }));
+});
+Root.displayName = 'TimeSlotList.Root';
+/**
+ * Internal component to handle the Root content with core layer access
+ */
+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 })) }));
+});
+RootContent.displayName = 'TimeSlotList.RootContent';
+/**
+ * Container for the time slots list with empty state support.
+ * Wraps GenericList.Items. Follows List Container Level pattern.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <TimeSlotList.TimeSlots emptyState={<div>No slots available</div>}>
+ *   <TimeSlotList.TimeSlotRepeater>
+ *     {children}
+ *   </TimeSlotList.TimeSlotRepeater>
+ * </TimeSlotList.TimeSlots>
+ * ```
+ */
+export const TimeSlots = React.forwardRef((props, ref) => {
+    const { children, ...otherProps } = props;
+    return (_jsx(GenericList.Items, { ref: ref, "data-testid": TestIds.timeSlotListTimeSlots, ...otherProps, children: children }));
+});
+TimeSlots.displayName = 'TimeSlotList.TimeSlots';
+/**
+ * Internal component that wraps each time slot item with context provider.
+ * This is separate to allow using the service hook within the repeater.
+ */
+const TimeSlotItemWrapper = ({ slot, children, }) => {
+    return (_jsx(TimeSlotProvider, { slot: slot, children: _jsx(CoreTimeSlotInfo, { children: ({ bookable, isSelected }) => (_jsx("div", { "data-testid": TestIds.timeSlotListTimeSlot, "data-slot-start": slot.localStartDate, "data-slot-id": slot.id, "data-bookable": bookable, "data-selected": isSelected, children: children })) }) }));
+};
+/**
+ * Repeater component that renders each time slot.
+ * Follows Repeater Level pattern and uses GenericList.Repeater for consistency.
+ * Automatically provides TimeSlot context to children.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <TimeSlotList.TimeSlotRepeater>
+ *   <TimeSlot.StartDate />
+ *   <TimeSlot.Duration />
+ *   <TimeSlot.Actions.Select />
+ * </TimeSlotList.TimeSlotRepeater>
+ * ```
+ */
+export const TimeSlotRepeater = React.forwardRef((props, ref) => {
+    const { children } = props;
+    return (_jsx(GenericList.Repeater, { ref: ref, itemWrapper: ({ item: slot, children: itemChildren }) => (_jsx(TimeSlotItemWrapper, { slot: slot, children: itemChildren }, slot.id)), children: children }));
+});
+TimeSlotRepeater.displayName = 'TimeSlotList.TimeSlotRepeater';
+/**
+ * Displays a button to load more time slots. Not rendered if no more slots are left to load.
+ * Follows the architecture rules - does not support asChild as it's a simple trigger component.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <TimeSlotList.Actions.LoadMore asChild>
+ *   <button>Load More</button>
+ * </TimeSlotList.Actions.LoadMore>
+ * ```
+ */
+export const LoadMore = React.forwardRef((props, ref) => {
+    const { children = _jsx("button", {}), ...otherProps } = props;
+    return (_jsx(GenericList.Actions.LoadMore, { ref: ref, "data-testid": TestIds.timeSlotListLoadMore, ...otherProps, children: children }));
+});
+LoadMore.displayName = 'TimeSlotList.Actions.LoadMore';
+/**
+ * Actions namespace for TimeSlotList
+ */
+export const Actions = {
+    LoadMore,
+};
+// ============================================================================
+// TimeSlot Entity Components (re-exported)
+// ============================================================================
+/**
+ * TimeSlot namespace containing components for displaying individual time slot data.
+ * These components must be used within TimeSlotList.TimeSlotRepeater.
+ *
+ * @example
+ * ```tsx
+ * <TimeSlotList.TimeSlotRepeater>
+ *   <TimeSlot.StartDate />
+ *   <TimeSlot.Duration />
+ *   <TimeSlot.Actions.Select />
+ *
+ *   // Location selection - visible when slot is selected
+ *   <TimeSlot.Locations>
+ *     <TimeSlot.LocationRepeater>
+ *       <TimeSlot.Location.Name />
+ *       <TimeSlot.Location.Actions.Select />
+ *     </TimeSlot.LocationRepeater>
+ *   </TimeSlot.Locations>
+ *
+ *   // Staff member selection - visible when slot is selected
+ *   <TimeSlot.StaffMembers>
+ *     <TimeSlot.StaffMemberRepeater>
+ *       <TimeSlot.StaffMember.Name />
+ *       <TimeSlot.StaffMember.Actions.Select />
+ *     </TimeSlot.StaffMemberRepeater>
+ *   </TimeSlot.StaffMembers>
+ * </TimeSlotList.TimeSlotRepeater>
+ * ```
+ */
+export const TimeSlot = {
+    StartDate,
+    EndDate,
+    Duration,
+    Actions: TimeSlotActions,
+    Locations,
+    LocationRepeater,
+    Location,
+    StaffMembers,
+    StaffMemberRepeater,
+    StaffMember,
+};

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

@@ -4,7 +4,8 @@
  * Persists across page navigation in SPA until page refresh
  */
 import { type Signal } from '@wix/services-definitions/core-services/signals';
-import type { services, availabilityTimeSlots } from '@wix/bookings';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+import type { TimeSlot, Resource, NestedTimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
 /**
  * BookingSelection contains the service AND its related selections
@@ -12,11 +13,11 @@ import type { FormValues } from '@wix/form-public';
 export interface BookingSelection {
     /** Unique identifier for this booking instance (allows same service multiple times) */
     instanceId: string;
-    service: services.Service;
+    service: Service;
     /** Selected resources (staff members, rooms, etc.) */
-    staff?: availabilityTimeSlots.Resource;
+    staff?: Resource;
     /** Per-service slot data from nested slots (for multi-service bookings) */
-    nestedSlotData?: availabilityTimeSlots.NestedTimeSlot;
+    nestedSlotData?: NestedTimeSlot;
 }
 export interface Location {
     id: string;
@@ -30,12 +31,12 @@ export interface BookingServiceActions {
     setService(service: Omit<BookingSelection, 'instanceId'>): string;
     /** Adds a service and returns the generated instanceId */
     addService(service: Omit<BookingSelection, 'instanceId'>): string;
-    /** Updates a booking selection by instanceId */
-    updateServiceByInstanceId(instanceId: string, updates: Partial<Omit<BookingSelection, 'instanceId'>>): void;
-    /** Removes a service selection by instanceId. If no instanceId provided, removes the first service. */
-    removeServiceByInstanceId(instanceId?: string): void;
+    /** Updates a booking selection. If no instanceId provided, updates the first selection. */
+    updateBookingSelection(updates: Partial<Omit<BookingSelection, 'instanceId'>>, instanceId?: string): void;
+    /** Removes a booking selection. If no instanceId provided, removes the first selection. */
+    removeBookingSelection(instanceId?: string): void;
     clearServices(): void;
-    setTimeSlot(slot: availabilityTimeSlots.TimeSlot | null): void;
+    setTimeSlot(slot: TimeSlot | null): void;
     clearTimeSlot(): void;
     setLocation(location: Location | null): void;
     clearLocation(): void;
@@ -51,7 +52,7 @@ export interface BookingService {
     /** Signal containing the booking selections (services with their related data) */
     bookingSelections: Signal<BookingSelection[]>;
     /** Signal containing the currently selected time slot */
-    timeSlot: Signal<availabilityTimeSlots.TimeSlot | null>;
+    timeSlot: Signal<TimeSlot | null>;
     /** Signal containing the selected location (derived from timeSlot) */
     location: Signal<Location | null>;
     /** Signal containing the form values */
@@ -75,7 +76,7 @@ export interface BookingServiceConfig {
     /** Optional initial booking selections to pre-populate */
     initialBookingSelections?: BookingSelection[];
     /** Optional initial time slot to pre-populate */
-    initialTimeSlot?: availabilityTimeSlots.TimeSlot | null;
+    initialTimeSlot?: TimeSlot | null;
     /** Optional initial form values */
     initialFormValues?: FormValues | null;
 }

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

@@ -82,12 +82,14 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
             bookingSelectionsSignal.set([...current, newSelection]);
             return instanceId;
         },
-        updateServiceByInstanceId(instanceId, updates) {
+        updateBookingSelection(updates, instanceId) {
             const current = bookingSelectionsSignal.get();
-            const updated = current.map((s) => s.instanceId === instanceId ? { ...s, ...updates } : s);
+            // If no instanceId provided, update the first selection (index 0)
+            const targetId = instanceId ?? current[0]?.instanceId;
+            const updated = current.map((s) => s.instanceId === targetId ? { ...s, ...updates } : s);
             bookingSelectionsSignal.set(updated);
         },
-        removeServiceByInstanceId(instanceId) {
+        removeBookingSelection(instanceId) {
             const current = bookingSelectionsSignal.get();
             if (!instanceId) {
                 // Remove first selection if no instanceId provided

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

@@ -4,4 +4,5 @@
  */
 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 BookingSelection, type Location, type BookingServiceActions, } from './booking/booking.js';
+export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, type ServiceListServiceAPI, type ServiceListServiceConfig, type ServiceListActions, type QueryOptions, loadServiceListServiceInitialData, type SuccessServiceListServiceConfigResult, type ErrorServiceListServiceConfigResult, } from './service-list/service-list.js';

package/cjs/dist/services/index.js

@@ -4,4 +4,5 @@
  */
 export { ServiceService, ServiceServiceDefinition, loadServiceServiceInitialData, } from './service/service.js';
 export { BookingService, BookingServiceDefinition, } from './booking/booking.js';
+export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, loadServiceListServiceInitialData, } from './service-list/service-list.js';

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

@@ -3,7 +3,7 @@
  * Handles loading and managing a single service's data, loading state, and errors.
  */
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import { services } from '@wix/bookings';
+import { type Service, type Payment } from '@wix/auto_sdk_bookings_services';
 import type { MoneyData } from '@wix/headless-components/react';
 /**
  * Actions object for service selection
@@ -23,9 +23,9 @@ export interface ServiceActions {
  */
 export interface ServicePaymentData {
     /** The service payment information from the service */
-    servicePayment: services.Payment | undefined;
+    servicePayment: Payment | undefined;
     /** The rate type of the service (FIXED, VARIED, CUSTOM, NO_FEE, etc.) */
-    rateType: services.Payment['rateType'] | undefined;
+    rateType: Payment['rateType'] | undefined;
     /** Primary price (used for FIXED or VARIED default) */
     money: MoneyData | null;
     /** Minimum price (used for VARIED) */
@@ -46,7 +46,7 @@ export interface ServicePaymentData {
  */
 export interface ServiceServiceAPI {
     /** Reactive signal containing the current service data */
-    serviceSignal: Signal<services.Service>;
+    serviceSignal: Signal<Service>;
     /** Reactive signal indicating if a service is currently being loaded */
     isLoadingSignal: Signal<boolean>;
     /** Reactive signal containing any error message, or null if no error */
@@ -83,7 +83,7 @@ export declare const ServiceServiceDefinition: string & {
  */
 export interface ServiceServiceConfig {
     /** The initial service data to configure the service with */
-    service?: services.Service;
+    service?: Service;
     /** The service ID to load if no initial service is provided */
     serviceId?: string;
     /** The service slug to load if no initial service is provided */

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

@@ -4,7 +4,7 @@
  */
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-import { services } from '@wix/bookings';
+import { ServiceType, RateType, } from '@wix/auto_sdk_bookings_services';
 import { getServiceById, getServiceBySlug, } from '../../api/query-services/index.js';
 import { BookingServiceDefinition } from '../booking/booking.js';
 import { convertToMoneyData } from '../../utils/money.js';
@@ -88,8 +88,8 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
     const requiresAvailabilitySignal = signalsService.computed(() => {
         const currentService = serviceSignal.get();
         const serviceType = currentService.type;
-        return (serviceType === services.ServiceType.APPOINTMENT ||
-            serviceType === services.ServiceType.CLASS);
+        return (serviceType === ServiceType.APPOINTMENT ||
+            serviceType === ServiceType.CLASS);
     });
     // paymentData signal - computed payment data from service
     const paymentDataSignal = signalsService.computed(() => {
@@ -104,21 +104,21 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
         // Extract pricing based on rate type
         if (payment) {
             switch (rateType) {
-                case services.RateType.FIXED:
+                case RateType.FIXED:
                     // FIXED: Use payment.fixed.price
                     money = convertToMoneyData(payment.fixed?.price);
                     break;
-                case services.RateType.VARIED:
+                case RateType.VARIED:
                     // VARIED: Use defaultPrice as money, plus min/max for range
                     money = convertToMoneyData(payment.varied?.defaultPrice);
                     minPrice = convertToMoneyData(payment.varied?.minPrice);
                     maxPrice = convertToMoneyData(payment.varied?.maxPrice);
                     break;
-                case services.RateType.CUSTOM:
+                case RateType.CUSTOM:
                     // CUSTOM: Use description text (no numeric price)
                     priceDescription = payment.custom?.description || null;
                     break;
-                case services.RateType.NO_FEE:
+                case RateType.NO_FEE:
                     // NO_FEE: Free service (amount = 0)
                     money = { amount: 0, currency: 'USD' };
                     break;
@@ -203,7 +203,7 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
                 .filter((s) => s.service._id === currentService._id)
                 .map((s) => s.instanceId);
             instancesToRemove.forEach((instanceId) => {
-                bookingService.actions.removeServiceByInstanceId(instanceId);
+                bookingService.actions.removeBookingSelection(instanceId);
             });
         },
     };

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

@@ -3,7 +3,7 @@
  * Handles querying and pagination of services list (NO selection management)
  */
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import { services } from '@wix/bookings';
+import type { Service } from '@wix/auto_sdk_bookings_services';
 import type { QueryServicesRequest, PagingMetadata } from '../../api/query-services/index.js';
 export type { ServiceListFilters } from '../../api/query-services/index.js';
 /**
@@ -15,7 +15,7 @@ export type QueryOptions = Omit<QueryServicesRequest, 'pagingMetadata'>;
  * Configuration for the ServiceList service
  */
 export interface ServiceListServiceConfig {
-    services?: services.Service[];
+    services?: Service[];
     options?: QueryServicesRequest;
 }
 /**
@@ -30,7 +30,7 @@ export interface ServiceListActions {
  */
 export interface ServiceListServiceAPI {
     /** Reactive signal containing the list of services */
-    servicesSignal: Signal<services.Service[]>;
+    servicesSignal: Signal<Service[]>;
     /** Reactive signal containing current query options (appId, filters, sort) - changes trigger re-fetch */
     queryOptionsSignal: Signal<QueryOptions>;
     /** Reactive signal containing pagination metadata (limit, offset, count, hasNext) - updated after fetches */

package/cjs/dist/services/time-slot-list/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * TimeSlotList Service
+ * Main export file for time slot list service
+ */
+export { TimeSlotListServiceDefinition, ViewMode, type TimeSlot, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, } from './time-slot-list.def.js';
+export { TimeSlotListService, loadTimeSlotListConfig, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list.js';

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

@@ -0,0 +1,6 @@
+/**
+ * TimeSlotList Service
+ * Main export file for time slot list service
+ */
+export { TimeSlotListServiceDefinition, ViewMode, } from './time-slot-list.def.js';
+export { TimeSlotListService, loadTimeSlotListConfig, } from './time-slot-list.js';

package/cjs/dist/services/time-slot-list/time-slot-list.d.ts

@@ -0,0 +1,58 @@
+/**
+ * TimeSlotList Service Implementation
+ * Manages time slot fetching, selection, and state
+ */
+import type { Service } from '@wix/auto_sdk_bookings_services';
+import { type TimeSlotListServiceConfig, ViewMode } from './time-slot-list.def.js';
+export declare const TimeSlotListService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: import("./time-slot-list.def.js").TimeSlotListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & import("./time-slot-list.def.js").TimeSlotListServiceAPI, TimeSlotListServiceConfig>;
+/**
+ * Options for loading time slots configuration on the server
+ */
+export interface LoadTimeSlotListConfigOptions {
+    /** Services to fetch time slots for */
+    services?: Service[];
+    /** Start date for the time range (defaults to current date) */
+    startDate?: Date;
+    /** End date for the time range (defaults to 7 days from start) */
+    endDate?: Date;
+    /** Timezone for formatting (defaults to UTC) */
+    timezone?: string;
+    /** View mode (defaults to CLASSIC) */
+    viewMode?: ViewMode;
+}
+/**
+ * Result type for SSR loader - either success with config or error
+ */
+export type LoadTimeSlotListConfigResult = {
+    type: 'success';
+    config: TimeSlotListServiceConfig;
+} | {
+    type: 'error';
+    error: string;
+};
+/**
+ * SSR Loader: Pre-fetches time slots for server-side rendering
+ * Use this in Astro/Next.js getServerSideProps or page loaders
+ *
+ * @example
+ * ```typescript
+ * // In Astro page
+ * const loadResult = await loadTimeSlotListConfig({
+ *   services: bookingServices,
+ *   startDate: new Date(),
+ *   endDate: addDays(new Date(), 7),
+ *   timezone: 'America/New_York',
+ * });
+ *
+ * if (loadResult.type === 'error') {
+ *   // Handle error
+ * }
+ *
+ * const timeSlotListConfig = loadResult.config;
+ * ```
+ */
+export declare function loadTimeSlotListConfig(options: LoadTimeSlotListConfigOptions): Promise<LoadTimeSlotListConfigResult>;

package/cjs/dist/services/time-slot-list/time-slot-list.def.d.ts

@@ -0,0 +1,84 @@
+/**
+ * TimeSlotList Service Definition
+ * Defines interfaces and service contract for time slot management
+ */
+import type { Signal } from '@wix/services-definitions/core-services/signals';
+import type { TimeSlot as ApiTimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+export declare enum ViewMode {
+    CLASSIC = "classic",
+    AGENDA = "agenda"
+}
+/**
+ * Maps a location to its available staff members
+ */
+export interface StaffByLocation {
+    location: {
+        id: string;
+        name: string;
+    };
+    staffMembers: {
+        id: string;
+        name: string;
+    }[];
+}
+/**
+ * Grouped time slot that represents a unique time with all available locations/staff
+ * Extends the API TimeSlot type but replaces location-specific fields with aggregated data
+ */
+export interface TimeSlot extends Omit<ApiTimeSlot, 'location' | 'availableResources'> {
+    /** Maps each location to its available staff members */
+    staffByLocation: StaffByLocation[];
+    /** Original API slots for this time (needed for booking service) */
+    originalSlots: ApiTimeSlot[];
+    /** Unique identifier for the time slot */
+    id: string;
+}
+/**
+ * User's selection state
+ */
+export interface SlotSelection {
+    slot: TimeSlot;
+    locationId: string | null;
+    staffMemberId: string | null;
+}
+export interface TimeSlotListServiceConfig {
+    /** Services to fetch time slots for */
+    services?: Service[];
+    /** Pre-loaded time slots (from SSR) - already grouped by time */
+    timeSlots?: TimeSlot[];
+    /** Start date for the time range */
+    startDate?: Date;
+    /** End date for the time range */
+    endDate?: Date;
+    /** Timezone for formatting */
+    timezone?: string;
+    /** View mode */
+    viewMode?: ViewMode;
+}
+export interface TimeSlotListServiceActions {
+    selectSlot: (slot: TimeSlot) => void;
+    selectLocation: (locationId: string) => void;
+    selectStaffMember: (staffMemberId: string) => void;
+    clearPreferences: () => void;
+    loadMore: () => Promise<void>;
+    setDateRange: (start: Date, end: Date) => void;
+    setTimezone: (tz: string) => void;
+}
+export interface TimeSlotListServiceAPI {
+    timeSlots: Signal<TimeSlot[]>;
+    selection: Signal<SlotSelection | null>;
+    isLoading: Signal<boolean>;
+    error: Signal<string | null>;
+    hasMore: Signal<boolean>;
+    viewMode: Signal<ViewMode>;
+    startDate: Signal<Date>;
+    endDate: Signal<Date>;
+    timezone: Signal<string | undefined>;
+    actions: TimeSlotListServiceActions;
+}
+export declare const TimeSlotListServiceDefinition: string & {
+    __api: TimeSlotListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & TimeSlotListServiceAPI;

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

@@ -0,0 +1,17 @@
+/**
+ * TimeSlotList Service Definition
+ * Defines interfaces and service contract for time slot management
+ */
+import { defineService } from '@wix/services-definitions';
+// ============================================================================
+// Enums
+// ============================================================================
+export var ViewMode;
+(function (ViewMode) {
+    ViewMode["CLASSIC"] = "classic";
+    ViewMode["AGENDA"] = "agenda";
+})(ViewMode || (ViewMode = {}));
+// ============================================================================
+// Service Definition
+// ============================================================================
+export const TimeSlotListServiceDefinition = defineService('time-slot-list');