@suiteop/storefront 0.5.0 → 0.6.0

package/dist/{client-2KyVv-2l.d.cts → client-s-lEwqzc.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { e as StorefrontStay, a as StorefrontBuildingAvailabilityQuery, g as StorefrontUnitAvailability, S as StorefrontAvailability, d as StorefrontCalendarQuery, b as StorefrontCalendar } from './availability-Dh0yLSkj.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>;
@@ -123,7 +123,7 @@ declare const storefrontListingSchema: z.ZodObject<{
     countryCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 type StorefrontListing = z.infer<typeof storefrontListingSchema>;
-declare const STOREFRONT_LISTING_SORTS: readonly ["recommended", "price_asc", "price_desc", "rating"];
+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[];
@@ -135,6 +135,8 @@ interface StorefrontListingsQuery {
     priceMax?: number;
     amenities?: readonly string[];
     bounds?: readonly [number, number, number, number] | string;
+    checkIn?: string;
+    checkOut?: string;
     sort?: StorefrontListingSort;
     facets?: boolean;
     limit?: number;
@@ -284,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;
@@ -300,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;
@@ -312,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?: {
@@ -334,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;
@@ -350,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;
@@ -362,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?: {
@@ -382,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;
@@ -557,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;
 }
@@ -578,17 +595,25 @@ 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: {
+        /**
+         * 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;
         }>;
@@ -597,22 +622,40 @@ interface StorefrontClient {
     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>;
     };
@@ -634,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: {
@@ -644,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 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.d.cts

@@ -1,11 +1,17 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { c as StorefrontCalendarDay } from './availability-Dh0yLSkj.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 { c as StorefrontCalendarDay } from './availability-Dh0yLSkj.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/config.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkZLAOY6IF_cjs = require('./chunk-ZLAOY6IF.cjs');
+var chunkJF245QUY_cjs = require('./chunk-JF245QUY.cjs');
 var zod = require('zod');
 
-var STOREFRONT_LOCALES=["en","fr","es","de","it","pt","nl"];var STOREFRONT_LAYOUTS=["listings","locations","areas","single"];var STOREFRONT_THEMES=["folio","hearth","circuit","tide","noir","fjord"];var REQUIRED="validation.required";var TOO_LONG="validation.max_length";var TOO_MANY="validation.too_large";var INVALID="validation.invalid";var text=max=>zod.z.string(INVALID).max(max,TOO_LONG);var localeSchema=zod.z.enum(STOREFRONT_LOCALES,"validation.storefront.locale_unsupported");var hexSchema=zod.z.string(INVALID).regex(/^#[0-9A-Fa-f]{6}$/,"validation.storefront.color_hex");var assetUrlSchema=zod.z.url({protocol:/^https$/,error:"validation.storefront.url_https"});var localizedSchema=zod.z.partialRecord(localeSchema,text(200),INVALID);var linkSchema=zod.z.object({label:localizedSchema,href:text(500).regex(/^(\/(?!\/)|https:\/\/)/,"validation.storefront.link_href")},INVALID);var fontSchema=zod.z.enum(chunkZLAOY6IF_cjs.STOREFRONT_FONTS,"validation.invalid_option");var storefrontSiteConfigSchema=zod.z.object({layout:zod.z.enum(STOREFRONT_LAYOUTS).optional().catch(void 0),theme:zod.z.enum(STOREFRONT_THEMES).optional().catch(void 0),brand:zod.z.object({name:text(80).min(1,REQUIRED),logoUrl:assetUrlSchema.nullable(),logoOnDarkUrl:assetUrlSchema.nullable().optional(),faviconUrl:assetUrlSchema.nullable()},INVALID),colors:zod.z.object({primary:hexSchema,secondary:hexSchema.nullable().optional(),primaryForeground:hexSchema.optional(),background:hexSchema.optional(),foreground:hexSchema.optional(),accent:hexSchema.optional()},INVALID),fonts:zod.z.object({heading:fontSchema.optional(),body:fontSchema.optional()},INVALID).optional(),nav:zod.z.array(linkSchema,INVALID).max(8,TOO_MANY),footer:zod.z.object({text:localizedSchema,links:zod.z.array(linkSchema,INVALID).max(12,TOO_MANY)},INVALID),defaultLocale:localeSchema,locales:zod.z.array(localeSchema,INVALID).min(1,REQUIRED).max(STOREFRONT_LOCALES.length,TOO_MANY),seo:zod.z.object({titleTemplate:text(80).includes("%s",{error:"validation.storefront.title_template_placeholder"}),defaultDescription:localizedSchema,ogImageUrl:assetUrlSchema.nullable()},INVALID)},INVALID).refine(c=>c.locales.includes(c.defaultLocale),{path:["defaultLocale"],message:"validation.storefront.default_locale_not_listed"});var DEFAULT_STOREFRONT_LAYOUT="listings";var DEFAULT_STOREFRONT_THEME="tide";var STOREFRONT_THEME_RECIPES={folio:{mode:"light",fonts:{heading:"eb_garamond",body:"libre_franklin"},radius:{sm:0,md:0,lg:0,btn:0},btn:{size:12,w:600,ls:"0.14em",tt:"uppercase",h:46},type:{display:[88,1,400,"-0.015em"],h1:[56,1.05,400,"-0.01em"],h2:[36,1.15,400,"0"],h3:[24,1.25,500,"0"],body:[18,1.6,400,"0"],small:[14,1.5,400,"0"],label:[11,1.3,600,"0.16em","uppercase"]},space:{section:144,gutter:32},neutral:{hue:null,mix:0,c:.006},L:{bg:.985,surface:1,surface2:.955,tint:.95,border:.87,ink:.19,muted:.47,dark:.22},C:{ink:.02,dark:.04,tint:.022},shadow:false},hearth:{mode:"light",fonts:{heading:"lora",body:"karla"},radius:{sm:6,md:12,lg:18,btn:8},btn:{size:15,w:700,ls:"0",tt:"none",h:48},type:{display:[64,1.08,500,"-0.01em"],h1:[48,1.12,500,"-0.01em"],h2:[32,1.2,500,"0"],h3:[22,1.3,600,"0"],body:[17,1.6,400,"0"],small:[14,1.5,400,"0"],label:[12,1.3,700,"0.1em","uppercase"]},space:{section:112,gutter:28},neutral:{hue:75,mix:.85,c:.014},L:{bg:.972,surface:.99,surface2:.945,tint:.935,border:.885,ink:.25,muted:.48,dark:.28},C:{ink:.025,dark:.05,tint:.032},shadow:true},circuit:{mode:"light",fonts:{heading:"space_grotesk",body:"ibm_plex_sans"},radius:{sm:8,md:12,lg:16,btn:999},btn:{size:15,w:600,ls:"-0.005em",tt:"none",h:44},type:{display:[64,1.02,600,"-0.035em"],h1:[44,1.08,600,"-0.03em"],h2:[30,1.15,600,"-0.02em"],h3:[20,1.3,600,"-0.01em"],body:[16,1.55,400,"0"],small:[14,1.45,400,"0"],label:[12,1.3,600,"0.02em"]},space:{section:88,gutter:20},neutral:{hue:null,mix:0,c:.004},L:{bg:1,surface:.975,surface2:.958,tint:.958,border:.915,ink:.17,muted:.48,dark:.19},C:{ink:.012,dark:.03,tint:.035},shadow:true},tide:{mode:"light",fonts:{heading:"outfit",body:"mulish"},radius:{sm:12,md:20,lg:28,btn:999},btn:{size:15,w:700,ls:"0.01em",tt:"none",h:50},type:{display:[76,1.02,300,"-0.02em"],h1:[48,1.1,400,"-0.015em"],h2:[34,1.15,400,"-0.01em"],h3:[21,1.3,500,"0"],body:[17,1.6,400,"0"],small:[14,1.5,400,"0"],label:[12,1.3,700,"0.08em","uppercase"]},space:{section:120,gutter:24},neutral:{hue:null,mix:0,c:.005},L:{bg:.99,surface:.968,surface2:.945,tint:.95,border:.905,ink:.26,muted:.48,dark:.29},C:{ink:.035,dark:.055,tint:.028},shadow:true},noir:{mode:"dark",fonts:{heading:"cormorant_garamond",body:"manrope"},radius:{sm:0,md:2,lg:2,btn:0},btn:{size:11,w:600,ls:"0.22em",tt:"uppercase",h:48},type:{display:[84,1,300,"0.02em","uppercase"],h1:[56,1.05,300,"0.01em"],h2:[38,1.15,400,"0"],h3:[24,1.25,500,"0.02em"],body:[16,1.7,400,"0"],small:[13,1.55,400,"0.01em"],label:[11,1.3,600,"0.24em","uppercase"]},space:{section:152,gutter:32},neutral:{hue:null,mix:0,c:.016},L:{bg:.165,surface:.205,surface2:.245,tint:.24,border:.34,ink:.94,muted:.76,dark:.12},C:{ink:.01,dark:.014,tint:.035},shadow:false},fjord:{mode:"light",fonts:{heading:"dm_sans",body:"dm_sans"},radius:{sm:2,md:4,lg:6,btn:4},btn:{size:14,w:500,ls:"0",tt:"none",h:44},type:{display:[60,1.05,500,"-0.03em"],h1:[42,1.1,500,"-0.025em"],h2:[28,1.2,500,"-0.015em"],h3:[19,1.35,500,"-0.005em"],body:[16,1.6,400,"0"],small:[13,1.5,400,"0"],label:[12,1.3,500,"0"]},space:{section:128,gutter:24},neutral:{hue:85,mix:.85,c:.006},L:{bg:.976,surface:.995,surface2:.948,tint:.945,border:.895,ink:.23,muted:.49,dark:.26},C:{ink:.008,dark:.02,tint:.022},shadow:false}};var clamp=(v,a,b)=>Math.min(b,Math.max(a,v));var toLin=c=>c<=.04045?c/12.92:Math.pow((c+.055)/1.055,2.4);var toGam=c=>c<=.0031308?12.92*c:1.055*Math.pow(c,1/2.4)-.055;var hexToRgb=hex=>{const h=hex.replace("#","");return [0,2,4].map(i=>parseInt(h.slice(i,i+2),16)/255)};var rgbToHex=rgb=>"#"+rgb.map(v=>Math.round(clamp(v,0,1)*255).toString(16).padStart(2,"0")).join("").toUpperCase();function hexToOklch(hex){const[r,g,b]=hexToRgb(hex).map(toLin);const l=Math.cbrt(.4122214708*r+.5363325363*g+.0514459929*b);const m=Math.cbrt(.2119034982*r+.6806995451*g+.1073969566*b);const s=Math.cbrt(.0883024619*r+.2817188376*g+.6299787005*b);const L=.2104542553*l+.793617785*m-.0040720468*s;const A=1.9779984951*l-2.428592205*m+.4505937099*s;const B=.0259040371*l+.7827717662*m-.808675766*s;let H=Math.atan2(B,A)*180/Math.PI;if(H<0)H+=360;return [L,Math.sqrt(A*A+B*B),H]}function oklchToLinear(L,C,H){const a=C*Math.cos(H*Math.PI/180);const b=C*Math.sin(H*Math.PI/180);const l=(L+.3963377774*a+.2158037573*b)**3;const m=(L-.1055613458*a-.0638541728*b)**3;const s=(L-.0894841775*a-1.291485548*b)**3;return [4.0767416621*l-3.3077115913*m+.2309699292*s,-1.2684380046*l+2.6097574011*m-.3413193965*s,-0.0041960863*l-.7034186147*m+1.707614701*s]}var inGamut=rgb=>rgb.every(v=>v>=-1e-4&&v<=1.0001);function oklchToHex(lightness,C,H){const L=clamp(lightness,0,1);let rgb=oklchToLinear(L,C,H);if(!inGamut(rgb)){let lo=0;let hi=C;for(let i=0;i<22;i++){const mid=(lo+hi)/2;if(inGamut(oklchToLinear(L,mid,H)))lo=mid;else hi=mid;}rgb=oklchToLinear(L,lo,H);}return rgbToHex(rgb.map(v=>toGam(clamp(v,0,1))))}var luminance=hex=>{const[r,g,b]=hexToRgb(hex).map(toLin);return .2126*r+.7152*g+.0722*b};function contrastRatio(a,b){const x=luminance(a);const y=luminance(b);return (Math.max(x,y)+.05)/(Math.min(x,y)+.05)}var minContrast=(hex,grounds)=>Math.min(...grounds.map(g=>contrastRatio(hex,g)));var rgba=(hex,alpha)=>{const[r,g,b]=hexToRgb(hex).map(v=>Math.round(v*255));return `rgba(${r},${g},${b},${alpha})`};var mixHue=(a,b,t)=>{const d=(b-a+540)%360-180;return (a+d*t+360)%360};function fit(lightness,C,H,grounds,target,dir){let L=lightness;let hex=oklchToHex(L,C,H);let steps=0;while(minContrast(hex,grounds)<target&&steps<100){L=clamp(L+dir*.01,0,1);hex=oklchToHex(L,C,H);steps++;}return {hex,L,steps}}var SERIF_FONTS=new Set(["playfair_display","merriweather","bitter","fraunces","cormorant_garamond","eb_garamond","lora","crimson_pro","source_serif_4","ibm_plex_serif"]);function storefrontFontStack(font){return `'${chunkZLAOY6IF_cjs.STOREFRONT_FONT_FAMILIES[font]}', ${SERIF_FONTS.has(font)?"serif":"sans-serif"}`}var AA=4.5;var INK=7;function derivePalette(recipe,brandHex,secondary,overrides){const[bL,bC,bH]=hexToOklch(brandHex);const nh=recipe.neutral.hue==null?bH:mixHue(bH,recipe.neutral.hue,recipe.neutral.mix);const nc=recipe.neutral.c;const{L,C}=recipe;const dark=recipe.mode==="dark";const dir=dark?1:-1;const N=(l,c=nc)=>oklchToHex(l,c,nh);const bg=overrides.background?.toUpperCase()??N(L.bg);const surface=N(L.surface,L.surface>=.999?0:nc);const surface2=N(L.surface2);const tint=oklchToHex(L.tint,Math.min(bC,C.tint),bH);const border=N(L.border,nc*1.5);const borderStrong=N(dark?L.border+.12:L.border-.2,nc*1.5);const grounds=[bg,surface,surface2,tint];const ink=overrides.foreground?.toUpperCase()??fit(L.ink,C.ink,nh,grounds,INK,dir).hex;const muted=fit(L.muted,nc*2.5,nh,grounds,AA,dir).hex;const brandText=fit(bL,bC,bH,grounds,AA,dir);const accentText=overrides.accent?.toUpperCase()??brandText.hex;const notes=[];let p;let on;if(!dark){const white=oklchToHex(.995,.003,bH);if(contrastRatio(brandHex,white)>=AA){p={hex:brandHex.toUpperCase(),L:bL};on=white;}else if(bL>=.7&&contrastRatio(brandHex,ink)>=AA){p={hex:brandHex.toUpperCase(),L:bL};on=ink;notes.push({code:"light_brand_ink_label",text:"Light brand: button keeps the colour and takes an ink label"});}else {p=fit(bL,bC,bH,[white],AA,-1);on=white;notes.push({code:"button_darkened",from:round2(bL),to:round2(p.L),text:`Button darkened L ${bL.toFixed(2)} \u2192 ${p.L.toFixed(2)} for a white label`});}}else {on=bg;p=fit(Math.max(bL,.72),bC,bH,[bg,surface],AA,1);if(p.L>bL+.005){notes.push({code:"brand_lifted",from:round2(bL),to:round2(p.L),text:`Brand lifted L ${bL.toFixed(2)} \u2192 ${p.L.toFixed(2)} to read on dark`});}}const onPrimary=overrides.primaryForeground?.toUpperCase()??on;let primaryHover=oklchToHex(p.L+(dark?.05:-0.06),bC,bH);if(contrastRatio(primaryHover,onPrimary)<AA){primaryHover=oklchToHex(p.L+(dark?-0.04:.04),bC,bH);}const darkToken=oklchToHex(L.dark,Math.min(bC,C.dark),bH);const phBg=dark?oklchToHex(.27,Math.min(bC,.03),bH):oklchToHex(L.tint-.045,Math.min(bC,.03),bH);const t={bg,surface,surface2,tint,border,borderStrong,ink,muted,primary:p.hex,onPrimary,primaryHover,accentText,dark:darkToken,onDark:oklchToHex(.97,.008,bH),onDarkMuted:fit(.82,.012,bH,[darkToken],AA,1).hex,darkAccent:fit(Math.max(bL,.72),bC,bH,[darkToken],AA,1).hex,focus:dark?p.hex:accentText,phBg,phText:fit(dark?.7:.48,.02,bH,[phBg],AA,dir).hex};if(secondary)t.accent2=fit(...hexToOklch(secondary),grounds,AA,dir).hex;if(!dark&&brandText.steps>0&&accentText===brandText.hex){notes.push({code:"brand_text_darkened",steps:brandText.steps,text:`Brand text darkened ${brandText.steps} step${brandText.steps>1?"s":""} to reach 4.5:1`});}return {t,notes}}var round2=n=>Math.round(n*100)/100;function failingOverride(t,overrides){const grounds=[t.bg,t.surface,t.surface2,t.tint];if(overrides.foreground){const ratio=minContrast(t.ink,grounds);if(ratio<AA)return {field:"foreground",ratio,against:"background"}}if(overrides.accent){const ratio=minContrast(t.accentText,grounds);if(ratio<AA)return {field:"accent",ratio,against:"background"}}if(overrides.primaryForeground){const ratio=contrastRatio(t.onPrimary,t.primary);if(ratio<AA)return {field:"primaryForeground",ratio,against:"button"}}if(overrides.background){const ratio=Math.min(contrastRatio(t.ink,t.bg),contrastRatio(t.muted,t.bg));if(ratio<AA)return {field:"background",ratio,against:"text"}}return null}function deriveStorefrontTheme(theme,brandHex,opts={}){const recipe=STOREFRONT_THEME_RECIPES[theme];const overrides={...opts.overrides};const problems=[];let palette=derivePalette(recipe,brandHex,opts.secondary,overrides);for(let problem=failingOverride(palette.t,overrides);problem;){problems.push({...problem,ratio:Math.round(problem.ratio*10)/10});delete overrides[problem.field];palette=derivePalette(recipe,brandHex,opts.secondary,overrides);problem=failingOverride(palette.t,overrides);}const{t,notes}=palette;const r=recipe.radius;const px=n=>`${n}px`;const vars={"--so-bg":t.bg,"--so-surface":t.surface,"--so-surface-2":t.surface2,"--so-tint":t.tint,"--so-border":t.border,"--so-border-strong":t.borderStrong,"--so-ink":t.ink,"--so-muted":t.muted,"--so-primary":t.primary,"--so-on-primary":t.onPrimary,"--so-primary-hover":t.primaryHover,"--so-accent-text":t.accentText,"--so-dark":t.dark,"--so-on-dark":t.onDark,"--so-on-dark-muted":t.onDarkMuted,"--so-dark-accent":t.darkAccent,"--so-focus":t.focus,"--so-ph-bg":t.phBg,"--so-ph-text":t.phText,"--so-ph-line":rgba(t.phText,.16),"--so-accent-2":t.accent2??t.accentText,"--so-scrim":`linear-gradient(180deg, ${rgba(t.dark,.55)} 0%, ${rgba(t.dark,0)} 26%, ${rgba(t.dark,0)} 40%, ${rgba(t.dark,.72)} 100%)`,"--so-scrim-solid":rgba(t.dark,.45),"--so-shadow":recipe.shadow?`0 1px 2px ${rgba(t.dark,.06)}, 0 10px 30px ${rgba(t.dark,.1)}`:"none","--so-shadow-float":`0 2px 6px ${rgba(t.dark,.08)}, 0 18px 50px ${rgba(t.dark,.18)}`,"--so-font-heading":storefrontFontStack(opts.heading??recipe.fonts.heading),"--so-font-body":storefrontFontStack(opts.body??recipe.fonts.body),"--so-r-sm":px(r.sm),"--so-r-md":px(r.md),"--so-r-lg":px(r.lg),"--so-r-btn":px(r.btn),"--so-btn-size":px(recipe.btn.size),"--so-btn-w":String(recipe.btn.w),"--so-btn-ls":recipe.btn.ls,"--so-btn-tt":recipe.btn.tt,"--so-btn-h":px(recipe.btn.h),"--so-section":px(recipe.space.section),"--so-gutter":px(recipe.space.gutter)};for(const[step,[size,lh,w,ls,tt]]of Object.entries(recipe.type)){vars[`--t-${step}-size`]=px(size);vars[`--t-${step}-lh`]=String(lh);vars[`--t-${step}-w`]=String(w);vars[`--t-${step}-ls`]=ls;vars[`--t-${step}-tt`]=tt??"none";}const grade=x=>x>=7?"AAA":x>=AA?"AA":"Fail";const checks=[["Body text",t.ink,t.bg],["Muted text",t.muted,t.surface2],["Button label",t.onPrimary,t.primary],["Brand text",t.accentText,t.bg],["On dark section",t.onDark,t.dark],["Brand on dark",t.darkAccent,t.dark]].map(([label,a,b])=>{const x=Math.round(contrastRatio(a,b)*10)/10;return {label,ratio:x.toFixed(1),grade:grade(x),pass:x>=AA}});return {theme,tokens:t,vars,checks,notes,problems}}function storefrontThemeFonts(theme,fonts){const pair=STOREFRONT_THEME_RECIPES[theme].fonts;return {heading:fonts?.heading??pair.heading,body:fonts?.body??pair.body}}function resolveStorefrontTheme(config){const theme=config.theme??DEFAULT_STOREFRONT_THEME;const fonts=storefrontThemeFonts(theme,config.fonts);const{primary,secondary,background,foreground,accent,primaryForeground}=explicitThemeChoices(config).colors;const derived=deriveStorefrontTheme(theme,primary,{secondary,...fonts,overrides:{background,foreground,accent,primaryForeground}});return {theme,layout:config.layout??DEFAULT_STOREFRONT_LAYOUT,fonts,derived,cssVariables:derived.vars}}var OVERRIDE_TOKENS={background:"bg",foreground:"ink",accent:"accentText",primaryForeground:"onPrimary"};var OVERRIDES=Object.keys(OVERRIDE_TOKENS);function legacyButtonLabel(primary,t){if(contrastRatio(t.onPrimary,primary)>=AA)return t.onPrimary;const reads=[t.onDark,t.ink,t.dark,t.bg].filter(hex=>contrastRatio(hex,primary)>=AA);return (reads.length?reads:["#FFFFFF","#000000"]).reduce((best,hex)=>contrastRatio(hex,primary)>contrastRatio(best,primary)?hex:best)}function explicitThemeChoices(config){const theme=config.theme??DEFAULT_STOREFRONT_THEME;const given=pickOverrides(config.colors);const colors={...config.colors};for(const field of OVERRIDES){const value=given[field];if(!value)continue;const others={...given};delete others[field];const{tokens}=deriveStorefrontTheme(theme,config.colors.primary,{overrides:others});const derived=field==="primaryForeground"?[tokens.onPrimary,legacyButtonLabel(config.colors.primary,tokens)]:[tokens[OVERRIDE_TOKENS[field]]];if(derived.includes(value.toUpperCase()))delete colors[field];}const pair=STOREFRONT_THEME_RECIPES[theme].fonts;const fonts={...config.fonts?.heading&&config.fonts.heading!==pair.heading?{heading:config.fonts.heading}:{},...config.fonts?.body&&config.fonts.body!==pair.body?{body:config.fonts.body}:{}};const{fonts:_fonts,...rest}=config;return {...rest,colors,...fonts.heading||fonts.body?{fonts}:{}}}function pickOverrides(colors){const{background,foreground,accent,primaryForeground}=colors;return Object.fromEntries(Object.entries({background,foreground,accent,primaryForeground}).filter(([,v])=>!!v))}function defineSuiteOpConfig(config){return storefrontSiteConfigSchema.parse(config)}
+var STOREFRONT_LOCALES=["en","fr","es","de","it","pt","nl"];var STOREFRONT_LAYOUTS=["listings","locations","areas","single"];var STOREFRONT_THEMES=["folio","hearth","circuit","tide","noir","fjord"];var REQUIRED="validation.required";var TOO_LONG="validation.max_length";var TOO_MANY="validation.too_large";var INVALID="validation.invalid";var text=max=>zod.z.string(INVALID).max(max,TOO_LONG);var localeSchema=zod.z.enum(STOREFRONT_LOCALES,"validation.storefront.locale_unsupported");var hexSchema=zod.z.string(INVALID).regex(/^#[0-9A-Fa-f]{6}$/,"validation.storefront.color_hex");var assetUrlSchema=zod.z.url({protocol:/^https$/,error:"validation.storefront.url_https"});var localizedSchema=zod.z.partialRecord(localeSchema,text(200),INVALID);var linkSchema=zod.z.object({label:localizedSchema,href:text(500).regex(/^(\/(?!\/)|https:\/\/)/,"validation.storefront.link_href")},INVALID);var fontSchema=zod.z.enum(chunkJF245QUY_cjs.STOREFRONT_FONTS,"validation.invalid_option");var storefrontSiteConfigSchema=zod.z.object({layout:zod.z.enum(STOREFRONT_LAYOUTS).optional().catch(void 0),theme:zod.z.enum(STOREFRONT_THEMES).optional().catch(void 0),brand:zod.z.object({name:text(80).min(1,REQUIRED),logoUrl:assetUrlSchema.nullable(),logoOnDarkUrl:assetUrlSchema.nullable().optional(),faviconUrl:assetUrlSchema.nullable()},INVALID),colors:zod.z.object({primary:hexSchema,secondary:hexSchema.nullable().optional(),primaryForeground:hexSchema.optional(),background:hexSchema.optional(),foreground:hexSchema.optional(),accent:hexSchema.optional()},INVALID),fonts:zod.z.object({heading:fontSchema.optional(),body:fontSchema.optional()},INVALID).optional(),nav:zod.z.array(linkSchema,INVALID).max(8,TOO_MANY),footer:zod.z.object({text:localizedSchema,links:zod.z.array(linkSchema,INVALID).max(12,TOO_MANY)},INVALID),defaultLocale:localeSchema,locales:zod.z.array(localeSchema,INVALID).min(1,REQUIRED).max(STOREFRONT_LOCALES.length,TOO_MANY),seo:zod.z.object({titleTemplate:text(80).includes("%s",{error:"validation.storefront.title_template_placeholder"}),defaultDescription:localizedSchema,ogImageUrl:assetUrlSchema.nullable()},INVALID)},INVALID).refine(c=>c.locales.includes(c.defaultLocale),{path:["defaultLocale"],message:"validation.storefront.default_locale_not_listed"});var DEFAULT_STOREFRONT_LAYOUT="listings";var DEFAULT_STOREFRONT_THEME="tide";var STOREFRONT_THEME_RECIPES={folio:{mode:"light",fonts:{heading:"eb_garamond",body:"libre_franklin"},radius:{sm:0,md:0,lg:0,btn:0},btn:{size:12,w:600,ls:"0.14em",tt:"uppercase",h:46},type:{display:[88,1,400,"-0.015em"],h1:[56,1.05,400,"-0.01em"],h2:[36,1.15,400,"0"],h3:[24,1.25,500,"0"],body:[18,1.6,400,"0"],small:[14,1.5,400,"0"],label:[11,1.3,600,"0.16em","uppercase"]},space:{section:144,gutter:32},neutral:{hue:null,mix:0,c:.006},L:{bg:.985,surface:1,surface2:.955,tint:.95,border:.87,ink:.19,muted:.47,dark:.22},C:{ink:.02,dark:.04,tint:.022},shadow:false},hearth:{mode:"light",fonts:{heading:"lora",body:"karla"},radius:{sm:6,md:12,lg:18,btn:8},btn:{size:15,w:700,ls:"0",tt:"none",h:48},type:{display:[64,1.08,500,"-0.01em"],h1:[48,1.12,500,"-0.01em"],h2:[32,1.2,500,"0"],h3:[22,1.3,600,"0"],body:[17,1.6,400,"0"],small:[14,1.5,400,"0"],label:[12,1.3,700,"0.1em","uppercase"]},space:{section:112,gutter:28},neutral:{hue:75,mix:.85,c:.014},L:{bg:.972,surface:.99,surface2:.945,tint:.935,border:.885,ink:.25,muted:.48,dark:.28},C:{ink:.025,dark:.05,tint:.032},shadow:true},circuit:{mode:"light",fonts:{heading:"space_grotesk",body:"ibm_plex_sans"},radius:{sm:8,md:12,lg:16,btn:999},btn:{size:15,w:600,ls:"-0.005em",tt:"none",h:44},type:{display:[64,1.02,600,"-0.035em"],h1:[44,1.08,600,"-0.03em"],h2:[30,1.15,600,"-0.02em"],h3:[20,1.3,600,"-0.01em"],body:[16,1.55,400,"0"],small:[14,1.45,400,"0"],label:[12,1.3,600,"0.02em"]},space:{section:88,gutter:20},neutral:{hue:null,mix:0,c:.004},L:{bg:1,surface:.975,surface2:.958,tint:.958,border:.915,ink:.17,muted:.48,dark:.19},C:{ink:.012,dark:.03,tint:.035},shadow:true},tide:{mode:"light",fonts:{heading:"outfit",body:"mulish"},radius:{sm:12,md:20,lg:28,btn:999},btn:{size:15,w:700,ls:"0.01em",tt:"none",h:50},type:{display:[76,1.02,300,"-0.02em"],h1:[48,1.1,400,"-0.015em"],h2:[34,1.15,400,"-0.01em"],h3:[21,1.3,500,"0"],body:[17,1.6,400,"0"],small:[14,1.5,400,"0"],label:[12,1.3,700,"0.08em","uppercase"]},space:{section:120,gutter:24},neutral:{hue:null,mix:0,c:.005},L:{bg:.99,surface:.968,surface2:.945,tint:.95,border:.905,ink:.26,muted:.48,dark:.29},C:{ink:.035,dark:.055,tint:.028},shadow:true},noir:{mode:"dark",fonts:{heading:"cormorant_garamond",body:"manrope"},radius:{sm:0,md:2,lg:2,btn:0},btn:{size:11,w:600,ls:"0.22em",tt:"uppercase",h:48},type:{display:[84,1,300,"0.02em","uppercase"],h1:[56,1.05,300,"0.01em"],h2:[38,1.15,400,"0"],h3:[24,1.25,500,"0.02em"],body:[16,1.7,400,"0"],small:[13,1.55,400,"0.01em"],label:[11,1.3,600,"0.24em","uppercase"]},space:{section:152,gutter:32},neutral:{hue:null,mix:0,c:.016},L:{bg:.165,surface:.205,surface2:.245,tint:.24,border:.34,ink:.94,muted:.76,dark:.12},C:{ink:.01,dark:.014,tint:.035},shadow:false},fjord:{mode:"light",fonts:{heading:"dm_sans",body:"dm_sans"},radius:{sm:2,md:4,lg:6,btn:4},btn:{size:14,w:500,ls:"0",tt:"none",h:44},type:{display:[60,1.05,500,"-0.03em"],h1:[42,1.1,500,"-0.025em"],h2:[28,1.2,500,"-0.015em"],h3:[19,1.35,500,"-0.005em"],body:[16,1.6,400,"0"],small:[13,1.5,400,"0"],label:[12,1.3,500,"0"]},space:{section:128,gutter:24},neutral:{hue:85,mix:.85,c:.006},L:{bg:.976,surface:.995,surface2:.948,tint:.945,border:.895,ink:.23,muted:.49,dark:.26},C:{ink:.008,dark:.02,tint:.022},shadow:false}};var clamp=(v,a,b)=>Math.min(b,Math.max(a,v));var toLin=c=>c<=.04045?c/12.92:Math.pow((c+.055)/1.055,2.4);var toGam=c=>c<=.0031308?12.92*c:1.055*Math.pow(c,1/2.4)-.055;var hexToRgb=hex=>{const h=hex.replace("#","");return [0,2,4].map(i=>parseInt(h.slice(i,i+2),16)/255)};var rgbToHex=rgb=>"#"+rgb.map(v=>Math.round(clamp(v,0,1)*255).toString(16).padStart(2,"0")).join("").toUpperCase();function hexToOklch(hex){const[r,g,b]=hexToRgb(hex).map(toLin);const l=Math.cbrt(.4122214708*r+.5363325363*g+.0514459929*b);const m=Math.cbrt(.2119034982*r+.6806995451*g+.1073969566*b);const s=Math.cbrt(.0883024619*r+.2817188376*g+.6299787005*b);const L=.2104542553*l+.793617785*m-.0040720468*s;const A=1.9779984951*l-2.428592205*m+.4505937099*s;const B=.0259040371*l+.7827717662*m-.808675766*s;let H=Math.atan2(B,A)*180/Math.PI;if(H<0)H+=360;return [L,Math.sqrt(A*A+B*B),H]}function oklchToLinear(L,C,H){const a=C*Math.cos(H*Math.PI/180);const b=C*Math.sin(H*Math.PI/180);const l=(L+.3963377774*a+.2158037573*b)**3;const m=(L-.1055613458*a-.0638541728*b)**3;const s=(L-.0894841775*a-1.291485548*b)**3;return [4.0767416621*l-3.3077115913*m+.2309699292*s,-1.2684380046*l+2.6097574011*m-.3413193965*s,-0.0041960863*l-.7034186147*m+1.707614701*s]}var inGamut=rgb=>rgb.every(v=>v>=-1e-4&&v<=1.0001);function oklchToHex(lightness,C,H){const L=clamp(lightness,0,1);let rgb=oklchToLinear(L,C,H);if(!inGamut(rgb)){let lo=0;let hi=C;for(let i=0;i<22;i++){const mid=(lo+hi)/2;if(inGamut(oklchToLinear(L,mid,H)))lo=mid;else hi=mid;}rgb=oklchToLinear(L,lo,H);}return rgbToHex(rgb.map(v=>toGam(clamp(v,0,1))))}var luminance=hex=>{const[r,g,b]=hexToRgb(hex).map(toLin);return .2126*r+.7152*g+.0722*b};function contrastRatio(a,b){const x=luminance(a);const y=luminance(b);return (Math.max(x,y)+.05)/(Math.min(x,y)+.05)}var minContrast=(hex,grounds)=>Math.min(...grounds.map(g=>contrastRatio(hex,g)));var rgba=(hex,alpha)=>{const[r,g,b]=hexToRgb(hex).map(v=>Math.round(v*255));return `rgba(${r},${g},${b},${alpha})`};var mixHue=(a,b,t)=>{const d=(b-a+540)%360-180;return (a+d*t+360)%360};function fit(lightness,C,H,grounds,target,dir){let L=lightness;let hex=oklchToHex(L,C,H);let steps=0;while(minContrast(hex,grounds)<target&&steps<100){L=clamp(L+dir*.01,0,1);hex=oklchToHex(L,C,H);steps++;}return {hex,L,steps}}var SERIF_FONTS=new Set(["playfair_display","merriweather","bitter","fraunces","cormorant_garamond","eb_garamond","lora","crimson_pro","source_serif_4","ibm_plex_serif"]);function storefrontFontStack(font){return `'${chunkJF245QUY_cjs.STOREFRONT_FONT_FAMILIES[font]}', ${SERIF_FONTS.has(font)?"serif":"sans-serif"}`}var AA=4.5;var INK=7;function derivePalette(recipe,brandHex,secondary,overrides){const[bL,bC,bH]=hexToOklch(brandHex);const nh=recipe.neutral.hue==null?bH:mixHue(bH,recipe.neutral.hue,recipe.neutral.mix);const nc=recipe.neutral.c;const{L,C}=recipe;const dark=recipe.mode==="dark";const dir=dark?1:-1;const N=(l,c=nc)=>oklchToHex(l,c,nh);const bg=overrides.background?.toUpperCase()??N(L.bg);const surface=N(L.surface,L.surface>=.999?0:nc);const surface2=N(L.surface2);const tint=oklchToHex(L.tint,Math.min(bC,C.tint),bH);const border=N(L.border,nc*1.5);const borderStrong=N(dark?L.border+.12:L.border-.2,nc*1.5);const grounds=[bg,surface,surface2,tint];const ink=overrides.foreground?.toUpperCase()??fit(L.ink,C.ink,nh,grounds,INK,dir).hex;const muted=fit(L.muted,nc*2.5,nh,grounds,AA,dir).hex;const brandText=fit(bL,bC,bH,grounds,AA,dir);const accentText=overrides.accent?.toUpperCase()??brandText.hex;const notes=[];let p;let on;if(!dark){const white=oklchToHex(.995,.003,bH);if(contrastRatio(brandHex,white)>=AA){p={hex:brandHex.toUpperCase(),L:bL};on=white;}else if(bL>=.7&&contrastRatio(brandHex,ink)>=AA){p={hex:brandHex.toUpperCase(),L:bL};on=ink;notes.push({code:"light_brand_ink_label",text:"Light brand: button keeps the colour and takes an ink label"});}else {p=fit(bL,bC,bH,[white],AA,-1);on=white;notes.push({code:"button_darkened",from:round2(bL),to:round2(p.L),text:`Button darkened L ${bL.toFixed(2)} \u2192 ${p.L.toFixed(2)} for a white label`});}}else {on=bg;p=fit(Math.max(bL,.72),bC,bH,[bg,surface],AA,1);if(p.L>bL+.005){notes.push({code:"brand_lifted",from:round2(bL),to:round2(p.L),text:`Brand lifted L ${bL.toFixed(2)} \u2192 ${p.L.toFixed(2)} to read on dark`});}}const onPrimary=overrides.primaryForeground?.toUpperCase()??on;let primaryHover=oklchToHex(p.L+(dark?.05:-0.06),bC,bH);if(contrastRatio(primaryHover,onPrimary)<AA){primaryHover=oklchToHex(p.L+(dark?-0.04:.04),bC,bH);}const darkToken=oklchToHex(L.dark,Math.min(bC,C.dark),bH);const phBg=dark?oklchToHex(.27,Math.min(bC,.03),bH):oklchToHex(L.tint-.045,Math.min(bC,.03),bH);const t={bg,surface,surface2,tint,border,borderStrong,ink,muted,primary:p.hex,onPrimary,primaryHover,accentText,dark:darkToken,onDark:oklchToHex(.97,.008,bH),onDarkMuted:fit(.82,.012,bH,[darkToken],AA,1).hex,darkAccent:fit(Math.max(bL,.72),bC,bH,[darkToken],AA,1).hex,focus:dark?p.hex:accentText,phBg,phText:fit(dark?.7:.48,.02,bH,[phBg],AA,dir).hex};if(secondary)t.accent2=fit(...hexToOklch(secondary),grounds,AA,dir).hex;if(!dark&&brandText.steps>0&&accentText===brandText.hex){notes.push({code:"brand_text_darkened",steps:brandText.steps,text:`Brand text darkened ${brandText.steps} step${brandText.steps>1?"s":""} to reach 4.5:1`});}return {t,notes}}var round2=n=>Math.round(n*100)/100;function failingOverride(t,overrides){const grounds=[t.bg,t.surface,t.surface2,t.tint];if(overrides.foreground){const ratio=minContrast(t.ink,grounds);if(ratio<AA)return {field:"foreground",ratio,against:"background"}}if(overrides.accent){const ratio=minContrast(t.accentText,grounds);if(ratio<AA)return {field:"accent",ratio,against:"background"}}if(overrides.primaryForeground){const ratio=contrastRatio(t.onPrimary,t.primary);if(ratio<AA)return {field:"primaryForeground",ratio,against:"button"}}if(overrides.background){const ratio=Math.min(contrastRatio(t.ink,t.bg),contrastRatio(t.muted,t.bg));if(ratio<AA)return {field:"background",ratio,against:"text"}}return null}function deriveStorefrontTheme(theme,brandHex,opts={}){const recipe=STOREFRONT_THEME_RECIPES[theme];const overrides={...opts.overrides};const problems=[];let palette=derivePalette(recipe,brandHex,opts.secondary,overrides);for(let problem=failingOverride(palette.t,overrides);problem;){problems.push({...problem,ratio:Math.round(problem.ratio*10)/10});delete overrides[problem.field];palette=derivePalette(recipe,brandHex,opts.secondary,overrides);problem=failingOverride(palette.t,overrides);}const{t,notes}=palette;const r=recipe.radius;const px=n=>`${n}px`;const vars={"--so-bg":t.bg,"--so-surface":t.surface,"--so-surface-2":t.surface2,"--so-tint":t.tint,"--so-border":t.border,"--so-border-strong":t.borderStrong,"--so-ink":t.ink,"--so-muted":t.muted,"--so-primary":t.primary,"--so-on-primary":t.onPrimary,"--so-primary-hover":t.primaryHover,"--so-accent-text":t.accentText,"--so-dark":t.dark,"--so-on-dark":t.onDark,"--so-on-dark-muted":t.onDarkMuted,"--so-dark-accent":t.darkAccent,"--so-focus":t.focus,"--so-ph-bg":t.phBg,"--so-ph-text":t.phText,"--so-ph-line":rgba(t.phText,.16),"--so-accent-2":t.accent2??t.accentText,"--so-scrim":`linear-gradient(180deg, ${rgba(t.dark,.55)} 0%, ${rgba(t.dark,0)} 26%, ${rgba(t.dark,0)} 40%, ${rgba(t.dark,.72)} 100%)`,"--so-scrim-solid":rgba(t.dark,.45),"--so-shadow":recipe.shadow?`0 1px 2px ${rgba(t.dark,.06)}, 0 10px 30px ${rgba(t.dark,.1)}`:"none","--so-shadow-float":`0 2px 6px ${rgba(t.dark,.08)}, 0 18px 50px ${rgba(t.dark,.18)}`,"--so-font-heading":storefrontFontStack(opts.heading??recipe.fonts.heading),"--so-font-body":storefrontFontStack(opts.body??recipe.fonts.body),"--so-r-sm":px(r.sm),"--so-r-md":px(r.md),"--so-r-lg":px(r.lg),"--so-r-btn":px(r.btn),"--so-btn-size":px(recipe.btn.size),"--so-btn-w":String(recipe.btn.w),"--so-btn-ls":recipe.btn.ls,"--so-btn-tt":recipe.btn.tt,"--so-btn-h":px(recipe.btn.h),"--so-section":px(recipe.space.section),"--so-gutter":px(recipe.space.gutter)};for(const[step,[size,lh,w,ls,tt]]of Object.entries(recipe.type)){vars[`--t-${step}-size`]=px(size);vars[`--t-${step}-lh`]=String(lh);vars[`--t-${step}-w`]=String(w);vars[`--t-${step}-ls`]=ls;vars[`--t-${step}-tt`]=tt??"none";}const grade=x=>x>=7?"AAA":x>=AA?"AA":"Fail";const checks=[["Body text",t.ink,t.bg],["Muted text",t.muted,t.surface2],["Button label",t.onPrimary,t.primary],["Brand text",t.accentText,t.bg],["On dark section",t.onDark,t.dark],["Brand on dark",t.darkAccent,t.dark]].map(([label,a,b])=>{const x=Math.round(contrastRatio(a,b)*10)/10;return {label,ratio:x.toFixed(1),grade:grade(x),pass:x>=AA}});return {theme,tokens:t,vars,checks,notes,problems}}function storefrontThemeFonts(theme,fonts){const pair=STOREFRONT_THEME_RECIPES[theme].fonts;return {heading:fonts?.heading??pair.heading,body:fonts?.body??pair.body}}function resolveStorefrontTheme(config){const theme=config.theme??DEFAULT_STOREFRONT_THEME;const fonts=storefrontThemeFonts(theme,config.fonts);const{primary,secondary,background,foreground,accent,primaryForeground}=explicitThemeChoices(config).colors;const derived=deriveStorefrontTheme(theme,primary,{secondary,...fonts,overrides:{background,foreground,accent,primaryForeground}});return {theme,layout:config.layout??DEFAULT_STOREFRONT_LAYOUT,fonts,derived,cssVariables:derived.vars}}var OVERRIDE_TOKENS={background:"bg",foreground:"ink",accent:"accentText",primaryForeground:"onPrimary"};var OVERRIDES=Object.keys(OVERRIDE_TOKENS);function legacyButtonLabel(primary,t){if(contrastRatio(t.onPrimary,primary)>=AA)return t.onPrimary;const reads=[t.onDark,t.ink,t.dark,t.bg].filter(hex=>contrastRatio(hex,primary)>=AA);return (reads.length?reads:["#FFFFFF","#000000"]).reduce((best,hex)=>contrastRatio(hex,primary)>contrastRatio(best,primary)?hex:best)}function explicitThemeChoices(config){const theme=config.theme??DEFAULT_STOREFRONT_THEME;const given=pickOverrides(config.colors);const colors={...config.colors};for(const field of OVERRIDES){const value=given[field];if(!value)continue;const others={...given};delete others[field];const{tokens}=deriveStorefrontTheme(theme,config.colors.primary,{overrides:others});const derived=field==="primaryForeground"?[tokens.onPrimary,legacyButtonLabel(config.colors.primary,tokens)]:[tokens[OVERRIDE_TOKENS[field]]];if(derived.includes(value.toUpperCase()))delete colors[field];}const pair=STOREFRONT_THEME_RECIPES[theme].fonts;const fonts={...config.fonts?.heading&&config.fonts.heading!==pair.heading?{heading:config.fonts.heading}:{},...config.fonts?.body&&config.fonts.body!==pair.body?{body:config.fonts.body}:{}};const{fonts:_fonts,...rest}=config;return {...rest,colors,...fonts.heading||fonts.body?{fonts}:{}}}function pickOverrides(colors){const{background,foreground,accent,primaryForeground}=colors;return Object.fromEntries(Object.entries({background,foreground,accent,primaryForeground}).filter(([,v])=>!!v))}function defineSuiteOpConfig(config){return storefrontSiteConfigSchema.parse(config)}
 
 Object.defineProperty(exports, "STOREFRONT_FONT_FAMILIES", {
 	enumerable: true,
-	get: function () { return chunkZLAOY6IF_cjs.STOREFRONT_FONT_FAMILIES; }
+	get: function () { return chunkJF245QUY_cjs.STOREFRONT_FONT_FAMILIES; }
 });
 exports.DEFAULT_STOREFRONT_LAYOUT = DEFAULT_STOREFRONT_LAYOUT;
 exports.DEFAULT_STOREFRONT_THEME = DEFAULT_STOREFRONT_THEME;