@suiteop/storefront 0.4.0 → 0.6.0

package/dist/{client-CZWN4im4.d.cts → client-s-lEwqzc.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { d as StorefrontStay, S as StorefrontAvailability, c as StorefrontCalendarQuery, a as StorefrontCalendar } from './availability-CnzmxuV3.cjs';
+import { e as StorefrontStay, a as StorefrontBuildingAvailabilityQuery, g as StorefrontUnitAvailability, S as StorefrontAvailability, d as StorefrontCalendarQuery, b as StorefrontCalendar } from './availability.d-Cla9GuGc.js';
 
 declare const storefrontGuestInputSchema: z.ZodObject<{
     firstName: z.ZodString;
@@ -27,13 +27,13 @@ type ConfirmCheckoutSessionInput = z.infer<typeof confirmCheckoutSessionInputSch
 declare const bookingResultSchema: z.ZodObject<{
     bookingRequestId: z.ZodUUID;
     confirmationToken: z.ZodString;
-    status: z.ZodType<"inquiry" | "processing" | "confirmed" | "failed" | "expired" | "pending_pms_sync" | "pending_payment" | "authorized" | "reserved" | "cancelled" | (string & {}), unknown, z.core.$ZodTypeInternals<"inquiry" | "processing" | "confirmed" | "failed" | "expired" | "pending_pms_sync" | "pending_payment" | "authorized" | "reserved" | "cancelled" | (string & {}), unknown>>;
+    status: z.ZodType<"authorized" | "cancelled" | "confirmed" | "expired" | "failed" | "inquiry" | "pending_payment" | "pending_pms_sync" | "processing" | "reserved" | (string & {}), unknown, z.core.$ZodTypeInternals<"authorized" | "cancelled" | "confirmed" | "expired" | "failed" | "inquiry" | "pending_payment" | "pending_pms_sync" | "processing" | "reserved" | (string & {}), unknown>>;
     confirmationCode: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 type BookingResult = z.infer<typeof bookingResultSchema>;
 declare const storefrontBookingSchema: z.ZodObject<{
     id: z.ZodUUID;
-    status: z.ZodType<"inquiry" | "processing" | "confirmed" | "failed" | "expired" | "pending_pms_sync" | "pending_payment" | "authorized" | "reserved" | "cancelled" | (string & {}), unknown, z.core.$ZodTypeInternals<"inquiry" | "processing" | "confirmed" | "failed" | "expired" | "pending_pms_sync" | "pending_payment" | "authorized" | "reserved" | "cancelled" | (string & {}), unknown>>;
+    status: z.ZodType<"authorized" | "cancelled" | "confirmed" | "expired" | "failed" | "inquiry" | "pending_payment" | "pending_pms_sync" | "processing" | "reserved" | (string & {}), unknown, z.core.$ZodTypeInternals<"authorized" | "cancelled" | "confirmed" | "expired" | "failed" | "inquiry" | "pending_payment" | "pending_pms_sync" | "processing" | "reserved" | (string & {}), unknown>>;
     propertyId: z.ZodNullable<z.ZodUUID>;
     checkIn: z.ZodNullable<z.ZodISODate>;
     checkOut: z.ZodNullable<z.ZodISODate>;
@@ -76,6 +76,8 @@ declare const storefrontListingSummarySchema: z.ZodObject<{
     latitude: z.ZodNullable<z.ZodNumber>;
     longitude: z.ZodNullable<z.ZodNumber>;
     bookable: z.ZodBoolean;
+    fromPriceMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type StorefrontListingSummary = z.infer<typeof storefrontListingSummarySchema>;
 declare const storefrontImageSchema: z.ZodObject<{
@@ -100,6 +102,8 @@ declare const storefrontListingSchema: z.ZodObject<{
     latitude: z.ZodNullable<z.ZodNumber>;
     longitude: z.ZodNullable<z.ZodNumber>;
     bookable: z.ZodBoolean;
+    fromPriceMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     buildingSlug: z.ZodString;
     buildingAddress: z.ZodUnknown;
     description: z.ZodNullable<z.ZodString>;
@@ -116,18 +120,47 @@ declare const storefrontListingSchema: z.ZodObject<{
     checkInTime: z.ZodNullable<z.ZodString>;
     checkOutTime: z.ZodNullable<z.ZodString>;
     beds: z.ZodNullable<z.ZodNumber>;
-    fromPriceMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     countryCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type StorefrontListing = z.infer<typeof storefrontListingSchema>;
-declare const storefrontListingsQuerySchema: z.ZodObject<{
-    location: z.ZodOptional<z.ZodString>;
-    building: z.ZodOptional<z.ZodUUID>;
-    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+declare const STOREFRONT_LISTING_SORTS: readonly ['recommended', 'price_asc', 'price_desc', 'rating'];
+type StorefrontListingSort = (typeof STOREFRONT_LISTING_SORTS)[number];
+interface StorefrontListingsQuery {
+    location?: string | readonly string[];
+    building?: string;
+    guests?: number;
+    bedrooms?: number;
+    currency?: string;
+    priceMin?: number;
+    priceMax?: number;
+    amenities?: readonly string[];
+    bounds?: readonly [number, number, number, number] | string;
+    checkIn?: string;
+    checkOut?: string;
+    sort?: StorefrontListingSort;
+    facets?: boolean;
+    limit?: number;
+    offset?: number;
+}
+declare const storefrontListingFacetsSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    areas: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        slug: z.ZodNullable<z.ZodString>;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    bedrooms: z.ZodArray<z.ZodObject<{
+        bedrooms: z.ZodNumber;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    price: z.ZodNullable<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        currency: z.ZodNullable<z.ZodString>;
+        buckets: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
-type StorefrontListingsQuery = z.infer<typeof storefrontListingsQuerySchema>;
+type StorefrontListingFacets = z.infer<typeof storefrontListingFacetsSchema>;
 declare const storefrontBuildingSchema: z.ZodObject<{
     id: z.ZodUUID;
     locationId: z.ZodNullable<z.ZodUUID>;
@@ -253,7 +286,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
             wbraid: string | null;
             fbclid: string | null;
             msclkid: string | null;
-            paidClick: "google" | "microsoft" | "meta" | null;
+            paidClick: "google" | "meta" | "microsoft" | null;
         } | null;
         last: {
             ts: string;
@@ -269,7 +302,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
             wbraid: string | null;
             fbclid: string | null;
             msclkid: string | null;
-            paidClick: "google" | "microsoft" | "meta" | null;
+            paidClick: "google" | "meta" | "microsoft" | null;
         } | null;
         ids: {
             gaClientId: string | null;
@@ -281,7 +314,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
             analytics: boolean;
             ads: boolean;
             source: "default" | "user";
-            region: "restricted" | "other";
+            region: "other" | "restricted";
             decidedAt: string | null;
         };
         experiment?: {
@@ -303,7 +336,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
             wbraid: string | null;
             fbclid: string | null;
             msclkid: string | null;
-            paidClick: "google" | "microsoft" | "meta" | null;
+            paidClick: "google" | "meta" | "microsoft" | null;
         } | null;
         last: {
             ts: string;
@@ -319,7 +352,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
             wbraid: string | null;
             fbclid: string | null;
             msclkid: string | null;
-            paidClick: "google" | "microsoft" | "meta" | null;
+            paidClick: "google" | "meta" | "microsoft" | null;
         } | null;
         ids: {
             gaClientId: string | null;
@@ -331,7 +364,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
             analytics: boolean;
             ads: boolean;
             source: "default" | "user";
-            region: "restricted" | "other";
+            region: "other" | "restricted";
             decidedAt: string | null;
         };
         experiment?: {
@@ -351,7 +384,7 @@ declare const createCheckoutSessionInputSchema: z.ZodObject<{
 type CreateCheckoutSessionInput = z.infer<typeof createCheckoutSessionInputSchema>;
 declare const checkoutSessionSchema: z.ZodObject<{
     id: z.ZodUUID;
-    status: z.ZodType<"inquiry" | "processing" | "confirmed" | "failed" | "expired" | "pending_pms_sync" | "pending_payment" | "authorized" | "reserved" | "cancelled" | (string & {}), unknown, z.core.$ZodTypeInternals<"inquiry" | "processing" | "confirmed" | "failed" | "expired" | "pending_pms_sync" | "pending_payment" | "authorized" | "reserved" | "cancelled" | (string & {}), unknown>>;
+    status: z.ZodType<"authorized" | "cancelled" | "confirmed" | "expired" | "failed" | "inquiry" | "pending_payment" | "pending_pms_sync" | "processing" | "reserved" | (string & {}), unknown, z.core.$ZodTypeInternals<"authorized" | "cancelled" | "confirmed" | "expired" | "failed" | "inquiry" | "pending_payment" | "pending_pms_sync" | "processing" | "reserved" | (string & {}), unknown>>;
     quote: z.ZodObject<{
         listingId: z.ZodUUID;
         checkIn: z.ZodISODate;
@@ -526,18 +559,33 @@ type StorefrontQuote = z.infer<typeof storefrontQuoteSchema>;
 declare const STOREFRONT_API_PATH = "/api/storefront/v1";
 interface StorefrontClientOptions {
     publishableKey: string;
+    /**
+     * `'same-origin'` → `/api/storefront/v1` on the page's origin (SuiteOp-hosted sites, via the
+     * storefront edge). A URL → that origin (a `WrongRegionError.baseUrl` works as is). Omitted →
+     * the key's regional host: `https://api-<region>.suiteop.com` for `pk_live_`, the region's
+     * staging host for `pk_test_`.
+     */
     baseUrl?: 'same-origin' | (string & {});
+    /** Per-request timeout. Default 10 s for reads, 20 s for quotes and checkout. */
     timeoutMs?: number;
     fetch?: typeof fetch;
+    /** Sent as `Accept-Language`, so API-side copy (cancellation policy text) localises. */
     locale?: string;
 }
 interface RequestOptions {
+    /** Aborting rejects the call with the signal's reason (an `AbortError`). */
     signal?: AbortSignal;
 }
 interface CreateCheckoutSessionOptions extends RequestOptions {
+    /**
+     * Omitted → one UUID v4 per quoteRef + ratePlanId, reused by every retry on this client until
+     * the outcome is final (a dead session or a definitive refusal releases it).
+     */
     idempotencyKey?: string;
 }
+/** `collections.list` paging. */
 interface ContentListQuery {
+    /** 1–100, default 20. */
     limit?: number;
     offset?: number;
 }
@@ -547,38 +595,67 @@ interface Page<T> {
     limit: number;
     offset: number;
 }
+/** The session plus the Idempotency-Key it was created with — `<suiteop-checkout>` replays both. */
 type CreatedCheckoutSession = CheckoutSession & {
     idempotencyKey: string;
 };
+/** `POST /checkout-sessions/:id/confirm` body as sent (consents and language are optional). */
 type ConfirmCheckoutSessionRequest = z.input<typeof confirmCheckoutSessionInputSchema>;
 interface StorefrontClient {
+    /** The publishable key this client sends (public by design). */
     readonly publishableKey: string;
+    /** The resolved Storefront API base, ending in `/api/storefront/v1`. */
     readonly baseUrl: string;
     site: {
         get(opts?: RequestOptions): Promise<StorefrontSite>;
     };
     listings: {
-        list(query?: Partial<StorefrontListingsQuery>, opts?: RequestOptions): Promise<Page<StorefrontListingSummary>>;
+        /**
+         * The site's listings, filtered and sorted. `facets: true` adds the filters sheet's
+         * `facets` (one more query on the API).
+         */
+        list(query?: StorefrontListingsQuery, opts?: RequestOptions): Promise<Page<StorefrontListingSummary> & {
+            facets?: StorefrontListingFacets;
+        }>;
         get(id: string, opts?: RequestOptions): Promise<StorefrontListing>;
     };
     buildings: {
         list(opts?: RequestOptions): Promise<StorefrontBuilding[]>;
         get(id: string, opts?: RequestOptions): Promise<StorefrontBuilding>;
+        /**
+         * Every unit of the building for one stay — status, stay total and the next free window of the
+         * same length — in one call. Display only: read from the synced calendar, and the total is the
+         * nightly rates plus the cleaning fee, before taxes. `quotes.create` gives the bookable price.
+         * Pages like `listings.list` (`limit` 1–100, default 50).
+         */
+        availability(id: string, query: StorefrontStay & Partial<Pick<StorefrontBuildingAvailabilityQuery, 'limit' | 'offset'>>, opts?: RequestOptions): Promise<Page<StorefrontUnitAvailability>>;
     };
     locations: {
         list(opts?: RequestOptions): Promise<StorefrontLocation[]>;
     };
+    /**
+     * "Things to do": the guest-portal guide lists the manager shows on booking sites, with their
+     * places, in the client's `locale` (English fallback). Lists with no place are left out.
+     */
     guides: {
         list(opts?: RequestOptions): Promise<StorefrontGuide[]>;
+        /** By id; null when the site does not show that list. */
         get(id: string, opts?: RequestOptions): Promise<StorefrontGuide | null>;
     };
+    /** The site's content model as its code declared it (hidden types and fields left out). */
     contentModel: {
         get(opts?: RequestOptions): Promise<StorefrontContentModel>;
     };
+    /**
+     * Items of a collection the site declares (`defineContent`): published ones only, dated up to
+     * now, in the collection's order. `createContentReader` gives the typed version.
+     */
     collections: {
         list(key: string, query?: ContentListQuery, opts?: RequestOptions): Promise<Page<StorefrontContentItem>>;
+        /** By slug or id; null when there is none published (a draft, a future post, a typo). */
         get(key: string, slugOrId: string, opts?: RequestOptions): Promise<StorefrontContentItem | null>;
     };
+    /** A page section's one item. A section nobody filled in yet has `fields: {}`. */
     sections: {
         get(key: string, opts?: RequestOptions): Promise<StorefrontContentItem>;
     };
@@ -600,7 +677,17 @@ interface StorefrontClient {
     checkoutSessions: {
         create(input: CreateCheckoutSessionInput, opts?: CreateCheckoutSessionOptions): Promise<CreatedCheckoutSession>;
         get(id: string, opts?: RequestOptions): Promise<CheckoutSession>;
+        /**
+         * Drop the kept Idempotency-Key for this quote + rate plan; the next `create` opens a new
+         * session and a new payment hold. Never call it after a `failed` session or booking result:
+         * the guest may already have been charged, and a new session would take a second payment.
+         */
         forget(quoteRef: string, ratePlanId?: string): void;
+        /**
+         * Idempotent on the session: a double submit or a second tab gets the same booking. A
+         * confirm error that ends the session (`session_expired`, or `requiresNewSession`) releases
+         * the quote's key, so the next `create` opens a new session. A `failed` result does not.
+         */
         confirm(id: string, input: ConfirmCheckoutSessionRequest, opts?: RequestOptions): Promise<BookingResult>;
     };
     bookings: {
@@ -610,6 +697,7 @@ interface StorefrontClient {
         create(input: StorefrontContactInput, opts?: RequestOptions): Promise<void>;
     };
 }
+/** A typed client for one site's Storefront API, bound to its publishable key. */
 declare function createStorefrontClient(options: StorefrontClientOptions): StorefrontClient;
 
-export { type StorefrontReview as A, type BookingResult as B, type CheckoutMountDescriptor as C, type StorefrontReviewsQuery as D, type StorefrontSite as E, createStorefrontClient as F, type Page as P, type RequestOptions as R, STOREFRONT_API_PATH as S, type CheckoutSession as a, type ConfirmCheckoutSessionInput as b, type ConfirmCheckoutSessionRequest as c, type ContentListQuery as d, type CreateCheckoutSessionInput as e, type CreateCheckoutSessionOptions as f, type CreatedCheckoutSession as g, type StorefrontBooking as h, type StorefrontBuilding as i, type StorefrontClient as j, type StorefrontClientOptions as k, type StorefrontContactInput as l, type StorefrontContentItem as m, type StorefrontContentModel as n, type StorefrontContentRef as o, type StorefrontGuestInput as p, type StorefrontGuide as q, type StorefrontGuideItem as r, type StorefrontImage as s, type StorefrontListing as t, type StorefrontListingSummary as u, type StorefrontListingsQuery as v, type StorefrontLocation as w, type StorefrontQuote as x, type StorefrontQuoteInput as y, type StorefrontRatePlanQuote as z };
+export { type StorefrontQuoteInput as A, type BookingResult as B, type CheckoutMountDescriptor as C, type StorefrontRatePlanQuote as D, type StorefrontReview as E, type StorefrontReviewsQuery as F, type StorefrontSite as G, createStorefrontClient as H, type Page as P, type RequestOptions as R, STOREFRONT_API_PATH as S, type CheckoutSession as a, type ConfirmCheckoutSessionInput as b, type ConfirmCheckoutSessionRequest as c, type ContentListQuery as d, type CreateCheckoutSessionInput as e, type CreateCheckoutSessionOptions as f, type CreatedCheckoutSession as g, type StorefrontBooking as h, type StorefrontBuilding as i, type StorefrontClient as j, type StorefrontClientOptions as k, type StorefrontContactInput as l, type StorefrontContentItem as m, type StorefrontContentModel as n, type StorefrontContentRef as o, type StorefrontGuestInput as p, type StorefrontGuide as q, type StorefrontGuideItem as r, type StorefrontImage as s, type StorefrontListing as t, type StorefrontListingFacets as u, type StorefrontListingSort as v, type StorefrontListingSummary as w, type StorefrontListingsQuery as x, type StorefrontLocation as y, type StorefrontQuote as z };

package/dist/components.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
 var chunkEVSAMV5K_cjs = require('./chunk-EVSAMV5K.cjs');
-var chunkLVFRVNT3_cjs = require('./chunk-LVFRVNT3.cjs');
+var chunkEHQFWSP6_cjs = require('./chunk-EHQFWSP6.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
-var monthFormat=new Intl.DateTimeFormat("en-US",{month:"long",year:"numeric",timeZone:"UTC"});var dayFormat=new Intl.DateTimeFormat("en-US",{dateStyle:"full",timeZone:"UTC"});var WEEKDAYS=["Su","Mo","Tu","We","Th","Fr","Sa"];var utc=isoDate=>new Date(`${isoDate}T00:00:00Z`);var defaultLabels={dateRangePicker:{month:monthStart=>monthFormat.format(utc(monthStart)),weekday:dayIndex=>WEEKDAYS[dayIndex]??"",day:date=>dayFormat.format(utc(date)),previousMonth:"Previous month",nextMonth:"Next month"},guestPicker:{adults:"Adults",children:"Children",increment:field=>`Add ${field}`,decrement:field=>`Remove ${field}`},gallery:{region:"Photos",photo:(index,total)=>`Photo ${index+1} of ${total}`,previous:"Previous photo",next:"Next photo"}};function unavailableDates(days){return days.filter(d=>d.status!=="available").map(d=>d.date)}var DAY_MS=864e5;var toTime=date=>Date.parse(`${date}T00:00:00Z`);var fromTime=time=>new Date(time).toISOString().slice(0,10);var addDays=(date,days)=>fromTime(toTime(date)+days*DAY_MS);var monthOf=date=>`${date.slice(0,7)}-01`;function addMonths(monthStart,months){const d=new Date(toTime(monthStart));d.setUTCMonth(d.getUTCMonth()+months,1);return fromTime(d.getTime())}function localToday(){const now=new Date;const pad=n=>String(n).padStart(2,"0");return `${now.getFullYear()}-${pad(now.getMonth()+1)}-${pad(now.getDate())}`}function monthWeeks(monthStart,weekStartsOn){const lead=(new Date(toTime(monthStart)).getUTCDay()-weekStartsOn+7)%7;const next=addMonths(monthStart,1);const cells=Array.from({length:lead},()=>null);for(let d=monthStart;d<next;d=addDays(d,1))cells.push(d);while(cells.length%7)cells.push(null);return Array.from({length:cells.length/7},(_,w)=>cells.slice(w*7,w*7+7))}function DateRangePicker({value,onChange,unavailable,minNights=1,today:todayProp,defaultMonth,weekStartsOn=0,labels:labelsProp,className,classNames={}}){const labels={...defaultLabels.dateRangePicker,...labelsProp};const today=todayProp??localToday();const blocked=react.useMemo(()=>new Set(unavailable??[]),[unavailable]);const[focused,setFocused]=react.useState(()=>value.checkIn??today);const[month,setMonth]=react.useState(()=>defaultMonth?`${defaultMonth}-01`:monthOf(value.checkIn??today));const[shownCheckIn,setShownCheckIn]=react.useState(value.checkIn);if(value.checkIn!==shownCheckIn){setShownCheckIn(value.checkIn);if(value.checkIn!==null){setFocused(value.checkIn);setMonth(monthOf(value.checkIn));}}const grid=react.useRef(null);const moveFocus=react.useRef(false);react.useEffect(()=>{if(!moveFocus.current)return;moveFocus.current=false;grid.current?.querySelector(`[data-date="${focused}"]`)?.focus();},[focused,month]);const{checkIn,checkOut}=value;const pickingEnd=checkIn!==null&&checkOut===null;const nightFree=d=>d>=today&&!blocked.has(d);const validEnd=d=>{if(checkIn===null||d<=checkIn)return false;if((toTime(d)-toTime(checkIn))/DAY_MS<minNights)return false;for(let n=checkIn;n<d;n=addDays(n,1))if(!nightFree(n))return false;return true};const disabled=d=>pickingEnd&&checkIn!==null&&d>checkIn?!validEnd(d):!nightFree(d);function select(d){if(disabled(d))return;onChange(pickingEnd&&checkIn!==null&&d>checkIn?{checkIn,checkOut:d}:{checkIn:d,checkOut:null});}function stateOf(d){if(d===checkIn)return "start";if(d===checkOut)return "end";if(checkIn!==null&&checkOut!==null&&d>checkIn&&d<checkOut)return "in-range";return disabled(d)?"disabled":"available"}function focusDate(d){moveFocus.current=true;setFocused(d);setMonth(monthOf(d));}function onKeyDown(event,d){const step={ArrowLeft:-1,ArrowRight:1,ArrowUp:-7,ArrowDown:7}[event.key];if(step!==void 0){event.preventDefault();focusDate(addDays(d,step));}else if(event.key==="Enter"||event.key===" "){event.preventDefault();select(d);}}const tabStop=monthOf(focused)===month?focused:month;const weekdays=Array.from({length:7},(_,i)=>(i+weekStartsOn)%7);return jsxRuntime.jsxs("div",{className,children:[jsxRuntime.jsxs("div",{className:classNames.header,children:[jsxRuntime.jsx("button",{type:"button",className:classNames.nav,"aria-label":labels.previousMonth,onClick:()=>setMonth(addMonths(month,-1)),children:"\u2039"}),jsxRuntime.jsx("span",{className:classNames.title,"aria-live":"polite",children:labels.month(month)}),jsxRuntime.jsx("button",{type:"button",className:classNames.nav,"aria-label":labels.nextMonth,onClick:()=>setMonth(addMonths(month,1)),children:"\u203A"})]}),jsxRuntime.jsxs("table",{role:"grid","aria-label":labels.month(month),className:classNames.grid,ref:grid,children:[jsxRuntime.jsx("thead",{children:jsxRuntime.jsx("tr",{children:weekdays.map(i=>jsxRuntime.jsx("th",{scope:"col",className:classNames.weekday,children:labels.weekday(i)},i))})}),jsxRuntime.jsx("tbody",{children:monthWeeks(month,weekStartsOn).map((week,w)=>jsxRuntime.jsx("tr",{children:week.map((d,i)=>{if(d===null)return jsxRuntime.jsx("td",{role:"gridcell"},`pad-${i}`);const state=stateOf(d);return jsxRuntime.jsx("td",{role:"gridcell","data-date":d,"data-state":state,"data-today":d===today?"":void 0,className:classNames.day,tabIndex:d===tabStop?0:-1,"aria-label":labels.day(d),"aria-selected":state==="start"||state==="end"||state==="in-range","aria-disabled":disabled(d)||void 0,onClick:()=>select(d),onKeyDown:event=>onKeyDown(event,d),onFocus:()=>setFocused(d),children:Number(d.slice(8))},d)})},w))})]})]})}function isRecord(value){return typeof value==="object"&&value!==null}var firstString=(record,keys)=>keys.map(k=>record[k]).find(v=>typeof v==="string"&&v.length>0);function listingPhotos(listingOrPictures){if(isRecord(listingOrPictures)&&!Array.isArray(listingOrPictures)){const{images,pictures:pictures2}=listingOrPictures;if(images?.length){return images.map(({url,alt,width,height})=>({url,caption:alt,width,height}))}return listingPhotos(pictures2)}const pictures=listingOrPictures;if(!Array.isArray(pictures))return [];return pictures.flatMap(picture=>{if(typeof picture==="string")return picture?[{url:picture,caption:null}]:[];if(!isRecord(picture))return [];const url=firstString(picture,["original","url","large","regular","original_path","image_path","thumbnail","thumbnail_path"]);if(!url)return [];return [{url,caption:firstString(picture,["caption","description"])??null}]})}function Gallery({photos,onIndexChange,labels:labelsProp,sizes="100vw",className,classNames={}}){const labels={...defaultLabels.gallery,...labelsProp};const[index,setIndex]=react.useState(0);const total=photos.length;const current=Math.min(index,Math.max(0,total-1));const go=next=>{if(next<0||next>=total||next===current)return;setIndex(next);onIndexChange?.(next);};const onKeyDown=event=>{if(event.key==="ArrowLeft")go(current-1);else if(event.key==="ArrowRight")go(current+1);};return jsxRuntime.jsxs("section",{role:"region","aria-roledescription":"carousel","aria-label":labels.region,className,onKeyDown,children:[jsxRuntime.jsx("div",{className:classNames.viewport,"aria-live":"polite",children:photos.map((photo,i)=>jsxRuntime.jsx("div",{role:"group","aria-roledescription":"slide","aria-label":labels.photo(i,total),"data-state":i===current?"active":"inactive",hidden:i!==current,className:classNames.slide,children:jsxRuntime.jsx("img",{...chunkEVSAMV5K_cjs.cdnImageProps(photo.url,1080,sizes),...photo.width&&photo.height?{width:photo.width,height:photo.height}:{},alt:photo.caption||labels.photo(i,total),loading:i===0?"eager":"lazy",decoding:"async",className:classNames.image})},`${i}-${photo.url}`))}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.previous,disabled:current===0,onClick:()=>go(current-1),children:"\u2039"}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.next,disabled:current>=total-1,onClick:()=>go(current+1),children:"\u203A"})]})}function GuestPicker({value,onChange,max=chunkLVFRVNT3_cjs.STOREFRONT_MAX_GUESTS,labels:labelsProp,className,classNames={}}){const labels={...defaultLabels.guestPicker,...labelsProp};const id=react.useId();const fields=[{key:"adults",label:labels.adults,min:1,max:Math.max(value.adults,max-value.children)},{key:"children",label:labels.children,min:0,max:Math.max(value.children,max-value.adults)}];return jsxRuntime.jsx("div",{className,children:fields.map(field=>{const now=value[field.key];const set=next=>{const clamped=Math.min(field.max,Math.max(field.min,next));if(clamped!==now)onChange({...value,[field.key]:clamped});};const onKeyDown=event=>{const next={ArrowUp:now+1,ArrowRight:now+1,ArrowDown:now-1,ArrowLeft:now-1,Home:field.min,End:field.max}[event.key];if(next===void 0)return;event.preventDefault();set(next);};const labelId=`${id}-${field.key}`;return jsxRuntime.jsxs("div",{className:classNames.field,"data-field":field.key,children:[jsxRuntime.jsx("span",{id:labelId,className:classNames.label,children:field.label}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.decrement(field.label),disabled:now<=field.min,onClick:()=>set(now-1),children:"\u2212"}),jsxRuntime.jsx("div",{role:"spinbutton",tabIndex:0,className:classNames.value,"aria-labelledby":labelId,"aria-valuenow":now,"aria-valuemin":field.min,"aria-valuemax":field.max,onKeyDown,children:now}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.increment(field.label),disabled:now>=field.max,onClick:()=>set(now+1),children:"+"})]},field.key)})})}var usable=(lat,lng)=>typeof lat==="number"&&typeof lng==="number"&&Number.isFinite(lat)&&Number.isFinite(lng)&&Math.abs(lat)<=90&&Math.abs(lng)<=180;function Map({listings,children}){const markers=[];for(const listing of listings){if(usable(listing.latitude,listing.longitude)){markers.push({id:listing.id,lat:listing.latitude,lng:listing.longitude,listing});}}const bounds=markers.length===0?null:{north:Math.max(...markers.map(m=>m.lat)),south:Math.min(...markers.map(m=>m.lat)),east:Math.max(...markers.map(m=>m.lng)),west:Math.min(...markers.map(m=>m.lng))};return jsxRuntime.jsx(jsxRuntime.Fragment,{children:children({markers,bounds})})}
+var monthFormat=new Intl.DateTimeFormat("en-US",{month:"long",year:"numeric",timeZone:"UTC"});var dayFormat=new Intl.DateTimeFormat("en-US",{dateStyle:"full",timeZone:"UTC"});var WEEKDAYS=["Su","Mo","Tu","We","Th","Fr","Sa"];var utc=isoDate=>new Date(`${isoDate}T00:00:00Z`);var defaultLabels={dateRangePicker:{month:monthStart=>monthFormat.format(utc(monthStart)),weekday:dayIndex=>WEEKDAYS[dayIndex]??"",day:date=>dayFormat.format(utc(date)),previousMonth:"Previous month",nextMonth:"Next month"},guestPicker:{adults:"Adults",children:"Children",increment:field=>`Add ${field}`,decrement:field=>`Remove ${field}`},gallery:{region:"Photos",photo:(index,total)=>`Photo ${index+1} of ${total}`,previous:"Previous photo",next:"Next photo"}};function unavailableDates(days){return days.filter(d=>d.status!=="available").map(d=>d.date)}var DAY_MS=864e5;var toTime=date=>Date.parse(`${date}T00:00:00Z`);var fromTime=time=>new Date(time).toISOString().slice(0,10);var addDays=(date,days)=>fromTime(toTime(date)+days*DAY_MS);var monthOf=date=>`${date.slice(0,7)}-01`;function addMonths(monthStart,months){const d=new Date(toTime(monthStart));d.setUTCMonth(d.getUTCMonth()+months,1);return fromTime(d.getTime())}function localToday(){const now=new Date;const pad=n=>String(n).padStart(2,"0");return `${now.getFullYear()}-${pad(now.getMonth()+1)}-${pad(now.getDate())}`}function monthWeeks(monthStart,weekStartsOn){const lead=(new Date(toTime(monthStart)).getUTCDay()-weekStartsOn+7)%7;const next=addMonths(monthStart,1);const cells=Array.from({length:lead},()=>null);for(let d=monthStart;d<next;d=addDays(d,1))cells.push(d);while(cells.length%7)cells.push(null);return Array.from({length:cells.length/7},(_,w)=>cells.slice(w*7,w*7+7))}function DateRangePicker({value,onChange,unavailable,minNights=1,today:todayProp,defaultMonth,weekStartsOn=0,labels:labelsProp,className,classNames={}}){const labels={...defaultLabels.dateRangePicker,...labelsProp};const today=todayProp??localToday();const blocked=react.useMemo(()=>new Set(unavailable??[]),[unavailable]);const[focused,setFocused]=react.useState(()=>value.checkIn??today);const[month,setMonth]=react.useState(()=>defaultMonth?`${defaultMonth}-01`:monthOf(value.checkIn??today));const[shownCheckIn,setShownCheckIn]=react.useState(value.checkIn);if(value.checkIn!==shownCheckIn){setShownCheckIn(value.checkIn);if(value.checkIn!==null){setFocused(value.checkIn);setMonth(monthOf(value.checkIn));}}const grid=react.useRef(null);const moveFocus=react.useRef(false);react.useEffect(()=>{if(!moveFocus.current)return;moveFocus.current=false;grid.current?.querySelector(`[data-date="${focused}"]`)?.focus();},[focused,month]);const{checkIn,checkOut}=value;const pickingEnd=checkIn!==null&&checkOut===null;const nightFree=d=>d>=today&&!blocked.has(d);const validEnd=d=>{if(checkIn===null||d<=checkIn)return false;if((toTime(d)-toTime(checkIn))/DAY_MS<minNights)return false;for(let n=checkIn;n<d;n=addDays(n,1))if(!nightFree(n))return false;return true};const disabled=d=>pickingEnd&&checkIn!==null&&d>checkIn?!validEnd(d):!nightFree(d);function select(d){if(disabled(d))return;onChange(pickingEnd&&checkIn!==null&&d>checkIn?{checkIn,checkOut:d}:{checkIn:d,checkOut:null});}function stateOf(d){if(d===checkIn)return "start";if(d===checkOut)return "end";if(checkIn!==null&&checkOut!==null&&d>checkIn&&d<checkOut)return "in-range";return disabled(d)?"disabled":"available"}function focusDate(d){moveFocus.current=true;setFocused(d);setMonth(monthOf(d));}function onKeyDown(event,d){const step={ArrowLeft:-1,ArrowRight:1,ArrowUp:-7,ArrowDown:7}[event.key];if(step!==void 0){event.preventDefault();focusDate(addDays(d,step));}else if(event.key==="Enter"||event.key===" "){event.preventDefault();select(d);}}const tabStop=monthOf(focused)===month?focused:month;const weekdays=Array.from({length:7},(_,i)=>(i+weekStartsOn)%7);return jsxRuntime.jsxs("div",{className,children:[jsxRuntime.jsxs("div",{className:classNames.header,children:[jsxRuntime.jsx("button",{type:"button",className:classNames.nav,"aria-label":labels.previousMonth,onClick:()=>setMonth(addMonths(month,-1)),children:"\u2039"}),jsxRuntime.jsx("span",{className:classNames.title,"aria-live":"polite",children:labels.month(month)}),jsxRuntime.jsx("button",{type:"button",className:classNames.nav,"aria-label":labels.nextMonth,onClick:()=>setMonth(addMonths(month,1)),children:"\u203A"})]}),jsxRuntime.jsxs("table",{role:"grid","aria-label":labels.month(month),className:classNames.grid,ref:grid,children:[jsxRuntime.jsx("thead",{children:jsxRuntime.jsx("tr",{children:weekdays.map(i=>jsxRuntime.jsx("th",{scope:"col",className:classNames.weekday,children:labels.weekday(i)},i))})}),jsxRuntime.jsx("tbody",{children:monthWeeks(month,weekStartsOn).map((week,w)=>jsxRuntime.jsx("tr",{children:week.map((d,i)=>{if(d===null)return jsxRuntime.jsx("td",{role:"gridcell"},`pad-${i}`);const state=stateOf(d);return jsxRuntime.jsx("td",{role:"gridcell","data-date":d,"data-state":state,"data-today":d===today?"":void 0,className:classNames.day,tabIndex:d===tabStop?0:-1,"aria-label":labels.day(d),"aria-selected":state==="start"||state==="end"||state==="in-range","aria-disabled":disabled(d)||void 0,onClick:()=>select(d),onKeyDown:event=>onKeyDown(event,d),onFocus:()=>setFocused(d),children:Number(d.slice(8))},d)})},w))})]})]})}function isRecord(value){return typeof value==="object"&&value!==null}var firstString=(record,keys)=>keys.map(k=>record[k]).find(v=>typeof v==="string"&&v.length>0);function listingPhotos(listingOrPictures){if(isRecord(listingOrPictures)&&!Array.isArray(listingOrPictures)){const{images,pictures:pictures2}=listingOrPictures;if(images?.length){return images.map(({url,alt,width,height})=>({url,caption:alt,width,height}))}return listingPhotos(pictures2)}const pictures=listingOrPictures;if(!Array.isArray(pictures))return [];return pictures.flatMap(picture=>{if(typeof picture==="string")return picture?[{url:picture,caption:null}]:[];if(!isRecord(picture))return [];const url=firstString(picture,["original","url","large","regular","original_path","image_path","thumbnail","thumbnail_path"]);if(!url)return [];return [{url,caption:firstString(picture,["caption","description"])??null}]})}function Gallery({photos,onIndexChange,labels:labelsProp,sizes="100vw",className,classNames={}}){const labels={...defaultLabels.gallery,...labelsProp};const[index,setIndex]=react.useState(0);const total=photos.length;const current=Math.min(index,Math.max(0,total-1));const go=next=>{if(next<0||next>=total||next===current)return;setIndex(next);onIndexChange?.(next);};const onKeyDown=event=>{if(event.key==="ArrowLeft")go(current-1);else if(event.key==="ArrowRight")go(current+1);};return jsxRuntime.jsxs("section",{role:"region","aria-roledescription":"carousel","aria-label":labels.region,className,onKeyDown,children:[jsxRuntime.jsx("div",{className:classNames.viewport,"aria-live":"polite",children:photos.map((photo,i)=>jsxRuntime.jsx("div",{role:"group","aria-roledescription":"slide","aria-label":labels.photo(i,total),"data-state":i===current?"active":"inactive",hidden:i!==current,className:classNames.slide,children:jsxRuntime.jsx("img",{...chunkEVSAMV5K_cjs.cdnImageProps(photo.url,1080,sizes),...photo.width&&photo.height?{width:photo.width,height:photo.height}:{},alt:photo.caption||labels.photo(i,total),loading:i===0?"eager":"lazy",decoding:"async",className:classNames.image})},`${i}-${photo.url}`))}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.previous,disabled:current===0,onClick:()=>go(current-1),children:"\u2039"}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.next,disabled:current>=total-1,onClick:()=>go(current+1),children:"\u203A"})]})}function GuestPicker({value,onChange,max=chunkEHQFWSP6_cjs.STOREFRONT_MAX_GUESTS,labels:labelsProp,className,classNames={}}){const labels={...defaultLabels.guestPicker,...labelsProp};const id=react.useId();const fields=[{key:"adults",label:labels.adults,min:1,max:Math.max(value.adults,max-value.children)},{key:"children",label:labels.children,min:0,max:Math.max(value.children,max-value.adults)}];return jsxRuntime.jsx("div",{className,children:fields.map(field=>{const now=value[field.key];const set=next=>{const clamped=Math.min(field.max,Math.max(field.min,next));if(clamped!==now)onChange({...value,[field.key]:clamped});};const onKeyDown=event=>{const next={ArrowUp:now+1,ArrowRight:now+1,ArrowDown:now-1,ArrowLeft:now-1,Home:field.min,End:field.max}[event.key];if(next===void 0)return;event.preventDefault();set(next);};const labelId=`${id}-${field.key}`;return jsxRuntime.jsxs("div",{className:classNames.field,"data-field":field.key,children:[jsxRuntime.jsx("span",{id:labelId,className:classNames.label,children:field.label}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.decrement(field.label),disabled:now<=field.min,onClick:()=>set(now-1),children:"\u2212"}),jsxRuntime.jsx("div",{role:"spinbutton",tabIndex:0,className:classNames.value,"aria-labelledby":labelId,"aria-valuenow":now,"aria-valuemin":field.min,"aria-valuemax":field.max,onKeyDown,children:now}),jsxRuntime.jsx("button",{type:"button",className:classNames.button,"aria-label":labels.increment(field.label),disabled:now>=field.max,onClick:()=>set(now+1),children:"+"})]},field.key)})})}var usable=(lat,lng)=>typeof lat==="number"&&typeof lng==="number"&&Number.isFinite(lat)&&Number.isFinite(lng)&&Math.abs(lat)<=90&&Math.abs(lng)<=180;function Map({listings,children}){const markers=[];for(const listing of listings){if(usable(listing.latitude,listing.longitude)){markers.push({id:listing.id,lat:listing.latitude,lng:listing.longitude,listing});}}const bounds=markers.length===0?null:{north:Math.max(...markers.map(m=>m.lat)),south:Math.min(...markers.map(m=>m.lat)),east:Math.max(...markers.map(m=>m.lng)),west:Math.min(...markers.map(m=>m.lng))};return jsxRuntime.jsx(jsxRuntime.Fragment,{children:children({markers,bounds})})}
 
 exports.DateRangePicker = DateRangePicker;
 exports.Gallery = Gallery;

package/dist/components.d.cts

@@ -1,11 +1,17 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { b as StorefrontCalendarDay } from './availability-CnzmxuV3.cjs';
+import { c as StorefrontCalendarDay } from './availability.d-Cla9GuGc.cjs';
 import 'zod';
 
+/**
+ * The components' English defaults. The SDK ships no other copy: pass `labels` (any subset)
+ * with your site's own translations.
+ */
 declare const defaultLabels: {
     dateRangePicker: {
+        /** Grid label; `monthStart` is the month's first day, YYYY-MM-DD. */
         month: (monthStart: string) => string;
+        /** Column header; 0 = Sunday. */
         weekday: (dayIndex: number) => string;
         day: (date: string) => string;
         previousMonth: string;
@@ -19,6 +25,7 @@ declare const defaultLabels: {
     };
     gallery: {
         region: string;
+        /** Fallback alt text and slide label; `index` is zero-based. */
         photo: (index: number, total: number) => string;
         previous: string;
         next: string;
@@ -28,6 +35,7 @@ type DateRangePickerLabels = typeof defaultLabels.dateRangePicker;
 type GuestPickerLabels = typeof defaultLabels.guestPicker;
 type GalleryLabels = typeof defaultLabels.gallery;
 
+/** Listing-local dates, YYYY-MM-DD. `checkOut` null while the guest is picking it. */
 interface DateRangeValue {
     checkIn: string | null;
     checkOut: string | null;
@@ -36,16 +44,27 @@ type Slot$2 = 'header' | 'title' | 'nav' | 'grid' | 'weekday' | 'day';
 interface DateRangePickerProps {
     value: DateRangeValue;
     onChange(value: DateRangeValue): void;
+    /** Nights that cannot be booked (see `unavailableDates`); checking out on one is allowed. */
     unavailable?: Iterable<string>;
+    /** Minimum nights for the stay. Default 1. */
     minNights?: number;
+    /** Earlier days are disabled. Default: the browser's local date. */
     today?: string;
+    /** Month shown first, YYYY-MM. Default: the check-in's month, else today's. */
     defaultMonth?: string;
+    /** 0 = Sunday (default), 1 = Monday. */
     weekStartsOn?: 0 | 1;
     labels?: Partial<DateRangePickerLabels>;
     className?: string;
     classNames?: Partial<Record<Slot$2, string>>;
 }
+/** The nights a `calendar.get` answer marks as not bookable. */
 declare function unavailableDates(days: readonly Pick<StorefrontCalendarDay, 'date' | 'status'>[]): string[];
+/**
+ * A controlled, unstyled stay picker: one month grid (`role="grid"`), arrow keys move by day
+ * and week, Enter / Space / click pick the check-in then the check-out. Each day carries
+ * `data-state` = `start` | `end` | `in-range` | `disabled` | `available`.
+ */
 declare function DateRangePicker({ value, onChange, unavailable, minNights, today: todayProp, defaultMonth, weekStartsOn, labels: labelsProp, className, classNames, }: DateRangePickerProps): react.JSX.Element;
 
 interface GalleryPhoto {
@@ -57,13 +76,29 @@ interface GalleryPhoto {
 type Slot$1 = 'viewport' | 'slide' | 'image' | 'button';
 interface GalleryProps {
     photos: readonly GalleryPhoto[];
+    /** Called with the zero-based index of the photo now shown. */
     onIndexChange?(index: number): void;
     labels?: Partial<GalleryLabels>;
+    /** The slide's rendered width, for the browser to pick a size (`<img sizes>`). */
     sizes?: string;
     className?: string;
     classNames?: Partial<Record<Slot$1, string>>;
 }
+/**
+ * A listing's photos for `Gallery`. Pass the listing: its `images` (the photos as SuiteOp hosts
+ * them) come first; with none — not copied yet, or an API revision without them — its `pictures`.
+ *
+ * `StorefrontListing.pictures` is the PMS's own photo array, passed through untyped (it can also
+ * be passed directly). This reads the shapes Guesty (`original` / `thumbnail`, `caption`),
+ * Hostaway (`url`, `caption`) and Streamline (`original_path` / `image_path` / `thumbnail_path`,
+ * `description`) send, plus bare URL strings, and drops anything without a URL.
+ */
 declare function listingPhotos(listingOrPictures: unknown): GalleryPhoto[];
+/**
+ * An unstyled carousel (`role="region"`, `aria-roledescription="carousel"`). Every photo is in
+ * the DOM — only the first loads eagerly — and inactive slides are `hidden`; each slide carries
+ * `data-state` = `active` | `inactive`.
+ */
 declare function Gallery({ photos, onIndexChange, labels: labelsProp, sizes, className, classNames, }: GalleryProps): react.JSX.Element;
 
 interface GuestCounts {
@@ -74,11 +109,13 @@ type Slot = 'field' | 'label' | 'button' | 'value';
 interface GuestPickerProps {
     value: GuestCounts;
     onChange(value: GuestCounts): void;
+    /** Most guests in total (the listing's `maxGuests`). Default 50, the API's ceiling. */
     max?: number;
     labels?: Partial<GuestPickerLabels>;
     className?: string;
     classNames?: Partial<Record<Slot, string>>;
 }
+/** Adults (at least 1) and children as two spinbuttons whose sum never exceeds `max`. */
 declare function GuestPicker({ value, onChange, max, labels: labelsProp, className, classNames, }: GuestPickerProps): react.JSX.Element;
 
 interface MapListing {
@@ -100,12 +137,17 @@ interface MapBounds {
 }
 interface MapRenderProps<T extends MapListing> {
     markers: MapMarker<T>[];
+    /** null when no listing has coordinates. */
     bounds: MapBounds | null;
 }
 interface MapProps<T extends MapListing> {
     listings: readonly T[];
     children(props: MapRenderProps<T>): ReactNode;
 }
+/**
+ * Ships no map library: computes markers (listings without usable coordinates dropped) and
+ * their bounds, and hands them to `children` — plug in MapLibre, Google Maps or a static image.
+ */
 declare function Map<T extends MapListing>({ listings, children }: MapProps<T>): react.JSX.Element;
 
 export { DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, Gallery, type GalleryLabels, type GalleryPhoto, type GalleryProps, type GuestCounts, GuestPicker, type GuestPickerLabels, type GuestPickerProps, Map, type MapBounds, type MapListing, type MapMarker, type MapProps, type MapRenderProps, defaultLabels, listingPhotos, unavailableDates };

package/dist/components.d.ts

@@ -1,11 +1,17 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { b as StorefrontCalendarDay } from './availability-CnzmxuV3.js';
+import { c as StorefrontCalendarDay } from './availability.d-Cla9GuGc.js';
 import 'zod';
 
+/**
+ * The components' English defaults. The SDK ships no other copy: pass `labels` (any subset)
+ * with your site's own translations.
+ */
 declare const defaultLabels: {
     dateRangePicker: {
+        /** Grid label; `monthStart` is the month's first day, YYYY-MM-DD. */
         month: (monthStart: string) => string;
+        /** Column header; 0 = Sunday. */
         weekday: (dayIndex: number) => string;
         day: (date: string) => string;
         previousMonth: string;
@@ -19,6 +25,7 @@ declare const defaultLabels: {
     };
     gallery: {
         region: string;
+        /** Fallback alt text and slide label; `index` is zero-based. */
         photo: (index: number, total: number) => string;
         previous: string;
         next: string;
@@ -28,6 +35,7 @@ type DateRangePickerLabels = typeof defaultLabels.dateRangePicker;
 type GuestPickerLabels = typeof defaultLabels.guestPicker;
 type GalleryLabels = typeof defaultLabels.gallery;
 
+/** Listing-local dates, YYYY-MM-DD. `checkOut` null while the guest is picking it. */
 interface DateRangeValue {
     checkIn: string | null;
     checkOut: string | null;
@@ -36,16 +44,27 @@ type Slot$2 = 'header' | 'title' | 'nav' | 'grid' | 'weekday' | 'day';
 interface DateRangePickerProps {
     value: DateRangeValue;
     onChange(value: DateRangeValue): void;
+    /** Nights that cannot be booked (see `unavailableDates`); checking out on one is allowed. */
     unavailable?: Iterable<string>;
+    /** Minimum nights for the stay. Default 1. */
     minNights?: number;
+    /** Earlier days are disabled. Default: the browser's local date. */
     today?: string;
+    /** Month shown first, YYYY-MM. Default: the check-in's month, else today's. */
     defaultMonth?: string;
+    /** 0 = Sunday (default), 1 = Monday. */
     weekStartsOn?: 0 | 1;
     labels?: Partial<DateRangePickerLabels>;
     className?: string;
     classNames?: Partial<Record<Slot$2, string>>;
 }
+/** The nights a `calendar.get` answer marks as not bookable. */
 declare function unavailableDates(days: readonly Pick<StorefrontCalendarDay, 'date' | 'status'>[]): string[];
+/**
+ * A controlled, unstyled stay picker: one month grid (`role="grid"`), arrow keys move by day
+ * and week, Enter / Space / click pick the check-in then the check-out. Each day carries
+ * `data-state` = `start` | `end` | `in-range` | `disabled` | `available`.
+ */
 declare function DateRangePicker({ value, onChange, unavailable, minNights, today: todayProp, defaultMonth, weekStartsOn, labels: labelsProp, className, classNames, }: DateRangePickerProps): react.JSX.Element;
 
 interface GalleryPhoto {
@@ -57,13 +76,29 @@ interface GalleryPhoto {
 type Slot$1 = 'viewport' | 'slide' | 'image' | 'button';
 interface GalleryProps {
     photos: readonly GalleryPhoto[];
+    /** Called with the zero-based index of the photo now shown. */
     onIndexChange?(index: number): void;
     labels?: Partial<GalleryLabels>;
+    /** The slide's rendered width, for the browser to pick a size (`<img sizes>`). */
     sizes?: string;
     className?: string;
     classNames?: Partial<Record<Slot$1, string>>;
 }
+/**
+ * A listing's photos for `Gallery`. Pass the listing: its `images` (the photos as SuiteOp hosts
+ * them) come first; with none — not copied yet, or an API revision without them — its `pictures`.
+ *
+ * `StorefrontListing.pictures` is the PMS's own photo array, passed through untyped (it can also
+ * be passed directly). This reads the shapes Guesty (`original` / `thumbnail`, `caption`),
+ * Hostaway (`url`, `caption`) and Streamline (`original_path` / `image_path` / `thumbnail_path`,
+ * `description`) send, plus bare URL strings, and drops anything without a URL.
+ */
 declare function listingPhotos(listingOrPictures: unknown): GalleryPhoto[];
+/**
+ * An unstyled carousel (`role="region"`, `aria-roledescription="carousel"`). Every photo is in
+ * the DOM — only the first loads eagerly — and inactive slides are `hidden`; each slide carries
+ * `data-state` = `active` | `inactive`.
+ */
 declare function Gallery({ photos, onIndexChange, labels: labelsProp, sizes, className, classNames, }: GalleryProps): react.JSX.Element;
 
 interface GuestCounts {
@@ -74,11 +109,13 @@ type Slot = 'field' | 'label' | 'button' | 'value';
 interface GuestPickerProps {
     value: GuestCounts;
     onChange(value: GuestCounts): void;
+    /** Most guests in total (the listing's `maxGuests`). Default 50, the API's ceiling. */
     max?: number;
     labels?: Partial<GuestPickerLabels>;
     className?: string;
     classNames?: Partial<Record<Slot, string>>;
 }
+/** Adults (at least 1) and children as two spinbuttons whose sum never exceeds `max`. */
 declare function GuestPicker({ value, onChange, max, labels: labelsProp, className, classNames, }: GuestPickerProps): react.JSX.Element;
 
 interface MapListing {
@@ -100,12 +137,17 @@ interface MapBounds {
 }
 interface MapRenderProps<T extends MapListing> {
     markers: MapMarker<T>[];
+    /** null when no listing has coordinates. */
     bounds: MapBounds | null;
 }
 interface MapProps<T extends MapListing> {
     listings: readonly T[];
     children(props: MapRenderProps<T>): ReactNode;
 }
+/**
+ * Ships no map library: computes markers (listings without usable coordinates dropped) and
+ * their bounds, and hands them to `children` — plug in MapLibre, Google Maps or a static image.
+ */
 declare function Map<T extends MapListing>({ listings, children }: MapProps<T>): react.JSX.Element;
 
 export { DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, Gallery, type GalleryLabels, type GalleryPhoto, type GalleryProps, type GuestCounts, GuestPicker, type GuestPickerLabels, type GuestPickerProps, Map, type MapBounds, type MapListing, type MapMarker, type MapProps, type MapRenderProps, defaultLabels, listingPhotos, unavailableDates };

package/dist/components.js

@@ -1,5 +1,5 @@
 import { cdnImageProps } from './chunk-A43EXKPY.js';
-import { STOREFRONT_MAX_GUESTS } from './chunk-6NFURJXI.js';
+import { STOREFRONT_MAX_GUESTS } from './chunk-IBCBDAGY.js';
 import { useMemo, useState, useRef, useEffect, useId } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';