@v-office/website-sdk 2.21.0 → 2.23.0

package/dist/{to-rental-highlights-CN-wpRh3.mjs → to-rental-highlights-C1NF2uuE.mjs}

@@ -1650,7 +1650,7 @@ const documents = {
 			}
 		}]
 	},
-	"\n  query CoreSDK_Search(\n    $first: Int!\n    $page: Int\n    $language: String\n    $vofficeData: VofficeData\n    $basicQueryInputs: [BasicQueryInput!]\n    $dataAttributes: [String!]! = []\n  ) {\n    search(\n      first: $first\n      page: $page\n      language: $language\n      voffice: $vofficeData\n      data: $basicQueryInputs\n    ) {\n      paginatorInfo {\n        hasMorePages\n        currentPage\n      }\n      data {\n        voffice_id\n        voffice_images {\n          id\n          path\n          title\n          description\n        }\n        voffice_room_images {\n          id\n          path\n          name\n          title\n          description\n        }\n        additional_voffice_data {\n          foundExactMatch\n          alternatives {\n            fromdate\n            tilldate\n            calc {\n              total\n              rent\n              summary\n              oTotal\n              oRent\n              oSummary\n              discountName\n            }\n          }\n          matchingPeriods {\n            fromdate\n            tilldate\n            calc {\n              total\n              rent\n              summary\n              oTotal\n              oRent\n              oSummary\n              discountName\n            }\n          }\n          calc {\n            total\n            rent\n            summary\n            oTotal\n            oRent\n            oSummary\n            discountName\n          }\n        }\n        data(attributes: $dataAttributes)\n      }\n    }\n  }\n": {
+	"\n  query CoreSDK_Search(\n    $first: Int!\n    $page: Int\n    $language: String\n    $vofficeData: VofficeData\n    $basicQueryInputs: [BasicQueryInput!]\n    $dataAttributes: [String!]! = []\n  ) {\n    search(\n      first: $first\n      page: $page\n      language: $language\n      voffice: $vofficeData\n      data: $basicQueryInputs\n    ) {\n      paginatorInfo {\n        hasMorePages\n        currentPage\n        total\n      }\n      data {\n        voffice_id\n        voffice_images {\n          id\n          path\n          title\n          description\n        }\n        voffice_room_images {\n          id\n          path\n          name\n          title\n          description\n        }\n        additional_voffice_data {\n          foundExactMatch\n          alternatives {\n            fromdate\n            tilldate\n            calc {\n              total\n              rent\n              summary\n              oTotal\n              oRent\n              oSummary\n              discountName\n            }\n          }\n          matchingPeriods {\n            fromdate\n            tilldate\n            calc {\n              total\n              rent\n              summary\n              oTotal\n              oRent\n              oSummary\n              discountName\n            }\n          }\n          calc {\n            total\n            rent\n            summary\n            oTotal\n            oRent\n            oSummary\n            discountName\n          }\n        }\n        data(attributes: $dataAttributes)\n      }\n    }\n  }\n": {
 		kind: "Document",
 		definitions: [{
 			kind: "OperationDefinition",
@@ -1875,19 +1875,29 @@ const documents = {
 							},
 							selectionSet: {
 								kind: "SelectionSet",
-								selections: [{
-									kind: "Field",
-									name: {
-										kind: "Name",
-										value: "hasMorePages"
-									}
-								}, {
-									kind: "Field",
-									name: {
-										kind: "Name",
-										value: "currentPage"
+								selections: [
+									{
+										kind: "Field",
+										name: {
+											kind: "Name",
+											value: "hasMorePages"
+										}
+									},
+									{
+										kind: "Field",
+										name: {
+											kind: "Name",
+											value: "currentPage"
+										}
+									},
+									{
+										kind: "Field",
+										name: {
+											kind: "Name",
+											value: "total"
+										}
 									}
-								}]
+								]
 							}
 						}, {
 							kind: "Field",
@@ -2274,6 +2284,287 @@ const documents = {
 				}]
 			}
 		}]
+	},
+	"\n  query CoreSDK_MapSearch(\n    $first: Int!\n    $page: Int\n    $language: String\n    $vofficeData: VofficeData\n    $basicQueryInputs: [BasicQueryInput!]\n    $dataAttributes: [String!]! = []\n  ) {\n    search(\n      first: $first\n      page: $page\n      language: $language\n      voffice: $vofficeData\n      data: $basicQueryInputs\n    ) {\n      paginatorInfo {\n        hasMorePages\n        total\n      }\n      data {\n        voffice_id\n        data(attributes: $dataAttributes)\n      }\n    }\n  }\n": {
+		kind: "Document",
+		definitions: [{
+			kind: "OperationDefinition",
+			operation: "query",
+			name: {
+				kind: "Name",
+				value: "CoreSDK_MapSearch"
+			},
+			variableDefinitions: [
+				{
+					kind: "VariableDefinition",
+					variable: {
+						kind: "Variable",
+						name: {
+							kind: "Name",
+							value: "first"
+						}
+					},
+					type: {
+						kind: "NonNullType",
+						type: {
+							kind: "NamedType",
+							name: {
+								kind: "Name",
+								value: "Int"
+							}
+						}
+					}
+				},
+				{
+					kind: "VariableDefinition",
+					variable: {
+						kind: "Variable",
+						name: {
+							kind: "Name",
+							value: "page"
+						}
+					},
+					type: {
+						kind: "NamedType",
+						name: {
+							kind: "Name",
+							value: "Int"
+						}
+					}
+				},
+				{
+					kind: "VariableDefinition",
+					variable: {
+						kind: "Variable",
+						name: {
+							kind: "Name",
+							value: "language"
+						}
+					},
+					type: {
+						kind: "NamedType",
+						name: {
+							kind: "Name",
+							value: "String"
+						}
+					}
+				},
+				{
+					kind: "VariableDefinition",
+					variable: {
+						kind: "Variable",
+						name: {
+							kind: "Name",
+							value: "vofficeData"
+						}
+					},
+					type: {
+						kind: "NamedType",
+						name: {
+							kind: "Name",
+							value: "VofficeData"
+						}
+					}
+				},
+				{
+					kind: "VariableDefinition",
+					variable: {
+						kind: "Variable",
+						name: {
+							kind: "Name",
+							value: "basicQueryInputs"
+						}
+					},
+					type: {
+						kind: "ListType",
+						type: {
+							kind: "NonNullType",
+							type: {
+								kind: "NamedType",
+								name: {
+									kind: "Name",
+									value: "BasicQueryInput"
+								}
+							}
+						}
+					}
+				},
+				{
+					kind: "VariableDefinition",
+					variable: {
+						kind: "Variable",
+						name: {
+							kind: "Name",
+							value: "dataAttributes"
+						}
+					},
+					type: {
+						kind: "NonNullType",
+						type: {
+							kind: "ListType",
+							type: {
+								kind: "NonNullType",
+								type: {
+									kind: "NamedType",
+									name: {
+										kind: "Name",
+										value: "String"
+									}
+								}
+							}
+						}
+					},
+					defaultValue: {
+						kind: "ListValue",
+						values: []
+					}
+				}
+			],
+			selectionSet: {
+				kind: "SelectionSet",
+				selections: [{
+					kind: "Field",
+					name: {
+						kind: "Name",
+						value: "search"
+					},
+					arguments: [
+						{
+							kind: "Argument",
+							name: {
+								kind: "Name",
+								value: "first"
+							},
+							value: {
+								kind: "Variable",
+								name: {
+									kind: "Name",
+									value: "first"
+								}
+							}
+						},
+						{
+							kind: "Argument",
+							name: {
+								kind: "Name",
+								value: "page"
+							},
+							value: {
+								kind: "Variable",
+								name: {
+									kind: "Name",
+									value: "page"
+								}
+							}
+						},
+						{
+							kind: "Argument",
+							name: {
+								kind: "Name",
+								value: "language"
+							},
+							value: {
+								kind: "Variable",
+								name: {
+									kind: "Name",
+									value: "language"
+								}
+							}
+						},
+						{
+							kind: "Argument",
+							name: {
+								kind: "Name",
+								value: "voffice"
+							},
+							value: {
+								kind: "Variable",
+								name: {
+									kind: "Name",
+									value: "vofficeData"
+								}
+							}
+						},
+						{
+							kind: "Argument",
+							name: {
+								kind: "Name",
+								value: "data"
+							},
+							value: {
+								kind: "Variable",
+								name: {
+									kind: "Name",
+									value: "basicQueryInputs"
+								}
+							}
+						}
+					],
+					selectionSet: {
+						kind: "SelectionSet",
+						selections: [{
+							kind: "Field",
+							name: {
+								kind: "Name",
+								value: "paginatorInfo"
+							},
+							selectionSet: {
+								kind: "SelectionSet",
+								selections: [{
+									kind: "Field",
+									name: {
+										kind: "Name",
+										value: "hasMorePages"
+									}
+								}, {
+									kind: "Field",
+									name: {
+										kind: "Name",
+										value: "total"
+									}
+								}]
+							}
+						}, {
+							kind: "Field",
+							name: {
+								kind: "Name",
+								value: "data"
+							},
+							selectionSet: {
+								kind: "SelectionSet",
+								selections: [{
+									kind: "Field",
+									name: {
+										kind: "Name",
+										value: "voffice_id"
+									}
+								}, {
+									kind: "Field",
+									name: {
+										kind: "Name",
+										value: "data"
+									},
+									arguments: [{
+										kind: "Argument",
+										name: {
+											kind: "Name",
+											value: "attributes"
+										},
+										value: {
+											kind: "Variable",
+											name: {
+												kind: "Name",
+												value: "dataAttributes"
+											}
+										}
+									}]
+								}]
+							}
+						}]
+					}
+				}]
+			}
+		}]
 	}
 };
 function graphql(source) {
@@ -2471,6 +2762,7 @@ const searchQuery = graphql(`
       paginatorInfo {
         hasMorePages
         currentPage
+        total
       }
       data {
         voffice_id
@@ -2530,6 +2822,33 @@ const searchQuery = graphql(`
     }
   }
 `);
+const mapSearchQuery = graphql(`
+  query CoreSDK_MapSearch(
+    $first: Int!
+    $page: Int
+    $language: String
+    $vofficeData: VofficeData
+    $basicQueryInputs: [BasicQueryInput!]
+    $dataAttributes: [String!]! = []
+  ) {
+    search(
+      first: $first
+      page: $page
+      language: $language
+      voffice: $vofficeData
+      data: $basicQueryInputs
+    ) {
+      paginatorInfo {
+        hasMorePages
+        total
+      }
+      data {
+        voffice_id
+        data(attributes: $dataAttributes)
+      }
+    }
+  }
+`);
 //#endregion
 //#region src/legacy-v9/parser/rentals/to-localized-string.ts
 const isNonEmptyString$1 = (value) => typeof value === "string" && value.length > 0;
@@ -2730,6 +3049,16 @@ const toFacilityImages = (images, locale) => images.flatMap((image) => {
 	return [item];
 });
 //#endregion
+//#region src/legacy-v9/parser/rentals/to-location.ts
+const toLocation = (location) => {
+	if (location == null) return void 0;
+	const [longitude, latitude] = location.coordinates;
+	return {
+		latitude,
+		longitude
+	};
+};
+//#endregion
 //#region src/legacy-v9/parser/rentals/render-property-attribute.ts
 const countLabelKey = (labelKey, value) => `${labelKey.slice(0, -6)}.count.${value === 1 ? "one" : "other"}`;
 const renderVofficePropertyAttribute = ({ key, metadata, locale, translate, value }) => Effect.gen(function* () {
@@ -3143,4 +3472,4 @@ const toRentalHighlights = ({ locale, translations, highlightPrioritization, cus
 	return highlights;
 });
 //#endregion
-export { toAddress as a, rentalFacilitiesForObjectGroupRelationQuery as c, rentalsAllFeedbacksQuery as d, rentalsAllWithoutFeedbacksQuery as f, toImages as i, rentalIdsQuery as l, renderVofficePropertyAttribute as n, toLocalizedString as o, toFacilityImages as r, searchQuery as s, toRentalHighlights as t, rentalsAllByFacilityObjectGroupsWithoutFeedbacksQuery as u };
+export { toFacilityImages as a, toLocalizedString as c, rentalFacilitiesForObjectGroupRelationQuery as d, rentalIdsQuery as f, rentalsAllWithoutFeedbacksQuery as h, toLocation as i, mapSearchQuery as l, rentalsAllFeedbacksQuery as m, toV9RentalHighlightKey as n, toImages as o, rentalsAllByFacilityObjectGroupsWithoutFeedbacksQuery as p, renderVofficePropertyAttribute as r, toAddress as s, toRentalHighlights as t, searchQuery as u };

package/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 Release notes of `@v-office/website-sdk`, newest first. Each version has its own directory.
 
+- `versions/2.23.0/CHANGELOG.md`: release notes for 2.23.0
+- `versions/2.22.0/CHANGELOG.md`: release notes for 2.22.0
 - `versions/2.21.0/CHANGELOG.md`: release notes for 2.21.0
 - `versions/2.20.4/CHANGELOG.md`: release notes for 2.20.4
 - `versions/2.20.3/CHANGELOG.md`: release notes for 2.20.3

package/instructions/MIGRATION.md

@@ -4,6 +4,8 @@
 
 Migration guides of `@v-office/website-sdk`, newest first. Apply them in order when skipping versions.
 
+- `versions/2.23.0/MIGRATION.md`: Migration: 2.22.0 to 2.23.0
+- `versions/2.22.0/MIGRATION.md`: Migration: 2.21.0 to 2.22.0
 - `versions/2.21.0/MIGRATION.md`: Migration: 2.20.4 to 2.21.0
 - `versions/2.20.4/MIGRATION.md`: Migration: 2.20.3 to 2.20.4
 - `versions/2.20.3/MIGRATION.md`: Migration: 2.20.2 to 2.20.3

package/instructions/creation.md

@@ -110,9 +110,14 @@ type WebsiteSDKOptions = {
   rentalPropertyHighlightPrioritization?: readonly RentalPropertyHighlightPrioritizationKey[];
   rentalScope?: RentalScope;
   shouldAddProposedAdditionalServiceAmount?: boolean;
+  searchAllRentalsAtOnce?: boolean;
 };
 ```
 
+`searchAllRentalsAtOnce` selects how a site searches, on v9 and v10 alike: every
+result with prices in one call (portfolios of up to 100 rentals), or paged results
+plus `mapSearch`. See `search.md`.
+
 `rentalHighlightPrioritization` and `rentalPropertyHighlightPrioritization` select
 which facts become highlights and set their order. They are ordered allowlists, not
 sorts over every available fact. A key that is not listed is not emitted even when
@@ -135,6 +140,7 @@ Unset options are normalized by the SDK:
 - `rentalPropertyHighlightPrioritization` defaults to the SDK default property highlight selection.
 - `rentalScope` defaults to `{}`.
 - `shouldAddProposedAdditionalServiceAmount` defaults to `false`.
+- `searchAllRentalsAtOnce` defaults to `false`.
 - `translationOverrides` is omitted unless provided.
 
 ### v9 Property Highlight Sources

package/instructions/search.md

@@ -374,6 +374,38 @@ requested locale; backend numeric amounts and modifier type keys are not exposed
 individual modifier lines. Exact-period results are returned in `items`;
 alternative-period suggestions are returned in root-level `alternatives`.
 
+On legacy v9 only, an exact match may include `matchingPeriods` when the backend
+chose the dates itself in a window search (`start`/`end` plus `minNights`/`maxNights`).
+The field exists only on the v9 facade: `sdk.live.search.search` of a
+`WebsiteSDKV9` returns `V9SearchSearchOutput`, whose items are
+`V9SearchSearchOutputItem`. Narrow on `sdk.backend === "v9"` to read it. Each entry has the same shape as an `alternativePeriods` entry: `start`, `end`,
+and the optional `formattedTotal` and `discount` for that period. Entries keep the
+backend order. The item's own `formattedTotal` and `discount` are the price of the
+first entry when that entry has one; otherwise they are the backend's overall price
+for the hit. Show `matchingPeriods[0]` as the dates the card price is for, and open
+the rental page with those dates so card and detail price agree. For a
+fixed-period search without a window, the dates are the requested ones and
+`matchingPeriods` is absent, never an empty array.
+
+```json
+{
+  "id": "214950",
+  "nameOrLabel": "Ferienhaus Seeblick",
+  "timeZone": "Europe/Berlin",
+  "formattedTotal": "1.144,10 €",
+  "matchingPeriods": [
+    {
+      "start": "2026-10-01",
+      "end": "2026-10-08",
+      "formattedTotal": "1.144,10 €"
+    }
+  ]
+}
+```
+
+`pageInfo.totalCount` is the number of rentals the backend matched for the search
+over all pages.
+
 `appliedFilters` reports what the backend actually applied, and is what a "remove
 this filter" chip should be built from. `label` is localized presentation and can
 repeat, so it cannot identify a filter; `key` plus `value` can. `value` is the
@@ -395,6 +427,84 @@ the expanded leaf entries. A UI may collapse those leaves under the composition
 display, but should keep the returned keys and canonical values when removing direct
 filters.
 
+## All Rentals At Once Or Map Search
+
+A search that prices many results is slow the first time the backend sees it, and
+a list next to a map should not wait for every price. An SDK therefore works in one
+of two modes, chosen with the `searchAllRentalsAtOnce` option (default `false`).
+Both modes behave the same on v9 and v10, so a site keeps its code when it moves
+from one backend to the other.
+
+### `searchAllRentalsAtOnce: true`
+
+For portfolios of up to `SEARCH_ALL_RENTALS_AT_ONCE_MAX_RESULTS` (100) rentals.
+`sdk.live.search.search` returns every result with its price in one call, so a list
+and a map can show all results with prices at the same time:
+
+```ts
+const sdk = createWebsiteSDK({ config, options: { searchAllRentalsAtOnce: true } });
+const output = await sdk.live.search.search({ locale: "de-DE", query: "adults=2" });
+// output.pageInfo: { hasNextPage: false, totalCount }
+```
+
+- The input has no `cursor` and no `limit`; passing either rejects the call with a
+  `CoreSDKError` whose `operation` is `search.allRentalsAtOnce`.
+- When the search matches more than 100 rentals, the call rejects with the same
+  `operation`. Use the default mode for such a portfolio.
+- `mapSearch` is not available: with `searchAllRentalsAtOnce: true` written in the
+  code, the returned `WebsiteSDKV9AllRentalsAtOnce`, `WebsiteSDKV10AllRentalsAtOnce`
+  or `WebsiteSDKAllRentalsAtOnce` type has no `mapSearch` and no `cursor`/`limit`;
+  when the value is only known at runtime, `mapSearch` rejects with the `operation`
+  `search.mapSearch`.
+- The call counts as one request for the search rate limit.
+
+### `searchAllRentalsAtOnce: false` (default)
+
+`sdk.live.search.search` is paged as before. `sdk.live.search.mapSearch` returns
+every rental the search matches, with its location and without prices:
+
+```ts
+const map = await sdk.live.search.mapSearch({ locale: "de-DE", query: "adults=2" });
+// map: { items: { id, location? }[], totalCount, appliedFilters, unusedFilterKeys }
+```
+
+`mapSearch` takes the same `query` as `search`, so map and list use the same
+filters. Because it arrives before any result is priced, its `totalCount` can also
+decide how to load the list: at most `SEARCH_ALL_RENTALS_AT_ONCE_MAX_RESULTS`
+matches can be loaded in one `search` call with that `limit` and shown with prices on
+the map (matched by `id`); more matches are paged, with a map without prices.
+
+```ts
+const map = await sdk.live.search.mapSearch({ locale, query });
+if (map.totalCount <= SEARCH_ALL_RENTALS_AT_ONCE_MAX_RESULTS) {
+  const all = await sdk.live.search.search({
+    locale,
+    query,
+    limit: SEARCH_ALL_RENTALS_AT_ONCE_MAX_RESULTS,
+  });
+} else {
+  const page = await sdk.live.search.search({ locale, query, limit: 24, cursor });
+}
+```
+
+In this mode a `search` call is one backend request, whatever its `limit`.
+
+### How each backend does it
+
+- v9 prices the rentals of one request one after another, but separate requests in
+  parallel. `searchAllRentalsAtOnce` counts the matches without prices first, then
+  fetches the priced results as backend pages of ten, at most eight at a time, and
+  merges them in backend order; an oversized search is refused before any price is
+  requested. When a booking between the requests moves rentals across page
+  boundaries, the pages disagree with the count; the SDK then asks for all results in
+  one request, a consistent snapshot, instead of returning a set with a gap. `mapSearch` selects no prices and loads up to 1,000 matches per request,
+  as many requests as the matches need.
+- v10 answers the whole result set in one request. `searchAllRentalsAtOnce` asks for
+  101 results and refuses the search when the response total is above 100.
+  `mapSearch` is one request without prices that returns only the location, for up
+  to 1,000 matches: the backend's result window, so `items` holds at most 1,000
+  rentals while `totalCount` can be higher.
+
 ## Backend Behavior
 
 ### v10
@@ -421,6 +531,10 @@ projection:
   and booking flow.
 - Pagination uses the backend `from`/`size` window behind the same opaque `cursor`,
   capped at 1,000 results.
+- v10 items have no `matchingPeriods`. A v10 hit counts as exact only when its period
+  equals the requested fixed period; a hit the backend priced for other dates,
+  including every hit of a `minNights`/`maxNights` window search, is returned in
+  `alternatives` with its dates in `alternativePeriods`.
 
 ### Legacy v9
 
@@ -442,7 +556,16 @@ shape:
   formatted original total.
 - The same mapping applies to exact-period items and individual alternative
   periods.
+- For an exact match, every `additional_voffice_data.matchingPeriods` entry with
+  both dates becomes a `matchingPeriods` entry (`fromdate`/`tilldate` become
+  `start`/`end`, its `calc` becomes the period's price fields); entries without
+  dates are dropped. In a window search the guest enters a window and a stay
+  length, not the stay itself. The backend returns the bookable stays inside the
+  window, earliest first; the SDK keeps that order.
 - v9 never executes a custom-attribute search filter.
+- A search requests only the rental data the search output reads: `name`,
+  `address`, `regionName`, `images`, the attribute behind each configured rental
+  highlight, the configured custom attributes and `rentalDataAttributes`.
 
 The field is omitted when v9 returns no final total or when its original total is
 not greater than the final total. v9 exposes at most one aggregated applied entry,
@@ -454,7 +577,7 @@ Use flat `WebsiteSDKConfig` files and optional `WebsiteSDKOptions`.
 
 For v10, config requires `searchEndpoint` (the full REST search URL) as of 2.5.0. See `creation.md` for `searchEndpoint` and the `customAttributes` option.
 
-Custom filter definitions can extend accepted search query keys. Search requests are rate-limited to one backend request per second with a queue size of five.
+Custom filter definitions can extend accepted search query keys. Search requests are rate-limited to one backend request per second with a queue size of five. A `searchAllRentalsAtOnce` search and a `mapSearch` each count as one request, including every backend request they make.
 
 ## CLI Usage
 

package/instructions/versions/2.22.0/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog: 2.22.0
+
+On a v9 hub, a search over a date window (`start`/`end` with `minNights`/`maxNights`)
+lets the hub pick the stay itself: the earliest bookable stay in the window. Such a hit came back as an exact result with a price but without the
+dates that price was for. A site could only link the rental page with the
+window the guest typed, and the detail page then showed a different price than
+the card.
+
+## Added
+
+- `v9`: exact search results carry `matchingPeriods` when the hub chose the
+  dates. Each entry has `start`, `end` and the optional `formattedTotal` and
+  `discount` for that period, in the hub's order. The field is absent for a
+  fixed-period search, never an empty array.
+- Types `V9SearchSearchOutput` and `V9SearchSearchOutputItem`.
+  `sdk.live.search.search` of a `WebsiteSDKV9` now returns
+  `V9SearchSearchOutput`; narrow on `sdk.backend === "v9"` to read
+  `matchingPeriods`.
+
+## Changed
+
+- `v9`: the `formattedTotal` and `discount` of an exact result are the price of
+  its first `matchingPeriods` entry when that entry has a price.
+
+## Unchanged
+
+- Fixed-period searches on v9: same items, same prices, no new field.
+- Alternatives and their `alternativePeriods`.
+- The v10 backend. v10 items have no `matchingPeriods`; a v10 hit for other
+  dates than the requested ones is still returned in `alternatives`.

package/instructions/versions/2.22.0/MIGRATION.md

@@ -0,0 +1,27 @@
+# Migration: 2.21.0 to 2.22.0
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.22.0
+```
+
+No changes are required. The v9 search result type is a superset of the
+previous one, so existing code compiles and renders as before.
+
+## 2. Show the dates of a window-search hit (`v9`)
+
+A v9 site that offers a date window with a night range should show
+`matchingPeriods[0]` on the result card as the dates the price is for, and open
+the rental page with those dates instead of the typed window. Card and detail
+page then show the same price.
+
+```ts
+if (sdk.backend === "v9") {
+  const output = await sdk.live.search.search(input);
+  for (const item of output.items) {
+    const period = item.matchingPeriods?.[0];
+    // period?.start, period?.end: dates for the card and the rental link
+  }
+}
+```

package/instructions/versions/2.22.0/release.json

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