@wix/himalaya-cli 0.995.0 → 0.996.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts

@@ -612,6 +612,10 @@ export interface ButtonProps {
     title: string;
     action: Action;
     style?: string;
+    /** Literal only, NOT bindable: a `"$service:…"` string here fails `validate`, and there is no
+     *  `disabledPath`. To disable from worker state, author two buttons — the live one and a
+     *  `disabled: true` copy — and swap them with complementary `modifiers.hiddenPath` flags
+     *  (e.g. `canSubmit` / `cannotSubmit`); also guard the action so a stray tap is a no-op. */
     disabled?: boolean;
     /** RFC 0034 — capability enrichments. */
     leadingIcon?: IconRef;
@@ -981,7 +985,9 @@ export interface FilterChip {
 }
 export interface FilterChipsProps {
     chips: FilterChip[];
-    /** Literal ids, or a binding-aware `$service:`/`$item.` live selection. */
+    /** Literal ids, or binding-aware: put the `$service:` sentinel INSIDE the array as its ONE
+     *  element — `selectedIds: ["$service:<svc>.<field>"]`, where the field holds the selected
+     *  ids. A bare `"$service:…"` string is rejected by `validate` — the prop is an array. */
     selectedIds?: string[];
     multiSelect?: boolean;
     onChange?: Action;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/tokens.d.ts

@@ -244,9 +244,16 @@ export interface TypographyToken {
     size: number;
     weight: number;
     line: number;
+    /** A font family name, or {@link SYSTEM_FONT_FAMILY} for the platform's own system font.
+     *  Absent → the renderer's default face. */
     family?: string;
     letterSpacing?: number;
 }
+/** The `family` sentinel for "this platform's system font" — SF Pro on iOS / macOS, Roboto on
+ *  Android, the browser's system UI stack on the web. Absent `family` cannot say this from an
+ *  idiom overlay, because overlays deep-merge and an absent key keeps the base family. It is
+ *  never a real family, so nothing bakes, packs or declares a face for it. */
+export declare const SYSTEM_FONT_FAMILY = "$system";
 /** RFC 0020 — a drop shadow. `color` is a hex string; `opacity` multiplies its
  *  alpha; `radius` is the blur radius; `x`/`y` the offset. All in points. */
 export interface ShadowToken {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/bookings-v2/src/extensions.d.ts

@@ -181,7 +181,12 @@ export interface WixQueryAvailabilityResponse {
  *  a `paging: { limit }` you add is silently dropped rather than honoured. */
 export interface WixServiceAvailabilityOptions {
     /** Bookable slots only. Defaults to `true`; pass `false` to get the unbookable
-     *  ones too (a greyed-out calendar), which is what the endpoint returns unfiltered. */
+     *  ones too (a greyed-out calendar), which is what the endpoint returns unfiltered.
+     *  `false` OMITS the filter key rather than sending `bookable: false` — the latter
+     *  is a filter for unbookable slots ONLY, i.e. an empty calendar on a live site.
+     *  Unfiltered is the large response described below, so keep the window to the
+     *  days on screen. For unbookable slots alone, filter the entries on
+     *  `entry.bookable === false`. */
     bookable?: boolean;
 }
 /**
@@ -227,11 +232,41 @@ export interface WixQueryResourcesResponse {
 export declare function queryResources(limit?: number): Promise<WixQueryResourcesResponse>;
 /** Convenience: staff members = resources tagged "staff" (filtered client-side). */
 export declare function queryStaff(limit?: number): Promise<WixResource[]>;
+/** How the customer intends to pay — the Create Booking `SelectedPaymentOption` enum.
+ *  `OFFLINE` = pay in person at the venue; `ONLINE` = pay through checkout;
+ *  `MEMBERSHIP` = a Wix Pricing Plan; `MEMBERSHIP_OFFLINE` = a pricing plan the
+ *  business redeems by hand. It must be one the service offers. */
+export type WixSelectedPaymentOption = "OFFLINE" | "ONLINE" | "MEMBERSHIP" | "MEMBERSHIP_OFFLINE";
+export interface WixBookSlotOptions {
+    /** Sent as `booking.selectedPaymentOption`. Omitted from the request when unset,
+     *  so a call without it sends exactly the body it always did. */
+    selectedPaymentOption?: WixSelectedPaymentOption;
+}
 /** Book a specific availability slot — POST /bookings/v2/bookings. Pass the FULL
  *  slot from queryServiceAvailability + the booker's contact. The v1 createBooking
  *  above rejects a bare slot; the v2 route with bookedEntity.slot is the one that
- *  works. Verified live (status CREATED). */
-export declare function bookSlot(slot: WixBookingSlotFull, firstName: string, lastName: string, email: string): Promise<WixCreateBookingResponse>;
+ *  works. Verified live (status CREATED).
+ *
+ *  A visitor booking a PAID service to pay in person (no on-device payment) is a
+ *  three-call chain:
+ *
+ *    1. `bookSlot(slot, first, last, email, { selectedPaymentOption: "OFFLINE" })`
+ *       → the booking, status CREATED.
+ *    2. `createCheckout([{ quantity: 1, catalogReference: { appId: <Wix Bookings
+ *       appDefId 13d21c63-b5ec-5912-8397-c3a5ddb27a97>, catalogItemId: booking.id } }])`
+ *       from `@himalaya/wix-ecom` → the checkout id.
+ *    3. `createOrder(checkoutId)` from `@himalaya/wix-ecom` → the order, with the
+ *       balance left for the venue to collect.
+ *
+ *  This chain was verified with raw Wix calls, not through these wrappers.
+ *  It is not verified whether `createOrder` still returns a `paymentGatewayOrderId`
+ *  for an OFFLINE booking, so do not read one as "charge now" and send a
+ *  pay-in-person customer into the cashier.
+ *
+ *  Wix documents `selectedPaymentOption` as REQUIRED whenever the booking is paid
+ *  through an eCommerce checkout, and it must be an option the service offers.
+ *  Leave `options` out and the request is the one this function always sent. */
+export declare function bookSlot(slot: WixBookingSlotFull, firstName: string, lastName: string, email: string, options?: WixBookSlotOptions): Promise<WixCreateBookingResponse>;
 export interface WixBookingAdditionalField {
     id?: string;
     label?: string;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs

@@ -7774,6 +7774,7 @@ function resolveResponsiveSize(rs, width) {
   if (width >= 600) return rs.medium ?? rs.base;
   return rs.base;
 }
+var SYSTEM_FONT_FAMILY = "$system";
 function buildTokenRegistry(tokens) {
   return {
     colors: new Set(Object.keys(tokens.colors ?? {})),
@@ -12906,6 +12907,7 @@ export {
   SUPPORTED_LOCALES,
   SURFACE_GROUPS,
   SURFACE_VIEW_LADDER,
+  SYSTEM_FONT_FAMILY,
   UNIVERSAL_LAUNCH_NAMESPACES,
   WIDGET_COMPONENTS,
   WIDGET_FAMILIES,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-bookings.mjs

@@ -65,9 +65,9 @@ function rescheduleBooking(bookingId, slot, revision, notify = false) {
 }
 function queryServiceAvailability(serviceId, startDate, endDate, options = {}) {
   if (!serviceId) throw new Error("queryServiceAvailability: serviceId is required");
-  const { bookable = true } = options;
+  const { bookable = true } = options ?? {};
   return wixCall("POST", "/bookings/v1/availability/query", {
-    query: { filter: { serviceId: [serviceId], startDate, endDate, bookable } }
+    query: { filter: { serviceId: [serviceId], startDate, endDate, ...bookable ? { bookable: true } : {} } }
   });
 }
 function queryResources(limit = 100) {
@@ -79,9 +79,15 @@ async function queryStaff(limit = 100) {
   const res = await queryResources(limit);
   return (res.resources ?? []).filter((r) => (r.tags ?? []).includes("staff"));
 }
-function bookSlot(slot, firstName, lastName, email) {
+function bookSlot(slot, firstName, lastName, email, options) {
+  const selectedPaymentOption = options?.selectedPaymentOption;
   return wixCall("POST", "/bookings/v2/bookings", {
-    booking: { bookedEntity: { slot }, contactDetails: { firstName, lastName, email }, totalParticipants: 1 }
+    booking: {
+      bookedEntity: { slot },
+      contactDetails: { firstName, lastName, email },
+      totalParticipants: 1,
+      ...selectedPaymentOption ? { selectedPaymentOption } : {}
+    }
   });
 }
 function getBookingFull(bookingId) {