@v-office/website-headless 0.1.0 → 0.2.0

package/README.md

@@ -64,10 +64,10 @@ parameters — the rules live here, the words live in the site.
 ## Development
 
 ```bash
-pnpm install
+pnpm install      # at the repository root; website-sdk is a workspace link
 pnpm build        # tsdown → dist/ (index, enhance; .mjs + .d.mts)
 pnpm check        # tsc · oxlint · oxfmt --check
-pnpm test         # vitest, jsdom environment
+pnpm test         # vitest, jsdom environment; then test/dist.node.mjs imports the build by name
 ```
 
 The tests cover the pure rules (validation, insurance gate, stay helpers,
@@ -78,8 +78,9 @@ DOM (jsdom); the SDKs use `node --test` because they do not.
 
 ## Publishing
 
-The **Publish** workflow (`.github/workflows/publishSDK.yml`, choice
-`website-headless`) publishes the exact version in `package.json` to npm after
-build, check and tests pass; it never bumps versions. Set the version by hand,
-merge, run the workflow. Consumers pin the exact version and receive updates
-through fleet rollouts (docs/website-platform/process/06-package-rollout.md).
+See [docs/internal/releasing/overview.md](../../docs/internal/releasing/overview.md). `node .github/release/cli.mts
+prepare website-headless <bump>` sets the version and scaffolds
+`instructions/versions/<version>/` with the notes and the `release.json`
+release facts; the `Release packages` workflow publishes what is on `main`
+after build, check and tests pass. Consumers pin the exact version and receive
+updates through fleet rollouts (docs/website-platform/process/06-package-rollout.md).

package/dist/enhance/index.d.mts

@@ -20,8 +20,8 @@
  * `{current}` shown) — the component renders the template from its copy, so
  * the enhancer carries no language of its own.
  */
-declare function initImageCarousels(selector?: string): void;
-declare function initRentalCarousel(viewport: HTMLElement): void;
+export declare function initImageCarousels(selector?: string): void;
+export declare function initRentalCarousel(viewport: HTMLElement): void;
 //#endregion
 //#region src/enhance/overlay.d.ts
 /**
@@ -66,11 +66,11 @@ declare function initRentalCarousel(viewport: HTMLElement): void;
  */
 /** Run `mutate` inside a view transition where the browser has one and the
  *  visitor has not asked for less motion; run it directly otherwise. */
-declare function withViewTransition(mutate: () => void): void;
+export declare function withViewTransition(mutate: () => void): void;
 /** Install the page's single pair of modality listeners. Safe to call often. */
-declare function trackInputModality(): void;
+export declare function trackInputModality(): void;
 /** Focus `el` only when the last real input was a keyboard one. */
-declare function focusForKeyboard(el: HTMLElement | null): void;
+export declare function focusForKeyboard(el: HTMLElement | null): void;
 /** Every selector the controller needs, stated by the caller. Each is scoped to
  *  `root`, so two overlays on one page cannot reach into each other. */
 interface HistoryOverlayOptions {
@@ -93,7 +93,7 @@ interface HistoryOverlayOptions {
 }
 /** Bind one overlay. Returns silently when the markup is not on this page, so
  *  a component whose overlay self-hides costs nothing. */
-declare function initHistoryOverlay(options: HistoryOverlayOptions): void;
+export declare function initHistoryOverlay(options: HistoryOverlayOptions): void;
 //#endregion
 //#region src/enhance/gallery.d.ts
 /**
@@ -179,6 +179,6 @@ interface GalleryOptions {
   layers: GalleryLayer[];
 }
 /** Bind one gallery. Returns silently when its root is not on this page. */
-declare function initGallery(options: GalleryOptions): void;
+export declare function initGallery(options: GalleryOptions): void;
 //#endregion
-export { type GalleryLayer, type GalleryOptions, type HistoryOverlayOptions, focusForKeyboard, initGallery, initHistoryOverlay, initImageCarousels, initRentalCarousel, trackInputModality, withViewTransition };
+export type { GalleryLayer, GalleryOptions, HistoryOverlayOptions };

package/dist/index.d.mts

@@ -8,31 +8,31 @@ import { BookingPaymentOption, BookingPaymentScheduleKind, GuestQuote, GuestQuot
  * package never depends on a framework; the adapters live in ./react and
  * friends.
  */
-type Listener<S> = (state: S) => void;
-type Unsubscribe = () => void;
-interface Store<S> {
+export type Listener<S> = (state: S) => void;
+export type Unsubscribe = () => void;
+export interface Store<S> {
   getState(): S;
   subscribe(listener: Listener<S>): Unsubscribe;
 }
-interface WritableStore<S> extends Store<S> {
+export interface WritableStore<S> extends Store<S> {
   /** Replaces the state and notifies every listener. Same reference = no-op. */
   setState(next: S): void;
 }
-declare function createStore<S>(initial: S): WritableStore<S>;
+export declare function createStore<S>(initial: S): WritableStore<S>;
 //#endregion
 //#region src/sdk.d.ts
-type WebsiteSdk = ReturnType<typeof createWebsiteSDK>;
+export type WebsiteSdk = ReturnType<typeof createWebsiteSDK>;
 /** Deployment stage: selects the public endpoint set below. */
-declare const STAGES: readonly ["development", "production"];
-type Stage = (typeof STAGES)[number];
+export declare const STAGES: readonly ["development", "production"];
+export type Stage = (typeof STAGES)[number];
 /** Public endpoints of the v10 backend per stage. */
-declare const VOFFICE_ENDPOINTS: Record<Stage, {
+export declare const VOFFICE_ENDPOINTS: Record<Stage, {
   apiEndpoint: string;
   imageBaseUrl: string;
   searchEndpoint: string;
 }>;
 /** Public endpoints of the v9 backend per stage; API URLs derive from `apiBaseUrl`. */
-declare const HUB_ENDPOINTS: Record<Stage, {
+export declare const HUB_ENDPOINTS: Record<Stage, {
   apiBaseUrl: string;
   imageProxyBaseUrl: string;
 }>;
@@ -40,7 +40,7 @@ declare const HUB_ENDPOINTS: Record<Stage, {
  *  secret to protect. Serializable on purpose: an Astro island receives it as a
  *  prop, so the site reads its env once (in .astro / a loader) and never inside
  *  a component. */
-type SdkConfig = {
+export type SdkConfig = {
   backend: "v9";
   imageProxyBaseUrl: string;
   v0ApiBaseUrl: string;
@@ -56,7 +56,7 @@ type SdkConfig = {
 };
 /** The three values a site actually decides — backend, stage, its token — as
  *  a full `SdkConfig`, with the endpoints the platform owns. */
-declare function sdkConfigFor({ backend, stage, token }: {
+export declare function sdkConfigFor({ backend, stage, token }: {
   backend: SdkConfig["backend"];
   stage: Stage;
   token: string;
@@ -65,7 +65,7 @@ declare function sdkConfigFor({ backend, stage, token }: {
  *  overrides, custom attributes, highlight prioritization). The caller owns the
  *  lifecycle and calls `await sdk.dispose()` when done. The API is rate-limited
  *  (1/s), so a browser surface keeps ONE instance for its lifetime. */
-declare function createSdk(config: SdkConfig, options?: WebsiteSDKOptions): WebsiteSdk;
+export declare function createSdk(config: SdkConfig, options?: WebsiteSDKOptions): WebsiteSdk;
 /**
  * Render `error` and its whole cause chain as indented JSON.
  *
@@ -84,7 +84,7 @@ declare function createSdk(config: SdkConfig, options?: WebsiteSDKOptions): Webs
  * `CoreSDKError` logged as the five bland fields above with the sentence that
  * names the fault dropped.
  */
-declare function describeSdkError(error: unknown): string;
+export declare function describeSdkError(error: unknown): string;
 /**
  * Log a failed SDK call with the backend's reason, tagged by `scope`.
  *
@@ -97,7 +97,7 @@ declare function describeSdkError(error: unknown): string;
  * log it separately for a clickable stack; doubling it here would print every
  * failure twice on the surfaces that already do.
  */
-declare function logSdkFailure(scope: string, error: unknown): void;
+export declare function logSdkFailure(scope: string, error: unknown): void;
 //#endregion
 //#region src/quote.d.ts
 /** One row of the price breakdown. `label`/`amount` are the SDK's own
@@ -108,13 +108,13 @@ declare function logSdkFailure(scope: string, error: unknown): void;
  *  from a charge line — see `adaptGuestQuote` for why those rows exist. Its
  *  `amount` is the modifier's own signed string ("-140,00 €"), so the row is a
  *  deduction from the running total, not another charge. */
-interface QuoteLine {
+export interface QuoteLine {
   label: string;
   amount: string;
   nested: boolean;
   discount: boolean;
 }
-interface PriceQuote {
+export interface PriceQuote {
   /** Section/line breakdown flattened in SDK order (sub-items follow their
    *  parent line, flagged `nested`). */
   lines: QuoteLine[];
@@ -122,7 +122,7 @@ interface PriceQuote {
   total: string;
 }
 /** Bookable add-on from `quote.additionalServices`, verbatim fields. */
-interface QuoteAddonService {
+export interface QuoteAddonService {
   id: string;
   label: string;
   /** SDK charge string as-is (e.g. "25,00 €" — the PMS's own formatting). */
@@ -160,13 +160,13 @@ interface QuoteAddonService {
    *  the feed omits it. */
   unavailableReason?: string | undefined;
 }
-interface QuotePolicyRule {
+export interface QuotePolicyRule {
   daysBeforeArrival: number;
   /** SDK's formatted percentage string, verbatim. */
   refundPercentage: string;
 }
 /** Selectable cancellation policy from `quote.cancellationPolicies`. */
-interface QuoteCancellationPolicy {
+export interface QuoteCancellationPolicy {
   id: string;
   label: string;
   selected: boolean;
@@ -184,7 +184,7 @@ interface QuoteCancellationPolicy {
 /** Voucher status echoed back on a re-priced quote (`quote.voucher`). On v10
  *  the SDK authoritatively reports whether the code applied a modifier; v9
  *  reports `"unknown"`. `message` is the PMS's own note, verbatim. */
-interface QuoteVoucher {
+export interface QuoteVoucher {
   code: string;
   status: "applied" | "not_applied" | "unknown";
   message?: string | undefined;
@@ -194,7 +194,7 @@ interface QuoteVoucher {
  *  whichever insurer the hub setup configures, and only when that setup enables
  *  insurance at all — otherwise the SDK returns the "none" option alone and the
  *  adapter yields no `QuoteInsurance`. */
-interface QuoteInsuranceOption {
+export interface QuoteInsuranceOption {
   id: string;
   label: string;
   /** SDK's own locale-formatted premium (e.g. "14,00 €"). There is no numeric
@@ -228,7 +228,7 @@ interface QuoteInsuranceOption {
  *  policy separately, so a UI that shows both must show them as two figures.
  *  Adding them would mean parsing the PMS's formatted strings, which this file
  *  does not do for any other charge either. */
-interface QuoteInsurance {
+export interface QuoteInsurance {
   /** The SDK's own "no insurance" label, verbatim. */
   noneLabel: string;
   options: QuoteInsuranceOption[];
@@ -236,7 +236,7 @@ interface QuoteInsurance {
   selectedId: string | null;
 }
 /** The renderable view of a live GuestQuote — card + selectable options. */
-interface QuoteView {
+export interface QuoteView {
   card: PriceQuote;
   services: QuoteAddonService[];
   policies: QuoteCancellationPolicy[];
@@ -246,7 +246,7 @@ interface QuoteView {
   /** Selectable travel insurance — absent when the feed offers no product. */
   insurance?: QuoteInsurance | undefined;
 }
-type QuoteResult = {
+export type QuoteResult = {
   status: "available";
   /** Flattened price card (back-compat: the widget renders this). */
   quote: PriceQuote;
@@ -271,7 +271,7 @@ type QuoteResult = {
  *  `@v-office/website-sdk` does not re-export it and sdk-core is a transitive
  *  dependency an adopting project does not declare — so `Extract` off the
  *  result type is the reachable spelling. */
-type QuoteUnavailableCode = Extract<GuestQuoteResult, {
+export type QuoteUnavailableCode = Extract<GuestQuoteResult, {
   status: "unavailable";
 }>["code"];
 /** The two codes that mean "the stay WAS priced, but the rental's rate setup
@@ -289,13 +289,13 @@ type QuoteUnavailableCode = Extract<GuestQuoteResult, {
  *  unbookable until the surplus rows are removed in the PMS. What the site owes
  *  the guest is honest copy — never the generic "not available", which asserts
  *  a booking conflict that does not exist. */
-declare const MULTI_RATE_CODES: readonly ["AmbiguousMultiRate", "UnresolvableMultiRate"];
+export declare const MULTI_RATE_CODES: readonly ["AmbiguousMultiRate", "UnresolvableMultiRate"];
 /** True when an unavailable quote is a rate-configuration fault rather than a
  *  genuinely unbookable stay. Callers branch the MESSAGE on this and must keep
  *  booking disabled either way (SDK 2.16.0 MIGRATION, "Required Consumer
  *  Work"). */
-declare function isRateConfigurationFault(code: QuoteUnavailableCode | undefined): boolean;
-interface QuoteOccupancy {
+export declare function isRateConfigurationFault(code: QuoteUnavailableCode | undefined): boolean;
+export interface QuoteOccupancy {
   adults: number;
   children: number;
   childrenAges?: number[] | undefined;
@@ -325,23 +325,23 @@ interface QuoteOccupancy {
  * checked by adding, and as a price claim the customer would have to stand
  * behind. The total stays the single net number.
  */
-declare function adaptGuestQuote(quote: GuestQuote): QuoteView;
+export declare function adaptGuestQuote(quote: GuestQuote): QuoteView;
 /** Price a stay for `rentalId`. The caller owns the SDK instance and its
  *  lifecycle — pass a shared one to reuse its queue + cache across the caller's
  *  lifetime. `voucher` re-prices with a code (the PMS decides what it's worth). */
-declare function fetchQuote(rentalId: string, period: {
+export declare function fetchQuote(rentalId: string, period: {
   start: string;
   end: string;
 }, occupancy: QuoteOccupancy, sdk: WebsiteSdk, locale: Locale, voucher?: string): Promise<QuoteResult>;
-type QuoteSelectionResult = {
+export type QuoteSelectionResult = {
   ok: true;
   quote: GuestQuote;
 } | {
   ok: false;
   reason?: string | undefined;
 };
-declare function addQuoteService(quote: GuestQuote, id: string, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
-declare function removeQuoteService(quote: GuestQuote, id: string, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
+export declare function addQuoteService(quote: GuestQuote, id: string, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
+export declare function removeQuoteService(quote: GuestQuote, id: string, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
 /** Drop every additional-service selection from `quote`.
  *
  *  A fresh quote's selection state is not knowable from the service list. It is
@@ -351,8 +351,8 @@ declare function removeQuoteService(quote: GuestQuote, id: string, sdk: WebsiteS
  *  (`GuestQuote.selections` is behind an unexported symbol). Rather than branch
  *  on something invisible, a caller that needs a known starting point clears
  *  first and steps up from zero with `addQuoteService`. */
-declare function clearQuoteServices(quote: GuestQuote, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
-declare function selectQuotePolicy(quote: GuestQuote, id: string, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
+export declare function clearQuoteServices(quote: GuestQuote, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
+export declare function selectQuotePolicy(quote: GuestQuote, id: string, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
 /** Select a travel-insurance product (`id`) or none (`null`). Unlike the
  *  service/policy calls the SDK returns the new GuestQuote directly and throws
  *  on failure (unknown id) — normalized here to the same QuoteSelectionResult
@@ -364,7 +364,7 @@ declare function selectQuotePolicy(quote: GuestQuote, id: string, sdk: WebsiteSd
  *  off the quote. A product with `requiresTravelers` needs the pre-contract /
  *  payment / `bookInsurance` steps on top, which the checkout does not
  *  implement — it offers only the products it can complete. */
-declare function selectQuoteInsurance(quote: GuestQuote, id: string | null, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
+export declare function selectQuoteInsurance(quote: GuestQuote, id: string | null, sdk: WebsiteSdk): Promise<QuoteSelectionResult>;
 /**
  * The concrete "free cancellation until" date for ONE policy — DERIVED, not
  * fabricated: the PMS states its rules relatively (`daysBeforeArrival` +
@@ -380,16 +380,16 @@ declare function selectQuoteInsurance(quote: GuestQuote, id: string | null, sdk:
  *  own formatted string ("100%"), so this reads it rather than comparing a
  *  number — the one place that pattern is written, because both the derived
  *  deadline and the "is this a refundable rate at all" question depend on it. */
-declare function fullRefundRule(policy: QuoteCancellationPolicy | undefined): QuotePolicyRule | undefined;
-declare function policyFreeCancellationUntil(policy: QuoteCancellationPolicy | undefined, arrival: Date): Date | null;
+export declare function fullRefundRule(policy: QuoteCancellationPolicy | undefined): QuotePolicyRule | undefined;
+export declare function policyFreeCancellationUntil(policy: QuoteCancellationPolicy | undefined, arrival: Date): Date | null;
 /** The deadline for the stay as it stands — i.e. of the SELECTED policy.
  *  Kept as its own name because that is what a summary line means: not "some
  *  policy allows this" but "what you have chosen allows this". */
-declare function freeCancellationUntil(policies: QuoteCancellationPolicy[], arrival: Date): Date | null;
+export declare function freeCancellationUntil(policies: QuoteCancellationPolicy[], arrival: Date): Date | null;
 /** The same stay priced under ONE cancellation policy. `quote` is a real
  *  GuestQuote branched off the base, so the UI can show its card, and hand the
  *  branch on to a later step, without re-quoting the stay. */
-interface PolicyBranch {
+export interface PolicyBranch {
   id: string;
   /** The branch quote — the base itself for the already-selected policy. */
   quote: GuestQuote;
@@ -420,15 +420,15 @@ interface PolicyBranch {
  * budget delays the ones that can succeed. It simply gets no branch, and the UI
  * renders it as the unselectable row it already is.
  */
-declare function pricePolicyBranches(base: GuestQuote, sdk: WebsiteSdk): Promise<PolicyBranch[]>;
+export declare function pricePolicyBranches(base: GuestQuote, sdk: WebsiteSdk): Promise<PolicyBranch[]>;
 //#endregion
 //#region src/booking.d.ts
 /** Where the payment provider sends the guest back after an online payment
  *  (relative — the SDK/PSP resolves it against the site origin). */
-declare const CHECKOUT_RETURN_PATH = "/buchen/bestaetigung";
+export declare const CHECKOUT_RETURN_PATH = "/buchen/bestaetigung";
 /** The checkout form's flat contact fields (the UI shape). `toBookingContact`
  *  folds them into the SDK's nested BookingContact. */
-interface BookingContactForm {
+export interface BookingContactForm {
   forename: string;
   surname: string;
   /** Anrede ("Frau" / "Herr"); omitted when the guest picks none. */
@@ -443,13 +443,13 @@ interface BookingContactForm {
   phone?: string | undefined;
   note?: string | undefined;
 }
-interface PaymentLine {
+export interface PaymentLine {
   label: string;
   amount: string;
 }
 /** One payment entry, verbatim — a contractual step (Anzahlung / Restzahlung /
  *  Rate / Kaution) or a way to settle the whole outstanding balance. */
-interface PaymentScheduleView {
+export interface PaymentScheduleView {
   /** SDK's stable kind, for programmatic behaviour ONLY. Everything the guest
    *  reads comes from `label`: the SDK translates it, and a v10 installment is
    *  not automatically a v9 prepayment. */
@@ -476,12 +476,12 @@ interface PaymentScheduleView {
  *  a `PaymentScheduleView`: those are the PMS's own steps, owed to the site's
  *  operator and payable through the SDK. This one is a different contract with
  *  a different recipient, and it leaves the site entirely. */
-interface InsurancePaymentLink {
+export interface InsurancePaymentLink {
   label: string;
   url: string;
   description?: string | undefined;
 }
-interface BookingConfirmation {
+export interface BookingConfirmation {
   bookingNumber: string;
   /** The contractual steps, in backend order — what the guest owes and when. */
   schedules: PaymentScheduleView[];
@@ -503,10 +503,10 @@ interface BookingConfirmation {
  * real. Throws on transport/backend errors (the caller renders an honest
  * retry message; nothing was necessarily booked when it throws).
  */
-declare function submitBooking(quote: GuestQuote, contact: BookingContactForm, sdk: WebsiteSdk, returnPath?: string): Promise<BookingConfirmation>;
+export declare function submitBooking(quote: GuestQuote, contact: BookingContactForm, sdk: WebsiteSdk, returnPath?: string): Promise<BookingConfirmation>;
 /** True for the option kinds `submitPaymentOption` can perform in-browser
  *  (redirect / form_post / stripe_checkout). Bank transfer is display-only. */
-declare function isSubmittableOption(option: BookingPaymentOption): option is SubmittableBookingPaymentOption;
+export declare function isSubmittableOption(option: BookingPaymentOption): option is SubmittableBookingPaymentOption;
 /** Perform an online payment option (redirects the browser to the PSP).
  *  USER-initiated only.
  *
@@ -516,31 +516,31 @@ declare function isSubmittableOption(option: BookingPaymentOption): option is Su
  *  booking, not a failed one. The checkout's catch discards the error entirely
  *  — `.catch(() => setPayError(true))` — so without this a guest who cannot
  *  pay leaves no trace at all, on a booking someone now has to chase. */
-declare function payWithOption(option: SubmittableBookingPaymentOption, sdk: WebsiteSdk): Promise<void>;
+export declare function payWithOption(option: SubmittableBookingPaymentOption, sdk: WebsiteSdk): Promise<void>;
 //#endregion
 //#region src/booking-snapshot.d.ts
 /** Rental identity, parked by the checkout page (which has it from SSR) and
  *  folded into the snapshot at book time — the SDK seam that writes the
  *  snapshot never sees a rental name or a link. */
-declare const CHECKOUT_CONTEXT_KEY = "voffice:checkout-context";
+export declare const CHECKOUT_CONTEXT_KEY = "voffice:checkout-context";
 /** The finished record `/buchen/bestaetigung` reads. */
-declare const BOOKING_SNAPSHOT_KEY = "voffice:booking-return";
+export declare const BOOKING_SNAPSHOT_KEY = "voffice:booking-return";
 /** One gallery image, in the SDK's own shape (`RentalGalleryImage` minus the
  *  fields this page does not render). Stored so the confirmation can show the
  *  unit rather than describe it — the guest booked a place, not a table. */
-interface SnapshotImage {
+export interface SnapshotImage {
   src: string;
   srcset?: string | undefined;
   alt: string;
 }
-interface CheckoutContext {
+export interface CheckoutContext {
   rentalName: string;
   location?: string | undefined;
   href?: string | undefined;
   /** Capped at the same five the checkout's own summary strip shows. */
   images?: SnapshotImage[] | undefined;
 }
-interface BookingSnapshotGuests {
+export interface BookingSnapshotGuests {
   adults: number;
   children: number;
   babies: number;
@@ -549,7 +549,7 @@ interface BookingSnapshotGuests {
 /** Every field but `bookingNumber` self-hides when absent — the return page
  *  renders a row only for what it actually has, never an empty shell
  *  (`DATA_SCHEMA.md`: "Optional field gates optional UI"). */
-interface BookingSnapshot {
+export interface BookingSnapshot {
   bookingNumber: string;
   rentalName?: string | undefined;
   location?: string | undefined;
@@ -564,7 +564,7 @@ interface BookingSnapshot {
 }
 /** Park the rental's identity for the return page. Called by the checkout page
  *  on load — it is the last place in the flow that knows the rental by name. */
-declare function saveCheckoutContext(context: CheckoutContext): void;
+export declare function saveCheckoutContext(context: CheckoutContext): void;
 /**
  * Write the return page's record. Called by `submitBooking` the moment the
  * reservation exists — EARLIER than the SDK's "before submitting a payment
@@ -573,14 +573,14 @@ declare function saveCheckoutContext(context: CheckoutContext): void;
  *
  * Never throws. The snapshot is a nicety; the booking is not.
  */
-declare function saveBookingSnapshot(bookingNumber: string, quote: GuestQuote): void;
+export declare function saveBookingSnapshot(bookingNumber: string, quote: GuestQuote): void;
 //#endregion
 //#region src/checkout/insurance.d.ts
 /** The plan's documents as the checkout treats them: what it lists, what the
  *  guest must open, and what makes a plan sellable at all read the SAME list,
  *  so a hidden document can never end up required-but-unlisted (which would be
  *  a gate the guest cannot close). */
-declare function shownInsuranceResources(option: QuoteInsuranceOption): {
+export declare function shownInsuranceResources(option: QuoteInsuranceOption): {
   label: string;
   url: string;
 }[];
@@ -599,10 +599,10 @@ declare function shownInsuranceResources(option: QuoteInsuranceOption): {
  *     them cannot be concluded lawfully here, so it self-hides rather than
  *     being sold undocumented — the same rule as (1), applied to a legal
  *     precondition instead of a technical one. */
-declare function selectableInsuranceOptions(insurance: QuoteInsurance): QuoteInsuranceOption[];
+export declare function selectableInsuranceOptions(insurance: QuoteInsurance): QuoteInsuranceOption[];
 /** The selected plan, but only when it is one the guest could actually pick
  *  here — so no price row can name a product the section above never showed. */
-declare function selectedInsuranceOption(insurance: QuoteInsurance | undefined): QuoteInsuranceOption | undefined;
+export declare function selectedInsuranceOption(insurance: QuoteInsurance | undefined): QuoteInsuranceOption | undefined;
 /** The identity of an insurance PRODUCT, as opposed to the id of one priced
  *  variant of it.
  *
@@ -617,7 +617,7 @@ declare function selectedInsuranceOption(insurance: QuoteInsurance | undefined):
  *
  *  The label is what survives that: the same string in every band, and the name
  *  the guest actually chose, since it is what the radio shows. */
-declare function insuranceProductKey(option: QuoteInsuranceOption): string;
+export declare function insuranceProductKey(option: QuoteInsuranceOption): string;
 /** The plan id to re-apply onto a re-priced quote, or null when there is
  *  nothing to do — no choice, already applied, or a product this feed no longer
  *  offers as a selectable one. The last case is why the feed is checked rather
@@ -640,7 +640,7 @@ declare function insuranceProductKey(option: QuoteInsuranceOption): string;
  *  the section no longer shows, so re-applying it would leave the quote
  *  carrying an insurance the page neither displays nor can take a document
  *  confirmation for. */
-declare function insuranceIdToReapply(fresh: QuoteView, wanted: QuoteInsuranceOption | undefined): string | null;
+export declare function insuranceIdToReapply(fresh: QuoteView, wanted: QuoteInsuranceOption | undefined): string | null;
 /** Progress through the document step. Held by the orchestration hook because
  *  the submit button, a card away, is gated on it. */
 interface InsuranceDocsState {
@@ -659,11 +659,11 @@ interface InsuranceDocsState {
    *  total — would be friction with nothing behind it. */
   confirmedProduct: string | null;
 }
-declare const NO_INSURANCE_DOCS: InsuranceDocsState;
+export declare const NO_INSURANCE_DOCS: InsuranceDocsState;
 /** True while a chosen plan's document step is unfinished. No plan chosen (or
  *  "keine Versicherung") is never blocking — the duty attaches to the insurance
  *  contract, not to the stay. */
-declare function insuranceDocsPending(option: QuoteInsuranceOption | undefined, docs: InsuranceDocsState): boolean;
+export declare function insuranceDocsPending(option: QuoteInsuranceOption | undefined, docs: InsuranceDocsState): boolean;
 //#endregion
 //#region src/checkout/stay.d.ts
 interface Stay {
@@ -679,14 +679,14 @@ interface Stay {
  *  SDK both use. Local on purpose (matches date-fns `format(date,
  *  "yyyy-MM-dd")`, which the sites' own lib/dates.ts uses): a calendar day
  *  picked in the browser must not shift across midnight UTC. */
-declare function isoDate(date: Date): string;
-declare function occupancyOf(stay: Stay): QuoteOccupancy;
+export declare function isoDate(date: Date): string;
+export declare function occupancyOf(stay: Stay): QuoteOccupancy;
 /** The identity of a stay for "is the shown price still the shown stay"
  *  comparisons — every field that changes the quote, in one string. */
-declare function stayKeyOf(stay: Stay): string;
+export declare function stayKeyOf(stay: Stay): string;
 /** The stay as URL search params (`start`/`end`/`adults`/… — the same
  *  vocabulary the rental page reads + writes). */
-declare function stayParams(stay: Stay): string;
+export declare function stayParams(stay: Stay): string;
 //#endregion
 //#region src/checkout/createCheckoutFlow.d.ts
 /**
@@ -836,10 +836,10 @@ interface CheckoutFlow extends Store<CheckoutFlowState>, CheckoutFlowActions {
 }
 /** What a UI binding hands to the rendering code: the state plus the actions. */
 type CheckoutFlowApi = CheckoutFlowState & CheckoutFlowActions;
-declare function createCheckoutFlow(initialOptions: CheckoutFlowOptions): CheckoutFlow;
+export declare function createCheckoutFlow(initialOptions: CheckoutFlowOptions): CheckoutFlow;
 //#endregion
 //#region src/checkout/card-order.d.ts
-declare function stabilizeCardOrder(view: QuoteView, order: Map<string, number>): QuoteView;
+export declare function stabilizeCardOrder(view: QuoteView, order: Map<string, number>): QuoteView;
 //#endregion
 //#region src/checkout/validation.d.ts
 /**
@@ -869,19 +869,19 @@ interface ValidationMessages {
   postalcodeInvalidCH: string;
   streetHouseNumberWarning: string;
 }
-declare function normalizePhone(raw: string, dial: string | undefined): string;
-declare function phoneError(raw: string, dial: string | undefined, c: ValidationMessages): string | undefined;
-declare function emailError(raw: string, c: ValidationMessages): string | undefined;
-declare function postalcodeError(raw: string, country: string, c: ValidationMessages): string | undefined;
-declare function streetWarning(raw: string, c: ValidationMessages): string | undefined;
-declare const VALIDATED_FIELDS: readonly ["forename", "surname", "email", "phone", "street", "postalcode", "city"];
+export declare function normalizePhone(raw: string, dial: string | undefined): string;
+export declare function phoneError(raw: string, dial: string | undefined, c: ValidationMessages): string | undefined;
+export declare function emailError(raw: string, c: ValidationMessages): string | undefined;
+export declare function postalcodeError(raw: string, country: string, c: ValidationMessages): string | undefined;
+export declare function streetWarning(raw: string, c: ValidationMessages): string | undefined;
+export declare const VALIDATED_FIELDS: readonly ["forename", "surname", "email", "phone", "street", "postalcode", "city"];
 /** Validate one named field. Takes the selected COUNTRY plus its calling code
  *  (`dial`, undefined when the register has none for it): two validators depend
  *  on the country — the phone via the dial code, the PLZ via its format rule.
  *  The dial code is passed in rather than looked up because the ISO→dial
  *  mapping lives with the site's country register (its localized "Land"
  *  options), not here. */
-declare function fieldError(name: string, value: string, country: string, dial: string | undefined, c: ValidationMessages): string | undefined;
+export declare function fieldError(name: string, value: string, country: string, dial: string | undefined, c: ValidationMessages): string | undefined;
 /** Country options in the shape the site's country register provides —
  *  `[code, label]` pairs, a featured group plus the full ISO register. Kept
  *  structural so the site's own `CountryGroups` type satisfies it. */
@@ -889,7 +889,7 @@ interface CountryGroupsLike {
   featured: ReadonlyArray<readonly [string, string]>;
   all: ReadonlyArray<readonly [string, string]>;
 }
-declare function detectCountry(countries: CountryGroupsLike): string;
+export declare function detectCountry(countries: CountryGroupsLike): string;
 //#endregion
 //#region src/checkout/structure.d.ts
 /**
@@ -901,20 +901,22 @@ declare function detectCountry(countries: CountryGroupsLike): string;
  * checkout UI can silently drop a legal obligation — the § 312j BGB
  * Button-Lösung wording, the insurance documents listed before the guest's
  * confirmation, the price stated directly above the order button — and every
- * unit test still passes. This module is a contract over the RENDERED result,
- * checked by the platform's publish gate for imported and custom checkouts
- * alike.
+ * unit test still passes. This module is a contract over the RENDERED result.
+ * The imported `Booking` component satisfies it by construction; a site's own
+ * checkout is a developer's review item when it changes. The platform does
+ * NOT run this assertion at publish time (decided 2026-09-11,
+ * docs/website-platform/process/10-dist-checks.md "Custom checkouts").
  *
  * Two halves:
  *   - `CHECKOUT_PARTS`: the `data-part` vocabulary. Imported components carry
- *     these attributes; a site's own markup must keep them so the gate (and
- *     a site's own CSS) can find the elements.
+ *     these attributes; a site's own markup must keep them so this check
+ *     (and a site's own CSS) can find the elements.
  *   - `CHECKOUT_STRUCTURE` + `assertCheckoutStructure(root)`: the requirements
- *     and a pure DOM check the smoke suite runs against the rendered checkout
- *     (a browser page or a jsdom document). Every requirement names the legal
+ *     and a pure DOM check over a rendered checkout (a browser page or a
+ *     jsdom document in a test). Every requirement names the legal
  *     basis it exists for, so a failure message tells the reader WHY.
  */
-declare const CHECKOUT_PARTS: {
+export declare const CHECKOUT_PARTS: {
   /** The one place the guest is told the price they are about to owe. */
   readonly priceTotal: "checkout-price-total";
   /** The § 312j order button. */
@@ -930,8 +932,8 @@ type CheckoutPart = (typeof CHECKOUT_PARTS)[keyof typeof CHECKOUT_PARTS];
 /** German "kostenpflichtig bestellen"-class labels the courts have accepted
  *  for § 312j Abs. 3 BGB. The check is on the RENDERED button text, so a site
  *  may re-voice the label — but only within this class. */
-declare const BUTTON_SOLUTION_PATTERN: RegExp;
-declare const CHECKOUT_STRUCTURE: {
+export declare const BUTTON_SOLUTION_PATTERN: RegExp;
+export declare const CHECKOUT_STRUCTURE: {
   readonly "submit-present": {
     readonly basis: "§ 312j Abs. 3 BGB (Button-Lösung)";
     readonly description: "exactly one order button carries data-part=checkout-submit";
@@ -959,20 +961,20 @@ interface StructureViolation {
   basis: string;
   detail: string;
 }
-declare function assertCheckoutStructure(root: ParentNode): StructureViolation[];
+export declare function assertCheckoutStructure(root: ParentNode): StructureViolation[];
 //#endregion
 //#region src/dates.d.ts
-declare function parseParam(value: string | null | undefined): Date | undefined;
-declare function parseGermanParam(value: string | null | undefined): Date | undefined;
+export declare function parseParam(value: string | null | undefined): Date | undefined;
+export declare function parseGermanParam(value: string | null | undefined): Date | undefined;
 /** A flexible-length stay ("3–5 Nächte") as the URL carries it. Off until the
  *  search UI offers it; the keys are reserved so a site can enable it. */
-declare const NIGHT_RANGE_ENABLED = false;
-interface NightRange {
+export declare const NIGHT_RANGE_ENABLED = false;
+export interface NightRange {
   min: number;
   max: number;
 }
-declare const NIGHT_RANGE_KEYS: readonly ["minNights", "maxNights", "nights_min", "nights_max"];
-declare function parseNightRange(params: URLSearchParams): NightRange | null;
+export declare const NIGHT_RANGE_KEYS: readonly ["minNights", "maxNights", "nights_min", "nights_max"];
+export declare function parseNightRange(params: URLSearchParams): NightRange | null;
 //#endregion
 //#region src/format.d.ts
 /**
@@ -981,7 +983,7 @@ declare function parseNightRange(params: URLSearchParams): NightRange | null;
  * when it is the zero-cents group at the end, so real cents ("1.234,50 €") stay.
  * A real value formatted for display, nothing fabricated; other formats pass.
  */
-declare function tidyPrice(formatted: string): string;
+export declare function tidyPrice(formatted: string): string;
 //#endregion
 //#region src/availability.d.ts
 /**
@@ -1009,9 +1011,9 @@ declare function tidyPrice(formatted: string): string;
  * every calendar fed from this map agrees: the widget's picker and the
  * checkout's copy, which reads the same shape.
  */
-declare function nightlyPrice(formatted: string, locale?: Locale): string;
+export declare function nightlyPrice(formatted: string, locale?: Locale): string;
 type VofficeSdk$1 = WebsiteSdk;
-interface InitialAvailability {
+export interface InitialAvailability {
   /** ISO dates (`YYYY-MM-DD`) the SDK flags as a valid check-in/arrival day. */
   canStart: Set<string>;
   /** ISO dates the rental is genuinely unbookable on (booked / closed / past the
@@ -1032,8 +1034,10 @@ interface InitialAvailability {
    *  arbiter of a bookable party), so `minPersons` isn't surfaced here. */
   maxPersons: number | null;
   maxAdults: number | null;
+  childrenAllowed: boolean | null;
+  maxPets: number | null;
 }
-interface EndAvailability {
+export interface EndAvailability {
   /** ISO dates the SDK flags as a valid check-out/departure for the chosen
    *  start (min-stay + checkout rules already applied by the SDK). */
   canEnd: Set<string>;
@@ -1049,13 +1053,13 @@ interface EndAvailability {
 /** Possible check-in days + occupancy caps for `rentalId` across the window.
  *  The caller's SDK instance is reused so its 30s per-rental cache spans the
  *  picker's lifetime. */
-declare function fetchInitialAvailability(sdk: VofficeSdk$1, rentalId: string, calculateFromDate: string, calculateThroughDate: string, locale: Locale): Promise<InitialAvailability>;
+export declare function fetchInitialAvailability(sdk: VofficeSdk$1, rentalId: string, calculateFromDate: string, calculateThroughDate: string, locale: Locale): Promise<InitialAvailability>;
 /** Possible check-out days for a chosen `selectedStartDate`. */
-declare function fetchEndAvailability(sdk: VofficeSdk$1, rentalId: string, calculateFromDate: string, calculateThroughDate: string, selectedStartDate: string, locale: Locale): Promise<EndAvailability>;
+export declare function fetchEndAvailability(sdk: VofficeSdk$1, rentalId: string, calculateFromDate: string, calculateThroughDate: string, selectedStartDate: string, locale: Locale): Promise<EndAvailability>;
 //#endregion
 //#region src/search.d.ts
 type VofficeSdk = WebsiteSdk;
-interface SearchImage {
+export interface SearchImage {
   src: string;
   srcset?: string | undefined;
   alt: string;
@@ -1070,7 +1074,7 @@ interface SearchImage {
  *  for the single window it used to render. A window whose dates the feed omits
  *  has no label and never reaches this list; one the feed does not price shows
  *  no price rather than a placeholder. */
-interface AlternativePeriod {
+export interface AlternativePeriod {
   /** „31. Aug - 4. Sep", composed from this window's own start and end. */
   label: string;
   /** The detail-page link carrying THIS window's dates, so the rental opens on
@@ -1094,16 +1098,17 @@ interface AlternativePeriod {
     amount: string | null;
   }[];
 }
-interface SearchResultItem {
+export interface SearchResultItem {
   /** PMS id — shared by the result card and its map marker. */
   id: string;
   /** `nameOrLabel`, verbatim. */
   name: string;
   /** `address.city`, verbatim (empty when the feed omits it). */
   location: string;
-  /** Internal detail link, derived from the name (URL generation), with the
-   *  user's booking context (dates + party size) appended as a query so the
-   *  search selection carries into the rental page. */
+  /** Internal detail link — `rentalsPath` (see `runLiveSearch`) + the slug
+   *  derived from the name (URL generation), with the user's booking context
+   *  (dates + party size) appended as a query so the search selection carries
+   *  into the rental page. */
   href: string;
   images: SearchImage[];
   /** Parsed out of the SDK highlights; 0 when the highlight is absent. */
@@ -1207,7 +1212,7 @@ interface SearchResultItem {
     lng: number;
   } | null;
 }
-interface SearchPayload {
+export interface SearchPayload {
   items: SearchResultItem[];
   /** Stay length from the user's start/end query, or null when undated. */
   nights: number | null;
@@ -1219,6 +1224,16 @@ interface SearchPayload {
   /** `pageInfo.hasNextPage`, verbatim. */
   hasNextPage: boolean;
 }
+export interface LiveSearchOptions {
+  /** Path of the site's rental detail pages, prefixed to every result `href`
+   *  before the slug (e.g. `/de/unterkuenfte`). A trailing slash is tolerated.
+   *  Default: `DEFAULT_RENTALS_PATH`. */
+  rentalsPath?: string | undefined;
+}
+/** The rental detail pages' path when the caller names none — the site
+ *  starter's German route. A site whose pages live elsewhere (a locale prefix,
+ *  another segment) passes its own `rentalsPath` to `runLiveSearch`. */
+export declare const DEFAULT_RENTALS_PATH = "/unterkuenfte";
 /**
  * Run a live search for the given URL query string (e.g.
  * `window.location.search`). Builds the SDK query from the picker params,
@@ -1229,28 +1244,34 @@ interface SearchPayload {
  * Pass `cursor` (the previous page's `pageInfo.nextCursor`, treated as
  * opaque) to fetch the next page. The returned `cursor`/`hasNextPage` are
  * the SDK's `pageInfo` straight through, so the caller can keep paging.
+ *
+ * `options.rentalsPath` is the path the site serves its rental detail pages
+ * under — the part of every result `href` before the slug. Routing is the
+ * site's decision (a locale prefix like `/de/unterkuenfte`, another segment),
+ * so it arrives as an option the way `SearchBar.action` and `Quote.checkoutPath`
+ * do; `locale` never implies it. Defaults to `DEFAULT_RENTALS_PATH`.
  */
-declare function runLiveSearch(sdk: VofficeSdk, searchString: string, locale: Locale, cursor?: string | null): Promise<SearchPayload>;
+export declare function runLiveSearch(sdk: VofficeSdk, searchString: string, locale: Locale, cursor?: string | null, options?: LiveSearchOptions): Promise<SearchPayload>;
 //#endregion
 //#region src/sort.d.ts
 /** URL param. A client-side scope like `property`/`region`, NOT an SDK query
  *  key — it is dropped from the SDK query string in search.ts's DROP_KEYS and
  *  travels as the separate `sort` input instead. */
-declare const SORT_PARAM = "sort";
-type SortValue = "empfohlen" | "preis-auf" | "preis-ab";
+export declare const SORT_PARAM = "sort";
+export type SortValue = "empfohlen" | "preis-auf" | "preis-ab";
 /** The backend's own order. Emits no `sort` at all, so it is exactly the
  *  ordering the page has always shown. Typed as the literal (not `SortValue`)
  *  so `value === DEFAULT_SORT` narrows the rest away for `SDK_SORT`. */
-declare const DEFAULT_SORT: "empfohlen";
-interface SortOption {
+export declare const DEFAULT_SORT: "empfohlen";
+export interface SortOption {
   value: SortValue;
   label: string;
   /** Needs a period + occupancy, or the SDK rejects it before transport. */
   pricedOnly?: boolean;
 }
-declare const SORT_OPTIONS: readonly SortOption[];
+export declare const SORT_OPTIONS: readonly SortOption[];
 /** The sort in the URL, or the default when absent/unknown. */
-declare function activeSort(search: string): SortValue;
+export declare function activeSort(search: string): SortValue;
 /**
  * Can this query be priced? Mirrors the SDK's own precondition: a fixed period
  * (`start`+`end`) or a flexible window (`dates`/`month`/`weekend`), AND
@@ -1262,15 +1283,15 @@ declare function activeSort(search: string): SortValue;
  * gate and still reach the SDK undated. `weekend` is the exception — it is a
  * presence-only flag on both sides.
  */
-declare function isPricedQuery(search: string): boolean;
+export declare function isPricedQuery(search: string): boolean;
 /** Is this option selectable for the current query? */
-declare function isSortAvailable(option: SortOption, search: string): boolean;
+export declare function isSortAvailable(option: SortOption, search: string): boolean;
 /**
  * The `sort` to hand the SDK for this URL, or `undefined` for the backend's
  * own order. Falls back to `undefined` (rather than throwing) when a price
  * sort survives in the URL after the dates were cleared.
  */
-declare function resolveSdkSort(search: string): SearchSearchSort | undefined;
+export declare function resolveSdkSort(search: string): SearchSearchSort | undefined;
 //#endregion
 //#region src/filters.d.ts
 /**
@@ -1279,8 +1300,8 @@ declare function resolveSdkSort(search: string): SearchSearchSort | undefined;
  * into `FilterDef[]` (which keys, in which order) and hands the list to the
  * results surface. Boolean filters toggle, integer filters are a lower bound.
  */
-type FilterType = "boolean" | "int";
-interface FilterDef {
+export type FilterType = "boolean" | "int";
+export interface FilterDef {
   /** The URL query key, which is also the SDK's search parameter key. */
   key: string;
   label: string;
@@ -1289,23 +1310,23 @@ interface FilterDef {
   min: number;
   max: number;
 }
-interface ActiveFilter {
+export interface ActiveFilter {
   key: string;
   label: string;
 }
 /** A boolean filter is active when its param is present and truthy. */
-declare const isBooleanFilterActive: (value: string) => boolean;
+export declare const isBooleanFilterActive: (value: string) => boolean;
 /**
  * The filters currently applied in the query, in the order the defs are
  * declared — the removable chips. An `int` label is prefixed with the localized
  * "minimum" wording, because its value is a lower bound.
  */
-declare function activeFiltersFromQuery(searchParams: URLSearchParams, defs: readonly FilterDef[], minimumPrefix: string): ActiveFilter[];
+export declare function activeFiltersFromQuery(searchParams: URLSearchParams, defs: readonly FilterDef[], minimumPrefix: string): ActiveFilter[];
 /** The dog-friendly search as the URL carries it: `pets=true` (or a count) and,
  *  from an older vocabulary, `petsCount=N`. Read by the live search. */
-declare const PETS_PARAM = "pets";
-declare const PETS_COUNT_PARAM = "petsCount";
-declare function petsCountInQuery(search: string): number;
+export declare const PETS_PARAM = "pets";
+export declare const PETS_COUNT_PARAM = "petsCount";
+export declare function petsCountInQuery(search: string): number;
 //#endregion
 //#region src/regions.d.ts
 /**
@@ -1323,18 +1344,18 @@ declare function petsCountInQuery(search: string): number;
  */
 /** URL query key carrying the active region scope. Repeatable: several
  *  `region=<name>` values OR together (show rentals in ANY selected region). */
-declare const REGION_PARAM = "region";
+export declare const REGION_PARAM = "region";
 /** The regions active in a URL query string: the `region` values, trimmed,
  *  de-duplicated, order preserved. Absent or empty → `[]`. */
-declare function activeRegions(search: string): string[];
+export declare function activeRegions(search: string): string[];
 /**
  * The results inside the region scope. A rental may carry several regions
  * (MULTI_SELECT) and matches when any of them is selected; with no active
  * region every result stays. A rental the map does not know is outside every
  * region, so it drops out of a scoped search rather than passing unseen.
  */
-declare function scopeToRegions<T extends {
+export declare function scopeToRegions<T extends {
   id: string;
 }>(items: readonly T[], active: readonly string[], regionsByRentalId: (id: string) => readonly string[] | undefined): T[];
 //#endregion
-export { ActiveFilter, AlternativePeriod, BOOKING_SNAPSHOT_KEY, BUTTON_SOLUTION_PATTERN, BookingConfirmation, BookingContactForm, BookingSnapshot, BookingSnapshotGuests, CHECKOUT_CONTEXT_KEY, CHECKOUT_PARTS, CHECKOUT_RETURN_PATH, CHECKOUT_STRUCTURE, CheckoutContext, type CheckoutFlow, type CheckoutFlowActions, type CheckoutFlowApi, type CheckoutFlowMessages, type CheckoutFlowOptions, type CheckoutFlowState, type CheckoutIssue, type CheckoutPart, type CheckoutPhase, type CountryGroupsLike, DEFAULT_SORT, EndAvailability, FilterDef, FilterType, HUB_ENDPOINTS, InitialAvailability, type InsuranceDocsState, InsurancePaymentLink, Listener, type Locale, MULTI_RATE_CODES, NIGHT_RANGE_ENABLED, NIGHT_RANGE_KEYS, NO_INSURANCE_DOCS, NightRange, PETS_COUNT_PARAM, PETS_PARAM, PaymentLine, PaymentScheduleView, PolicyBranch, PriceQuote, QuoteAddonService, QuoteCancellationPolicy, QuoteInsurance, QuoteInsuranceOption, QuoteLine, QuoteOccupancy, QuotePolicyRule, QuoteResult, QuoteSelectionResult, QuoteUnavailableCode, QuoteView, QuoteVoucher, REGION_PARAM, SORT_OPTIONS, SORT_PARAM, STAGES, SdkConfig, SearchImage, SearchPayload, SearchResultItem, SnapshotImage, SortOption, SortValue, Stage, type Stay, Store, type StructureViolation, Unsubscribe, VALIDATED_FIELDS, VOFFICE_ENDPOINTS, type ValidationMessages, WebsiteSdk, WritableStore, activeFiltersFromQuery, activeRegions, activeSort, adaptGuestQuote, addQuoteService, assertCheckoutStructure, clearQuoteServices, createCheckoutFlow, createSdk, createStore, describeSdkError, detectCountry, emailError, fetchEndAvailability, fetchInitialAvailability, fetchQuote, fieldError, freeCancellationUntil, fullRefundRule, insuranceDocsPending, insuranceIdToReapply, insuranceProductKey, isBooleanFilterActive, isPricedQuery, isRateConfigurationFault, isSortAvailable, isSubmittableOption, isoDate, logSdkFailure, nightlyPrice, normalizePhone, occupancyOf, parseGermanParam, parseNightRange, parseParam, payWithOption, petsCountInQuery, phoneError, policyFreeCancellationUntil, postalcodeError, pricePolicyBranches, removeQuoteService, resolveSdkSort, runLiveSearch, saveBookingSnapshot, saveCheckoutContext, scopeToRegions, sdkConfigFor, selectQuoteInsurance, selectQuotePolicy, selectableInsuranceOptions, selectedInsuranceOption, shownInsuranceResources, stabilizeCardOrder, stayKeyOf, stayParams, streetWarning, submitBooking, tidyPrice };
+export type { CheckoutFlow, CheckoutFlowActions, CheckoutFlowApi, CheckoutFlowMessages, CheckoutFlowOptions, CheckoutFlowState, CheckoutIssue, CheckoutPart, CheckoutPhase, CountryGroupsLike, InsuranceDocsState, Locale, Stay, StructureViolation, ValidationMessages };

package/dist/index.mjs

@@ -1384,17 +1384,19 @@ function detectCountry(countries) {
 * checkout UI can silently drop a legal obligation — the § 312j BGB
 * Button-Lösung wording, the insurance documents listed before the guest's
 * confirmation, the price stated directly above the order button — and every
-* unit test still passes. This module is a contract over the RENDERED result,
-* checked by the platform's publish gate for imported and custom checkouts
-* alike.
+* unit test still passes. This module is a contract over the RENDERED result.
+* The imported `Booking` component satisfies it by construction; a site's own
+* checkout is a developer's review item when it changes. The platform does
+* NOT run this assertion at publish time (decided 2026-09-11,
+* docs/website-platform/process/10-dist-checks.md "Custom checkouts").
 *
 * Two halves:
 *   - `CHECKOUT_PARTS`: the `data-part` vocabulary. Imported components carry
-*     these attributes; a site's own markup must keep them so the gate (and
-*     a site's own CSS) can find the elements.
+*     these attributes; a site's own markup must keep them so this check
+*     (and a site's own CSS) can find the elements.
 *   - `CHECKOUT_STRUCTURE` + `assertCheckoutStructure(root)`: the requirements
-*     and a pure DOM check the smoke suite runs against the rendered checkout
-*     (a browser page or a jsdom document). Every requirement names the legal
+*     and a pure DOM check over a rendered checkout (a browser page or a
+*     jsdom document in a test). Every requirement names the legal
 *     basis it exists for, so a failure message tells the reader WHY.
 */
 const CHECKOUT_PARTS = {
@@ -1442,8 +1444,8 @@ function precedes(a, b) {
 	return (a.compareDocumentPosition(b) & 4) === 4;
 }
 /**
-* Check a rendered checkout. `root` is `document` in the smoke suite's browser
-* page, or a jsdom document in tests. Returns every violation found (empty =
+* Check a rendered checkout. `root` is `document` in a browser page, or a
+* jsdom document in tests. Returns every violation found (empty =
 * compliant). The insurance rule is conditional on purpose: the duty attaches
 * to concluding an insurance contract, so a checkout that renders no
 * confirmation control has nothing to gate.
@@ -1451,7 +1453,7 @@ function precedes(a, b) {
 /** The text a sighted guest sees: descendants hidden by the `hidden` attribute,
 *  `aria-hidden` or an inline display/visibility rule are excluded, so a legal
 *  phrase in a hidden span cannot satisfy the wording rule. Stylesheet-based
-*  hiding needs layout and is the smoke suite's browser run to catch. */
+*  hiding needs layout and only a browser run can catch it. */
 function visibleText(el) {
 	let text = "";
 	for (const node of el.childNodes) if (node.nodeType === 3) text += node.textContent ?? "";
@@ -1598,7 +1600,9 @@ async function fetchInitialAvailability(sdk, rentalId, calculateFromDate, calcul
 			priceByDay,
 			tooltipByDay,
 			maxPersons: out.maxPersons ?? null,
-			maxAdults: out.maxAdults ?? null
+			maxAdults: out.maxAdults ?? null,
+			childrenAllowed: out.childrenAllowed ?? null,
+			maxPets: out.maxPets ?? null
 		};
 	}
 }
@@ -1889,14 +1893,18 @@ function buildHandover(params, dates) {
 	const suffix = out.toString();
 	return suffix ? `?${suffix}` : "";
 }
-function mapBase(item) {
+/** The rental detail pages' path when the caller names none — the site
+*  starter's German route. A site whose pages live elsewhere (a locale prefix,
+*  another segment) passes its own `rentalsPath` to `runLiveSearch`. */
+const DEFAULT_RENTALS_PATH = "/unterkuenfte";
+function mapBase(item, rentalsPath) {
 	const name = item.nameOrLabel.trim();
 	const highlights = item.highlights ?? [];
 	return {
 		id: item.id,
 		name,
 		location: item.address?.city?.trim() ?? "",
-		href: `/unterkuenfte/${slugify(name)}`,
+		href: `${rentalsPath.replace(/\/+$/, "")}/${slugify(name)}`,
 		images: (item.images ?? []).map((img) => ({
 			src: img.src,
 			srcset: img.srcset?.trim() || void 0,
@@ -1946,11 +1954,11 @@ function mapDiscount(discount) {
 		})
 	};
 }
-function mapItem(item, params, locale) {
+function mapItem(item, params, locale, rentalsPath) {
 	const scopeType = typeof item.scope === "string" ? item.scope : item.scope?.type;
 	const alternativePeriodLabel = formatPeriodLabel(item.alternativePeriod ?? (typeof item.scope === "object" ? item.scope.alternativePeriod : void 0), locale);
 	const isAlternativePeriod = alternativePeriodLabel != null || scopeType === "alternativePeriod" || scopeType === "alternative-period";
-	const base = mapBase(item);
+	const base = mapBase(item, rentalsPath);
 	return {
 		...base,
 		href: `${base.href}${buildHandover(params)}`,
@@ -1967,8 +1975,8 @@ function mapItem(item, params, locale) {
 *  label come from the first candidate period (the SDK returns them best-first,
 *  `boost`-ordered). Always flagged as an alternative so the card shows the
 *  period pill instead of treating it as an exact total. */
-function mapAlternativeEntry(entry, params, locale) {
-	const base = mapBase(entry.item);
+function mapAlternativeEntry(entry, params, locale, rentalsPath) {
+	const base = mapBase(entry.item, rentalsPath);
 	const periods = (entry.alternativePeriods ?? []).flatMap((candidate) => {
 		const label = formatPeriodLabel({
 			start: candidate.start,
@@ -2016,8 +2024,15 @@ function mapAlternativeEntry(entry, params, locale) {
 * Pass `cursor` (the previous page's `pageInfo.nextCursor`, treated as
 * opaque) to fetch the next page. The returned `cursor`/`hasNextPage` are
 * the SDK's `pageInfo` straight through, so the caller can keep paging.
+*
+* `options.rentalsPath` is the path the site serves its rental detail pages
+* under — the part of every result `href` before the slug. Routing is the
+* site's decision (a locale prefix like `/de/unterkuenfte`, another segment),
+* so it arrives as an option the way `SearchBar.action` and `Quote.checkoutPath`
+* do; `locale` never implies it. Defaults to `DEFAULT_RENTALS_PATH`.
 */
-async function runLiveSearch(sdk, searchString, locale, cursor) {
+async function runLiveSearch(sdk, searchString, locale, cursor, options = {}) {
+	const rentalsPath = options.rentalsPath ?? "/unterkuenfte";
 	const params = new URLSearchParams(searchString);
 	const nights = computeNights(params);
 	const sort = resolveSdkSort(searchString);
@@ -2030,9 +2045,9 @@ async function runLiveSearch(sdk, searchString, locale, cursor) {
 			...sort ? { sort } : {},
 			...cursor ? { cursor } : {}
 		});
-		const exact = result.items.map((item) => mapItem(item, params, locale));
+		const exact = result.items.map((item) => mapItem(item, params, locale, rentalsPath));
 		const exactIds = new Set(exact.map((item) => item.id));
-		const alternatives = (result.alternatives ?? []).filter((entry) => entry?.item?.id && !exactIds.has(entry.item.id)).map((entry) => mapAlternativeEntry(entry, params, locale));
+		const alternatives = (result.alternatives ?? []).filter((entry) => entry?.item?.id && !exactIds.has(entry.item.id)).map((entry) => mapAlternativeEntry(entry, params, locale, rentalsPath));
 		const items = exact.concat(alternatives);
 		return {
 			items,
@@ -2082,4 +2097,4 @@ function scopeToRegions(items, active, regionsByRentalId) {
 	return items.filter((item) => regionsByRentalId(item.id)?.some((r) => active.includes(r)));
 }
 //#endregion
-export { BOOKING_SNAPSHOT_KEY, BUTTON_SOLUTION_PATTERN, CHECKOUT_CONTEXT_KEY, CHECKOUT_PARTS, CHECKOUT_RETURN_PATH, CHECKOUT_STRUCTURE, DEFAULT_SORT, HUB_ENDPOINTS, MULTI_RATE_CODES, NIGHT_RANGE_ENABLED, NIGHT_RANGE_KEYS, NO_INSURANCE_DOCS, PETS_COUNT_PARAM, PETS_PARAM, REGION_PARAM, SORT_OPTIONS, SORT_PARAM, STAGES, VALIDATED_FIELDS, VOFFICE_ENDPOINTS, activeFiltersFromQuery, activeRegions, activeSort, adaptGuestQuote, addQuoteService, assertCheckoutStructure, clearQuoteServices, createCheckoutFlow, createSdk, createStore, describeSdkError, detectCountry, emailError, fetchEndAvailability, fetchInitialAvailability, fetchQuote, fieldError, freeCancellationUntil, fullRefundRule, insuranceDocsPending, insuranceIdToReapply, insuranceProductKey, isBooleanFilterActive, isPricedQuery, isRateConfigurationFault, isSortAvailable, isSubmittableOption, isoDate, logSdkFailure, nightlyPrice, normalizePhone, occupancyOf, parseGermanParam, parseNightRange, parseParam, payWithOption, petsCountInQuery, phoneError, policyFreeCancellationUntil, postalcodeError, pricePolicyBranches, removeQuoteService, resolveSdkSort, runLiveSearch, saveBookingSnapshot, saveCheckoutContext, scopeToRegions, sdkConfigFor, selectQuoteInsurance, selectQuotePolicy, selectableInsuranceOptions, selectedInsuranceOption, shownInsuranceResources, stabilizeCardOrder, stayKeyOf, stayParams, streetWarning, submitBooking, tidyPrice };
+export { BOOKING_SNAPSHOT_KEY, BUTTON_SOLUTION_PATTERN, CHECKOUT_CONTEXT_KEY, CHECKOUT_PARTS, CHECKOUT_RETURN_PATH, CHECKOUT_STRUCTURE, DEFAULT_RENTALS_PATH, DEFAULT_SORT, HUB_ENDPOINTS, MULTI_RATE_CODES, NIGHT_RANGE_ENABLED, NIGHT_RANGE_KEYS, NO_INSURANCE_DOCS, PETS_COUNT_PARAM, PETS_PARAM, REGION_PARAM, SORT_OPTIONS, SORT_PARAM, STAGES, VALIDATED_FIELDS, VOFFICE_ENDPOINTS, activeFiltersFromQuery, activeRegions, activeSort, adaptGuestQuote, addQuoteService, assertCheckoutStructure, clearQuoteServices, createCheckoutFlow, createSdk, createStore, describeSdkError, detectCountry, emailError, fetchEndAvailability, fetchInitialAvailability, fetchQuote, fieldError, freeCancellationUntil, fullRefundRule, insuranceDocsPending, insuranceIdToReapply, insuranceProductKey, isBooleanFilterActive, isPricedQuery, isRateConfigurationFault, isSortAvailable, isSubmittableOption, isoDate, logSdkFailure, nightlyPrice, normalizePhone, occupancyOf, parseGermanParam, parseNightRange, parseParam, payWithOption, petsCountInQuery, phoneError, policyFreeCancellationUntil, postalcodeError, pricePolicyBranches, removeQuoteService, resolveSdkSort, runLiveSearch, saveBookingSnapshot, saveCheckoutContext, scopeToRegions, sdkConfigFor, selectQuoteInsurance, selectQuotePolicy, selectableInsuranceOptions, selectedInsuranceOption, shownInsuranceResources, stabilizeCardOrder, stayKeyOf, stayParams, streetWarning, submitBooking, tidyPrice };

package/instructions/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+<!-- generated by `node .github/release/cli.mts index`; do not edit by hand -->
+
+Release notes of `@v-office/website-headless`, newest first. Each version has its own directory.
+
+- `versions/0.2.0/CHANGELOG.md`: release notes for 0.2.0
+- `versions/0.1.1/CHANGELOG.md`: release notes for 0.1.1

package/instructions/MIGRATION.md

@@ -0,0 +1,8 @@
+# Migration
+
+<!-- generated by `node .github/release/cli.mts index`; do not edit by hand -->
+
+Migration guides of `@v-office/website-headless`, newest first. Apply them in order when skipping versions.
+
+- `versions/0.2.0/MIGRATION.md`: Migration: 0.1.1 to 0.2.0
+- `versions/0.1.1/MIGRATION.md`: Migration to 0.1.1

package/instructions/versions/0.1.1/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog: 0.1.1
+
+Baseline of the shipped release notes for `@v-office/website-headless`. The package is the framework-free behavior layer of the website platform: the checkout flow as a store, validation and insurance rules, the checkout's structural requirements and the progressive-enhancement engines.
+
+Changes before 0.1.1 are recorded in this repository's git history only. From
+this version on, every release carries its own `CHANGELOG.md` and
+`MIGRATION.md` in `instructions/versions/<version>/`.

package/instructions/versions/0.1.1/MIGRATION.md

@@ -0,0 +1,4 @@
+# Migration to 0.1.1
+
+No changes required. 0.1.1 is the version that was published when the shipped
+release notes were introduced; consumers already on it stay as they are.

package/instructions/versions/0.1.1/release.json

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

package/instructions/versions/0.2.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog: 0.2.0
+
+The initial availability of the booking date picker now carries the v9 rules for children and
+pets, so a guest selector can stop offering a party the quote would refuse.
+
+## Added
+
+- `fetchInitialAvailability` returns `childrenAllowed` and `maxPets` in its
+  `InitialAvailability`. On v9 with `@v-office/website-sdk` 2.28.0 or later,
+  `childrenAllowed` is `false` when the rental takes no children, babies included, and
+  `maxPets` is the most pets the quote accepts, `0` for none. Both are `null` on v10, with an
+  older SDK and when the rental states no rule; `null` means no limit.
+
+## Unchanged
+
+- `maxPersons` and `maxAdults` keep their meaning. On v9 they carry the rental's limits from
+  `@v-office/website-sdk` 2.28.0 on, where they were `null` before.

package/instructions/versions/0.2.0/MIGRATION.md

@@ -0,0 +1,16 @@
+# Migration: 0.1.1 to 0.2.0
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-headless@0.2.0
+```
+
+No changes are required for code that reads `fetchInitialAvailability`. Code that builds an
+`InitialAvailability` itself, such as a test fixture, adds `childrenAllowed: null` and
+`maxPets: null`.
+
+A site with its own guest selector can use the two fields: offer neither children nor babies
+when `childrenAllowed` is `false`, and cap pets at `maxPets`, hiding them at `0`. Keep a
+selection the guest arrived with visible until they remove it, so a party the quote refuses
+can still be corrected.

package/instructions/versions/0.2.0/release.json

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

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@v-office/website-headless",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-free behavior layer for v-office websites, never UI: the checkout flow as a subscribable store (createCheckoutFlow), validation and insurance rules, the checkout's structural requirements, the live search, availability and quote runners over a caller-owned SDK, and progressive-enhancement engines for server-rendered markup",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "instructions"
   ],
   "type": "module",
   "sideEffects": false,
@@ -18,14 +19,14 @@
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "26.1.2",
-    "@v-office/website-sdk": "2.18.0",
+    "@types/node": "26.5.1",
+    "@v-office/website-sdk": "2.28.0",
     "jsdom": "^30.0.1",
-    "oxfmt": "0.62.0",
-    "oxlint": "1.77.0",
-    "tsdown": "0.22.14",
+    "oxfmt": "0.67.0",
+    "oxlint": "1.82.0",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.0"
   },
   "peerDependencies": {
     "@v-office/website-sdk": ">=2.13.0 <3"
@@ -42,6 +43,6 @@
     "fmt": "oxfmt",
     "fmt:check": "oxfmt --check",
     "check": "pnpm run typecheck && pnpm run lint && pnpm run fmt:check",
-    "test": "vitest run"
+    "test": "vitest run && node --test test/dist.node.mjs"
   }
 }