@wix/headless-bookings 0.0.25 → 0.0.26

package/cjs/dist/services/booking/book-action/buildCheckoutRequest.js

@@ -0,0 +1,62 @@
+/**
+ * Builds the createCheckout request
+ */
+import { ChannelType } from '@wix/auto_sdk_ecom_checkout';
+const BOOKINGS_APP_DEF_ID = '13d21c63-b5ec-5912-8397-c3a5ddb27a97';
+/**
+ * Builds a checkout request from the booking ID and contact details
+ *
+ * Contact details come from the booking response and are used to populate:
+ * - billingInfo.contactDetails (firstName, lastName, phone)
+ * - billingInfo.address (from fullAddress if available)
+ * - shippingInfo.shippingDestination.contactDetails
+ * - buyerInfo (email, contactId)
+ *
+ * @param params - The checkout parameters
+ * @returns CreateCheckoutRequest ready to be sent to the API
+ */
+export function buildCheckoutRequest(params) {
+    const { bookingId, contactDetails, businessLocationId } = params;
+    // Build checkoutInfo incrementally for readability
+    const checkoutInfo = {};
+    // businessLocationId for multi-location support
+    if (businessLocationId) {
+        checkoutInfo.businessLocationId = businessLocationId;
+    }
+    // Billing info and shipping info from contact details
+    if (contactDetails) {
+        checkoutInfo.billingInfo = {
+            contactDetails,
+            ...(contactDetails.fullAddress?.country
+                ? { address: { ...contactDetails.fullAddress } }
+                : {}),
+        };
+        checkoutInfo.shippingInfo = {
+            shippingDestination: {
+                contactDetails,
+            },
+        };
+    }
+    // Buyer info with email and contactId
+    if (contactDetails?.email) {
+        checkoutInfo.buyerInfo = {
+            email: contactDetails.email,
+            ...(contactDetails.contactId
+                ? { contactId: contactDetails.contactId }
+                : {}),
+        };
+    }
+    return {
+        channelType: ChannelType.WEB,
+        lineItems: [
+            {
+                quantity: 1,
+                catalogReference: {
+                    catalogItemId: bookingId,
+                    appId: BOOKINGS_APP_DEF_ID,
+                },
+            },
+        ],
+        checkoutInfo,
+    };
+}

package/cjs/dist/services/booking/book-action/canBook.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Validation logic for the Book action
+ */
+import type { ServiceSelection } from '../booking.js';
+import type { FormValues } from '@wix/form-public';
+/**
+ * Parameters for canBook validation
+ */
+export interface CanBookParams {
+    serviceSelections: ServiceSelection[];
+    formSubmission: FormValues | null;
+}
+/**
+ * Validates if booking can be executed
+ * Checks that all required data is present:
+ * - At least one service selection
+ * - Each service selection has a time slot selected
+ * - Form submission filled
+ *
+ * @param params - The booking data to validate
+ * @returns true if booking can proceed, false otherwise
+ */
+export declare function canBook(params: CanBookParams): boolean;

package/cjs/dist/services/booking/book-action/canBook.js

@@ -0,0 +1,19 @@
+/**
+ * Validation logic for the Book action
+ */
+/**
+ * Validates if booking can be executed
+ * Checks that all required data is present:
+ * - At least one service selection
+ * - Each service selection has a time slot selected
+ * - Form submission filled
+ *
+ * @param params - The booking data to validate
+ * @returns true if booking can proceed, false otherwise
+ */
+export function canBook(params) {
+    const { serviceSelections, formSubmission } = params;
+    return (serviceSelections.length > 0 &&
+        serviceSelections.every((item) => item.timeSlot !== undefined) &&
+        formSubmission !== null);
+}

package/cjs/dist/services/booking/book-action/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Book Action - Exports
+ */
+export { executeBookAction } from './bookAction.js';
+export { canBook, type CanBookParams } from './canBook.js';
+export { buildBookingRequest } from './buildBookingRequest.js';
+export { buildCheckoutRequest, type BuildCheckoutParams, } from './buildCheckoutRequest.js';
+export type { BookProps, BookResult, BookingError, BookActionParams, BookChildProps, } from './types.js';

package/cjs/dist/services/booking/book-action/index.js

@@ -0,0 +1,7 @@
+/**
+ * Book Action - Exports
+ */
+export { executeBookAction } from './bookAction.js';
+export { canBook } from './canBook.js';
+export { buildBookingRequest } from './buildBookingRequest.js';
+export { buildCheckoutRequest, } from './buildCheckoutRequest.js';

package/cjs/dist/services/booking/book-action/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Types for the Book action
+ */
+import type { ServiceSelection, Location } from '../booking.js';
+import type { FormValues } from '@wix/form-public';
+/**
+ * Result returned from the book action
+ */
+export type BookResult = {
+    checkoutId: string;
+};
+/**
+ * Error object for booking errors
+ */
+export interface BookingError {
+    message: string;
+    errorObject: unknown;
+}
+/**
+ * Parameters for executing the book action
+ */
+export interface BookActionParams {
+    serviceSelections: ServiceSelection[];
+    location: Location | null;
+    formSubmission: FormValues | null;
+    timezone?: string;
+}
+/**
+ * Props passed to children of Book component
+ */
+export interface BookChildProps {
+    isLoading: boolean;
+    error: BookingError | null;
+    canBook: boolean;
+    onClick: () => void;
+    disabled: boolean;
+}
+/**
+ * Props for the Book headless component
+ */
+export interface BookProps {
+    asChild?: boolean;
+    children?: React.ReactNode | ((props: BookChildProps) => React.ReactNode);
+    className?: string;
+    label?: string;
+    loadingState?: string;
+    disabled?: boolean;
+    onCheckoutRequired?: (result: BookResult) => void;
+    onError?: (error: BookingError) => void;
+}

package/cjs/dist/services/booking/book-action/types.js

@@ -0,0 +1,4 @@
+/**
+ * Types for the Book action
+ */
+export {};

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

@@ -7,6 +7,7 @@ import { type Signal } from '@wix/services-definitions/core-services/signals';
 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';
+import type { BookResult } from './book-action/types.js';
 export declare const ANY_STAFF_MEMBER_ID = "__any_staff_member__";
 /**
  * Minimal time slot data for service selections
@@ -62,6 +63,7 @@ export interface BookingServiceActions {
     setFormSubmission(values: FormValues | null): void;
     clearFormSubmission(): void;
     clearAll(): void;
+    book(): Promise<BookResult>;
 }
 /**
  * Booking Service interface

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

@@ -5,6 +5,7 @@
  */
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+import { executeBookAction } from './book-action/bookAction.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -174,6 +175,21 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
             locationSignal.set(null);
             formSubmissionSignal.set(null);
         },
+        // Book action - collects data from signals and delegates to executeBookAction
+        // Loading/error state management is handled in Book.tsx component
+        async book() {
+            const serviceSelections = serviceSelectionsSignal.get();
+            const formSubmission = formSubmissionSignal.get();
+            const location = locationSignal.get();
+            const timezone = timezoneSignal.get();
+            // Validation happens inside executeBookAction
+            return executeBookAction({
+                serviceSelections,
+                formSubmission,
+                location,
+                timezone,
+            });
+        },
     };
     return {
         serviceSelections: serviceSelectionsSignal,

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

@@ -6,4 +6,5 @@ export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type
 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';
+export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCheckoutParams, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, type BookingFormServiceAPI, type BookingFormServiceConfig, type BookingFormServiceInternalAPI, type ValidationResult, } from './booking-form/booking-form.js';

package/cjs/dist/services/index.js

@@ -6,4 +6,5 @@ export { ServiceService, ServiceServiceDefinition, loadServiceServiceInitialData
 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';
+export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, } from './booking-form/booking-form.js';

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

@@ -3,8 +3,16 @@
  * Defines interfaces and service contract for time slot management
  */
 import type { Signal } from '@wix/services-definitions/core-services/signals';
-import type { TimeSlot as ApiTimeSlot, Location } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { TimeSlot as ApiTimeSlot, LocationTypeWithLiterals } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Location filter input for availability calls.
+ * Require a stable `id` + `locationType` pair (no optional fields).
+ */
+export interface Location {
+    id: string;
+    locationType: LocationTypeWithLiterals;
+}
 export declare enum ViewMode {
     CLASSIC = "classic",
     AGENDA = "agenda"
@@ -48,7 +56,7 @@ export interface SlotSelection {
  */
 export interface TimeSlotsFilters {
     /** Filter by specific locations */
-    locations?: Location[];
+    location?: Location;
     /** Filter by specific staff member IDs */
     staffMemberIds?: string[];
     /** Filter by bookable status. If undefined, returns both bookable and non-bookable */

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

@@ -65,31 +65,13 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
      * Helper: Get services from config or BookingService
      */
     const getServices = () => {
-        if (config.services?.length)
-            return config.services;
-        return bookingService.serviceSelections.get().map((s) => s.service);
-    };
-    /**
-     * Helper: Get filters from config or BookingService
-     */
-    const getFilters = () => {
-        // Get BookingService selections (these take priority)
-        const location = bookingService.location.get();
-        const serviceSelections = bookingService.serviceSelections.get();
-        const selectedStaffMemberIds = serviceSelections
-            .map((serviceSelection) => serviceSelection.resources.map((r) => r._id))
-            .flat();
-        const selectedLocation = location ? { _id: location.id } : null;
-        // Merge config filters with BookingService selections (selections win)
-        return {
-            ...config.filters,
-            locations: selectedLocation
-                ? [selectedLocation]
-                : config.filters?.locations,
-            staffMemberIds: selectedStaffMemberIds.length
-                ? selectedStaffMemberIds
-                : config.filters?.staffMemberIds,
-        };
+        const selectedServices = bookingService.serviceSelections
+            .get()
+            .map((s) => s.service);
+        if (selectedServices.length) {
+            return selectedServices;
+        }
+        return config.services ?? [];
     };
     /**
      * Fetch time slots from API
@@ -97,7 +79,6 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
      */
     const fetchTimeSlots = async () => {
         const selectedServices = getServices();
-        const filters = getFilters();
         isLoadingSignal.set(true);
         errorSignal.set(null);
         cursorSignal.set(undefined);
@@ -110,7 +91,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
                 timeZone: bookingService.timezone.get(),
                 viewMode: viewModeSignal.get(),
                 cursor: cursorSignal.get(),
-                ...filters,
+                ...config.filters,
             });
             timeSlotsSignal.set(response.timeSlots);
             const nextCursor = response.cursorPagingMetadata?.cursors?.next ?? undefined;
@@ -303,7 +284,6 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
         if (!cursor || isLoadingSignal.get())
             return;
         const selectedServices = getServices();
-        const filters = getFilters();
         isLoadingSignal.set(true);
         try {
             const response = await fetchAvailability({
@@ -313,7 +293,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
                 timeZone: bookingService.timezone.get(),
                 cursor,
                 viewMode: viewModeSignal.get(),
-                ...filters,
+                ...config.filters,
             });
             // API returns grouped slots, merge with existing
             const existing = timeSlotsSignal.get();

package/dist/api/fetch-availability/index.d.ts

@@ -2,15 +2,15 @@
  * Time Slot List API
  * Fetches available time slots for booking services from Wix Bookings
  */
-import { type Location, type CursorPaging, type CursorPagingMetadata } from '@wix/auto_sdk_bookings_availability-time-slots';
+import { type CursorPaging, type CursorPagingMetadata } from '@wix/auto_sdk_bookings_availability-time-slots';
 import { type Service } from '@wix/auto_sdk_bookings_services';
-import { ViewMode, type TimeSlot } from '../../services/time-slot-list/time-slot-list.def.js';
+import { ViewMode, type TimeSlot, type Location } from '../../services/time-slot-list/time-slot-list.def.js';
 export interface FetchAvailabilityOptions {
     services: Service[];
     fromLocalDate?: string | null;
     toLocalDate?: string | null;
     timeZone?: string | null;
-    locations?: Location[];
+    location?: Location;
     /** Filter by specific staff member IDs (passed as resourceIds to API) */
     staffMemberIds?: string[];
     cursorPaging?: CursorPaging;
@@ -52,12 +52,12 @@ export interface FetchAvailabilityResponse {
  * // response.timeSlots are grouped by time
  * ```
  */
-export declare function fetchAvailability({ services: selectedServices, viewMode, fromLocalDate, toLocalDate, timeZone, locations, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }: {
+export declare function fetchAvailability({ services: selectedServices, viewMode, fromLocalDate, toLocalDate, timeZone, location, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }: {
     services: Service[];
     fromLocalDate: Date;
     toLocalDate: Date;
     timeZone?: string;
-    locations?: Location[];
+    location?: Location;
     staffMemberIds?: string[];
     cursor?: string;
     viewMode?: ViewMode;

package/dist/api/fetch-availability/index.js

@@ -115,7 +115,7 @@ function detectFlow(bookingServices, viewMode) {
  * // response.timeSlots are grouped by time
  * ```
  */
-export async function fetchAvailability({ services: selectedServices, viewMode = ViewMode.CLASSIC, fromLocalDate, toLocalDate, timeZone, locations, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }) {
+export async function fetchAvailability({ services: selectedServices, viewMode = ViewMode.CLASSIC, fromLocalDate, toLocalDate, timeZone, location, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }) {
     const flow = detectFlow(selectedServices, viewMode);
     const serviceIds = selectedServices.map((s) => s._id);
     // Convert Date objects to local ISO strings
@@ -138,6 +138,12 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
                 },
             ]
             : undefined;
+        const includeResourceTypeIds = isAnyStaffMemberSelected || isFetchAvailabileDays
+            ? undefined
+            : [STAFF_RESOURCE_TYPE_ID];
+        const locations = location
+            ? [{ _id: location.id, locationType: location.locationType }]
+            : undefined;
         const response = await listAvailabilityTimeSlots({
             serviceId: serviceIds[0],
             fromLocalDate: fromLocalDateStr,
@@ -148,9 +154,7 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
             resourceTypes,
             bookable,
             bookingPolicyViolations,
-            includeResourceTypeIds: isAnyStaffMemberSelected || isFetchAvailabileDays
-                ? undefined
-                : [STAFF_RESOURCE_TYPE_ID],
+            includeResourceTypeIds,
             timeSlotsPerDay,
         });
         return {
@@ -164,7 +168,7 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
     }
     if (flow === FlowType.CLASS) {
         // Build eventFilter for location and staff filtering
-        const locationIds = locations?.map((l) => l._id);
+        const locationIds = location ? [location.id] : undefined;
         const eventFilter = {};
         if (locationIds?.length) {
             eventFilter['location.id'] = locationIds;
@@ -185,7 +189,6 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
         });
         return {
             timeSlots: groupTimeSlotsByTime(response.timeSlots || []),
-            // Note: listEventTimeSlots uses pagingMetadata instead of cursorPagingMetadata
             cursorPagingMetadata: response.pagingMetadata,
         };
     }

package/dist/react/booking/Book.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Book - High-level headless component for the book action button
+ * Wraps core Book with AsChildSlot pattern for customization
+ */
+import React from 'react';
+import type { BookChildProps, BookResult, BookingError } from '../../services/booking/book-action/types.js';
+/**
+ * Props for the high-level Book component
+ */
+export interface BookProps {
+    asChild?: boolean;
+    children?: React.ReactNode | ((props: BookChildProps) => React.ReactNode);
+    className?: string;
+    label?: string;
+    loadingState?: string;
+    disabled?: boolean;
+    onCheckoutRequired?: (result: BookResult) => void;
+    onError?: (error: BookingError) => void;
+}
+/**
+ * Book action button component with AsChildSlot pattern
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ *
+ * // With render function
+ * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? <Spinner /> : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Booking.Actions.Book>
+ *
+ * // With asChild
+ * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ *   <CustomBookButton />
+ * </Booking.Actions.Book>
+ * ```
+ */
+export declare const Book: React.ForwardRefExoticComponent<BookProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/react/booking/Book.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Book - High-level headless component for the book action button
+ * Wraps core Book with AsChildSlot pattern for customization
+ */
+import React from 'react';
+import { AsChildSlot } from '@wix/headless-utils/react';
+import * as CoreBook from '../core/booking/Book.js';
+var TestIds;
+(function (TestIds) {
+    TestIds["bookingActionBook"] = "booking-action-book";
+})(TestIds || (TestIds = {}));
+/**
+ * Book action button component with AsChildSlot pattern
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ *
+ * // With render function
+ * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? <Spinner /> : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Booking.Actions.Book>
+ *
+ * // With asChild
+ * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ *   <CustomBookButton />
+ * </Booking.Actions.Book>
+ * ```
+ */
+export const Book = React.forwardRef((props, ref) => {
+    const { asChild, children, className, label = 'Book Now', loadingState = 'Booking...', disabled, onCheckoutRequired, onError, } = props;
+    return (_jsx(CoreBook.Book, { onCheckoutRequired: onCheckoutRequired, onError: onError, disabled: disabled, children: (childProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.bookingActionBook, "data-in-progress": childProps.isLoading, customElement: children, customElementProps: childProps, children: _jsx("button", { onClick: childProps.onClick, disabled: childProps.disabled, children: childProps.isLoading ? loadingState : label }) })) }));
+});
+Book.displayName = 'Booking.Actions.Book';

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

@@ -34,3 +34,21 @@ export declare const Root: {
     (props: BookingRootProps): React.ReactNode;
     displayName: string;
 };
+/**
+ * Actions namespace containing action components for booking
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => toast.error(error)}
+ * />
+ * ```
+ */
+export declare const Actions: {
+    Book: React.ForwardRefExoticComponent<import("./Book.js").BookProps & React.RefAttributes<HTMLButtonElement>>;
+};

package/dist/react/booking/Booking.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as CoreBooking from '../core/booking/Booking.js';
+import { Book } from './Book.js';
 /**
  * Root component that provides booking context to the entire app.
  *
@@ -23,3 +24,21 @@ export const Root = (props) => {
     return (_jsx(CoreBooking.Root, { bookingServiceConfig: bookingServiceConfig, children: children }));
 };
 Root.displayName = 'Booking.Root';
+/**
+ * Actions namespace containing action components for booking
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => toast.error(error)}
+ * />
+ * ```
+ */
+export const Actions = {
+    Book,
+};

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

@@ -0,0 +1,41 @@
+/**
+ * Core Book - Provides book action data via render props
+ * NO AsChildSlot, NO asChild - that belongs in high-level component
+ */
+import React from 'react';
+import type { BookResult, BookingError } from '../../../services/booking/book-action/types.js';
+/**
+ * Data exposed by Book component via render props
+ */
+export interface BookData {
+    isLoading: boolean;
+    error: BookingError | null;
+    canBook: boolean;
+    onClick: () => Promise<void>;
+    disabled: boolean;
+}
+/**
+ * Props for core Book component
+ */
+export interface BookProps {
+    children: (data: BookData) => React.ReactNode;
+    onCheckoutRequired?: (result: BookResult) => void;
+    onError?: (error: BookingError) => void;
+    disabled?: boolean;
+}
+/**
+ * Core Book component - provides book action data via render props.
+ * Used internally by higher-level Booking.Actions.Book component.
+ *
+ * @example
+ * ```tsx
+ * <Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? 'Booking...' : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Book>
+ * ```
+ */
+export declare function Book(props: BookProps): React.ReactNode;