@nickkupriyanov/slotline-react 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -1,21 +1,32 @@
 import * as react from 'react';
 import { ReactNode, ComponentPropsWithoutRef } from 'react';
-import { BookingAdapter, BuiltInLocale, SlotlineMessages, SlotlineTheme, BookingResult, BookingRequest, SlotlineClassSlot, FlowState, DayAvailability, FieldErrors, TimeSlot, ClassValue } from '@nickkupriyanov/slotline-core';
-export { AvailabilityQuery, BookingAdapter, BookingDetails, BookingRequest, BookingResult, DayAvailability, FLOW_STEPS, FieldErrors, FlowAction, FlowState, LoadStatus, MockAdapterOptions, SLOT_CLASS, SlotlineClassSlot, SlotlineMessages, SlotlineStep, SlotlineTheme, SlotsQuery, TimeSlot, addDays, addMonths, buildMonthGrid, compareDayKeys, countSlots, createFlowState, createMockAdapter, cx, dayKeyOf, dayKeyOfInstant, defaultMessages, flowReducer, format, formatFullDay, formatMonthYear, formatTime, formatTimeZoneName, isDayKey, monthKeyOf, resolveMessages, stepIndex, todayKey, validateDetails } from '@nickkupriyanov/slotline-core';
+import { DefaultBookingValues, BookingAdapter, AvailabilityAdapter, BookingChangeMetadata, BuiltInLocale, SlotlineMessages, SlotlineTheme, TimeFormat, BookingContext, InitialBookingAttempt, BookingResult, BookingRequest, BookingError, BookingErrorContext, SlotlineClassSlot, BookingSnapshot, BookingControllerActions, ClassValue } from '@nickkupriyanov/slotline-core';
+export { AvailabilityAdapter, AvailabilityQuery, BOOKING_ERROR_CODES, BookingAction, BookingAdapter, BookingAttemptOutcome, BookingAttemptState, BookingCapabilities, BookingChangeMetadata, BookingClock, BookingConfig, BookingConfigInput, BookingConfigOverrides, BookingContext, BookingController, BookingControllerActions, BookingControllerHandlers, BookingControllerInputs, BookingControllerOptions, BookingDetails, BookingError, BookingErrorCode, BookingErrorContext, BookingFieldConfig, BookingFieldOption, BookingFieldType, BookingInvitation, BookingRequest, BookingResult, BookingSnapshot, BookingState, BookingTimeAnchor, BookingValues, BookingView, DEFAULT_BOOKING_CONTEXT, DEFAULT_BOOKING_FIELDS, DEFAULT_CONTEXT_KEY, DEFAULT_DURATION_OPTIONS, DEFAULT_TIME_FORMAT, DayAvailability, DefaultBookingValues, FALLBACK_LOCALE, FALLBACK_TIME_ZONE, FLOW_STEP_ORDER, InitialBookingAttempt, InstantLike, LoadStatus, MockAdapterOptions, MockFailure, ResolvedBookingField, SLOT_CLASS, SelectionChangeReason, SelectionStatus, SlotlineClassSlot, SlotlineMessages, SlotlineStep, SlotlineTheme, SlotsQuery, SubmitStatus, TimeFormat, TimeSlot, addDays, addMonths, bookingReducer, buildMonthGrid, clampDayKey, compareDayKeys, contextKeyOf, countSlots, createBookingController, createBookingState, createEmptyValues, createIdempotencyKey, createMockAdapter, createTimeAnchor, cx, dayKeyOf, dayKeyOfInstant, defaultMessages, deriveBookingView, detectLocale, endOf, format, formatFullDay, formatMonthYear, formatTime, formatTimeZoneName, formatUtcOffset, guaranteesNotCreated, instantOf, instantOfZonedTime, isAbortError, isBookingError, isBookingErrorCode, isDayKey, isRepeatedLocalTime, isRetrySafe, midnightAfter, monthKeyOf, resolveBookingConfig, resolveBookingFields, resolveMessages, resolveTimeZone, retryWindowClosesAt, soonestBoundary, systemClock, timeAnchorKey, toBookingError, todayKey, unmappedFieldNames, userSteps, validateBookingValues, visibleFieldErrors, wallKeyOf, zoneOffsetMs } from '@nickkupriyanov/slotline-core';
 
-interface SlotlineProps {
-    /** Availability + booking persistence. See {@link BookingAdapter}. */
-    adapter: BookingAdapter;
+/** Component props. `TValues` is inferred from the adapter, so a custom form keeps its own type. */
+interface SlotlineProps<TValues = DefaultBookingValues> {
+    /**
+     * The adapter the flow works against.
+     *
+     * A `selection` needs availability and slots; a `booking` also persists them, and
+     * the controller enforces the pairing. Typing the two shapes loosely here keeps
+     * the props readable for the common booking case — an application that selects
+     * only never has to write a `createBooking` stub.
+     */
+    adapter: BookingAdapter<TValues> | AvailabilityAdapter<TValues>;
     /** Duration options in minutes. Default: `[15, 30, 60]`. */
     durations?: number[];
     /** Controlled duration, in minutes. */
     duration?: number;
     /** Uncontrolled initial duration. Default: first entry of `durations`. */
     defaultDuration?: number;
-    /** Called whenever the user picks a different duration. */
-    onDurationChange?: (duration: number) => void;
+    /** Called whenever the duration changes, however it changed. */
+    onDurationChange?: (duration: number, metadata: BookingChangeMetadata) => void;
     /** IANA time zone used for every date and time rendered. Default: the browser zone. */
+    /** IANA time zone used for every date and time rendered, and for calendar queries. */
     timeZone?: string;
+    /** Uncontrolled initial time zone. Default: the browser zone. */
+    defaultTimeZone?: string;
     /** Built-in locale (`en`, `ru`) or any tag understood by `Intl`. Default: browser. */
     locale?: BuiltInLocale | (string & {});
     /** Per-string overrides merged on top of the locale defaults. */
@@ -30,13 +41,31 @@ interface SlotlineProps {
     maxDate?: string | Date;
     /** First column of the calendar. `0` = Sunday (default), `1` = Monday. */
     weekStartsOn?: 0 | 1;
+    /** `24h` (default) or a 12-hour cycle. */
+    timeFormat?: TimeFormat;
+    /** Uncontrolled initial hour cycle. */
+    defaultTimeFormat?: TimeFormat;
+    /** Called when the hour cycle changes. */
+    onTimeFormatChange?: (timeFormat: TimeFormat, metadata: BookingChangeMetadata) => void;
+    /** The schedule the widget works against. Default: a single implicit one. */
+    context?: BookingContext;
+    /** Called when the schedule changes. */
+    onContextChange?: (context: BookingContext, metadata: BookingChangeMetadata) => void;
+    /**
+     * An attempt the application restored after a reload. It opens on the attempt
+     * screen, resolved, so nothing is repeated by accident.
+     */
+    attempt?: InitialBookingAttempt | null;
+    /** Asks the application to look up the outcome of an unresolved attempt. */
+    onCheckStatus?: () => void;
     /**
      * Called after the adapter persisted the booking — even when the user has
-     * already moved on, in which case the UI does not jump to the confirmation.
+     * already moved on, in which case the UI does not jump to the confirmation. An
+     * exception thrown here never turns a created booking into a failure.
      */
-    onBooked?: (result: BookingResult, request: BookingRequest) => void;
-    /** Called on any adapter failure; the widget also renders the message inline. */
-    onError?: (error: Error) => void;
+    onBooked?: (result: BookingResult, request: BookingRequest<TValues>) => void;
+    /** Called on any adapter failure, with the phase it happened in. */
+    onError?: (error: BookingError, context: BookingErrorContext) => void;
     /** Renders a back button on the first step that calls this instead of leaving it out. */
     onDismiss?: () => void;
     /** Extra class on the outermost element. */
@@ -50,9 +79,9 @@ interface SlotlineProps {
     /** Replace the built-in animation kit (see `@nickkupriyanov/slotline-react/motion`). */
     animations?: AnimationKit;
 }
-interface SlotlineProviderProps extends SlotlineProps {
+type SlotlineProviderProps<TValues = DefaultBookingValues> = SlotlineProps<TValues> & {
     children: ReactNode;
-}
+};
 /**
  * Animation primitives the widget renders through. The default kit is pure CSS;
  * `@nickkupriyanov/slotline-react/motion` swaps in spring-based variants.
@@ -81,16 +110,19 @@ interface HeightProps {
 }
 
 /**
- * Provides the booking flow to any UI. Use it directly to build a custom
- * widget on top of `useSlotlineContext()`.
+ * Provides the booking flow to any UI. Use it directly to build a custom widget
+ * on top of `useSlotlineContext()`.
+ *
+ * The provider owns exactly one controller: it is created here, kept in step with
+ * the props, started after mounting and stopped on unmount.
  */
-declare function SlotlineProvider(props: SlotlineProviderProps): react.JSX.Element;
+declare function SlotlineProvider<TValues = DefaultBookingValues>(props: SlotlineProviderProps<TValues>): react.JSX.Element;
 /**
  * Builds a `Slotline` bound to a specific animation kit — used by
  * `@nickkupriyanov/slotline-react/motion` and available for custom kits.
  */
 declare function createSlotline(animations: AnimationKit): {
-    (props: SlotlineProps): react.JSX.Element;
+    <TValues = DefaultBookingValues>(props: SlotlineProps<TValues>): react.JSX.Element;
     displayName: string;
 };
 /**
@@ -104,89 +136,56 @@ declare function createSlotline(animations: AnimationKit): {
  * ```
  */
 declare const Slotline: {
-    (props: SlotlineProps): react.JSX.Element;
+    <TValues = DefaultBookingValues>(props: SlotlineProps<TValues>): react.JSX.Element;
     displayName: string;
 };
 
 /** The full widget: card, header, progress, panel, footer. */
 declare function SlotlineView(): react.JSX.Element;
 
+/** What the flow hands to a binding: one immutable snapshot and the actions. */
 interface UseBookingFlowResult {
-    state: FlowState;
-    /** Merged copy for the active locale. */
-    messages: SlotlineMessages;
-    /** Locale used for `Intl` formatting. */
-    locale: string;
-    timeZone: string;
-    /** Short zone hint, e.g. `GMT+2`. */
-    timeZoneName?: string;
-    theme: Exclude<SlotlineTheme, 'system'>;
-    /** Header title for the current step. */
-    title: string;
-    durations: number[];
-    weekStartsOn: 0 | 1;
-    minDate?: string;
-    maxDate?: string;
-    /** The 42 day keys of the visible month view. */
-    monthGrid: string[];
-    /** Short weekday headers, rotated to `weekStartsOn`. */
-    weekdayHeaders: string[];
-    /** Long weekday names for accessible headers, rotated to `weekStartsOn`. */
-    weekdayLongNames: string[];
-    monthLabel: string;
-    selectedDateLabel: string;
-    selectedTimeLabel: string;
-    durationLabel: string;
-    /** Availability for one day, if the adapter knows about it. */
-    availabilityOf: (dayKey: string) => DayAvailability | undefined;
-    isDayBookable: (dayKey: string) => boolean;
-    canGoBack: boolean;
-    fieldErrors: FieldErrors;
-    shownFieldErrors: FieldErrors;
-    /** `true` when the details form can be submitted. */
-    detailsValid: boolean;
-    actions: {
-        selectDate: (dayKey: string) => void;
-        selectSlot: (slot: TimeSlot) => void;
-        setDuration: (minutes: number) => void;
-        setDetails: (details: Partial<{
-            name: string;
-            email: string;
-            notes: string;
-        }>) => void;
-        /** Marks a field as touched so its validation message becomes visible. */
-        touchField: (field: 'name' | 'email') => void;
-        back: () => void;
-        submit: () => Promise<void>;
-        reset: () => void;
-        goToMonth: (monthKey: string) => void;
-        previousMonth: () => void;
-        nextMonth: () => void;
-        reloadAvailability: () => void;
-        reloadSlots: () => void;
-    };
+    snapshot: BookingSnapshot;
+    actions: BookingControllerActions;
 }
-declare function useBookingFlow(props: SlotlineProps): UseBookingFlowResult;
-
-declare const FlowContext: react.Context<UseBookingFlowResult | null>;
 /**
  * Reads the booking flow from the nearest `<Slotline>` / `<SlotlineProvider>`.
  * This is the hook to build a fully custom UI on top of.
  */
 declare function useSlotlineContext(): UseBookingFlowResult;
+/**
+ * Presentation values shared by the built-in parts. Copy and locale live here
+ * rather than in the view model: they are how the application asked the widget to
+ * speak, not something derived from the flow.
+ */
 interface SlotlineUIContextValue {
     animations: AnimationKit;
     classNames?: Partial<Record<SlotlineClassSlot, string>>;
+    className?: string;
     autoFocus: boolean;
     trapFocus: boolean;
-    className?: string;
+    /** Whether the application supplied a dismiss handler. */
+    canDismiss: boolean;
+    /** Asks the application to look up the outcome of an unresolved attempt. */
+    onCheckStatus?: (() => void) | undefined;
+    messages: SlotlineMessages;
+    locale: string;
+    theme: Exclude<SlotlineTheme, 'system'>;
 }
-declare const UIContext: react.Context<SlotlineUIContextValue>;
 declare function useUI(): SlotlineUIContextValue;
 declare function useAnimations(): AnimationKit;
 /** `classes('day', isToday && 'is-today')` → `"sl-day is-today <consumer class>"`. */
 declare function useClassNames(): (slot: SlotlineClassSlot, ...extra: ClassValue[]) => string;
 
+/**
+ * The headless widget: the whole flow, no markup.
+ *
+ * ```tsx
+ * const { snapshot, actions } = useBookingFlow({ adapter });
+ * ```
+ */
+declare function useBookingFlow<TValues = DefaultBookingValues>(props: SlotlineProps<TValues>): UseBookingFlowResult;
+
 /**
  * The default kit: no runtime, no dependencies. Every transition is a CSS
  * animation or transition, and all of them collapse under
@@ -194,4 +193,4 @@ declare function useClassNames(): (slot: SlotlineClassSlot, ...extra: ClassValue
  */
 declare const cssAnimations: AnimationKit;
 
-export { type AnimationKit, FlowContext, type HeightProps, Slotline, type SlotlineProps, SlotlineProvider, type SlotlineProviderProps, type SlotlineUIContextValue, SlotlineView, type StaggerItemProps, type StepHostProps, UIContext, type UseBookingFlowResult, createSlotline, cssAnimations, useAnimations, useBookingFlow, useClassNames, useSlotlineContext, useUI };
+export { type AnimationKit, type HeightProps, Slotline, type SlotlineProps, SlotlineProvider, type SlotlineProviderProps, type SlotlineUIContextValue, SlotlineView, type StaggerItemProps, type StepHostProps, type UseBookingFlowResult, createSlotline, cssAnimations, useAnimations, useBookingFlow, useClassNames, useSlotlineContext, useUI };

package/dist/index.d.ts

@@ -1,21 +1,32 @@
 import * as react from 'react';
 import { ReactNode, ComponentPropsWithoutRef } from 'react';
-import { BookingAdapter, BuiltInLocale, SlotlineMessages, SlotlineTheme, BookingResult, BookingRequest, SlotlineClassSlot, FlowState, DayAvailability, FieldErrors, TimeSlot, ClassValue } from '@nickkupriyanov/slotline-core';
-export { AvailabilityQuery, BookingAdapter, BookingDetails, BookingRequest, BookingResult, DayAvailability, FLOW_STEPS, FieldErrors, FlowAction, FlowState, LoadStatus, MockAdapterOptions, SLOT_CLASS, SlotlineClassSlot, SlotlineMessages, SlotlineStep, SlotlineTheme, SlotsQuery, TimeSlot, addDays, addMonths, buildMonthGrid, compareDayKeys, countSlots, createFlowState, createMockAdapter, cx, dayKeyOf, dayKeyOfInstant, defaultMessages, flowReducer, format, formatFullDay, formatMonthYear, formatTime, formatTimeZoneName, isDayKey, monthKeyOf, resolveMessages, stepIndex, todayKey, validateDetails } from '@nickkupriyanov/slotline-core';
+import { DefaultBookingValues, BookingAdapter, AvailabilityAdapter, BookingChangeMetadata, BuiltInLocale, SlotlineMessages, SlotlineTheme, TimeFormat, BookingContext, InitialBookingAttempt, BookingResult, BookingRequest, BookingError, BookingErrorContext, SlotlineClassSlot, BookingSnapshot, BookingControllerActions, ClassValue } from '@nickkupriyanov/slotline-core';
+export { AvailabilityAdapter, AvailabilityQuery, BOOKING_ERROR_CODES, BookingAction, BookingAdapter, BookingAttemptOutcome, BookingAttemptState, BookingCapabilities, BookingChangeMetadata, BookingClock, BookingConfig, BookingConfigInput, BookingConfigOverrides, BookingContext, BookingController, BookingControllerActions, BookingControllerHandlers, BookingControllerInputs, BookingControllerOptions, BookingDetails, BookingError, BookingErrorCode, BookingErrorContext, BookingFieldConfig, BookingFieldOption, BookingFieldType, BookingInvitation, BookingRequest, BookingResult, BookingSnapshot, BookingState, BookingTimeAnchor, BookingValues, BookingView, DEFAULT_BOOKING_CONTEXT, DEFAULT_BOOKING_FIELDS, DEFAULT_CONTEXT_KEY, DEFAULT_DURATION_OPTIONS, DEFAULT_TIME_FORMAT, DayAvailability, DefaultBookingValues, FALLBACK_LOCALE, FALLBACK_TIME_ZONE, FLOW_STEP_ORDER, InitialBookingAttempt, InstantLike, LoadStatus, MockAdapterOptions, MockFailure, ResolvedBookingField, SLOT_CLASS, SelectionChangeReason, SelectionStatus, SlotlineClassSlot, SlotlineMessages, SlotlineStep, SlotlineTheme, SlotsQuery, SubmitStatus, TimeFormat, TimeSlot, addDays, addMonths, bookingReducer, buildMonthGrid, clampDayKey, compareDayKeys, contextKeyOf, countSlots, createBookingController, createBookingState, createEmptyValues, createIdempotencyKey, createMockAdapter, createTimeAnchor, cx, dayKeyOf, dayKeyOfInstant, defaultMessages, deriveBookingView, detectLocale, endOf, format, formatFullDay, formatMonthYear, formatTime, formatTimeZoneName, formatUtcOffset, guaranteesNotCreated, instantOf, instantOfZonedTime, isAbortError, isBookingError, isBookingErrorCode, isDayKey, isRepeatedLocalTime, isRetrySafe, midnightAfter, monthKeyOf, resolveBookingConfig, resolveBookingFields, resolveMessages, resolveTimeZone, retryWindowClosesAt, soonestBoundary, systemClock, timeAnchorKey, toBookingError, todayKey, unmappedFieldNames, userSteps, validateBookingValues, visibleFieldErrors, wallKeyOf, zoneOffsetMs } from '@nickkupriyanov/slotline-core';
 
-interface SlotlineProps {
-    /** Availability + booking persistence. See {@link BookingAdapter}. */
-    adapter: BookingAdapter;
+/** Component props. `TValues` is inferred from the adapter, so a custom form keeps its own type. */
+interface SlotlineProps<TValues = DefaultBookingValues> {
+    /**
+     * The adapter the flow works against.
+     *
+     * A `selection` needs availability and slots; a `booking` also persists them, and
+     * the controller enforces the pairing. Typing the two shapes loosely here keeps
+     * the props readable for the common booking case — an application that selects
+     * only never has to write a `createBooking` stub.
+     */
+    adapter: BookingAdapter<TValues> | AvailabilityAdapter<TValues>;
     /** Duration options in minutes. Default: `[15, 30, 60]`. */
     durations?: number[];
     /** Controlled duration, in minutes. */
     duration?: number;
     /** Uncontrolled initial duration. Default: first entry of `durations`. */
     defaultDuration?: number;
-    /** Called whenever the user picks a different duration. */
-    onDurationChange?: (duration: number) => void;
+    /** Called whenever the duration changes, however it changed. */
+    onDurationChange?: (duration: number, metadata: BookingChangeMetadata) => void;
     /** IANA time zone used for every date and time rendered. Default: the browser zone. */
+    /** IANA time zone used for every date and time rendered, and for calendar queries. */
     timeZone?: string;
+    /** Uncontrolled initial time zone. Default: the browser zone. */
+    defaultTimeZone?: string;
     /** Built-in locale (`en`, `ru`) or any tag understood by `Intl`. Default: browser. */
     locale?: BuiltInLocale | (string & {});
     /** Per-string overrides merged on top of the locale defaults. */
@@ -30,13 +41,31 @@ interface SlotlineProps {
     maxDate?: string | Date;
     /** First column of the calendar. `0` = Sunday (default), `1` = Monday. */
     weekStartsOn?: 0 | 1;
+    /** `24h` (default) or a 12-hour cycle. */
+    timeFormat?: TimeFormat;
+    /** Uncontrolled initial hour cycle. */
+    defaultTimeFormat?: TimeFormat;
+    /** Called when the hour cycle changes. */
+    onTimeFormatChange?: (timeFormat: TimeFormat, metadata: BookingChangeMetadata) => void;
+    /** The schedule the widget works against. Default: a single implicit one. */
+    context?: BookingContext;
+    /** Called when the schedule changes. */
+    onContextChange?: (context: BookingContext, metadata: BookingChangeMetadata) => void;
+    /**
+     * An attempt the application restored after a reload. It opens on the attempt
+     * screen, resolved, so nothing is repeated by accident.
+     */
+    attempt?: InitialBookingAttempt | null;
+    /** Asks the application to look up the outcome of an unresolved attempt. */
+    onCheckStatus?: () => void;
     /**
      * Called after the adapter persisted the booking — even when the user has
-     * already moved on, in which case the UI does not jump to the confirmation.
+     * already moved on, in which case the UI does not jump to the confirmation. An
+     * exception thrown here never turns a created booking into a failure.
      */
-    onBooked?: (result: BookingResult, request: BookingRequest) => void;
-    /** Called on any adapter failure; the widget also renders the message inline. */
-    onError?: (error: Error) => void;
+    onBooked?: (result: BookingResult, request: BookingRequest<TValues>) => void;
+    /** Called on any adapter failure, with the phase it happened in. */
+    onError?: (error: BookingError, context: BookingErrorContext) => void;
     /** Renders a back button on the first step that calls this instead of leaving it out. */
     onDismiss?: () => void;
     /** Extra class on the outermost element. */
@@ -50,9 +79,9 @@ interface SlotlineProps {
     /** Replace the built-in animation kit (see `@nickkupriyanov/slotline-react/motion`). */
     animations?: AnimationKit;
 }
-interface SlotlineProviderProps extends SlotlineProps {
+type SlotlineProviderProps<TValues = DefaultBookingValues> = SlotlineProps<TValues> & {
     children: ReactNode;
-}
+};
 /**
  * Animation primitives the widget renders through. The default kit is pure CSS;
  * `@nickkupriyanov/slotline-react/motion` swaps in spring-based variants.
@@ -81,16 +110,19 @@ interface HeightProps {
 }
 
 /**
- * Provides the booking flow to any UI. Use it directly to build a custom
- * widget on top of `useSlotlineContext()`.
+ * Provides the booking flow to any UI. Use it directly to build a custom widget
+ * on top of `useSlotlineContext()`.
+ *
+ * The provider owns exactly one controller: it is created here, kept in step with
+ * the props, started after mounting and stopped on unmount.
  */
-declare function SlotlineProvider(props: SlotlineProviderProps): react.JSX.Element;
+declare function SlotlineProvider<TValues = DefaultBookingValues>(props: SlotlineProviderProps<TValues>): react.JSX.Element;
 /**
  * Builds a `Slotline` bound to a specific animation kit — used by
  * `@nickkupriyanov/slotline-react/motion` and available for custom kits.
  */
 declare function createSlotline(animations: AnimationKit): {
-    (props: SlotlineProps): react.JSX.Element;
+    <TValues = DefaultBookingValues>(props: SlotlineProps<TValues>): react.JSX.Element;
     displayName: string;
 };
 /**
@@ -104,89 +136,56 @@ declare function createSlotline(animations: AnimationKit): {
  * ```
  */
 declare const Slotline: {
-    (props: SlotlineProps): react.JSX.Element;
+    <TValues = DefaultBookingValues>(props: SlotlineProps<TValues>): react.JSX.Element;
     displayName: string;
 };
 
 /** The full widget: card, header, progress, panel, footer. */
 declare function SlotlineView(): react.JSX.Element;
 
+/** What the flow hands to a binding: one immutable snapshot and the actions. */
 interface UseBookingFlowResult {
-    state: FlowState;
-    /** Merged copy for the active locale. */
-    messages: SlotlineMessages;
-    /** Locale used for `Intl` formatting. */
-    locale: string;
-    timeZone: string;
-    /** Short zone hint, e.g. `GMT+2`. */
-    timeZoneName?: string;
-    theme: Exclude<SlotlineTheme, 'system'>;
-    /** Header title for the current step. */
-    title: string;
-    durations: number[];
-    weekStartsOn: 0 | 1;
-    minDate?: string;
-    maxDate?: string;
-    /** The 42 day keys of the visible month view. */
-    monthGrid: string[];
-    /** Short weekday headers, rotated to `weekStartsOn`. */
-    weekdayHeaders: string[];
-    /** Long weekday names for accessible headers, rotated to `weekStartsOn`. */
-    weekdayLongNames: string[];
-    monthLabel: string;
-    selectedDateLabel: string;
-    selectedTimeLabel: string;
-    durationLabel: string;
-    /** Availability for one day, if the adapter knows about it. */
-    availabilityOf: (dayKey: string) => DayAvailability | undefined;
-    isDayBookable: (dayKey: string) => boolean;
-    canGoBack: boolean;
-    fieldErrors: FieldErrors;
-    shownFieldErrors: FieldErrors;
-    /** `true` when the details form can be submitted. */
-    detailsValid: boolean;
-    actions: {
-        selectDate: (dayKey: string) => void;
-        selectSlot: (slot: TimeSlot) => void;
-        setDuration: (minutes: number) => void;
-        setDetails: (details: Partial<{
-            name: string;
-            email: string;
-            notes: string;
-        }>) => void;
-        /** Marks a field as touched so its validation message becomes visible. */
-        touchField: (field: 'name' | 'email') => void;
-        back: () => void;
-        submit: () => Promise<void>;
-        reset: () => void;
-        goToMonth: (monthKey: string) => void;
-        previousMonth: () => void;
-        nextMonth: () => void;
-        reloadAvailability: () => void;
-        reloadSlots: () => void;
-    };
+    snapshot: BookingSnapshot;
+    actions: BookingControllerActions;
 }
-declare function useBookingFlow(props: SlotlineProps): UseBookingFlowResult;
-
-declare const FlowContext: react.Context<UseBookingFlowResult | null>;
 /**
  * Reads the booking flow from the nearest `<Slotline>` / `<SlotlineProvider>`.
  * This is the hook to build a fully custom UI on top of.
  */
 declare function useSlotlineContext(): UseBookingFlowResult;
+/**
+ * Presentation values shared by the built-in parts. Copy and locale live here
+ * rather than in the view model: they are how the application asked the widget to
+ * speak, not something derived from the flow.
+ */
 interface SlotlineUIContextValue {
     animations: AnimationKit;
     classNames?: Partial<Record<SlotlineClassSlot, string>>;
+    className?: string;
     autoFocus: boolean;
     trapFocus: boolean;
-    className?: string;
+    /** Whether the application supplied a dismiss handler. */
+    canDismiss: boolean;
+    /** Asks the application to look up the outcome of an unresolved attempt. */
+    onCheckStatus?: (() => void) | undefined;
+    messages: SlotlineMessages;
+    locale: string;
+    theme: Exclude<SlotlineTheme, 'system'>;
 }
-declare const UIContext: react.Context<SlotlineUIContextValue>;
 declare function useUI(): SlotlineUIContextValue;
 declare function useAnimations(): AnimationKit;
 /** `classes('day', isToday && 'is-today')` → `"sl-day is-today <consumer class>"`. */
 declare function useClassNames(): (slot: SlotlineClassSlot, ...extra: ClassValue[]) => string;
 
+/**
+ * The headless widget: the whole flow, no markup.
+ *
+ * ```tsx
+ * const { snapshot, actions } = useBookingFlow({ adapter });
+ * ```
+ */
+declare function useBookingFlow<TValues = DefaultBookingValues>(props: SlotlineProps<TValues>): UseBookingFlowResult;
+
 /**
  * The default kit: no runtime, no dependencies. Every transition is a CSS
  * animation or transition, and all of them collapse under
@@ -194,4 +193,4 @@ declare function useClassNames(): (slot: SlotlineClassSlot, ...extra: ClassValue
  */
 declare const cssAnimations: AnimationKit;
 
-export { type AnimationKit, FlowContext, type HeightProps, Slotline, type SlotlineProps, SlotlineProvider, type SlotlineProviderProps, type SlotlineUIContextValue, SlotlineView, type StaggerItemProps, type StepHostProps, UIContext, type UseBookingFlowResult, createSlotline, cssAnimations, useAnimations, useBookingFlow, useClassNames, useSlotlineContext, useUI };
+export { type AnimationKit, type HeightProps, Slotline, type SlotlineProps, SlotlineProvider, type SlotlineProviderProps, type SlotlineUIContextValue, SlotlineView, type StaggerItemProps, type StepHostProps, type UseBookingFlowResult, createSlotline, cssAnimations, useAnimations, useBookingFlow, useClassNames, useSlotlineContext, useUI };