@wix/headless-bookings 0.0.29 → 0.0.30

package/cjs/dist/react/service/ServiceMedia.d.ts

@@ -0,0 +1,191 @@
+/**
+ * ServiceMedia - Compound component for displaying service media
+ * Provides components for displaying main media, cover media, and media galleries
+ */
+import React from 'react';
+import { AsChildChildren } from '@wix/headless-utils/react';
+/**
+ * Props for ServiceMedia.Main component
+ */
+export interface MainProps {
+    /** Whether to render as a child component */
+    asChild?: boolean;
+    /** Custom render function when using asChild */
+    children?: AsChildChildren<{
+        media: {
+            image?: string;
+        };
+    }>;
+    /** CSS class name */
+    className?: string;
+}
+/**
+ * Displays the service main media image using WixMediaImage.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <ServiceMedia.Main className="w-full h-64 object-cover rounded-lg" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild with primitive img element
+ * <ServiceMedia.Main asChild>
+ *   <img className="w-full h-64 object-cover shadow-lg" />
+ * </ServiceMedia.Main>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild with custom component accessing media data
+ * <ServiceMedia.Main asChild>
+ *   {React.forwardRef(({media, ...props}, ref) => (
+ *     <div ref={ref} {...props} className="relative aspect-video">
+ *       <WixMediaImage media={media} className="w-full h-full object-cover" />
+ *       <div className="absolute bottom-0 left-0 right-0 bg-gradient-to-t from-black/50 p-4">
+ *         <Service.Name className="text-primary-foreground" />
+ *       </div>
+ *     </div>
+ *   ))}
+ * </ServiceMedia.Main>
+ * ```
+ */
+export declare const Main: React.ForwardRefExoticComponent<MainProps & React.RefAttributes<HTMLImageElement>>;
+/**
+ * Props for ServiceMedia.Cover component
+ */
+export interface CoverProps {
+    /** Whether to render as a child component */
+    asChild?: boolean;
+    /** Custom render function when using asChild */
+    children?: AsChildChildren<{
+        media: {
+            image?: string;
+        };
+    }>;
+    /** CSS class name */
+    className?: string;
+}
+/**
+ * Displays the service cover media image using WixMediaImage.
+ * The cover media is typically used as a hero/banner image.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <ServiceMedia.Cover className="w-full h-96 object-cover" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild as a background image container
+ * <ServiceMedia.Cover asChild>
+ *   <div className="w-full h-96 bg-cover bg-center" />
+ * </ServiceMedia.Cover>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild with custom component accessing media data
+ * <ServiceMedia.Cover asChild>
+ *   {React.forwardRef(({media, ...props}, ref) => (
+ *     <header ref={ref} {...props} className="relative h-96">
+ *       <WixMediaImage media={media} className="w-full h-full object-cover" />
+ *       <div className="absolute inset-0 bg-black/40 flex items-center justify-center">
+ *         <h1 className="text-4xl font-bold text-primary-foreground">
+ *           <Service.Name />
+ *         </h1>
+ *       </div>
+ *     </header>
+ *   ))}
+ * </ServiceMedia.Cover>
+ * ```
+ */
+export declare const Cover: React.ForwardRefExoticComponent<CoverProps & React.RefAttributes<HTMLImageElement>>;
+/**
+ * Props for ServiceMedia.Gallery component
+ */
+export interface GalleryProps {
+    /** Child components to render within the gallery (MediaGallery components) */
+    children: React.ReactNode;
+    /** Whether the gallery should loop infinitely */
+    infinite?: boolean;
+    /** Auto-play configuration for the gallery */
+    autoPlay?: {
+        /** Direction of auto-play */
+        direction?: 'forward' | 'backward';
+        /** Interval between slides in milliseconds */
+        intervalMs?: number;
+    };
+}
+/**
+ * Container for service media items gallery.
+ * Renders a MediaGallery.Root with the service media items.
+ * Supports autoPlay and infinite scroll options for carousel behavior.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Basic usage with MediaGallery components
+ * <ServiceMedia.Gallery>
+ *   <MediaGallery.Thumbnails>
+ *     <MediaGallery.ThumbnailRepeater>
+ *       <MediaGallery.ThumbnailItem />
+ *     </MediaGallery.ThumbnailRepeater>
+ *   </MediaGallery.Thumbnails>
+ * </ServiceMedia.Gallery>
+ *
+ * // With autoPlay carousel
+ * <ServiceMedia.Gallery
+ *   autoPlay={{ direction: 'forward', intervalMs: 3000 }}
+ *   infinite
+ * >
+ *   <MediaGallery.Viewport />
+ *   <MediaGallery.Previous />
+ *   <MediaGallery.Next />
+ * </ServiceMedia.Gallery>
+ *
+ * // Full gallery with thumbnails and navigation
+ * <ServiceMedia.Gallery infinite>
+ *   <div className="gallery-container">
+ *     <MediaGallery.Viewport className="main-image" />
+ *     <div className="controls">
+ *       <MediaGallery.Previous>Prev</MediaGallery.Previous>
+ *       <MediaGallery.Next>Next</MediaGallery.Next>
+ *     </div>
+ *     <MediaGallery.Thumbnails>
+ *       <MediaGallery.ThumbnailRepeater>
+ *         <MediaGallery.ThumbnailItem />
+ *       </MediaGallery.ThumbnailRepeater>
+ *     </MediaGallery.Thumbnails>
+ *   </div>
+ * </ServiceMedia.Gallery>
+ * ```
+ */
+export declare const Gallery: React.FC<GalleryProps>;
+/**
+ * ServiceMedia compound component for displaying service media
+ *
+ * @example
+ * ```tsx
+ * import { Service, ServiceMedia } from '@wix/headless-bookings/react';
+ *
+ * function ServiceCard({ service }) {
+ *   return (
+ *     <Service.Root serviceServiceConfig={{ service }}>
+ *       <ServiceMedia.Main className="w-full h-48 object-cover" />
+ *       <Service.Name />
+ *     </Service.Root>
+ *   );
+ * }
+ * ```
+ */
+export declare const ServiceMedia: {
+    Main: React.ForwardRefExoticComponent<MainProps & React.RefAttributes<HTMLImageElement>>;
+    Cover: React.ForwardRefExoticComponent<CoverProps & React.RefAttributes<HTMLImageElement>>;
+    Gallery: React.FC<GalleryProps>;
+};
+export default ServiceMedia;

package/cjs/dist/react/service/ServiceMedia.js

@@ -0,0 +1,175 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ServiceMedia - Compound component for displaying service media
+ * Provides components for displaying main media, cover media, and media galleries
+ */
+import React from 'react';
+import { AsChildSlot } from '@wix/headless-utils/react';
+import { WixMediaImage } from '@wix/headless-media/react';
+import { MediaGallery } from '@wix/headless-media/react';
+import * as CoreServiceMediaMain from '../core/service/ServiceMediaMain.js';
+import * as CoreServiceMediaCover from '../core/service/ServiceMediaCover.js';
+import * as CoreServiceMediaGallery from '../core/service/ServiceMediaGallery.js';
+var TestIds;
+(function (TestIds) {
+    TestIds["serviceMediaMain"] = "service-media-main";
+    TestIds["serviceMediaCover"] = "service-media-cover";
+})(TestIds || (TestIds = {}));
+/**
+ * Displays the service main media image using WixMediaImage.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <ServiceMedia.Main className="w-full h-64 object-cover rounded-lg" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild with primitive img element
+ * <ServiceMedia.Main asChild>
+ *   <img className="w-full h-64 object-cover shadow-lg" />
+ * </ServiceMedia.Main>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild with custom component accessing media data
+ * <ServiceMedia.Main asChild>
+ *   {React.forwardRef(({media, ...props}, ref) => (
+ *     <div ref={ref} {...props} className="relative aspect-video">
+ *       <WixMediaImage media={media} className="w-full h-full object-cover" />
+ *       <div className="absolute bottom-0 left-0 right-0 bg-gradient-to-t from-black/50 p-4">
+ *         <Service.Name className="text-primary-foreground" />
+ *       </div>
+ *     </div>
+ *   ))}
+ * </ServiceMedia.Main>
+ * ```
+ */
+export const Main = React.forwardRef((props, ref) => {
+    const { asChild, children, className } = props;
+    return (_jsx(CoreServiceMediaMain.MainMedia, { children: ({ mainMedia }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.serviceMediaMain, customElement: children, customElementProps: { media: mainMedia }, children: mainMedia?.image ? _jsx(WixMediaImage, { media: mainMedia }) : null })) }));
+});
+Main.displayName = 'ServiceMedia.Main';
+/**
+ * Displays the service cover media image using WixMediaImage.
+ * The cover media is typically used as a hero/banner image.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default usage
+ * <ServiceMedia.Cover className="w-full h-96 object-cover" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild as a background image container
+ * <ServiceMedia.Cover asChild>
+ *   <div className="w-full h-96 bg-cover bg-center" />
+ * </ServiceMedia.Cover>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // asChild with custom component accessing media data
+ * <ServiceMedia.Cover asChild>
+ *   {React.forwardRef(({media, ...props}, ref) => (
+ *     <header ref={ref} {...props} className="relative h-96">
+ *       <WixMediaImage media={media} className="w-full h-full object-cover" />
+ *       <div className="absolute inset-0 bg-black/40 flex items-center justify-center">
+ *         <h1 className="text-4xl font-bold text-primary-foreground">
+ *           <Service.Name />
+ *         </h1>
+ *       </div>
+ *     </header>
+ *   ))}
+ * </ServiceMedia.Cover>
+ * ```
+ */
+export const Cover = React.forwardRef((props, ref) => {
+    const { asChild, children, className } = props;
+    return (_jsx(CoreServiceMediaCover.CoverMedia, { children: ({ coverMedia }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.serviceMediaCover, customElement: children, customElementProps: { media: coverMedia }, children: coverMedia?.image ? _jsx(WixMediaImage, { media: coverMedia }) : null })) }));
+});
+Cover.displayName = 'ServiceMedia.Cover';
+/**
+ * Container for service media items gallery.
+ * Renders a MediaGallery.Root with the service media items.
+ * Supports autoPlay and infinite scroll options for carousel behavior.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Basic usage with MediaGallery components
+ * <ServiceMedia.Gallery>
+ *   <MediaGallery.Thumbnails>
+ *     <MediaGallery.ThumbnailRepeater>
+ *       <MediaGallery.ThumbnailItem />
+ *     </MediaGallery.ThumbnailRepeater>
+ *   </MediaGallery.Thumbnails>
+ * </ServiceMedia.Gallery>
+ *
+ * // With autoPlay carousel
+ * <ServiceMedia.Gallery
+ *   autoPlay={{ direction: 'forward', intervalMs: 3000 }}
+ *   infinite
+ * >
+ *   <MediaGallery.Viewport />
+ *   <MediaGallery.Previous />
+ *   <MediaGallery.Next />
+ * </ServiceMedia.Gallery>
+ *
+ * // Full gallery with thumbnails and navigation
+ * <ServiceMedia.Gallery infinite>
+ *   <div className="gallery-container">
+ *     <MediaGallery.Viewport className="main-image" />
+ *     <div className="controls">
+ *       <MediaGallery.Previous>Prev</MediaGallery.Previous>
+ *       <MediaGallery.Next>Next</MediaGallery.Next>
+ *     </div>
+ *     <MediaGallery.Thumbnails>
+ *       <MediaGallery.ThumbnailRepeater>
+ *         <MediaGallery.ThumbnailItem />
+ *       </MediaGallery.ThumbnailRepeater>
+ *     </MediaGallery.Thumbnails>
+ *   </div>
+ * </ServiceMedia.Gallery>
+ * ```
+ */
+export const Gallery = (props) => {
+    const { children, infinite, autoPlay } = props;
+    return (_jsx(CoreServiceMediaGallery.MediaGallery, { children: ({ mediaItems }) => {
+            const mediaGalleryServiceConfig = {
+                media: mediaItems,
+                infinite,
+                autoPlay,
+            };
+            return (_jsx(MediaGallery.Root, { mediaGalleryServiceConfig: mediaGalleryServiceConfig, children: children }));
+        } }));
+};
+Gallery.displayName = 'ServiceMedia.Gallery';
+/**
+ * ServiceMedia compound component for displaying service media
+ *
+ * @example
+ * ```tsx
+ * import { Service, ServiceMedia } from '@wix/headless-bookings/react';
+ *
+ * function ServiceCard({ service }) {
+ *   return (
+ *     <Service.Root serviceServiceConfig={{ service }}>
+ *       <ServiceMedia.Main className="w-full h-48 object-cover" />
+ *       <Service.Name />
+ *     </Service.Root>
+ *   );
+ * }
+ * ```
+ */
+export const ServiceMedia = {
+    Main,
+    Cover,
+    Gallery,
+};
+export default ServiceMedia;

package/dist/react/core/service/ServiceMediaCover.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Core ServiceMediaCover Component
+ * Provides low-level access to service cover media via render props
+ */
+import React from 'react';
+/**
+ * Render props for CoverMedia component
+ */
+export interface CoverMediaRenderProps {
+    /** Cover media object containing the image string */
+    coverMedia: {
+        image?: string;
+    };
+    /** Whether the service has a cover media image */
+    hasCoverMedia: boolean;
+}
+/**
+ * Props for CoverMedia component
+ */
+export interface CoverMediaProps {
+    /** Render prop function that receives cover media data */
+    children: (props: CoverMediaRenderProps) => React.ReactNode;
+}
+/**
+ * Core component that provides access to service cover media via render props.
+ * The cover media is typically used as a hero/banner image.
+ * Must be used within a Service.Root context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ServiceMediaCover.CoverMedia>
+ *   {({ coverMedia, hasCoverMedia }) => (
+ *     hasCoverMedia ? (
+ *       <img src={coverMedia.image} alt="Service Cover" />
+ *     ) : (
+ *       <div>No cover image available</div>
+ *     )
+ *   )}
+ * </ServiceMediaCover.CoverMedia>
+ * ```
+ */
+export declare function CoverMedia(props: CoverMediaProps): React.ReactNode;

package/dist/react/core/service/ServiceMediaCover.js

@@ -0,0 +1,34 @@
+/**
+ * Core ServiceMediaCover Component
+ * Provides low-level access to service cover media via render props
+ */
+import { useService } from '@wix/services-manager-react';
+import { ServiceServiceDefinition } from '../../../services/service/service.js';
+/**
+ * Core component that provides access to service cover media via render props.
+ * The cover media is typically used as a hero/banner image.
+ * Must be used within a Service.Root context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ServiceMediaCover.CoverMedia>
+ *   {({ coverMedia, hasCoverMedia }) => (
+ *     hasCoverMedia ? (
+ *       <img src={coverMedia.image} alt="Service Cover" />
+ *     ) : (
+ *       <div>No cover image available</div>
+ *     )
+ *   )}
+ * </ServiceMediaCover.CoverMedia>
+ * ```
+ */
+export function CoverMedia(props) {
+    const serviceService = useService(ServiceServiceDefinition);
+    const service = serviceService.serviceSignal.get();
+    const coverMedia = {
+        image: service.media?.coverMedia?.image,
+    };
+    const hasCoverMedia = !!coverMedia.image;
+    return props.children({ coverMedia, hasCoverMedia });
+}

package/dist/react/core/service/ServiceMediaGallery.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Core ServiceMediaGallery Component
+ * Provides low-level access to service media gallery items via render props
+ */
+import React from 'react';
+/**
+ * Media item type for gallery items
+ */
+export interface MediaItem {
+    image?: string;
+}
+/**
+ * Render props for MediaGallery component
+ */
+export interface MediaGalleryRenderProps {
+    /** Array of media items in the gallery */
+    mediaItems: MediaItem[];
+    /** Whether the service has any media items */
+    hasMediaItems: boolean;
+}
+/**
+ * Props for MediaGallery component
+ */
+export interface MediaGalleryProps {
+    /** Render prop function that receives media gallery data */
+    children: (props: MediaGalleryRenderProps) => React.ReactNode;
+}
+/**
+ * Core component that provides access to service media gallery items via render props.
+ * Must be used within a Service.Root context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ServiceMediaGallery.MediaGallery>
+ *   {({ mediaItems, hasMediaItems }) => (
+ *     hasMediaItems ? (
+ *       <div>
+ *         {mediaItems.map((item, index) => (
+ *           <img key={index} src={item.image} alt={`Gallery item ${index}`} />
+ *         ))}
+ *       </div>
+ *     ) : (
+ *       <div>No gallery items available</div>
+ *     )
+ *   )}
+ * </ServiceMediaGallery.MediaGallery>
+ * ```
+ */
+export declare function MediaGallery(props: MediaGalleryProps): React.ReactNode;

package/dist/react/core/service/ServiceMediaGallery.js

@@ -0,0 +1,37 @@
+/**
+ * Core ServiceMediaGallery Component
+ * Provides low-level access to service media gallery items via render props
+ */
+import { useService } from '@wix/services-manager-react';
+import { ServiceServiceDefinition } from '../../../services/service/service.js';
+/**
+ * Core component that provides access to service media gallery items via render props.
+ * Must be used within a Service.Root context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ServiceMediaGallery.MediaGallery>
+ *   {({ mediaItems, hasMediaItems }) => (
+ *     hasMediaItems ? (
+ *       <div>
+ *         {mediaItems.map((item, index) => (
+ *           <img key={index} src={item.image} alt={`Gallery item ${index}`} />
+ *         ))}
+ *       </div>
+ *     ) : (
+ *       <div>No gallery items available</div>
+ *     )
+ *   )}
+ * </ServiceMediaGallery.MediaGallery>
+ * ```
+ */
+export function MediaGallery(props) {
+    const serviceService = useService(ServiceServiceDefinition);
+    const service = serviceService.serviceSignal.get();
+    const mediaItems = service.media?.items?.map((item) => ({
+        image: item.image,
+    })) || [];
+    const hasMediaItems = mediaItems.length > 0;
+    return props.children({ mediaItems, hasMediaItems });
+}

package/dist/react/core/service/ServiceMediaMain.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Core ServiceMediaMain Component
+ * Provides low-level access to service main media via render props
+ */
+import React from 'react';
+/**
+ * Render props for MainMedia component
+ */
+export interface MainMediaRenderProps {
+    /** Main media object containing the image string */
+    mainMedia: {
+        image?: string;
+    };
+    /** Whether the service has a main media image */
+    hasMainMedia: boolean;
+}
+/**
+ * Props for MainMedia component
+ */
+export interface MainMediaProps {
+    /** Render prop function that receives main media data */
+    children: (props: MainMediaRenderProps) => React.ReactNode;
+}
+/**
+ * Core component that provides access to service main media via render props.
+ * Must be used within a Service.Root context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ServiceMediaMain.MainMedia>
+ *   {({ mainMedia, hasMainMedia }) => (
+ *     hasMainMedia ? (
+ *       <img src={mainMedia.image} alt="Service" />
+ *     ) : (
+ *       <div>No image available</div>
+ *     )
+ *   )}
+ * </ServiceMediaMain.MainMedia>
+ * ```
+ */
+export declare function MainMedia(props: MainMediaProps): React.ReactNode;

package/dist/react/core/service/ServiceMediaMain.js

@@ -0,0 +1,33 @@
+/**
+ * Core ServiceMediaMain Component
+ * Provides low-level access to service main media via render props
+ */
+import { useService } from '@wix/services-manager-react';
+import { ServiceServiceDefinition } from '../../../services/service/service.js';
+/**
+ * Core component that provides access to service main media via render props.
+ * Must be used within a Service.Root context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ServiceMediaMain.MainMedia>
+ *   {({ mainMedia, hasMainMedia }) => (
+ *     hasMainMedia ? (
+ *       <img src={mainMedia.image} alt="Service" />
+ *     ) : (
+ *       <div>No image available</div>
+ *     )
+ *   )}
+ * </ServiceMediaMain.MainMedia>
+ * ```
+ */
+export function MainMedia(props) {
+    const serviceService = useService(ServiceServiceDefinition);
+    const service = serviceService.serviceSignal.get();
+    const mainMedia = {
+        image: service.media?.mainMedia?.image,
+    };
+    const hasMainMedia = !!mainMedia.image;
+    return props.children({ mainMedia, hasMainMedia });
+}

package/dist/react/index.d.ts

@@ -1,6 +1,7 @@
 export * as Booking from './booking/Booking.js';
 export * as BookingForm from './booking-form/BookingForm.js';
 export * as Service from './service/Service.js';
+export * as ServiceMedia from './service/ServiceMedia.js';
 export * as TimeSlotList from './time-slot-list/TimeSlotList.js';
 export * as ServiceList from './service-list/ServiceList.js';
 export * as Location from './location/Location.js';

package/dist/react/index.js

@@ -1,6 +1,7 @@
 export * as Booking from './booking/Booking.js';
 export * as BookingForm from './booking-form/BookingForm.js';
 export * as Service from './service/Service.js';
+export * as ServiceMedia from './service/ServiceMedia.js';
 export * as TimeSlotList from './time-slot-list/TimeSlotList.js';
 export * as ServiceList from './service-list/ServiceList.js';
 export * as Location from './location/Location.js';