@v-office/website-sdk 2.5.1 → 2.8.0

package/dist/{search-9yzAqHCg.mjs → search-Dzzra6IW.mjs}

@@ -1,133 +1,7 @@
-import { n as stable_filters_default } from "./client-C5ojrNQA.mjs";
-import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-CxWlq76f.mjs";
-import { CoreSDKError, STABLE_SEARCH_INPUTS, collectQueryParameters, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, parseQueryParameters, toCustomAttributeFilterLabel, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toQueryString, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
+import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-BNbBfJtO.mjs";
+import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-OvNe9ZQS.mjs";
+import { CoreSDKError, STABLE_SEARCH_INPUTS, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, resolveExpandedCompositions, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
 import { Effect } from "effect";
-//#region src/legacy-v9/parser/search/input/filter/apply-voffice-filter-derived-basic-query-inputs.ts
-const hasBasicQueryInput = ({ basicQueryInputs, key }) => basicQueryInputs.some((input) => input.key === key);
-const derivedBooleanFilters = [{
-	key: "pets",
-	isSelected: (filter) => (filter.petsCount ?? 0) > 0
-}];
-const applyVofficeFilterDerivedBasicQueryInputs = ({ appliedFilters, basicQueryInputs, filter, locale, translations }) => Effect.gen(function* () {
-	const nextAppliedFilters = [...appliedFilters];
-	const nextBasicQueryInputs = [...basicQueryInputs];
-	for (const derivedFilter of derivedBooleanFilters) {
-		if (!derivedFilter.isSelected(filter) || hasBasicQueryInput({
-			basicQueryInputs: nextBasicQueryInputs,
-			key: derivedFilter.key
-		})) continue;
-		nextBasicQueryInputs.push({
-			key: derivedFilter.key,
-			value: true
-		});
-		nextAppliedFilters.push({
-			key: derivedFilter.key,
-			label: yield* translations.translate(locale, `filter.${derivedFilter.key}.label`, derivedFilter.key)
-		});
-	}
-	return {
-		appliedFilters: nextAppliedFilters,
-		basicQueryInputs: nextBasicQueryInputs
-	};
-});
-//#endregion
-//#region src/legacy-v9/parser/search/input/filter/filter-query-keys.ts
-const FILTER_QUERY_KEYS = new Set(Object.keys(stable_filters_default));
-//#endregion
-//#region src/legacy-v9/parser/search/input/filter/to-basic-query-inputs.ts
-const isEnabledBooleanFilter = (value) => {
-	const normalizedValue = value.toLowerCase();
-	return normalizedValue === "" || normalizedValue === "true" || normalizedValue === "1";
-};
-const toBasicQueryInput = ({ queryKey, value, filter }) => {
-	if (filter.type === "BooleanFilter") return isEnabledBooleanFilter(value) ? {
-		key: queryKey,
-		value: true
-	} : void 0;
-	if (filter.type === "InputFilter") {
-		const numberValue = Number(value);
-		if (!Number.isInteger(numberValue) || numberValue < 0) return;
-		return {
-			key: queryKey,
-			value: numberValue
-		};
-	}
-};
-const toCustomBackendFilterInput = ({ queryKey, value, filter }) => {
-	switch (filter.type) {
-		case "boolean": return isEnabledBooleanFilter(value) ? {
-			key: queryKey,
-			value: true
-		} : void 0;
-		case "int": {
-			const numberValue = Number(value);
-			return Number.isInteger(numberValue) && numberValue >= 0 ? {
-				key: queryKey,
-				value: numberValue
-			} : void 0;
-		}
-		case "string": return value.length > 0 ? {
-			key: queryKey,
-			value
-		} : void 0;
-		case "option": return filter.options.some((option) => option.value === value) ? {
-			key: queryKey,
-			value
-		} : void 0;
-	}
-};
-const toBasicQueryInputs = ({ query, customAttributeFilterDefinitions, locale, translations }) => {
-	const appliedFilterEffects = [];
-	const basicQueryInputs = [];
-	const remainingParameters = [];
-	const seenScalarFilters = /* @__PURE__ */ new Set();
-	const customBackendFiltersByKey = new Map(customAttributeFilterDefinitions.filter((definition) => definition.source === "backendFilter" && definition.searchable).map((definition) => [definition.key, definition]));
-	for (const [queryKey, value] of parseQueryParameters(query)) {
-		const filter = stable_filters_default[queryKey];
-		const customBackendFilter = customBackendFiltersByKey.get(queryKey);
-		if ((!FILTER_QUERY_KEYS.has(queryKey) || filter == null) && customBackendFilter == null) {
-			remainingParameters.push([queryKey, value]);
-			continue;
-		}
-		if (seenScalarFilters.has(queryKey)) {
-			remainingParameters.push([queryKey, value]);
-			continue;
-		}
-		const basicQueryInput = filter == null ? customBackendFilter != null ? toCustomBackendFilterInput({
-			queryKey,
-			value,
-			filter: customBackendFilter
-		}) : void 0 : toBasicQueryInput({
-			queryKey,
-			value,
-			filter
-		});
-		if (basicQueryInput == null) {
-			remainingParameters.push([queryKey, value]);
-			continue;
-		}
-		seenScalarFilters.add(queryKey);
-		basicQueryInputs.push(basicQueryInput);
-		if (customBackendFilter != null) appliedFilterEffects.push(Effect.succeed({
-			key: queryKey,
-			label: toCustomAttributeFilterLabel({
-				definition: customBackendFilter,
-				locale,
-				value
-			})
-		}));
-		else appliedFilterEffects.push(translations.translate(locale, `filter.${queryKey}.label`, queryKey).pipe(Effect.map((label) => ({
-			key: queryKey,
-			label
-		}))));
-	}
-	return {
-		appliedFilters: Effect.all(appliedFilterEffects),
-		basicQueryInputs,
-		remainingQuery: toQueryString(remainingParameters)
-	};
-};
-//#endregion
 //#region src/legacy-v9/parser/search/input/search-input-error.ts
 const failInvalidV9SearchInput = (message) => Effect.fail(new CoreSDKError({
 	source: "v10",
@@ -305,6 +179,7 @@ const toVofficeSorting = (sort) => {
 //#region src/legacy-v9/parser/search/input/to-query-input.ts
 const toQueryInput = ({ query, sort, customAttributeFilterDefinitions, locale, translations }) => Effect.gen(function* () {
 	const compositionResult = expandCustomAttributeFilterCompositions({
+		capabilities: makeV9CustomAttributeFilterCapabilities(customAttributeFilterDefinitions),
 		customAttributeFilterDefinitions,
 		locale,
 		query
@@ -330,8 +205,16 @@ const toQueryInput = ({ query, sort, customAttributeFilterDefinitions, locale, t
 		locale,
 		translations
 	});
+	const compositionFilters = resolveExpandedCompositions({
+		compositions: compositionResult.compositions,
+		unusedFilterKeys: [
+			...compositionResult.unusedFilterKeys,
+			...occupancyResult?.unusedFilterKeys ?? [],
+			...toUnusedFilterKeys(basicQueryResult.remainingQuery)
+		]
+	});
 	return {
-		appliedFilters: [...compositionResult.appliedFilters, ...appliedFilters],
+		appliedFilters: [...compositionFilters.appliedFilters, ...appliedFilters],
 		queryInput: {
 			vofficeData: {
 				filter: Object.keys(filter).length > 0 ? filter : void 0,
@@ -340,7 +223,7 @@ const toQueryInput = ({ query, sort, customAttributeFilterDefinitions, locale, t
 			},
 			basicQueryInputs
 		},
-		unusedFilterKeys: [...occupancyResult?.unusedFilterKeys ?? [], ...toUnusedFilterKeys(basicQueryResult.remainingQuery)]
+		unusedFilterKeys: compositionFilters.unusedFilterKeys
 	};
 });
 //#endregion
@@ -356,7 +239,7 @@ const toFormattedPrice = ({ locale, calc }) => {
 };
 //#endregion
 //#region src/legacy-v9/parser/search/to-search-output-item.ts
-const toSearchOutputItem = ({ locale, imageProxyBaseUrl, rentalHighlightPrioritization, customAttributeFilterDefinitions, rental, translations, includeFormattedTotal }) => Effect.gen(function* () {
+const toSearchOutputItem = ({ locale, imageProxyBaseUrl, rentalHighlightPrioritization, customAttributes, rental, translations, includeFormattedTotal }) => Effect.gen(function* () {
 	const data = parseVofficeUnitData(rental.data);
 	const item = {
 		id: rental.voffice_id.toString(),
@@ -371,7 +254,7 @@ const toSearchOutputItem = ({ locale, imageProxyBaseUrl, rentalHighlightPrioriti
 		locale,
 		translations,
 		highlightPrioritization: rentalHighlightPrioritization,
-		customAttributeFilterDefinitions,
+		customAttributes,
 		attributes: data
 	});
 	if (highlights != null) item.highlights = highlights;

package/dist/{to-rental-highlights-CxWlq76f.mjs → to-rental-highlights-OvNe9ZQS.mjs}

@@ -1,4 +1,4 @@
-import { localeToLanguage, makeTranslate, renderCustomAttributeHighlight, renderLabeledAttributeValue, toCountry } from "@v-office/sdk-core";
+import { localeToLanguage, makeTranslate, renderLabeledAttributeValue, renderResolvedCustomAttribute, toCountry } from "@v-office/sdk-core";
 import { Effect, Schema } from "effect";
 //#region codegen/v9/heuristic-generation/v9-data.ts
 /**
@@ -5870,7 +5870,7 @@ const toV9RentalHighlightKey = (key) => {
 };
 //#endregion
 //#region src/legacy-v9/parser/rentals/to-rental-highlights.ts
-const toRentalHighlights = ({ locale, translations, highlightPrioritization, customAttributeFilterDefinitions, attributes }) => Effect.gen(function* () {
+const toRentalHighlights = ({ locale, translations, highlightPrioritization, customAttributes, attributes }) => Effect.gen(function* () {
 	const highlights = [];
 	const seenKeys = /* @__PURE__ */ new Set();
 	const knownAttributes = attributes.known;
@@ -5880,11 +5880,13 @@ const toRentalHighlights = ({ locale, translations, highlightPrioritization, cus
 		if (v9Key == null) {
 			if (seenKeys.has(highlightKey)) continue;
 			seenKeys.add(highlightKey);
-			const highlight = renderCustomAttributeHighlight({
-				definitions: customAttributeFilterDefinitions,
-				key: highlightKey,
+			const attribute = customAttributes.byKey[highlightKey];
+			if (attribute === void 0) continue;
+			const binding = attribute.v9;
+			const highlight = renderResolvedCustomAttribute({
+				attribute,
 				locale,
-				value: knownAttributes[highlightKey] ?? attributes.unknown[highlightKey]
+				value: binding === void 0 ? void 0 : knownAttributes[binding] ?? attributes.unknown[binding]
 			});
 			if (highlight != null) highlights.push(highlight);
 			continue;

package/dist/translations/v10/de-DE/core.json

@@ -5077,6 +5077,8 @@
   "RentalAttributesCategory.MEDIA.label": "Medien",
   "RentalAttributesCategory.OTHER.label": "Andere",
   "RentalAttributesCategory.OUTDOORS.label": "Außenbereich",
+  "RentalAttributesCategory.roomSummary.label": "Zimmer",
+  "RentalAttributesCategory.vicinity.label": "Umgebung",
   "RentalAttributesCategory.PRACTICAL_NECESSITIES.label": "Praktische Notwendigkeiten",
   "RentalAttributesCategory.PROPERTY_DETAILS_RULES.label": "Objektdetails & Regeln",
   "RentalAttributesCategory.PROPERTY_TYPE_LOCATION.label": "Unterkunftstyp & Standort",

package/dist/translations/v10/en-US/core.json

@@ -5077,6 +5077,8 @@
   "RentalAttributesCategory.MEDIA.label": "Media",
   "RentalAttributesCategory.OTHER.label": "Other",
   "RentalAttributesCategory.OUTDOORS.label": "Outdoor Area",
+  "RentalAttributesCategory.roomSummary.label": "Rooms",
+  "RentalAttributesCategory.vicinity.label": "Vicinity",
   "RentalAttributesCategory.PRACTICAL_NECESSITIES.label": "Practical Necessities",
   "RentalAttributesCategory.PROPERTY_DETAILS_RULES.label": "Property Details & Rules",
   "RentalAttributesCategory.PROPERTY_TYPE_LOCATION.label": "Property Type & Location",

package/instructions/CHANGELOG.md

@@ -4,6 +4,9 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.8.0/CHANGELOG.md`: `@v-office/website-sdk` 2.8.0 release notes.
+- `versions/2.7.0/CHANGELOG.md`: `@v-office/website-sdk` 2.7.0 release notes.
+- `versions/2.6.0/CHANGELOG.md`: compatibility note for an unreleased version label.
 - `versions/2.5.0/CHANGELOG.md`: `@v-office/website-sdk` 2.5.0 release notes.
 - `versions/2.4.3/CHANGELOG.md`: `@v-office/website-sdk` 2.4.3 documentation release notes.
 - `versions/2.4.2/CHANGELOG.md`: `@v-office/website-sdk` 2.4.2 release notes.

package/instructions/MIGRATION.md

@@ -4,6 +4,9 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.8.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.7.0 to 2.8.0.
+- `versions/2.7.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.5.x to 2.7.0.
+- `versions/2.6.0/MIGRATION.md`: compatibility note for an unreleased version label.
 - `versions/2.5.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.3 to 2.5.0.
 - `versions/2.4.3/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.2 to 2.4.3.
 - `versions/2.4.2/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.1 to 2.4.2.

package/instructions/README.md

@@ -1,12 +1,15 @@
 # Website SDK Instructions
 
-These instructions describe `@v-office/website-sdk` 2.5.0.
+These instructions describe the current source targeted for
+`@v-office/website-sdk` 2.8.0. Package versions remain unchanged until the release
+workflow performs the coordinated core and website bumps.
 
 Use this directory as the consumer-facing reference for the package:
 
 - `creation.md`: SDK construction, config, options, and CLI config files.
 - `rentals.md`: `sdk.static.rentals.getRentals`.
 - `filter.md`: `sdk.static.filter.getFilters`.
+- `custom-attributes.md`: custom attribute catalog, configuration, per-backend behaviour, and the v9-to-v10 move.
 - `search.md`: `sdk.live.search.search`.
 - `availability.md`: date-picker availability flows.
 - `quote.md`: quote, additional services, cancellation policy, and insurance flows.
@@ -15,6 +18,9 @@ Use this directory as the consumer-facing reference for the package:
 - `document-structured-json.md`: `sdk.static.documents.getTermsAndPrivacyPolicy` and structured document JSON rendering rules.
 - `CHANGELOG.md`: versioned changelog index.
 - `MIGRATION.md`: versioned migration index.
+- `versions/2.8.0/`: 2.8.0 custom-attribute release notes and 2.7.0-to-2.8.0 migration guide.
+- `versions/2.7.0/`: 2.7.0 release notes and 2.5.x-to-2.7.0 migration guide.
+- `versions/2.6.0/`: compatibility pointers for the unreleased 2.6.0 version label.
 - `versions/2.5.0/`: 2.5.0 release notes and 2.4.3-to-2.5.0 migration guide.
 - `versions/2.4.3/`: 2.4.3 documentation release notes and migration guide.
 - `versions/2.4.2/`: 2.4.2 release notes and 2.4.1-to-2.4.2 migration guide.
@@ -68,4 +74,4 @@ website-sdk --backend v10 search --locale de-DE --query "adults=2"
 website-sdk --backend v10 search --locale de-DE --query "adults=2" --sort '{"by":"field","orderBy":{"label":"ASC"}}'
 ```
 
-Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.5.0. v10 config additionally requires `searchEndpoint` as of 2.5.0.
+Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.8.0. v10 config additionally requires `searchEndpoint` as of 2.5.0.

package/instructions/booking.md

@@ -100,6 +100,13 @@ Sample:
           "provider": "adyen",
           "label": "Credit card",
           "url": "https://checkout.example.com"
+        },
+        {
+          "kind": "stripe_checkout",
+          "provider": "stripe",
+          "label": "Credit card",
+          "sessionId": "cs_live_a1Upmvi1v62AdILeDZl4l",
+          "accountId": "acct_1MpAB7AFrTg9gw7b"
         }
       ]
     }
@@ -113,13 +120,42 @@ Payment option variants:
 - `bank_transfer`: display-only payment details.
 - `redirect`: redirect the browser to the payment URL.
 - `form_post`: submit a generated HTML form, currently used for PayPal-style flows.
-- `stripe_checkout`: redirect to Stripe Checkout when a `url` is present.
+- `stripe_checkout`: open Stripe Checkout. Emitted on `v9` only.
+
+## Payment Submission
+
+Use `sdk.live.booking.submitPaymentOption(option)` or the top-level `submitPaymentOption(option)` export for every option except `bank_transfer`, which is display-only. Submission requires a browser environment and fails outside one.
+
+Render a button for every submittable option. Do not gate rendering on `url`: a `stripe_checkout` option is submittable as soon as it carries a `sessionId`.
+
+Stripe Checkout is opened one of two ways:
+
+- When the option has a `url`, the browser is redirected to it.
+- Otherwise the SDK loads Stripe.js from `https://js.stripe.com/v3/` and opens the session with `sessionId`, passing `accountId` as the connected account. The vOffice platform publishable keys are built in, and test (`cs_test_`) and live (`cs_live_`) sessions are handled automatically, so Stripe needs no configuration.
+
+Stripe.js is fetched on first use and reused afterwards, and an existing `window.Stripe` instance is reused when the page already provides one. A failed load is retried by the next submission instead of being remembered, so a guest can retry a Stripe payment without reloading the page. Sites with a Content-Security-Policy must allow `script-src https://js.stripe.com` and `frame-src https://js.stripe.com https://hooks.stripe.com`.
+
+Booking creation and payment are separate steps. When a payment option is on screen the reservation already exists, so present a submission failure as an unpaid booking rather than a failed booking:
+
+```ts
+try {
+  await sdk.live.booking.submitPaymentOption(option);
+} catch (error) {
+  showPaymentFailure({ bookingNumber: booking.bookingNumber, error });
+}
+```
+
+## Payment Return
+
+Online payment providers return the guest to a URL derived from `relativeRedirectUrl`. Stripe returns to that path with `payment=stripe&success=true` after payment and `payment=stripe&cancel=true` after cancellation, so the path must exist in your site and should read those query parameters.
+
+`relativeRedirectUrl` is supplied before the reservation exists, so the return URL cannot carry the booking number or guest token. Persist whatever the return page needs, for example in `sessionStorage`, before submitting a payment option.
 
-Use `sdk.live.booking.submitPaymentOption(option)` or the top-level `submitPaymentOption(option)` export for non-bank-transfer payment options in a browser environment.
+A successful return means the provider sent the browser back, not that the payment has settled. Confirmation reaches vOffice through the provider's webhook.
 
 ## Configuration
 
-Booking requests are rate-limited to one backend request per second with a queue size of five. `v9` books through the v0 `book` action and can initialize Stripe payment data. `v10` books through GraphQL and initializes Adyen redirect payment options.
+Booking requests are rate-limited to one backend request per second with a queue size of five. `v9` books through the v0 `book` action and initializes one Stripe Checkout Session per payment schedule option when the property has Stripe enabled. `v10` books through GraphQL and initializes Adyen redirect payment options.
 
 ## CLI Usage
 

package/instructions/creation.md

@@ -81,6 +81,7 @@ const options = defineWebsiteSDKOptions({
   },
   rentalHighlightPrioritization: ["bedrooms", "bathrooms", "maxPersons", "wifi"],
   rentalPropertyHighlightPrioritization: ["wifi", "parking"],
+  customAttributes,
   customAttributeFilterDefinitions: [],
   translationOverrides: {},
 });
@@ -91,8 +92,8 @@ const options = defineWebsiteSDKOptions({
 ```ts
 type WebsiteSDKOptions = {
   translationOverrides?: TranslationOverrides;
+  customAttributes?: CustomAttributeRegistrySnapshot;
   customAttributeFilterDefinitions?: readonly CustomAttributeFilterDefinition[];
-  customAttributeDefinitionManifest?: CustomAttributeDefinitionManifest;
   rentalHighlightPrioritization?: readonly RentalHighlightPrioritizationKey[];
   rentalPropertyHighlightPrioritization?: readonly RentalPropertyHighlightPrioritizationKey[];
   rentalScope?: RentalScope;
@@ -102,8 +103,8 @@ type WebsiteSDKOptions = {
 
 Unset options are normalized by the SDK:
 
+- `customAttributes` defaults to an empty registry.
 - `customAttributeFilterDefinitions` defaults to `[]`.
-- `customAttributeDefinitionManifest` is omitted unless provided; an absent manifest is treated as empty.
 - `rentalHighlightPrioritization` defaults to the SDK default rental highlight order.
 - `rentalPropertyHighlightPrioritization` defaults to the SDK default property highlight order.
 - `rentalScope` defaults to `{}`.
@@ -130,31 +131,45 @@ const options = defineWebsiteSDKOptions({
 
 The scope is always applied internally and is not returned by `static.filter.getFilters(...)`. Use it for website-level or tenant-level constraints.
 
-## Custom Attribute Filter Definitions
+## Custom Attributes
 
-Use `customAttributeFilterDefinitions` to add SDK-known filter keys for custom attributes, v9 backend filters, or composed filters:
+Custom attributes are configured through `customAttributes`, built by
+`defineCustomAttributes` from the workspace catalog plus your product policy:
+
+```ts
+const customAttributes = defineCustomAttributes({
+  catalog,
+  select: {
+    region: {
+      label: { "de-DE": "Region", "en-US": "Region" },
+      filter: true,
+      optionLabels: {
+        north: { "de-DE": "Nord", "en-US": "North" },
+      },
+    },
+  },
+});
+
+const options = defineWebsiteSDKOptions({ customAttributes });
+```
+
+See `custom-attributes.md` for the catalog, the selection shape, per-backend
+behaviour, and the v9-to-v10 move.
+
+## Backend Filters and Composed Filters
+
+`customAttributeFilterDefinitions` holds the two filter concepts that are _not_
+custom attributes:
 
 ```ts
 const options = defineWebsiteSDKOptions({
   customAttributeFilterDefinitions: [
     {
-      key: "region",
-      source: "customAttribute",
-      category: "ESSENTIALS",
-      label: {
-        "de-DE": "Region",
-        "en-US": "Region",
-      },
-      type: "option",
-      options: [
-        {
-          value: "north",
-          label: {
-            "de-DE": "Nord",
-            "en-US": "North",
-          },
-        },
-      ],
+      key: "atLeastTwoBedrooms",
+      source: "backendFilter",
+      category: "LIVING_SLEEPING",
+      label: { "de-DE": "Mind. zwei Schlafzimmer", "en-US": "At least two bedrooms" },
+      type: "boolean",
       searchable: true,
       internal: false,
     },
@@ -165,59 +180,27 @@ const options = defineWebsiteSDKOptions({
 Supported filter types:
 
 - `boolean`: accepts enabled query values such as `?key`, `?key=true`, or `?key=1`.
-- `int`: accepts integer query values and can expose optional `numericBounds` for UI controls.
+- `int`: accepts integer query values. The definition includes a `numericBounds`
+  object; omit its `min` and `max` fields when the UI needs no bounds.
 - `option`: accepts one of the configured `options` values and exposes those options through `getFilters`.
 - `string`: accepts any non-empty query value as an exact raw value.
 - `complex`: composition-only type that expands one boolean query-string filter into other configured filters.
 
 Supported sources:
 
-- `customAttribute`: backed by custom attributes.
-- `backendFilter`: backed by backend-defined search filter keys, mainly for v9 hub filters.
-- `composition`: expands one boolean query-string filter into other configured filters.
+- `backendFilter`: backed by backend-defined search filter keys, mainly for v9 hub filters. Advertised and executed by v9 only.
+- `composition`: expands one boolean query-string filter into other configured
+  filters. It is advertised only when every configured leaf can execute on the
+  active backend, and no generated leaf is committed unless all leaves are valid.
+  Nested compositions are rejected while recursive expansion is unsupported.
 
-Visibility:
+Exposure:
 
 - `internal: false` exposes searchable filters through `static.filter.getFilters(...)`.
 - `internal: true` keeps filters usable by search and compositions but hides them from `getFilters`.
-- `searchable: false` keeps custom attributes as display metadata only.
 
-## Custom Attribute Definition Manifest
-
-The v10 REST search backend filters and returns custom attributes by definition ID, while SDK configuration and query strings use keys. Because definition IDs are workspace/environment specific, use `customAttributeDefinitionManifest` to give the SDK a key-to-ID and ID-to-key mapping:
-
-```ts
-const options = defineWebsiteSDKOptions({
-  customAttributeDefinitionManifest: {
-    byKey: {
-      region: { id: "def-1", key: "region", type: "OPTION", visibility: "PUBLIC" },
-    },
-    byId: {
-      "def-1": { id: "def-1", key: "region", type: "OPTION", visibility: "PUBLIC" },
-    },
-  },
-});
-```
-
-```ts
-type CustomAttributeDefinitionManifestEntry = {
-  id: string;
-  key: string;
-  type: "BOOLEAN" | "INT" | "STRING" | "OPTION";
-  visibility: "PUBLIC" | string | null;
-  options?: readonly { value: string; label?: Record<string, string> }[];
-};
-
-type CustomAttributeDefinitionManifest = {
-  byKey: Record<string, CustomAttributeDefinitionManifestEntry>;
-  byId: Record<string, CustomAttributeDefinitionManifestEntry>;
-};
-```
-
-- Generate the manifest at build time from your definitions source, and pass a separate manifest per workspace/environment because IDs are not portable.
-- Custom-attribute keys that have no manifest entry are left in `unusedFilterKeys` instead of being applied as filters.
-- Only definitions with `visibility` of `PUBLIC` (or `null`) are surfaced as v10 search highlights; others are ignored.
-- The manifest is only used by v10 search. v9 and the non-search v10 endpoints ignore it.
+`internal` is a UI-visibility choice, not a security boundary — an internal filter is
+still parseable from a query string. See `custom-attributes.md`.
 
 ## Translation Overrides
 
@@ -262,8 +245,26 @@ Example `website-sdk-options.json`:
   "rentalScope": {
     "propertyId": "property-1"
   },
-  "rentalHighlightPrioritization": ["bedrooms", "bathrooms", "maxPersons", "wifi"],
+  "customAttributes": {
+    "catalog": {
+      "privateSauna": {
+        "id": "GQYKYgMVh28X7VLGursbkt",
+        "type": "BOOLEAN"
+      }
+    },
+    "select": {
+      "privateSauna": {
+        "label": { "de-DE": "Sauna", "en-US": "Sauna" },
+        "filter": true
+      }
+    }
+  },
+  "rentalHighlightPrioritization": ["bedrooms", "privateSauna", "wifi"],
   "customAttributeFilterDefinitions": [],
   "translationOverrides": {}
 }
 ```
+
+CLI options carry the custom-attribute **catalog and selection inputs**, not a
+pre-built registry. The CLI validates and joins them before creating the SDK. See
+`custom-attributes.md` for the complete shape and key-collision rules.