@v-office/website-headless 1.2.0 → 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`,
@@ -1793,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/index.d.mts

@@ -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`. */
@@ -2804,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 = {
@@ -8957,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,7 @@
 
 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

package/instructions/MIGRATION.md

@@ -4,6 +4,7 @@
 
 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

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.2.0",
+  "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",