@v-office/website-sdk 2.7.0 → 2.9.0

package/dist/{search-wcoZw2rt.mjs → search-CO9ID9op.mjs}

@@ -1,133 +1,7 @@
-import { n as stable_filters_default } from "./client-45_ofP_d.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-CYK_5Vk7.mjs";
+import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-B6a_fi0j.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-B6a_fi0j.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,23 +5870,45 @@ 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 RENTAL_VIEW_HIGHLIGHT_KEYS = /* @__PURE__ */ new Set([
+	"beachview",
+	"cityView",
+	"countrysideView",
+	"gardenView",
+	"innerCourtView",
+	"lakeview",
+	"mountainview",
+	"poolView",
+	"quietStreetView",
+	"riverView",
+	"seaview",
+	"valleyView"
+]);
+const toRentalHighlights = ({ locale, translations, highlightPrioritization, customAttributes, attributes }) => Effect.gen(function* () {
 	const highlights = [];
 	const seenKeys = /* @__PURE__ */ new Set();
 	const knownAttributes = attributes.known;
 	const translate = makeTranslate(translations, locale);
+	let hasViewHighlight = false;
 	for (const highlightKey of highlightPrioritization) {
+		const isViewHighlight = RENTAL_VIEW_HIGHLIGHT_KEYS.has(highlightKey);
+		if (isViewHighlight && hasViewHighlight) continue;
 		const v9Key = toV9RentalHighlightKey(highlightKey);
 		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);
+			if (highlight != null) {
+				highlights.push(highlight);
+				if (isViewHighlight) hasViewHighlight = true;
+			}
 			continue;
 		}
 		if (seenKeys.has(v9Key)) continue;
@@ -5898,7 +5920,10 @@ const toRentalHighlights = ({ locale, translations, highlightPrioritization, cus
 			locale,
 			value: knownAttributes[v9Key]
 		});
-		if (highlight != null) highlights.push(highlight);
+		if (highlight != null) {
+			highlights.push(highlight);
+			if (isViewHighlight) hasViewHighlight = true;
+		}
 	}
 	return highlights;
 });

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,7 +4,10 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
-- `versions/2.6.0/CHANGELOG.md`: `@v-office/website-sdk` 2.6.0 release notes.
+- `versions/2.9.0/CHANGELOG.md`: `@v-office/website-sdk` 2.9.0 release notes.
+- `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,7 +4,10 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
-- `versions/2.6.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.5.x to 2.6.0.
+- `versions/2.9.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.8.0 to 2.9.0.
+- `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.6.0.
+These instructions describe the current source targeted for
+`@v-office/website-sdk` 2.9.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,7 +18,10 @@ 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.6.0/`: 2.6.0 release notes and 2.5.x-to-2.6.0 migration guide.
+- `versions/2.9.0/`: 2.9.0 highlight-selection release notes and 2.8.0-to-2.9.0 migration guide.
+- `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.
@@ -69,4 +75,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.6.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.9.0. v10 config additionally requires `searchEndpoint` as of 2.5.0.

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;
@@ -100,12 +101,24 @@ type WebsiteSDKOptions = {
 };
 ```
 
+`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
+the source contains a value. This affects `highlights` only, not `attributes` or
+`vicinity`. Property highlights are available only with v10 property data.
+
+For either option, `undefined` uses the SDK default and `[]` emits no highlights.
+Duplicate keys are emitted once; unknown, unsupported, or unresolved keys are
+ignored. When several configured rental view facts have values, only the first one
+in the ordered allowlist is emitted. View-type descriptors qualify a view and are
+not part of this strongest-view selection.
+
 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.
+- `rentalHighlightPrioritization` defaults to the SDK default rental highlight selection.
+- `rentalPropertyHighlightPrioritization` defaults to the SDK default property highlight selection.
 - `rentalScope` defaults to `{}`.
 - `shouldAddProposedAdditionalServiceAmount` defaults to `false`.
 - `translationOverrides` is omitted unless provided.
@@ -130,31 +143,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 +192,30 @@ 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.
+
+For a new v9 `backendFilter` key, ask someone at be-on! with Hub access to add or
+confirm the backend filter before configuring it in the SDK.
 
-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 +260,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.