@v-office/website-headless 1.1.1 → 1.3.0

package/README.md

@@ -39,6 +39,7 @@ favourites namespace, the backend) have no default at all.
 - [Checkout flow](#checkout-flow)
 - [Contact form](#contact-form)
 - [Countries](#countries)
+- [Regions](#regions)
 - [Legal documents](#legal-documents)
 - [Favourites](#favourites)
 - [Shared helpers](#shared-helpers)
@@ -223,8 +224,8 @@ Everything in `.` runs in both places, but some calls belong to one of them:
 
 - **Build time** (they spend rate-limited requests or need full ICU): `loadRentalCatalogue`,
   `fetchRentalFlags`, `resolveSearchGroups`, `measureFilters`, `findOfferWindows`,
-  `findCampaignStart`, `fetchLegalDocuments`, `countryOptions`, `rentalIndexEntries`, `cardSource`,
-  `rentalFactsMap`, `buildShowcaseGroups`, `resolveFilters`. Their results are plain JSON and are
+  `findCampaignStart`, `fetchLegalDocuments`, `countryOptions`, `regionOptions`, `regionsByRental`,
+  `rentalIndexEntries`, `cardSource`, `rentalFactsMap`, `buildShowcaseGroups`, `resolveFilters`. Their results are plain JSON and are
   passed to islands as props.
 - **Browser**: the stores (`createSearchForm`, `createSearchStore`, `createQuoteFlow`,
   `createCheckoutFlow`, `createContactForm`, `createFavorites`), `loadRentalIndex`,
@@ -1521,10 +1522,13 @@ flow.start();
 
 - `readCheckoutHandover(search, options?)` (`CheckoutHandoverOptions`: `defaultAdults`,
   `allowOption`) → `CheckoutHandover`: `stay` (`Stay` or null: the missing-stay card), `policyId` (a
-  seed, applied only while still offered), `kind` (`"option"` only with `allowOption`),
-  `paymentReturn` (`?return=1`). Reads `pets` and the legacy `petsCount`.
-- `checkoutSearch({ stay, policyId, kind }, current?)` → the query string for `replaceState` after
-  an edit; every other parameter of `current` is kept.
+  seed, applied only while still offered), `kind` (`"option"` only with `allowOption`), `services`
+  (`?service=<id>:<count>`, repeatable, `<id>` alone is one: extras to add; a seed like `policyId`,
+  added only as far as the quote offers them), `paymentReturn` (`?return=1`). Reads `pets` and the
+  legacy `petsCount`.
+- `checkoutSearch({ stay, policyId, kind, counts? }, current?)` → the query string for `replaceState`
+  after an edit; with `counts` the chosen extras replace the URL's `service` keys, without them those
+  stay; every other parameter of `current` is kept.
 - `BookingKind`: `"booking" | "option"` (a non-binding option, SDK `kind: "OPTION"`).
 - `Stay`: `{ start, end, party }`, serializable.
 
@@ -1790,6 +1794,22 @@ build time; the result is plain data passed to islands.
   non-English tags first, then English tags with an explicit region; bare `"en"` is never maximized.
 - `CountryCode`: ISO 3166-1 alpha-2; the register is never filtered.
 
+## Regions
+
+Module `regions`. The region tree (`sdk.static.regions.getRegions` of `@v-office/website-sdk`, v10 and v9,
+one read per build) as the search's region data. A region's value is its id; it holds its subregions' rentals, so
+`?region=<id>` finds them too. Build time; the results are plain data passed to islands.
+
+- `regionOptions(tree, { locale, rentalIds })` → `RegionChoice[]` (`value` = id, `label` = name,
+  `count` = the site's rentals with the subregions', `group` = a subregion's top-level region name):
+  every region with one of the site's rentals (`rentalIds`, the ids of the rentals the site reads,
+  since the tree ignores `rentalScope`), in the tree's order. Pass them as they are as the `regions` prop of `SearchBar` from
+  `@v-office/website-components`, and as the `options` of a curated hidden `region` facet, which words
+  a `?region=` chip with the name instead of the id.
+  `createSearchForm` takes the `value`s.
+- `regionsByRental(tree)` → rental id → the ids of every region holding it, ancestors included: the
+  `regions` of `cardSource` extras, so `rentalFactsMap` carries them to the browser filter.
+
 ## Legal documents
 
 Module `legal`. Build time only.

package/dist/enhance/index.d.mts

@@ -1,4 +1,4 @@
-import { An as LngLat, Mn as MapPoint, _a as EnhancePart, a as PlaceMarker, ba as GateMarkers, ga as ENHANCE_PARTS, jn as MapBounds, s as ClusterOptions, va as EnhanceParts, wn as SameSpotLayout, ya as GATE_MARKERS } from "../index-CPMXjfFH.mjs";
+import { An as LngLat, Mn as MapPoint, _a as EnhancePart, a as PlaceMarker, ba as GateMarkers, ga as ENHANCE_PARTS, jn as MapBounds, s as ClusterOptions, va as EnhanceParts, wn as SameSpotLayout, ya as GATE_MARKERS } from "../index-Dlf8Hlzc.mjs";
 //#region src/enhance/lifecycle.d.ts
 /** Removes everything a binder added. Safe to call more than once. */
 type Dispose = () => void;

package/dist/{index-CPMXjfFH.d.mts → index-Dlf8Hlzc.d.mts}

@@ -1646,6 +1646,8 @@ interface SearchParamKeys {
   readonly policy: "policy";
   /** A booking kind handed to the checkout. */
   readonly kind: "kind";
+  /** An extra handed to the checkout, `id:count`, repeatable (the website chat puts a stay together). */
+  readonly service: "service";
   /** The payment-return marker on the checkout page. */
   readonly return: "return";
   /** An offer label carried from a result to the rental page, repeatable. */

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as describeOutcome, $i as RentalFlag, $n as fetchRentalFlags, $r as CardSource, $t as GuestBound, A as QueryShape, Ai as SdkMode, An as LngLat, Ar as SdkConfigForInput, At as quickFilterDefs, B as toSdkQuery, Bi as RentalDistance, Bn as resultCardSource, Br as RouteParams, Bt as SEARCH_PARAMS, C as SearchState, Ci as isIsoDay, Cn as SameSpotGroup, Cr as EnvRecord, Ct as ResolvedFilters, D as createSearchStore, Di as Locale, Dn as circleOffsets, Dr as HUB_ENDPOINTS, Dt as facetOptions, E as SearchStoreOptions, Ei as Backend, En as SameSpotOptions, Er as sdkConfigFromEnv, Et as activeFilters, F as externalSearchHref, Fi as WebsiteSdk, Fn as mapPoints, Fr as CardSourceExtras, Ft as writeSelection, G as sortFromSearch, Gi as parseCounts, Gn as PreviewStrategy, Gr as CardBadge, Gt as SearchQuery, H as SORT_URL_VALUE, Hi as distanceFact, Hn as shortReviewerName, Hr as routeHref, Ht as SearchParamAliases, I as handoverQuery, Ii as resolveSdk, In as ResultLinkOptions, Ir as cardSource, It as partyPairs, J as EmptyCause, Ji as BedRun, Jn as DEFAULT_FLAG_FILTERS, Jr as CardImage, Jt as searchHref, K as sortResults, Ki as parseDistances, Kn as descriptionPreview, Kr as CardContext, Kt as WriteSearchOptions, L as queryShape, Li as ADJACENT_BELOW_M, Ln as SearchResultItem, Lr as loadRentalFacts, Lt as readParty, M as SanitizedSearch, Mi as SdkSetup, Mn as MapPoint, Mr as VofficeEndpointTable, Mt as resolveFilters, N as SdkQueryOptions, Ni as SdkSource, Nn as PinLabelOptions, Nr as VofficeEndpoints, Nt as withoutFilter, O as ExternalSearchLink, Oi as STAGES, On as distanceMeters, Or as HubEndpointTable, Ot as measureFilters, P as SdkSearchQuery, Pi as Stage, Pn as hasMapPoints, Pr as sdkConfigFor, Pt as withoutFilters, Q as SearchedParts, Qi as RentalDetail, Qn as assignSlugs, Qr as CardRating, Qt as DEFAULT_GUEST_LIMITS, R as resultsQueryFlagScript, Ri as DistanceKind, Rn as catalogueResultItem, Rr as rentalFactsMap, Rt as FlexibleStay, S as SearchScopeKind, Si as formatIsoDate, Sn as PixelOffset, Sr as createSdk, St as ResolveFiltersOptions, T as SearchStore, Ti as todayIso, Tn as SameSpotMode, Tr as SdkEnvError, Tt as WhenEmpty, U as SortKey, Ui as isAdjacent, Un as splitReviewAuthor, Ur as AlternativePeriod, Ut as SearchParamKeys, V as DEFAULT_SORT_OPTIONS, Vi as WATER_KINDS, Vn as newestReviewsFirst, Vr as RouteTemplate, Vt as SearchContract, W as SortOptionState, Wi as isSpecEcho, Wn as DescriptionPreview, Wr as BadgeRule, Wt as SearchPeriod, X as Relaxation, Xi as DescriptionContent, Xn as LoadRentalCatalogueOptions, Xr as CardModelOptions, Xt as ChildAgeRange, Y as OutcomeInput, Yi as CatalogueRental, Yn as FetchRentalFlagsOptions, Yr as CardLiveField, Yt as writeSearch, Z as SearchOutcome, Zi as RentalAddress, Zn as RentalFlagsResult, Zr as CardPill, Zt as DEFAULT_CHILD_AGE, _ as FAVORITE_LEAVE_MS, _a as EnhancePart, _i as Glyph, _n as DEFAULT_FIT, _r as fetchSearchPage, _t as FilterGroupSpec, a as PlaceMarker, aa as ReviewCriterion, ai as RentalFactsMap, an as Party, ar as AmenityPreviewItem, at as OffersWindowSpec, b as SearchActions, ba as GateMarkers, bi as IsoMonth, bn as frameFor, br as SharedSdk, bt as FilterSpec, c as DEFAULT_CLUSTER, ca as PlainTextOptions, ci as toCardModel, cn as clampParty, cr as AdaptEvent, ct as findCampaignStart, d as ResultsMapController, da as StructuredDocumentOptions, di as Range, dn as stayKeyOf, dr as adaptRental, dt as offersWindowQuery, ea as RentalImage, ei as CardStatus, en as GuestBounds, er as loadRentalCatalogue, et as CampaignChip, f as ResultsMapOptions, fa as TextMarkup, fi as matches, fn as Listener, fr as RawSearchPage, ft as ActiveFilter, g as CampaignOf, ga as ENHANCE_PARTS, gi as GLYPHS, gn as createStore, gr as WalkSummary, gt as FilterEntry, h as createResultsMapController, ha as plainText, hi as parsePriceLabel, hn as WritableStore, hr as WalkOptions, ht as FilterDef, i as MapPlace, ia as RentalRoom, ii as RentalFacts, in as GuestOptions, ir as ALWAYS_EXCLUDED_CATEGORIES, it as OfferWindow, j as ResultHandoverOptions, ji as SdkOptions, jn as MapBounds, jr as VOFFICE_ENDPOINTS, jt as readSelection, k as ExternalSearchSource, ki as SdkConfig, kn as layoutSameSpot, kr as HubEndpoints, kt as minimumSteps, l as MapResultsSource, la as RichBlock, li as CardMatch, ln as guestBounds, lr as AdaptRentalOptions, lt as findOfferWindows, m as ResultsMapSurface, ma as parseTextBlocks, mi as formatPriceLabel, mn as Unsubscribe, mr as SearchPageRequest, mt as FacetOptionsOptions, n as RentalAddressModeError, na as RentalReview, ni as PillOptions, nn as GuestKind, nr as slugify, nt as FindCampaignStartOptions, o as mergePlaces, oa as ReviewSummary, oi as StayPrice, on as QuoteOccupancy, or as AmenityPreviewOptions, ot as campaignChips, p as ResultsMapState, pa as normalizeStructuredDocument, pi as PriceCents, pn as Store, pr as SEARCH_PAGE_SIZE, pt as FacetOption, q as toSdkSort, qi as AmenityGroup, qn as descriptionSummary, qr as CardFact, qt as readSearch, r as rentalAddressLine, ra as RentalReviews, ri as RentalCardModel, rn as GuestLimits, rr as HIDDEN_ROOM_ATTRIBUTES, rt as FindOfferWindowsOptions, s as ClusterOptions, sa as RoomKind, si as StayWindow, sn as agesComplete, sr as amenityPreview, st as campaignGroup, t as RentalAddressMode, ta as RentalPropertyInfo, ti as FactKind, tn as GuestCaps, tr as rankHighlights, tt as CampaignChipsInput, u as MapViewReport, ua as RichInline, ui as CardSignal, un as occupancyOf, ur as RentalContentError, ut as offerWindowHref, v as FavoritesPort, va as EnhanceParts, vi as GlyphList, vn as DefaultFit, vr as walkSearchPages, vt as FilterMeasurement, w as SearchStatus, wi as nightsBetween, wn as SameSpotLayout, wr as SDK_ENV, wt as SdkFilterDefinition, x as SearchScope, xi as addDays, xn as idsInView, xr as shareSdk, xt as ImplicitScope, y as HistoryPort, ya as GATE_MARKERS, yi as IsoDay, yn as FitOptions, yr as loadSharedSdk, yt as FilterSelection, z as sanitizeSearch, zi as RentalCounts, zn as compareUndatedSearchOrder, zr as withRentalFacts, zt as QueryPair } from "./index-CPMXjfFH.mjs";
+import { $ as describeOutcome, $i as RentalFlag, $n as fetchRentalFlags, $r as CardSource, $t as GuestBound, A as QueryShape, Ai as SdkMode, An as LngLat, Ar as SdkConfigForInput, At as quickFilterDefs, B as toSdkQuery, Bi as RentalDistance, Bn as resultCardSource, Br as RouteParams, Bt as SEARCH_PARAMS, C as SearchState, Ci as isIsoDay, Cn as SameSpotGroup, Cr as EnvRecord, Ct as ResolvedFilters, D as createSearchStore, Di as Locale, Dn as circleOffsets, Dr as HUB_ENDPOINTS, Dt as facetOptions, E as SearchStoreOptions, Ei as Backend, En as SameSpotOptions, Er as sdkConfigFromEnv, Et as activeFilters, F as externalSearchHref, Fi as WebsiteSdk, Fn as mapPoints, Fr as CardSourceExtras, Ft as writeSelection, G as sortFromSearch, Gi as parseCounts, Gn as PreviewStrategy, Gr as CardBadge, Gt as SearchQuery, H as SORT_URL_VALUE, Hi as distanceFact, Hn as shortReviewerName, Hr as routeHref, Ht as SearchParamAliases, I as handoverQuery, Ii as resolveSdk, In as ResultLinkOptions, Ir as cardSource, It as partyPairs, J as EmptyCause, Ji as BedRun, Jn as DEFAULT_FLAG_FILTERS, Jr as CardImage, Jt as searchHref, K as sortResults, Ki as parseDistances, Kn as descriptionPreview, Kr as CardContext, Kt as WriteSearchOptions, L as queryShape, Li as ADJACENT_BELOW_M, Ln as SearchResultItem, Lr as loadRentalFacts, Lt as readParty, M as SanitizedSearch, Mi as SdkSetup, Mn as MapPoint, Mr as VofficeEndpointTable, Mt as resolveFilters, N as SdkQueryOptions, Ni as SdkSource, Nn as PinLabelOptions, Nr as VofficeEndpoints, Nt as withoutFilter, O as ExternalSearchLink, Oi as STAGES, On as distanceMeters, Or as HubEndpointTable, Ot as measureFilters, P as SdkSearchQuery, Pi as Stage, Pn as hasMapPoints, Pr as sdkConfigFor, Pt as withoutFilters, Q as SearchedParts, Qi as RentalDetail, Qn as assignSlugs, Qr as CardRating, Qt as DEFAULT_GUEST_LIMITS, R as resultsQueryFlagScript, Ri as DistanceKind, Rn as catalogueResultItem, Rr as rentalFactsMap, Rt as FlexibleStay, S as SearchScopeKind, Si as formatIsoDate, Sn as PixelOffset, Sr as createSdk, St as ResolveFiltersOptions, T as SearchStore, Ti as todayIso, Tn as SameSpotMode, Tr as SdkEnvError, Tt as WhenEmpty, U as SortKey, Ui as isAdjacent, Un as splitReviewAuthor, Ur as AlternativePeriod, Ut as SearchParamKeys, V as DEFAULT_SORT_OPTIONS, Vi as WATER_KINDS, Vn as newestReviewsFirst, Vr as RouteTemplate, Vt as SearchContract, W as SortOptionState, Wi as isSpecEcho, Wn as DescriptionPreview, Wr as BadgeRule, Wt as SearchPeriod, X as Relaxation, Xi as DescriptionContent, Xn as LoadRentalCatalogueOptions, Xr as CardModelOptions, Xt as ChildAgeRange, Y as OutcomeInput, Yi as CatalogueRental, Yn as FetchRentalFlagsOptions, Yr as CardLiveField, Yt as writeSearch, Z as SearchOutcome, Zi as RentalAddress, Zn as RentalFlagsResult, Zr as CardPill, Zt as DEFAULT_CHILD_AGE, _ as FAVORITE_LEAVE_MS, _a as EnhancePart, _i as Glyph, _n as DEFAULT_FIT, _r as fetchSearchPage, _t as FilterGroupSpec, a as PlaceMarker, aa as ReviewCriterion, ai as RentalFactsMap, an as Party, ar as AmenityPreviewItem, at as OffersWindowSpec, b as SearchActions, ba as GateMarkers, bi as IsoMonth, bn as frameFor, br as SharedSdk, bt as FilterSpec, c as DEFAULT_CLUSTER, ca as PlainTextOptions, ci as toCardModel, cn as clampParty, cr as AdaptEvent, ct as findCampaignStart, d as ResultsMapController, da as StructuredDocumentOptions, di as Range, dn as stayKeyOf, dr as adaptRental, dt as offersWindowQuery, ea as RentalImage, ei as CardStatus, en as GuestBounds, er as loadRentalCatalogue, et as CampaignChip, f as ResultsMapOptions, fa as TextMarkup, fi as matches, fn as Listener, fr as RawSearchPage, ft as ActiveFilter, g as CampaignOf, ga as ENHANCE_PARTS, gi as GLYPHS, gn as createStore, gr as WalkSummary, gt as FilterEntry, h as createResultsMapController, ha as plainText, hi as parsePriceLabel, hn as WritableStore, hr as WalkOptions, ht as FilterDef, i as MapPlace, ia as RentalRoom, ii as RentalFacts, in as GuestOptions, ir as ALWAYS_EXCLUDED_CATEGORIES, it as OfferWindow, j as ResultHandoverOptions, ji as SdkOptions, jn as MapBounds, jr as VOFFICE_ENDPOINTS, jt as readSelection, k as ExternalSearchSource, ki as SdkConfig, kn as layoutSameSpot, kr as HubEndpoints, kt as minimumSteps, l as MapResultsSource, la as RichBlock, li as CardMatch, ln as guestBounds, lr as AdaptRentalOptions, lt as findOfferWindows, m as ResultsMapSurface, ma as parseTextBlocks, mi as formatPriceLabel, mn as Unsubscribe, mr as SearchPageRequest, mt as FacetOptionsOptions, n as RentalAddressModeError, na as RentalReview, ni as PillOptions, nn as GuestKind, nr as slugify, nt as FindCampaignStartOptions, o as mergePlaces, oa as ReviewSummary, oi as StayPrice, on as QuoteOccupancy, or as AmenityPreviewOptions, ot as campaignChips, p as ResultsMapState, pa as normalizeStructuredDocument, pi as PriceCents, pn as Store, pr as SEARCH_PAGE_SIZE, pt as FacetOption, q as toSdkSort, qi as AmenityGroup, qn as descriptionSummary, qr as CardFact, qt as readSearch, r as rentalAddressLine, ra as RentalReviews, ri as RentalCardModel, rn as GuestLimits, rr as HIDDEN_ROOM_ATTRIBUTES, rt as FindOfferWindowsOptions, s as ClusterOptions, sa as RoomKind, si as StayWindow, sn as agesComplete, sr as amenityPreview, st as campaignGroup, t as RentalAddressMode, ta as RentalPropertyInfo, ti as FactKind, tn as GuestCaps, tr as rankHighlights, tt as CampaignChipsInput, u as MapViewReport, ua as RichInline, ui as CardSignal, un as occupancyOf, ur as RentalContentError, ut as offerWindowHref, v as FavoritesPort, va as EnhanceParts, vi as GlyphList, vn as DefaultFit, vr as walkSearchPages, vt as FilterMeasurement, w as SearchStatus, wi as nightsBetween, wn as SameSpotLayout, wr as SDK_ENV, wt as SdkFilterDefinition, x as SearchScope, xi as addDays, xn as idsInView, xr as shareSdk, xt as ImplicitScope, y as HistoryPort, ya as GATE_MARKERS, yi as IsoDay, yn as FitOptions, yr as loadSharedSdk, yt as FilterSelection, z as sanitizeSearch, zi as RentalCounts, zn as compareUndatedSearchOrder, zr as withRentalFacts, zt as QueryPair } from "./index-Dlf8Hlzc.mjs";
 import { BookingPaymentOption, BookingPaymentScheduleKind, ContactSubmitInput, GuestQuote, GuestQuoteResult, SubmittableBookingPaymentOption } from "@v-office/website-sdk";
 import { BackendKind } from "@v-office/website-sdk/capabilities/search";
 //#region src/map/constants.d.ts
@@ -194,6 +194,49 @@ export declare const dialCode: DialCode;
 /** See {@link DetectCountry}. */
 export declare const detectCountry: DetectCountry;
 //#endregion
+//#region src/regions/regions.d.ts
+/** The minimal shape read off `sdk.static.regions.getRegions`; its result passes as it is. */
+interface RegionTree {
+  /** Depth first: every region before its subregions. */
+  readonly regions: readonly {
+    readonly id: string;
+    /** `null` on a top-level region. */
+    readonly parentId: string | null;
+    readonly name: Readonly<Record<Locale, string>>;
+    /** The region's rentals and its subregions'. */
+    readonly rentalIds: readonly string[];
+  }[];
+}
+/** One region choice: a search bar `RegionOption` and a curated `region` facet's `FacetOption`. */
+interface RegionChoice {
+  /** The region id, the `?region=` value. */
+  readonly value: string;
+  /** The region's name in the locale. */
+  readonly label: string;
+  /** The site's rentals in the region and its subregions. */
+  readonly count: number;
+  /** A subregion's top-level region name; a top-level region has none. */
+  readonly group?: string;
+}
+/** What `regionOptions` reads. */
+interface RegionOptionsInput {
+  /** The label language. */
+  readonly locale: Locale;
+  /** The ids of the site's rentals. The tree ignores the SDK's `rentalScope`, so a region
+   *  counts only these, and a region without any of them is not offered. */
+  readonly rentalIds: readonly string[];
+}
+/** Every region with at least one of the site's rentals, in the tree's order (a region before its
+ *  subregions). */
+type RegionOptions = (tree: RegionTree, input: RegionOptionsInput) => RegionChoice[];
+/** Rental id → the ids of every region holding it, its regions' ancestors included: the
+ *  `RentalFacts.regions` / `CardSource.regions` the browser matches `?region=` against. */
+type RegionsByRental = (tree: RegionTree) => Record<string, readonly string[]>;
+/** See {@link RegionOptions}. */
+export declare const regionOptions: RegionOptions;
+/** See {@link RegionsByRental}. */
+export declare const regionsByRental: RegionsByRental;
+//#endregion
 //#region src/favorites/favorites.d.ts
 /** The window event every site script listens to (`detail: FavoritesChange`); kept verbatim. The
  *  `./enhance` binder dispatches it from `onChange`. */
@@ -1666,6 +1709,10 @@ interface CheckoutHandover {
   policyId: string | null;
   /** `?kind=option`, honoured only with `allowOption`; otherwise "booking". */
   kind: BookingKind;
+  /** `?service=<id>:<count>` (repeatable; `<id>` alone is one): the extras to add, by service id. A
+   *  seed like `policyId`: the flow adds only what the quote offers, up to the count the PMS allows,
+   *  and keeps what it refuses out. Empty without any. */
+  services?: Readonly<Record<string, number>> | undefined;
   /** `?return=1`: a payment provider sent the guest back to this page (sites that return to the
    *  checkout itself; the package's own return page is a separate route). */
   paymentReturn: boolean;
@@ -1682,11 +1729,14 @@ interface CheckoutHandoverOptions {
 type ReadCheckoutHandover = (search: string, options?: CheckoutHandoverOptions) => CheckoutHandover;
 /** The query string (no leading "?") for `history.replaceState` after an edit: the stay (pets as
  *  `pets`), an explicit policy only (never today's pre-selection, which would pin it), `kind=option`
- *  for an option. Every other parameter in `current` (tracking, site keys) is preserved after them. */
+ *  for an option, and with `counts` the chosen extras (`service=<id>:<count>`; without `counts` the
+ *  URL's `service` keys stay as they are). Every other parameter in `current` (tracking, site keys)
+ *  is preserved after them. */
 type CheckoutSearch = (input: {
   stay: Stay | null;
   policyId: string | null;
   kind: BookingKind;
+  counts?: Readonly<Record<string, number>> | undefined;
 }, current?: string) => string;
 /** See {@link ReadCheckoutHandover}. */
 export declare const readCheckoutHandover: ReadCheckoutHandover;
@@ -2797,4 +2847,4 @@ type FetchLegalDocuments = (sdk: WebsiteSdk, locale: Locale) => Promise<LegalDoc
 /** See {@link FetchLegalDocuments}. */
 export declare const fetchLegalDocuments: FetchLegalDocuments;
 //#endregion
-export { ADJACENT_BELOW_M, ALWAYS_EXCLUDED_CATEGORIES, type ActiveFilter, type AdaptEvent, type AdaptRentalOptions, type AlternativePeriod, type AmenityGroup, type AmenityPreviewItem, type AmenityPreviewOptions, type AvailabilityWindowInput, type Backend, type BadgeRule, type BedRun, type BookableFrom, type BookingConfirmation, type BookingContact, type BookingKind, type BookingSnapshot, type BuiltInFieldSpec, type BuiltInPolicyLabels, type CampaignChip, type CampaignChipsInput, type CampaignLabelSource, type CampaignOf, type CardBadge, type CardContext, type CardFact, type CardImage, type CardLiveField, type CardMatch, type CardModelOptions, type CardPill, type CardRating, type CardSignal, type CardSource, type CardSourceExtras, type CardStatus, type CatalogueRental, type CheckedCopy, type CheckoutActions, type CheckoutBlocker, type CheckoutContext, type CheckoutEventDetail, type CheckoutFlow, type CheckoutFlowOptions, type CheckoutHandover, type CheckoutHandoverOptions, type CheckoutInsuranceState, type CheckoutIssue, type CheckoutMessages, type CheckoutPart, type CheckoutPhase, type CheckoutPolicyState, type CheckoutRequirement, type CheckoutService, type CheckoutState, type CheckoutStructure, type CheckoutVoucherState, type ChildAgeRange, type ClusterOptions, type ContactControl, type ContactEventDetail, type ContactFieldName, type ContactFieldSpec, type ContactForm, type ContactFormActions, type ContactFormMessages, type ContactFormOptions, type ContactFormState, type ContactLink, type ContactPhase, type ContactSubmitOutcome, type ContactValue, type ContactValues, type CountryCode, type CountryGroups, type CountryOption, type CountryOptionsInput, DEFAULT_CHILD_AGE, DEFAULT_CLUSTER, DEFAULT_FIT, DEFAULT_FLAG_FILTERS, DEFAULT_GUEST_LIMITS, DEFAULT_SORT_OPTIONS, type DateControls, type DateMode, type DateSearch, type DateSearchOptions, type DateSearchState, type DayKind, type DayPrices, type DayState, type DefaultFit, type DescriptionContent, type DescriptionPreview, type DistanceKind, ENHANCE_PARTS, type EmptyCause, type EndAvailability, type EndAvailabilityInput, type EnhancePart, type EnhanceParts, type EnvRecord, type ExternalSearchLink, type ExternalSearchSource, type ExtraFieldSpec, FAVORITE_LEAVE_MS, type FacetOption, type FacetOptionsOptions, type FactKind, type Favorites, type FavoritesChange, type FavoritesOptions, type FavoritesPort, type FavoritesState, type FetchRentalFlagsOptions, type FieldWidth, type FilterDef, type FilterEntry, type FilterGroupSpec, type FilterMeasurement, type FilterSelection, type FilterSpec, type FindCampaignStartOptions, type FindOfferWindowsOptions, type FitOptions, type FlexibleStay, GATE_MARKERS, GLYPHS, type GateMarkers, type Glyph, type GlyphList, type GuestBound, type GuestBounds, type GuestCaps, type GuestForm, type GuestFormField, type GuestFormOptions, type GuestFormState, type GuestKind, type GuestLimits, type GuestOptions, type GuestSearch, type GuestSearchOptions, type GuestSearchState, HIDDEN_ROOM_ATTRIBUTES, HUB_ENDPOINTS, type HistoryPort, type HubEndpointTable, type HubEndpoints, type ImplicitScope, type InitialAvailability, type InsuranceDocsState, type InsurancePaymentLink, type IsoDay, type IsoMonth, type LegalDocument, type LegalDocuments, type Listener, type LiveSearchOptions, type LngLat, type LoadRentalCatalogueOptions, type Locale, type MapBounds, type MapPlace, type MapPoint, type MapResultsSource, type MapViewReport, type OfferWindow, type OffersWindowSpec, type OptionalGuestField, type OutcomeInput, type Party, type PaymentLine, type PaymentReturn, type PaymentScheduleView, type PeriodLabel, type PeriodValue, type PillOptions, type PinLabelOptions, type PixelOffset, type PlaceMarker, type PlainTextOptions, type PolicyBranch, type PolicyBranchOptions, type PolicyChoiceMode, type PolicyOffer, type PolicyOfferInput, type PolicyOption, type PolicyStance, type PolicyTerms, type PolicyTermsOptions, type PolicyTitle, type PreviewStrategy, type PriceCents, type PriceLine, type PriceView, type QueryPair, type QueryShape, type QuoteAddonService, type QuoteCancellationPolicy, type QuoteCta, type QuoteEventDetail, type QuoteFlow, type QuoteFlowOptions, type QuoteFlowSettings, type QuoteFlowState, type QuoteHandover, type QuoteInsurance, type QuoteInsuranceOption, type QuoteOccupancy, type QuoteOutcome, type QuotePolicyRule, type QuoteRequest, type QuoteResult, type QuoteSelectionResult, type QuoteUnavailableCode, type QuoteView, type QuoteVoucher, type Range, type RawSearchPage, type RelatedOptions, type Relaxation, type RentalAddress, type RentalAddressMode, RentalAddressModeError, type RentalCardModel, RentalContentError, type RentalCounts, type RentalDetail, type RentalDistance, type RentalFacts, type RentalFactsMap, type RentalFlag, type RentalFlagsResult, type RentalImage, type RentalIndexEntry, type RentalMatch, type RentalMatchOptions, type RentalPropertyInfo, type RentalReview, type RentalReviews, type RentalRoom, type ResolveFiltersOptions, type ResolvedContactField, type ResolvedContactItem, type ResolvedFilters, type ResolvedSearchGroup, type ResultHandoverOptions, type ResultLinkOptions, type ResultsMapController, type ResultsMapOptions, type ResultsMapState, type ResultsMapSurface, type ReviewCriterion, type ReviewSummary, type RichBlock, type RichInline, type RoomKind, type RotationOptions, type RouteParams, type RouteTemplate, type RoutedContactIssues, SDK_ENV, SEARCH_PAGE_SIZE, SEARCH_PARAMS, SORT_URL_VALUE, STAGES, type Salutation, type SameSpotGroup, type SameSpotLayout, type SameSpotMode, type SameSpotOptions, type SanitizedSearch, type SdkConfig, type SdkConfigForInput, SdkEnvError, type SdkFilterDefinition, type SdkMode, type SdkOptions, type SdkQueryOptions, type SdkSearchQuery, type SdkSetup, type SdkSource, type SearchActions, type SearchContract, type SearchField, type SearchForm, type SearchFormIssue, type SearchFormOptions, type SearchFormState, type SearchGroupSpec, type SearchOutcome, type SearchPage, type SearchPageRequest, type SearchParamAliases, type SearchParamKeys, type SearchPeriod, type SearchQuery, type SearchResultItem, type SearchScope, type SearchScopeKind, type SearchState, type SearchStatus, type SearchStore, type SearchStoreClaim, type SearchStoreOptions, type SearchedParts, type SelectOption, type Selection, type SelectionSpec, type ShareLocation, type ShareUrlOptions, type SharedSdk, type ShowcaseGroup, type ShowcaseGroupSpec, type ShowcaseOrder, type SnapshotImage, type SortKey, type SortOptionState, type Stage, type Stay, type StayPicker, type StayPickerOptions, type StayPickerState, type StayPrice, type StayWindow, type StorageLike, type Store, type StructureRequirement, type StructureViolation, type StructuredDocumentOptions, type SubmitBookingOptions, type SubmitWording, type Template, type TextMarkup, type TokensOf, type Unsubscribe, VOFFICE_ENDPOINTS, type ValidationMessages, type ValueConstraints, type VofficeEndpointTable, type VofficeEndpoints, WATER_KINDS, type WalkOptions, type WalkSummary, type WebsiteSdk, type WhenEmpty, type WhenUnavailable, type WritableStore, type WriteSearchOptions, activeFilters, adaptRental, addDays, agesComplete, amenityPreview, assignSlugs, campaignChips, campaignGroup, cardSource, catalogueResultItem, circleOffsets, clampParty, compareUndatedSearchOrder, createResultsMapController, createSdk, createSearchStore, createStore, describeOutcome, descriptionPreview, descriptionSummary, distanceFact, distanceMeters, externalSearchHref, facetOptions, fetchRentalFlags, fetchSearchPage, findCampaignStart, findOfferWindows, formatIsoDate, formatPriceLabel, frameFor, guestBounds, handoverQuery, hasMapPoints, idsInView, isAdjacent, isIsoDay, isSpecEcho, layoutSameSpot, loadRentalCatalogue, loadRentalFacts, loadSharedSdk, mapPoints, matches, measureFilters, mergePlaces, minimumSteps, newestReviewsFirst, nightsBetween, normalizeStructuredDocument, occupancyOf, offerWindowHref, offersWindowQuery, parseCounts, parseDistances, parsePriceLabel, parseTextBlocks, partyPairs, plainText, queryShape, quickFilterDefs, rankHighlights, readParty, readSearch, readSelection, rentalAddressLine, rentalFactsMap, resolveFilters, resolveSdk, resultCardSource, resultsQueryFlagScript, routeHref, sanitizeSearch, sdkConfigFor, sdkConfigFromEnv, searchHref, shareSdk, shortReviewerName, slugify, sortFromSearch, sortResults, splitReviewAuthor, stayKeyOf, toCardModel, toSdkQuery, toSdkSort, todayIso, walkSearchPages, withRentalFacts, withoutFilter, withoutFilters, writeSearch, writeSelection };
+export { ADJACENT_BELOW_M, ALWAYS_EXCLUDED_CATEGORIES, type ActiveFilter, type AdaptEvent, type AdaptRentalOptions, type AlternativePeriod, type AmenityGroup, type AmenityPreviewItem, type AmenityPreviewOptions, type AvailabilityWindowInput, type Backend, type BadgeRule, type BedRun, type BookableFrom, type BookingConfirmation, type BookingContact, type BookingKind, type BookingSnapshot, type BuiltInFieldSpec, type BuiltInPolicyLabels, type CampaignChip, type CampaignChipsInput, type CampaignLabelSource, type CampaignOf, type CardBadge, type CardContext, type CardFact, type CardImage, type CardLiveField, type CardMatch, type CardModelOptions, type CardPill, type CardRating, type CardSignal, type CardSource, type CardSourceExtras, type CardStatus, type CatalogueRental, type CheckedCopy, type CheckoutActions, type CheckoutBlocker, type CheckoutContext, type CheckoutEventDetail, type CheckoutFlow, type CheckoutFlowOptions, type CheckoutHandover, type CheckoutHandoverOptions, type CheckoutInsuranceState, type CheckoutIssue, type CheckoutMessages, type CheckoutPart, type CheckoutPhase, type CheckoutPolicyState, type CheckoutRequirement, type CheckoutService, type CheckoutState, type CheckoutStructure, type CheckoutVoucherState, type ChildAgeRange, type ClusterOptions, type ContactControl, type ContactEventDetail, type ContactFieldName, type ContactFieldSpec, type ContactForm, type ContactFormActions, type ContactFormMessages, type ContactFormOptions, type ContactFormState, type ContactLink, type ContactPhase, type ContactSubmitOutcome, type ContactValue, type ContactValues, type CountryCode, type CountryGroups, type CountryOption, type CountryOptionsInput, DEFAULT_CHILD_AGE, DEFAULT_CLUSTER, DEFAULT_FIT, DEFAULT_FLAG_FILTERS, DEFAULT_GUEST_LIMITS, DEFAULT_SORT_OPTIONS, type DateControls, type DateMode, type DateSearch, type DateSearchOptions, type DateSearchState, type DayKind, type DayPrices, type DayState, type DefaultFit, type DescriptionContent, type DescriptionPreview, type DistanceKind, ENHANCE_PARTS, type EmptyCause, type EndAvailability, type EndAvailabilityInput, type EnhancePart, type EnhanceParts, type EnvRecord, type ExternalSearchLink, type ExternalSearchSource, type ExtraFieldSpec, FAVORITE_LEAVE_MS, type FacetOption, type FacetOptionsOptions, type FactKind, type Favorites, type FavoritesChange, type FavoritesOptions, type FavoritesPort, type FavoritesState, type FetchRentalFlagsOptions, type FieldWidth, type FilterDef, type FilterEntry, type FilterGroupSpec, type FilterMeasurement, type FilterSelection, type FilterSpec, type FindCampaignStartOptions, type FindOfferWindowsOptions, type FitOptions, type FlexibleStay, GATE_MARKERS, GLYPHS, type GateMarkers, type Glyph, type GlyphList, type GuestBound, type GuestBounds, type GuestCaps, type GuestForm, type GuestFormField, type GuestFormOptions, type GuestFormState, type GuestKind, type GuestLimits, type GuestOptions, type GuestSearch, type GuestSearchOptions, type GuestSearchState, HIDDEN_ROOM_ATTRIBUTES, HUB_ENDPOINTS, type HistoryPort, type HubEndpointTable, type HubEndpoints, type ImplicitScope, type InitialAvailability, type InsuranceDocsState, type InsurancePaymentLink, type IsoDay, type IsoMonth, type LegalDocument, type LegalDocuments, type Listener, type LiveSearchOptions, type LngLat, type LoadRentalCatalogueOptions, type Locale, type MapBounds, type MapPlace, type MapPoint, type MapResultsSource, type MapViewReport, type OfferWindow, type OffersWindowSpec, type OptionalGuestField, type OutcomeInput, type Party, type PaymentLine, type PaymentReturn, type PaymentScheduleView, type PeriodLabel, type PeriodValue, type PillOptions, type PinLabelOptions, type PixelOffset, type PlaceMarker, type PlainTextOptions, type PolicyBranch, type PolicyBranchOptions, type PolicyChoiceMode, type PolicyOffer, type PolicyOfferInput, type PolicyOption, type PolicyStance, type PolicyTerms, type PolicyTermsOptions, type PolicyTitle, type PreviewStrategy, type PriceCents, type PriceLine, type PriceView, type QueryPair, type QueryShape, type QuoteAddonService, type QuoteCancellationPolicy, type QuoteCta, type QuoteEventDetail, type QuoteFlow, type QuoteFlowOptions, type QuoteFlowSettings, type QuoteFlowState, type QuoteHandover, type QuoteInsurance, type QuoteInsuranceOption, type QuoteOccupancy, type QuoteOutcome, type QuotePolicyRule, type QuoteRequest, type QuoteResult, type QuoteSelectionResult, type QuoteUnavailableCode, type QuoteView, type QuoteVoucher, type Range, type RawSearchPage, type RegionChoice, type RegionOptionsInput, type RegionTree, type RelatedOptions, type Relaxation, type RentalAddress, type RentalAddressMode, RentalAddressModeError, type RentalCardModel, RentalContentError, type RentalCounts, type RentalDetail, type RentalDistance, type RentalFacts, type RentalFactsMap, type RentalFlag, type RentalFlagsResult, type RentalImage, type RentalIndexEntry, type RentalMatch, type RentalMatchOptions, type RentalPropertyInfo, type RentalReview, type RentalReviews, type RentalRoom, type ResolveFiltersOptions, type ResolvedContactField, type ResolvedContactItem, type ResolvedFilters, type ResolvedSearchGroup, type ResultHandoverOptions, type ResultLinkOptions, type ResultsMapController, type ResultsMapOptions, type ResultsMapState, type ResultsMapSurface, type ReviewCriterion, type ReviewSummary, type RichBlock, type RichInline, type RoomKind, type RotationOptions, type RouteParams, type RouteTemplate, type RoutedContactIssues, SDK_ENV, SEARCH_PAGE_SIZE, SEARCH_PARAMS, SORT_URL_VALUE, STAGES, type Salutation, type SameSpotGroup, type SameSpotLayout, type SameSpotMode, type SameSpotOptions, type SanitizedSearch, type SdkConfig, type SdkConfigForInput, SdkEnvError, type SdkFilterDefinition, type SdkMode, type SdkOptions, type SdkQueryOptions, type SdkSearchQuery, type SdkSetup, type SdkSource, type SearchActions, type SearchContract, type SearchField, type SearchForm, type SearchFormIssue, type SearchFormOptions, type SearchFormState, type SearchGroupSpec, type SearchOutcome, type SearchPage, type SearchPageRequest, type SearchParamAliases, type SearchParamKeys, type SearchPeriod, type SearchQuery, type SearchResultItem, type SearchScope, type SearchScopeKind, type SearchState, type SearchStatus, type SearchStore, type SearchStoreClaim, type SearchStoreOptions, type SearchedParts, type SelectOption, type Selection, type SelectionSpec, type ShareLocation, type ShareUrlOptions, type SharedSdk, type ShowcaseGroup, type ShowcaseGroupSpec, type ShowcaseOrder, type SnapshotImage, type SortKey, type SortOptionState, type Stage, type Stay, type StayPicker, type StayPickerOptions, type StayPickerState, type StayPrice, type StayWindow, type StorageLike, type Store, type StructureRequirement, type StructureViolation, type StructuredDocumentOptions, type SubmitBookingOptions, type SubmitWording, type Template, type TextMarkup, type TokensOf, type Unsubscribe, VOFFICE_ENDPOINTS, type ValidationMessages, type ValueConstraints, type VofficeEndpointTable, type VofficeEndpoints, WATER_KINDS, type WalkOptions, type WalkSummary, type WebsiteSdk, type WhenEmpty, type WhenUnavailable, type WritableStore, type WriteSearchOptions, activeFilters, adaptRental, addDays, agesComplete, amenityPreview, assignSlugs, campaignChips, campaignGroup, cardSource, catalogueResultItem, circleOffsets, clampParty, compareUndatedSearchOrder, createResultsMapController, createSdk, createSearchStore, createStore, describeOutcome, descriptionPreview, descriptionSummary, distanceFact, distanceMeters, externalSearchHref, facetOptions, fetchRentalFlags, fetchSearchPage, findCampaignStart, findOfferWindows, formatIsoDate, formatPriceLabel, frameFor, guestBounds, handoverQuery, hasMapPoints, idsInView, isAdjacent, isIsoDay, isSpecEcho, layoutSameSpot, loadRentalCatalogue, loadRentalFacts, loadSharedSdk, mapPoints, matches, measureFilters, mergePlaces, minimumSteps, newestReviewsFirst, nightsBetween, normalizeStructuredDocument, occupancyOf, offerWindowHref, offersWindowQuery, parseCounts, parseDistances, parsePriceLabel, parseTextBlocks, partyPairs, plainText, queryShape, quickFilterDefs, rankHighlights, readParty, readSearch, readSelection, rentalAddressLine, rentalFactsMap, resolveFilters, resolveSdk, resultCardSource, resultsQueryFlagScript, routeHref, sanitizeSearch, sdkConfigFor, sdkConfigFromEnv, searchHref, shareSdk, shortReviewerName, slugify, sortFromSearch, sortResults, splitReviewAuthor, stayKeyOf, toCardModel, toSdkQuery, toSdkSort, todayIso, walkSearchPages, withRentalFacts, withoutFilter, withoutFilters, writeSearch, writeSelection };

package/dist/index.mjs

@@ -986,6 +986,34 @@ const detectCountry = function detectCountry(countries, languages, fallback = "D
 	return fallback;
 };
 //#endregion
+//#region src/regions/regions.ts
+/** See {@link RegionOptions}. */
+const regionOptions = function regionOptions(tree, { locale, rentalIds }) {
+	const siteRentals = new Set(rentalIds);
+	const topLevelName = /* @__PURE__ */ new Map();
+	const choices = [];
+	for (const region of tree.regions) {
+		const name = region.name[locale];
+		const group = region.parentId === null ? void 0 : topLevelName.get(region.parentId);
+		topLevelName.set(region.id, group ?? name);
+		const count = region.rentalIds.filter((id) => siteRentals.has(id)).length;
+		if (count === 0) continue;
+		choices.push({
+			value: region.id,
+			label: name,
+			count,
+			...group === void 0 ? {} : { group }
+		});
+	}
+	return choices;
+};
+/** See {@link RegionsByRental}. */
+const regionsByRental = function regionsByRental(tree) {
+	const byRental = {};
+	for (const region of tree.regions) for (const rentalId of region.rentalIds) (byRental[rentalId] ??= []).push(region.id);
+	return byRental;
+};
+//#endregion
 //#region src/guests/party.ts
 /** The kit limits every site ran on; a site overrides single keys. */
 const DEFAULT_GUEST_LIMITS = {
@@ -1469,6 +1497,7 @@ const SEARCH_PARAMS = {
 	campaign: "campaign",
 	policy: "policy",
 	kind: "kind",
+	service: "service",
 	return: "return",
 	offer: "offer"
 };
@@ -7136,6 +7165,83 @@ const payWithOption = (sdk, option) => sdk.live.booking.submitPaymentOption(opti
 /** The window CustomEvent name. Renaming it is a major. */
 const CHECKOUT_EVENT = "voffice:checkout";
 //#endregion
+//#region src/checkout/handover.ts
+const DEFAULT_ADULTS$1 = 2;
+/** The most distinct extras a URL hands over: more than any quote offers, a bound for junk links. */
+const MAX_SERVICES = 50;
+const MAX_SERVICE_ID = 100;
+/** `id:count` or `id` (one) per `service` key; unreadable entries are skipped, a repeated id adds up
+*  to the cap. */
+function readServices(params) {
+	const services = /* @__PURE__ */ new Map();
+	for (const raw of params.getAll(SEARCH_PARAMS.service)) {
+		const at = raw.lastIndexOf(":");
+		const id = (at === -1 ? raw : raw.slice(0, at)).trim();
+		const count = at === -1 ? 1 : Number(raw.slice(at + 1));
+		if (!id || id.length > MAX_SERVICE_ID || !Number.isInteger(count) || count < 1) continue;
+		if (!services.has(id) && services.size >= MAX_SERVICES) continue;
+		services.set(id, Math.min(99, (services.get(id) ?? 0) + count));
+	}
+	return Object.fromEntries(services);
+}
+/** The keys the write-back owns; everything else in the URL is carried through untouched. */
+const OWNED_KEYS = /* @__PURE__ */ new Set([
+	SEARCH_PARAMS.start,
+	SEARCH_PARAMS.end,
+	SEARCH_PARAMS.adults,
+	SEARCH_PARAMS.children,
+	SEARCH_PARAMS.childrenAges,
+	SEARCH_PARAMS.babies,
+	SEARCH_PARAMS.pets,
+	SEARCH_PARAMS.petsCount,
+	SEARCH_PARAMS.policy,
+	SEARCH_PARAMS.kind
+]);
+function readHandover(search, options) {
+	const params = new URLSearchParams(search);
+	const start = params.get(SEARCH_PARAMS.start);
+	const end = params.get(SEARCH_PARAMS.end);
+	const dated = isIsoDay(start) && isIsoDay(end) && nightsBetween(start, end) > 0;
+	const party = readParty(params);
+	const adults = party && party.adults > 0 ? party.adults : options.defaultAdults ?? DEFAULT_ADULTS$1;
+	const withAdults = {
+		...party ?? {
+			children: 0,
+			childrenAges: [],
+			babies: 0,
+			pets: 0
+		},
+		adults
+	};
+	return {
+		stay: dated ? {
+			start,
+			end,
+			party: withAdults
+		} : null,
+		policyId: params.get(SEARCH_PARAMS.policy) || null,
+		kind: options.allowOption === true && params.get(SEARCH_PARAMS.kind) === "option" ? "option" : "booking",
+		services: readServices(params),
+		paymentReturn: params.get(SEARCH_PARAMS.return) === "1"
+	};
+}
+function writeHandover({ stay, policyId, kind, counts }, current) {
+	const pairs = [];
+	if (stay) pairs.push([SEARCH_PARAMS.start, stay.start], [SEARCH_PARAMS.end, stay.end], ...partyPairs(stay.party, SEARCH_PARAMS.pets));
+	if (policyId) pairs.push([SEARCH_PARAMS.policy, policyId]);
+	if (kind === "option") pairs.push([SEARCH_PARAMS.kind, "option"]);
+	if (counts) {
+		for (const [id, count] of Object.entries(counts)) if (count > 0) pairs.push([SEARCH_PARAMS.service, `${id}:${count}`]);
+	}
+	const owned = (key) => OWNED_KEYS.has(key) || counts !== void 0 && key === SEARCH_PARAMS.service;
+	const carried = [...new URLSearchParams(current)].filter(([key]) => !owned(key));
+	return new URLSearchParams([...pairs, ...carried].map(([key, value]) => [key, value])).toString();
+}
+/** See {@link ReadCheckoutHandover}. */
+const readCheckoutHandover = (search, options) => readHandover(search, options ?? {});
+/** See {@link CheckoutSearch}. */
+const checkoutSearch = (input, current) => writeHandover(input, current ?? "");
+//#endregion
 //#region src/checkout/insurance.ts
 /** Nothing opened, nothing confirmed. */
 const NO_INSURANCE_DOCS = {
@@ -7202,11 +7308,11 @@ async function run(sdk, input) {
 	};
 	const cleared = await clearQuoteServices(sdk, result.live);
 	if (!cleared.ok) throw new Error("clearAdditionalServices failed: the extras baseline is unknown");
-	const stepped = await stepServices(sdk, cleared.quote, result.view, input.counts);
-	const policy = await applyPolicy(sdk, stepped.quote, input);
-	const reapply = insuranceIdToReapply(adaptGuestQuote(policy.quote), input.insurance);
-	const insured = reapply === void 0 ? null : await selectQuoteInsurance(sdk, policy.quote, reapply);
-	const quote = insured?.ok ? insured.quote : policy.quote;
+	const policy = await applyPolicy(sdk, cleared.quote, input);
+	const stepped = await stepServices(sdk, policy.quote, adaptGuestQuote(policy.quote), input.counts);
+	const reapply = insuranceIdToReapply(adaptGuestQuote(stepped.quote), input.insurance);
+	const insured = reapply === void 0 ? null : await selectQuoteInsurance(sdk, stepped.quote, reapply);
+	const quote = insured?.ok ? insured.quote : stepped.quote;
 	return {
 		kind: "priced",
 		quote,
@@ -7266,8 +7372,7 @@ const requote = (sdk, input) => run(sdk, input);
 //#region src/checkout/flow.ts
 /** Later edits coalesce (a burst of stepper clicks prices once); the first quote runs at once. */
 const REQUOTE_DELAY_MS = 350;
-const DEFAULT_ADULTS$1 = 2;
-const DEFAULT_MAX_PER_BOOKING = 99;
+const DEFAULT_ADULTS = 2;
 const chosenInsurance = (view) => selectedInsuranceOption(view?.insurance);
 /** The handed-over stay under the same party rules as the quote: clamped to the bounds and every age
 *  outside the band unchosen (the child-ages blocker then asks for it). */
@@ -7281,7 +7386,7 @@ function handedOverStay(options, how) {
 	};
 }
 function initialRaw(options, how) {
-	const { policyId } = options.handover;
+	const { policyId, services } = options.handover;
 	const stay = handedOverStay(options, how);
 	return {
 		phase: stay ? { kind: "loading" } : { kind: "missing-stay" },
@@ -7289,7 +7394,7 @@ function initialRaw(options, how) {
 		live: null,
 		view: null,
 		quoted: null,
-		counts: {},
+		counts: services ?? {},
 		issue: null,
 		chosenPolicyId: policyId,
 		voucher: {
@@ -7311,7 +7416,7 @@ function initialRaw(options, how) {
 function derivationOf(options) {
 	const { guests, caps } = options;
 	const emptyParty = {
-		adults: guests?.defaultAdults ?? DEFAULT_ADULTS$1,
+		adults: guests?.defaultAdults ?? DEFAULT_ADULTS,
 		children: 0,
 		childrenAges: [],
 		babies: 0,
@@ -7341,7 +7446,7 @@ function derivationOf(options) {
 function servicesOf(raw, busy) {
 	return (raw.view?.services ?? []).map((service) => {
 		const count = raw.counts[service.id] ?? 0;
-		const max = service.maxPerBooking ?? DEFAULT_MAX_PER_BOOKING;
+		const max = service.maxPerBooking ?? 99;
 		return {
 			...service,
 			count,
@@ -8088,61 +8193,6 @@ function guestForm(options) {
 /** See {@link CreateGuestForm}. */
 const createGuestForm = (options) => guestForm(options);
 //#endregion
-//#region src/checkout/handover.ts
-const DEFAULT_ADULTS = 2;
-/** The keys the write-back owns; everything else in the URL is carried through untouched. */
-const OWNED_KEYS = /* @__PURE__ */ new Set([
-	SEARCH_PARAMS.start,
-	SEARCH_PARAMS.end,
-	SEARCH_PARAMS.adults,
-	SEARCH_PARAMS.children,
-	SEARCH_PARAMS.childrenAges,
-	SEARCH_PARAMS.babies,
-	SEARCH_PARAMS.pets,
-	SEARCH_PARAMS.petsCount,
-	SEARCH_PARAMS.policy,
-	SEARCH_PARAMS.kind
-]);
-function readHandover(search, options) {
-	const params = new URLSearchParams(search);
-	const start = params.get(SEARCH_PARAMS.start);
-	const end = params.get(SEARCH_PARAMS.end);
-	const dated = isIsoDay(start) && isIsoDay(end) && nightsBetween(start, end) > 0;
-	const party = readParty(params);
-	const adults = party && party.adults > 0 ? party.adults : options.defaultAdults ?? DEFAULT_ADULTS;
-	const withAdults = {
-		...party ?? {
-			children: 0,
-			childrenAges: [],
-			babies: 0,
-			pets: 0
-		},
-		adults
-	};
-	return {
-		stay: dated ? {
-			start,
-			end,
-			party: withAdults
-		} : null,
-		policyId: params.get(SEARCH_PARAMS.policy) || null,
-		kind: options.allowOption === true && params.get(SEARCH_PARAMS.kind) === "option" ? "option" : "booking",
-		paymentReturn: params.get(SEARCH_PARAMS.return) === "1"
-	};
-}
-function writeHandover({ stay, policyId, kind }, current) {
-	const pairs = [];
-	if (stay) pairs.push([SEARCH_PARAMS.start, stay.start], [SEARCH_PARAMS.end, stay.end], ...partyPairs(stay.party, SEARCH_PARAMS.pets));
-	if (policyId) pairs.push([SEARCH_PARAMS.policy, policyId]);
-	if (kind === "option") pairs.push([SEARCH_PARAMS.kind, "option"]);
-	const carried = [...new URLSearchParams(current)].filter(([key]) => !OWNED_KEYS.has(key));
-	return new URLSearchParams([...pairs, ...carried].map(([key, value]) => [key, value])).toString();
-}
-/** See {@link ReadCheckoutHandover}. */
-const readCheckoutHandover = (search, options) => readHandover(search, options ?? {});
-/** See {@link CheckoutSearch}. */
-const checkoutSearch = (input, current) => writeHandover(input, current ?? "");
-//#endregion
 //#region src/checkout/structure.ts
 /** The legal `data-part` vocabulary. Imported components carry it; a custom checkout must keep it.
 *  Style-only hooks are not here (components `BOOKING_PARTS`). Renaming a part is a major. */
@@ -8935,4 +8985,4 @@ function parseNodes(data) {
 /** See {@link FetchLegalDocuments}. */
 const fetchLegalDocuments = (sdk, locale) => fetchDocuments(sdk, locale);
 //#endregion
-export { ADJACENT_BELOW_M, ALWAYS_EXCLUDED_CATEGORIES, BOOKING_KIND_ATTRIBUTE, BOOKING_SNAPSHOT_KEY, BUILT_IN_POLICY_LABELS, CAMPAIGN_PARAM, CHECKOUT_CONTEXT_KEY, CHECKOUT_EVENT, CHECKOUT_PARTS, CHECKOUT_STRUCTURE, CONTACT_ENDPOINT_REQUIRED, CONTACT_EVENT, CONTACT_LIMITS, DEFAULT_CHILD_AGE, DEFAULT_CLUSTER, DEFAULT_CONTACT_FIELDS, DEFAULT_FEATURED_COUNTRIES, DEFAULT_FIT, DEFAULT_FLAG_FILTERS, DEFAULT_GUEST_LIMITS, DEFAULT_MAP_STYLE_URL, DEFAULT_SORT_OPTIONS, ENHANCE_PARTS, FAVORITES_EVENT, FAVORITE_LEAVE_MS, GATE_MARKERS, GLYPHS, HIDDEN_ROOM_ATTRIBUTES, HUB_ENDPOINTS, MULTI_RATE_CODES, NO_INSURANCE_DOCS, POLICY_DEADLINE_HAS_TIME, QUOTE_EVENT, QUOTE_PARAM_KEYS, RELOAD_FLASH_MS, RentalAddressModeError, RentalContentError, SALUTATION_WIRE_VALUES, SAME_SPOT_METERS, SDK_ENV, SEARCH_PAGE_SIZE, SEARCH_PARAMS, SORT_URL_VALUE, STAGES, SUBMIT_WORDING, SdkEnvError, TRACKING_PARAM_PATTERN, VOFFICE_ENDPOINTS, WATER_KINDS, WINDOW_PARAM_KEYS, acquireFavorites, acquireQuoteFlow, acquireSearchStore, activeFilters, adaptGuestQuote, adaptRental, addDays, addQuoteService, agesComplete, amenityPreview, assertCheckoutStructure, assignSlugs, browserStorage, buildContactInput, buildShowcaseGroups, campaignChips, campaignGroup, cardSource, catalogueResultItem, checkoutHref, checkoutSearch, circleOffsets, clampParty, clearQuoteServices, compareUndatedSearchOrder, connectSearchStore, contactSpecProblems, countryOptions, createCheckoutFlow, createContactForm, createDateSearch, createFavorites, createGuestForm, createGuestSearch, createQuoteFlow, createResultsMapController, createSdk, createSearchForm, createSearchStore, createStayPicker, createStore, dayPriceLabel, defineCopy, describeOutcome, describePeriod, describePolicyOffer, describeSdkError, descriptionPreview, descriptionSummary, detectCountry, dialCode, distanceFact, distanceMeters, emailError, externalSearchHref, facetOptions, favoritesStorageKey, fetchEndAvailability, fetchInitialAvailability, fetchLegalDocuments, fetchQuote, fetchRentalFlags, fetchSearchPage, fillTemplate, findCampaignStart, findOfferWindows, floorplanUrl, foldSearchText, formatIsoDate, formatPriceLabel, formatStayRange, frameFor, freeCancellationUntil, guestBounds, handoverQuery, hasMapPoints, idsInView, insuranceDocsPending, insuranceIdToReapply, insuranceProductKey, isAdjacent, isBuiltInPolicy, isIsoDay, isRateConfigurationFault, isSpecEcho, isSubmittableOption, isTrackingParam, layoutSameSpot, loadRentalCatalogue, loadRentalFacts, loadRentalIndex, loadSharedSdk, logSdkFailure, mapPoints, matchRentals, matches, measureFilters, mergePlaces, minimumSteps, newestReviewsFirst, nightsBetween, normalizePhone, normalizeStructuredDocument, occupancyOf, offerWindowHref, offeredPolicies, offersWindowQuery, parseCounts, parseDistances, parsePriceLabel, parseTextBlocks, partyPairs, payWithOption, phoneError, plainText, policyStance, policyTerms, policyTitle, postalcodeError, prefillFromParams, pricePolicyBranches, queryShape, quickFilterDefs, rankHighlights, readCheckoutHandover, readParty, readPaymentReturn, readQuoteHandover, readSearch, readSelection, removeQuoteService, rentalAddressLine, rentalFactsMap, rentalIndexEntries, resolveContactFields, resolveFilters, resolveSdk, resolveSearchGroups, resultCardSource, resultsQueryFlagScript, rotationWindow, routeContactIssues, routeHref, runLiveSearch, sanitizeSearch, saveCheckoutContext, sdkConfigFor, sdkConfigFromEnv, searchHref, seededShuffle, selectQuoteInsurance, selectQuotePolicy, selectRelated, selectRentals, selectableInsuranceOptions, selectedInsuranceOption, shareSdk, shareUrl, shortReviewerName, shownInsuranceResources, slugify, sortFromSearch, sortResults, splitReviewAuthor, stabilizeCardOrder, stayKeyOf, stayQuery, streetWarning, submitBooking, toCardModel, toSdkQuery, toSdkSort, todayIso, validateContactValues, walkSearchPages, webpSrcset, webpUrl, withRentalFacts, withoutFilter, withoutFilters, withoutTracking, writeQuoteParams, writeSearch, writeSelection };
+export { ADJACENT_BELOW_M, ALWAYS_EXCLUDED_CATEGORIES, BOOKING_KIND_ATTRIBUTE, BOOKING_SNAPSHOT_KEY, BUILT_IN_POLICY_LABELS, CAMPAIGN_PARAM, CHECKOUT_CONTEXT_KEY, CHECKOUT_EVENT, CHECKOUT_PARTS, CHECKOUT_STRUCTURE, CONTACT_ENDPOINT_REQUIRED, CONTACT_EVENT, CONTACT_LIMITS, DEFAULT_CHILD_AGE, DEFAULT_CLUSTER, DEFAULT_CONTACT_FIELDS, DEFAULT_FEATURED_COUNTRIES, DEFAULT_FIT, DEFAULT_FLAG_FILTERS, DEFAULT_GUEST_LIMITS, DEFAULT_MAP_STYLE_URL, DEFAULT_SORT_OPTIONS, ENHANCE_PARTS, FAVORITES_EVENT, FAVORITE_LEAVE_MS, GATE_MARKERS, GLYPHS, HIDDEN_ROOM_ATTRIBUTES, HUB_ENDPOINTS, MULTI_RATE_CODES, NO_INSURANCE_DOCS, POLICY_DEADLINE_HAS_TIME, QUOTE_EVENT, QUOTE_PARAM_KEYS, RELOAD_FLASH_MS, RentalAddressModeError, RentalContentError, SALUTATION_WIRE_VALUES, SAME_SPOT_METERS, SDK_ENV, SEARCH_PAGE_SIZE, SEARCH_PARAMS, SORT_URL_VALUE, STAGES, SUBMIT_WORDING, SdkEnvError, TRACKING_PARAM_PATTERN, VOFFICE_ENDPOINTS, WATER_KINDS, WINDOW_PARAM_KEYS, acquireFavorites, acquireQuoteFlow, acquireSearchStore, activeFilters, adaptGuestQuote, adaptRental, addDays, addQuoteService, agesComplete, amenityPreview, assertCheckoutStructure, assignSlugs, browserStorage, buildContactInput, buildShowcaseGroups, campaignChips, campaignGroup, cardSource, catalogueResultItem, checkoutHref, checkoutSearch, circleOffsets, clampParty, clearQuoteServices, compareUndatedSearchOrder, connectSearchStore, contactSpecProblems, countryOptions, createCheckoutFlow, createContactForm, createDateSearch, createFavorites, createGuestForm, createGuestSearch, createQuoteFlow, createResultsMapController, createSdk, createSearchForm, createSearchStore, createStayPicker, createStore, dayPriceLabel, defineCopy, describeOutcome, describePeriod, describePolicyOffer, describeSdkError, descriptionPreview, descriptionSummary, detectCountry, dialCode, distanceFact, distanceMeters, emailError, externalSearchHref, facetOptions, favoritesStorageKey, fetchEndAvailability, fetchInitialAvailability, fetchLegalDocuments, fetchQuote, fetchRentalFlags, fetchSearchPage, fillTemplate, findCampaignStart, findOfferWindows, floorplanUrl, foldSearchText, formatIsoDate, formatPriceLabel, formatStayRange, frameFor, freeCancellationUntil, guestBounds, handoverQuery, hasMapPoints, idsInView, insuranceDocsPending, insuranceIdToReapply, insuranceProductKey, isAdjacent, isBuiltInPolicy, isIsoDay, isRateConfigurationFault, isSpecEcho, isSubmittableOption, isTrackingParam, layoutSameSpot, loadRentalCatalogue, loadRentalFacts, loadRentalIndex, loadSharedSdk, logSdkFailure, mapPoints, matchRentals, matches, measureFilters, mergePlaces, minimumSteps, newestReviewsFirst, nightsBetween, normalizePhone, normalizeStructuredDocument, occupancyOf, offerWindowHref, offeredPolicies, offersWindowQuery, parseCounts, parseDistances, parsePriceLabel, parseTextBlocks, partyPairs, payWithOption, phoneError, plainText, policyStance, policyTerms, policyTitle, postalcodeError, prefillFromParams, pricePolicyBranches, queryShape, quickFilterDefs, rankHighlights, readCheckoutHandover, readParty, readPaymentReturn, readQuoteHandover, readSearch, readSelection, regionOptions, regionsByRental, removeQuoteService, rentalAddressLine, rentalFactsMap, rentalIndexEntries, resolveContactFields, resolveFilters, resolveSdk, resolveSearchGroups, resultCardSource, resultsQueryFlagScript, rotationWindow, routeContactIssues, routeHref, runLiveSearch, sanitizeSearch, saveCheckoutContext, sdkConfigFor, sdkConfigFromEnv, searchHref, seededShuffle, selectQuoteInsurance, selectQuotePolicy, selectRelated, selectRentals, selectableInsuranceOptions, selectedInsuranceOption, shareSdk, shareUrl, shortReviewerName, shownInsuranceResources, slugify, sortFromSearch, sortResults, splitReviewAuthor, stabilizeCardOrder, stayKeyOf, stayQuery, streetWarning, submitBooking, toCardModel, toSdkQuery, toSdkSort, todayIso, validateContactValues, walkSearchPages, webpSrcset, webpUrl, withRentalFacts, withoutFilter, withoutFilters, withoutTracking, writeQuoteParams, writeSearch, writeSelection };

package/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 Release notes of `@v-office/website-headless`, newest first. Each version has its own directory.
 
+- `versions/1.3.0/CHANGELOG.md`: release notes for 1.3.0
+- `versions/1.2.0/CHANGELOG.md`: release notes for 1.2.0
 - `versions/1.1.1/CHANGELOG.md`: release notes for 1.1.1
 - `versions/1.1.0/CHANGELOG.md`: release notes for 1.1.0
 - `versions/1.0.0/CHANGELOG.md`: release notes for 1.0.0

package/instructions/MIGRATION.md

@@ -4,6 +4,8 @@
 
 Migration guides of `@v-office/website-headless`, newest first. Apply them in order when skipping versions.
 
+- `versions/1.3.0/MIGRATION.md`: Migration: 1.2.0 to 1.3.0
+- `versions/1.2.0/MIGRATION.md`: Migration: 1.1.1 to 1.2.0
 - `versions/1.1.1/MIGRATION.md`: Migration: 1.1.0 to 1.1.1
 - `versions/1.1.0/MIGRATION.md`: Migration: 1.0.0 to 1.1.0
 - `versions/1.0.0/MIGRATION.md`: Migration: 0.2.0 to 1.0.0

package/instructions/versions/1.2.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog: 1.2.0
+
+The booking page takes the extras a link hands over. AI Studio's website chat puts a stay together
+with extras (bed linen, a cot, a second dog, …) and links to the booking page with them chosen.
+
+## Added
+
+- `readCheckoutHandover` reads `?service=<id>:<count>` (repeatable; `<id>` alone is one) into
+  `services`. The checkout flow adds them with its first quote, like the handed-over rate: only extras
+  the quote offers, only as many as the PMS allows. What it refuses stays out; the price on the
+  booking page is always the PMS's for what is selected.
+- `checkoutSearch` takes `counts`, the chosen extras, and writes them as `service` keys; without
+  `counts` the URL's `service` keys stay as they are.
+
+## Changed
+
+- Nothing for existing links: a URL without `service` keys works as before.
+
+## Fixed
+
+- The checkout keeps the rate the guest chose when the extras already chosen exceed that rate's
+  limits. Each rate has its own extras and limits, and the checkout used to add the extras first,
+  so the PMS refused the rate and the price fell back to the standard rate. It now applies the rate
+  first and adds the extras within that rate's limits; what it refuses stays out.

package/instructions/versions/1.2.0/MIGRATION.md

@@ -0,0 +1,11 @@
+# Migration: 1.1.1 to 1.2.0
+
+No changes required. A site with the platform's `Booking` gets the extras through
+`@v-office/website-components` 1.1.0, which writes the chosen extras back into the URL. A site
+with its own checkout passes `counts` (the chosen extras by id) to `checkoutSearch` to do the same.
+
+## 1. Upgrade
+
+```sh
+pnpm add --save-exact @v-office/website-headless@1.2.0
+```

package/instructions/versions/1.2.0/release.json

@@ -0,0 +1,3 @@
+{
+  "componentsAffectedByHeadlessChange": ["booking"]
+}

package/instructions/versions/1.3.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog: 1.3.0
+
+The search's region field and `?region=` scope can come from the website's region tree
+(`sdk.static.regions.getRegions` of `@v-office/website-sdk` 2.37.1 or later, v10 and v9).
+These helpers were described for 1.2.0, but 1.2.0 was published without them.
+
+## Added
+
+- `regionOptions(tree, { locale, rentalIds })` returns every region holding one of the site's
+  rentals as a `RegionChoice` (`value` = the region's id, its key such as `dornum`; `label` =
+  its name; `count` of the site's rentals; `group` = the top-level region's name for a
+  subregion), in the tree's order. `rentalIds` are the ids of the rentals the site reads: the
+  tree ignores the SDK's `rentalScope`. Pass them as the `regions` prop of `SearchBar` from
+  `@v-office/website-components`, and as the options of a curated hidden `region` facet.
+- `regionsByRental(tree)` maps each rental id to every region holding it, ancestors included,
+  for the `regions` of `cardSource`. `?region=<id>` then also finds the subregions' rentals.
+- The types `RegionChoice`, `RegionOptionsInput` and `RegionTree`.
+
+## Changed
+
+- Nothing for existing code. Without a region tree, regions work as before.

package/instructions/versions/1.3.0/MIGRATION.md

@@ -0,0 +1,10 @@
+# Migration: 1.2.0 to 1.3.0
+
+No changes required. To take a site's regions from the region tree, see
+`@v-office/website-sdk`'s `regions.md` (website-sdk 2.37.1 or later).
+
+## 1. Upgrade
+
+```sh
+pnpm add --save-exact @v-office/website-headless@1.3.0
+```

package/instructions/versions/1.3.0/release.json

@@ -0,0 +1,3 @@
+{
+  "componentsAffectedByHeadlessChange": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-office/website-headless",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "Framework-free behaviour layer for v-office websites, never UI: stores, pure rules and SDK runners for the search bar, results, map, showcase, quote, checkout and contact form, the rental and card models, and progressive-enhancement engines for server-rendered markup (./enhance)",
   "license": "UNLICENSED",
   "repository": {
@@ -26,7 +26,7 @@
   },
   "devDependencies": {
     "@types/node": "26.5.1",
-    "@v-office/website-sdk": "2.34.0",
+    "@v-office/website-sdk": "2.37.1",
     "effect": "4.0.0-rc.115",
     "jsdom": "^30.0.1",
     "oxfmt": "0.67.0",