@alfadocs/ui-kit 0.33.10 → 0.34.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.33.10",
+  "packageVersion": "0.34.0",
   "components": [
     {
       "kind": "component",

package/dist/components/booking/booking-types.d.ts

@@ -62,9 +62,30 @@ export interface BookingDetails {
 export interface BookingValue {
     insuranceType?: InsuranceType;
     specialtyId?: string;
+    /**
+     * Multi-select form of `specialtyId` — set this instead of (or alongside)
+     * `specialtyId` when `specialtyPickerStyle='multi-select'`. The cascade
+     * reads this array first and treats services / operators / slots as a
+     * union of the selected specialties. When both are set, the array wins.
+     * Added in 0.34.0.
+     */
+    specialtyIds?: string[];
     serviceId?: string;
+    /**
+     * Multi-select form of `serviceId` — see `specialtyIds`. Set when
+     * `servicePickerStyle='multi-select'`. Union semantics. Added in 0.34.0.
+     */
+    serviceIds?: string[];
     /** May be the literal `'all'` sentinel to mean "no operator preference". */
     operatorId?: string;
+    /**
+     * Multi-select form of `operatorId` — see `specialtyIds`. Set when
+     * `operatorPickerStyle='multi-select'`. The kit doesn't filter slots by
+     * operator itself (the consumer owns slot resolution), but consumers
+     * using multi-select operator typically filter `availableSlots` to the
+     * union of `operatorIds` before passing the data in. Added in 0.34.0.
+     */
+    operatorIds?: string[];
     /** YYYY-MM-DD. */
     date?: string;
     /** Opaque key from `availableSlots[date]`. */
@@ -179,6 +200,64 @@ export interface BookingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ari
      * reflect the new ISO when this fires.
      */
     onDateSelect?: (iso: string) => void;
+    /**
+     * Fires when the visible 4-day window starts or shifts. Used by
+     * two-query consumers to lazy-fetch `dailySlots/{date}` for the
+     * newly-visible days. Receives the inclusive ISO date strings of
+     * the first and last visible day in the window. Fires on mount
+     * (with the resolved initial window) and on every prev/next
+     * arrow click, internal jump-to-next-available action, and
+     * automatic re-sync triggered by `availableDates` arriving.
+     *
+     * Only fires when `datePickerStyle='four-day-grid'` — the
+     * month-calendar picker has no "window" concept; consumers using
+     * that style fetch availability per visible month and don't need
+     * this signal.
+     */
+    onWindowChange?: (startIso: string, endIso: string) => void;
+    /**
+     * @default 'select'
+     * UI rendered for the Specialty step. Independent of layout `variant`.
+     *
+     * - `'select'` (default): the kit's `<Select>` dropdown — current behaviour.
+     * - `'combobox'`: single-select `<Combobox>` with type-ahead search.
+     *   Pays off for long specialty lists (>10 entries).
+     * - `'multi-select'`: multi-select `<MultiSelect>` with chip-rendered
+     *   selections. Writes to `value.specialtyIds` (array). The cascade reads
+     *   the array as a union — services / operators / slots are filtered
+     *   by ANY of the selected specialties. Added in 0.34.0.
+     */
+    specialtyPickerStyle?: 'select' | 'combobox' | 'multi-select';
+    /**
+     * @default 'cards' for `variant='inline-list'`, `'select'` for others
+     * UI rendered for the Service step. Independent of layout `variant`.
+     *
+     * - `'cards'`: visual card grid (the long-standing `ServiceCardGroup`
+     *   used by inline-list). Card layout, one row per service with icon,
+     *   label, and duration.
+     * - `'select'`: compact `<Select>` dropdown (default for the chrome-
+     *   denser variants — calendar / flexible / accordion / progress).
+     * - `'combobox'`: single-select `<Combobox>` with type-ahead search.
+     * - `'multi-select'`: multi-select `<MultiSelect>` writing to
+     *   `value.serviceIds`. Cascade reads as union — operators / slots are
+     *   filtered by ANY of the selected services. Added in 0.34.0.
+     */
+    servicePickerStyle?: 'select' | 'combobox' | 'multi-select' | 'cards';
+    /**
+     * @default 'select'
+     * UI rendered for the Operator step. Independent of layout `variant`.
+     *
+     * - `'select'` (default): `<Select>` dropdown including the implicit
+     *   `'all'` "any operator" sentinel.
+     * - `'combobox'`: single-select `<Combobox>` with type-ahead search.
+     * - `'multi-select'`: multi-select `<MultiSelect>` writing to
+     *   `value.operatorIds`. The kit doesn't filter slots by operator
+     *   itself — the consumer owns slot resolution — but consumers using
+     *   multi-select operator typically filter `availableSlots` to the
+     *   union of selected operators before passing the data in. Added
+     *   in 0.34.0.
+     */
+    operatorPickerStyle?: 'select' | 'combobox' | 'multi-select';
     /**
      * @default 'month-calendar'
      * Selects the date + slot picker rendered inside the cascade's date

package/dist/components/booking/cascade.d.ts

@@ -66,8 +66,24 @@ export interface CascadeOutputs {
 export declare function deriveCascade(inputs: CascadeInputs): CascadeOutputs;
 export declare function resetOnInsuranceChange(value: BookingValue, next: InsuranceType | undefined): BookingValue;
 export declare function resetOnSpecialtyChange(value: BookingValue, next: string | undefined): BookingValue;
+/**
+ * Multi-select counterpart to `resetOnSpecialtyChange`. Writes the
+ * `specialtyIds` array form and clears any single-form `specialtyId`
+ * so the cascade reads the array. Added in 0.34.0.
+ */
+export declare function resetOnSpecialtyIdsChange(value: BookingValue, next: string[] | undefined): BookingValue;
 export declare function resetOnServiceChange(value: BookingValue, next: string | undefined): BookingValue;
+/** Multi-select counterpart to `resetOnServiceChange`. Added in 0.34.0. */
+export declare function resetOnServiceIdsChange(value: BookingValue, next: string[] | undefined): BookingValue;
 export declare function resetOnOperatorChange(value: BookingValue, next: string | undefined): BookingValue;
+/** Multi-select counterpart to `resetOnOperatorChange`. Added in 0.34.0. */
+export declare function resetOnOperatorIdsChange(value: BookingValue, next: string[] | undefined): BookingValue;
+/** Returns the effective specialty selection as an array. Empty when nothing picked. */
+export declare function resolveSpecialtyIds(value: BookingValue): string[];
+/** Returns the effective service selection as an array. Empty when nothing picked. */
+export declare function resolveServiceIds(value: BookingValue): string[];
+/** Returns the effective operator selection as an array. Empty when nothing picked. */
+export declare function resolveOperatorIds(value: BookingValue): string[];
 export declare function resetOnDateChange(value: BookingValue, next: string | undefined): BookingValue;
 export declare function resetOnSlotChange(value: BookingValue, next: string | undefined): BookingValue;
 export declare function applyAutoSelects(value: BookingValue, inputs: CascadePolicy & {

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-x4GlW5cb.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-eM0y0NIR.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/index.js

@@ -126,7 +126,7 @@ import { S as Tn, a as bn } from "./_chunks/suggestion-chip-C4kxWUIs.js";
 import { s as Rn } from "./_chunks/suggestion-chip.agent-6sNWFj7m.js";
 import { T as hn, t as Fn } from "./_chunks/transcript-panel-DyhTpAP7.js";
 import { T as Ln } from "./_chunks/typing-indicator-DHeVN4ob.js";
-import { B as kn, C as On, O as _n, b as yn } from "./_chunks/booking-x4GlW5cb.js";
+import { B as kn, C as On, O as _n, b as yn } from "./_chunks/booking-eM0y0NIR.js";
 import { C as Mn, c as Dn, r as wn } from "./_chunks/calendar-YHFknAGv.js";
 import { O as vn, o as Hn } from "./_chunks/operator-hero-7LiiP7zi.js";
 import { P as Gn, p as Un } from "./_chunks/patient-search-CBq62kmL.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit",
-  "version": "0.33.10",
+  "version": "0.34.0",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe.",
   "license": "BUSL-1.1",