@srimandir/kundli-generator 9.4.2 → 9.4.3

package/dist/analytics.d.ts

@@ -59,6 +59,32 @@ export declare const KUNDLI_ANALYTICS_EVENT_NAMES: {
     readonly kundli_plan_proceed_clicked: "kundli_plan_proceed_clicked";
     /** Plan sheet closed without proceeding */
     readonly kundli_plan_page_closed: "kundli_plan_page_closed";
+    /** "Select consultation slot" CTA clicked on the astrologer guidance plan card */
+    readonly kundli_plan_select_consultation_slot_clicked: "kundli_plan_select_consultation_slot_clicked";
+    /** Plan selection screen loads (full-screen consultation scheduling flow) */
+    readonly kundli_plan_screen_viewed: "kundli_plan_screen_viewed";
+    /** Slot selection screen loads */
+    readonly kundli_slot_screen_viewed: "kundli_slot_screen_viewed";
+    /** User picks a date */
+    readonly kundli_slot_date_selected: "kundli_slot_date_selected";
+    /** User switches Morning/Afternoon/Evening */
+    readonly kundli_day_part_selected: "kundli_day_part_selected";
+    /** User picks a guidance topic chip */
+    readonly kundli_guidance_topic_selected: "kundli_guidance_topic_selected";
+    /** User taps a time slot */
+    readonly kundli_slot_selected: "kundli_slot_selected";
+    /** User taps confirm slot / proceeds to reserve ("Proceed to payment" in the slot modal) */
+    readonly kundli_slot_reservation_requested: "kundli_slot_reservation_requested";
+    /** Payment screen loads with an active hold (tracked by host app's payment page) */
+    readonly kundli_payment_screen_viewed: "kundli_payment_screen_viewed";
+    /** User selects a payment method (tracked by host app's payment page) */
+    readonly kundli_payment_method_selected: "kundli_payment_method_selected";
+    /** User confirms payment / gateway opens (tracked by host app's payment page) */
+    readonly kundli_payment_initiated: "kundli_payment_initiated";
+    /** Success + confirmation screen shown (tracked by host app's confirmation page) */
+    readonly kundli_booking_confirmation_viewed: "kundli_booking_confirmation_viewed";
+    /** User routed back to re-select after losing their slot (expired/failed/taken) */
+    readonly kundli_slot_lost_fallback_shown: "kundli_slot_lost_fallback_shown";
     /** Legacy / alias: when landing page is viewed */
     readonly kundli_page_view: "kundli_page_view";
     /** Legacy / alias: when L1 form page is viewed (same as l1_page_opened) */
@@ -71,6 +97,12 @@ export declare const KUNDLI_ANALYTICS_EVENT_NAMES: {
     readonly kundli_view_sample_image_closed: "kundli_view_sample_image_closed";
 };
 export type KundliAnalyticsEventName = (typeof KUNDLI_ANALYTICS_EVENT_NAMES)[keyof typeof KUNDLI_ANALYTICS_EVENT_NAMES];
+/**
+ * Whether a consultation-slot-modal event fired during the original,
+ * pre-payment booking flow, or during the "Book slot again" retry flow on
+ * /payment_success (payment already succeeded, slot booking failed).
+ */
+export type ConsultationEventStatus = "pre_payment" | "post_payment";
 /** Optional analytics implementation. Pass from host to KundliPage/KundliForm to track events. */
 export interface KundliAnalytics {
     trackBannerClicked?(): void;
@@ -127,6 +159,9 @@ export interface KundliAnalytics {
     trackPlanSelected?(params: {
         planId: string;
         planName: string;
+        price?: string;
+        includes_consultation?: boolean;
+        cta_label?: string;
     }): void;
     /** Updated: includes question-related fields for the 3-SKU experiment. */
     trackPlanProceedClicked?(params: {
@@ -137,8 +172,117 @@ export interface KundliAnalytics {
         question_asked?: boolean;
         question_text?: string;
         question_source?: 'chip' | 'custom' | 'chip_edited';
+        cta_type?: 'proceed' | 'confirm_consultation_slot';
+        next_step?: 'payment' | 'slot_selection';
     }): void;
     trackPlanPageClosed?(): void;
+    /** Fires when the astrologer guidance plan's "Select consultation slot" CTA is clicked. */
+    trackSelectConsultationSlotClicked?(params: {
+        planId: string;
+        planName: string;
+    }): void;
+    /** Fires when the (full-screen) plan selection screen loads. */
+    trackPlanScreenViewed?(params: {
+        plans_shown: string[];
+        default_selected_plan: string;
+    }): void;
+    /** Fires as soon as the host app's availability response is received, regardless of whether the modal has rendered yet. */
+    trackAstrologerAvailabilityServed?(params: {
+        astrologers_shown: string[];
+        dates_available_count: number;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the consultation slot selection screen (full-screen modal) loads. */
+    trackSlotScreenViewed?(params: {
+        astrologers_shown: string[];
+        dates_available_count: number;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the modal auto-selects the default consultation language. */
+    trackConsultationLanguageDefaultSelected?(params: {
+        language: string;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the user manually changes the consultation language via the dropdown. */
+    trackConsultationLanguageChanged?(params: {
+        previous_language: string;
+        new_language: string;
+        slots_available: "yes" | "no";
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the modal auto-selects the default consultation date. */
+    trackConsultationDateDefaultSelected?(params: {
+        date: string;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the modal auto-selects the default consultation time. */
+    trackConsultationTimeDefaultSelected?(params: {
+        time: string;
+        gmt_offset: string;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the user picks a date tab. */
+    trackSlotDateSelected?(params: {
+        date: string;
+        day_part_default: string;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the user switches Morning/Afternoon/Evening. */
+    trackDayPartSelected?(params: {
+        day_part: string;
+        slots_available_count: number;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the user picks a guidance topic chip. */
+    trackGuidanceTopicSelected?(params: {
+        topic: string;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the user taps a time slot. */
+    trackSlotSelected?(params: {
+        astrologer_id?: string;
+        date: string;
+        time: string;
+        day_part: string;
+        topic: string | null;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the user taps the slot modal's "Proceed to payment" (confirm slot) CTA. */
+    trackSlotReservationRequested?(params: {
+        astrologer_id?: string;
+        slot_datetime: string;
+        status: ConsultationEventStatus;
+    }): void;
+    /** Fires when the payment screen loads with an active hold. Tracked by the host app. */
+    trackPaymentScreenViewed?(params: {
+        reservation_id: string;
+        amount: number;
+        currency: string;
+        seconds_remaining: number;
+    }): void;
+    /** Fires when the user selects a payment method. Tracked by the host app. */
+    trackPaymentMethodSelected?(params: {
+        method: string;
+        provider?: string;
+    }): void;
+    /** Fires when the user confirms payment / gateway opens. Tracked by the host app. */
+    trackPaymentInitiated?(params: {
+        reservation_id: string;
+        amount: number;
+        currency: string;
+        method: string;
+    }): void;
+    /** Fires when the booking confirmation screen is shown. Tracked by the host app. */
+    trackBookingConfirmationViewed?(params: {
+        booking_id: string;
+        slot_datetime: string;
+        astrologer_id?: string;
+        topic: string;
+    }): void;
+    /** Fires when the user is routed back to re-select after losing their slot. Tracked by the host app. */
+    trackSlotLostFallbackShown?(params: {
+        reason: 'expired' | 'payment_failed' | 'slot_taken';
+    }): void;
     /** Fires once when the SKU comparison table enters the viewport (≥50% visible). */
     trackComparisonTableImpression?(): void;
     /** Fires the first time per card-expansion the user focuses the question textbox. */

package/dist/components/KundliForm/KundliForm.d.ts

@@ -4,6 +4,8 @@ import { AtlasSearchLocalities } from './sections/UserInfoFormSection/useGoogleP
 export interface KundliFormValues {
     fullName: string;
     phone?: string;
+    /** ISD/country code for `phone` (e.g. "+1", "+91"). Prefilled from a `country_code` query param for international users; defaults to "+91"/"+1" based on `isGlobal` when absent or invalid. */
+    phoneCountryCode?: string;
     gender?: "male" | "female" | "";
     email: string;
     language_code?: "hi" | "en" | "te" | "ta" | "kn" | "gu" | "mr" | "";
@@ -11,7 +13,9 @@ export interface KundliFormValues {
     birthTime: string;
     birthTimeUnknown: boolean;
     birthPlace: string;
+    /** Latitude of birth place, when known (e.g. from Atlas locality search). Optional; not set for Google Places selections. */
     birthPlaceLat?: number;
+    /** Longitude of birth place, when known (e.g. from Atlas locality search). Optional; not set for Google Places selections. */
     birthPlaceLng?: number;
 }
 export interface KundliFormProps {
@@ -34,8 +38,12 @@ export interface KundliFormProps {
     originalPriceLabel?: string;
     discountedPriceLabel?: string;
     discountPillLabel?: string;
-    /** Atlas localities search callback used for Birth Place autocomplete */
+    /** Google Maps API key used for Birth Place autocomplete */
+    googleMapsApiKey?: string;
+    /** Atlas localities search callback, used for Birth Place autocomplete when `googleMapsAutocompleteEnabled` is false. */
     atlasSearchLocalities?: AtlasSearchLocalities;
+    /** When true (default), birth place autocomplete uses Google Places. When false, uses Atlas via `atlasSearchLocalities`. */
+    googleMapsAutocompleteEnabled?: boolean;
     /** Optional analytics (Mixpanel etc.). Also set on KundliProvider; passing here ensures events fire when form is used inside provider (e.g. avoids context loss from multiple React instances). */
     analytics?: KundliAnalytics;
 }

package/dist/components/KundliForm/sections/UserInfoFormSection/UserInfoFormSection.d.ts

@@ -9,8 +9,12 @@ export interface UserInfoFormSectionProps {
     onPhoneIsdCodeChange: (code: string) => void;
     showV1ExtraFields?: boolean;
     analytics?: KundliAnalytics;
-    /** Atlas localities search callback used for Birth Place autocomplete */
+    /** Google Maps API key used for Birth Place autocomplete */
+    googleMapsApiKey?: string;
+    /** Atlas localities search callback, used for Birth Place autocomplete when `googleMapsAutocompleteEnabled` is false. */
     atlasSearchLocalities?: AtlasSearchLocalities;
+    /** When true (default), birth place autocomplete uses Google Places. When false, uses Atlas via `atlasSearchLocalities`. */
+    googleMapsAutocompleteEnabled?: boolean;
     className?: string;
 }
 export declare const UserInfoFormSection: React.FC<UserInfoFormSectionProps>;

package/dist/components/KundliForm/sections/UserInfoFormSection/useAtlasPlacesAutocomplete.d.ts

@@ -0,0 +1,22 @@
+import { AtlasSearchLocalities } from './useGooglePlacesAutocomplete';
+export interface AtlasPrediction {
+    id: string;
+    description: string;
+    secondary_text?: string;
+    lat: number;
+    lng: number;
+}
+/**
+ * Atlas-backed birth place autocomplete. Used when `googleMapsAutocompleteEnabled`
+ * is false, as an alternative to `useGooglePlacesAutocomplete`.
+ */
+export declare const useAtlasPlacesAutocomplete: (params: {
+    searchLocalities?: AtlasSearchLocalities;
+    restrictCountry?: string;
+}) => {
+    predictions: AtlasPrediction[];
+    isSearching: boolean;
+    loadError: string | null;
+    searchPlaces: (query: string) => Promise<void>;
+    clearPredictions: () => void;
+};

package/dist/components/KundliForm/sections/UserInfoFormSection/useGooglePlacesAutocomplete.d.ts

@@ -1,9 +1,29 @@
 export interface PlacePrediction {
-    id: string;
+    place_id: string;
     description: string;
-    secondary_text?: string;
+    structured_formatting: {
+        main_text: string;
+        secondary_text: string;
+    };
+}
+export interface PlaceDetails {
+    display_name: string;
     lat: number;
     lng: number;
+    city?: string;
+    state?: string;
+    country?: string;
+}
+/**
+ * Atlas locality search types are kept for API compatibility with consumers
+ * that still pass an `atlasSearchLocalities` callback. Birth place
+ * autocomplete itself is powered by Google Places (see
+ * `useGooglePlacesAutocomplete` below); Atlas is accepted but not consumed.
+ */
+export interface AtlasSearchOptions {
+    limit?: number;
+    offset?: number;
+    restrictCountry?: string;
 }
 export interface AtlasPlaceOption {
     id: string;
@@ -12,19 +32,20 @@ export interface AtlasPlaceOption {
     lat: number;
     lng: number;
 }
-export interface AtlasSearchOptions {
-    limit?: number;
-    offset?: number;
-    restrictCountry?: string;
-}
 export type AtlasSearchLocalities = (query: string, options?: AtlasSearchOptions) => Promise<AtlasPlaceOption[]>;
 export declare const useGooglePlacesAutocomplete: (params: {
-    searchLocalities?: AtlasSearchLocalities;
+    apiKey?: string;
+    language?: string;
     restrictCountry?: string;
+    /** If true, defer loading until explicitly triggered (default: false) */
+    deferLoad?: boolean;
 }) => {
+    isLoaded: boolean;
     predictions: PlacePrediction[];
     isSearching: boolean;
     loadError: string | null;
     searchPlaces: (query: string) => Promise<void>;
+    getPlaceDetails: (placeId: string) => Promise<PlaceDetails | null>;
     clearPredictions: () => void;
+    triggerLoad: () => void;
 };

package/dist/components/KundliPage/KundliContext.d.ts

@@ -2,6 +2,7 @@ import { SupportedLocale } from '../../i18n/translations';
 import { KundliFormValues } from '../KundliForm';
 import { KundliAnalytics } from '../../analytics';
 import { KundliImageComponent } from '../../types/image';
+import { FetchConsultationSlots } from '../KundliPlanBottomSheet';
 import { AtlasSearchLocalities } from '../KundliForm/sections/UserInfoFormSection/useGooglePlacesAutocomplete';
 export type KundliView = "landing" | "form";
 export interface KundliContextConfig {
@@ -14,8 +15,30 @@ export interface KundliContextConfig {
     isGlobal?: boolean;
     /** Variant identifier for analytics tracking */
     variant?: string;
-    /** Atlas localities search callback for birth place autocomplete */
+    /** Pre-fills form values on mount (e.g. from URL query params on a deep-linked SEO flow). */
+    initialFormValues?: Partial<KundliFormValues>;
+    /** When true, automatically opens the plan selection bottom sheet once (requires variant "v1"). Used for deep-linked flows where the form is already fully pre-filled. */
+    autoOpenPlanSheet?: boolean;
+    /** Google Maps API key for birth place autocomplete */
+    googleMapsApiKey?: string;
+    /** Atlas localities search callback, used for Birth Place autocomplete when `googleMapsAutocompleteEnabled` is false. */
     atlasSearchLocalities?: AtlasSearchLocalities;
+    /** When true (default), birth place autocomplete uses Google Places. When false, uses Atlas via `atlasSearchLocalities`. */
+    googleMapsAutocompleteEnabled?: boolean;
+    /**
+     * Feature flag (experiment-controlled). When true, the Kundli plan selection sheet
+     * (`KundliPlanBottomSheet`) renders full-screen with the left-aligned header style,
+     * and selecting the astrologer-consultation plan opens the full-screen
+     * `ConsultationSlotModal` (date/time/topic picker) before proceeding to payment.
+     * When false (default), behavior is unchanged: bottom sheet, centered header,
+     * astrologer-consultation plan proceeds straight to payment.
+     */
+    enableConsultationScheduling?: boolean;
+    /**
+     * Fetches real consultation slot availability from the host app (no API/endpoint
+     * knowledge lives in this package). Called by `ConsultationSlotModal` when it opens.
+     */
+    fetchConsultationSlots?: FetchConsultationSlots;
     logoUrl?: string;
     reportImageUrl?: string;
     /** When true, LCP report image can be loaded with priority (e.g. next/image priority). */

package/dist/components/KundliPage/KundliPage.d.ts

@@ -45,10 +45,26 @@ export interface KundliPageProps {
     analytics?: KundliAnalytics;
     /** Notify when user changes language (e.g. to keep form view in sync when switching from landing) */
     onLocaleChange?: (locale: SupportedLocale) => void;
-    /** Atlas localities search callback for birth place autocomplete */
+    /** Google Maps API key for birth place autocomplete */
+    googleMapsApiKey?: string;
+    /** Atlas localities search callback, used for Birth Place autocomplete when `googleMapsAutocompleteEnabled` is false. */
     atlasSearchLocalities?: AtlasSearchLocalities;
+    /** When true (default), birth place autocomplete uses Google Places. When false, uses Atlas via `atlasSearchLocalities`. */
+    googleMapsAutocompleteEnabled?: boolean;
     /** Enables 3-SKU experiment flow when used with v1 variant. */
     enableThreeSkuFlow?: boolean;
+    /**
+     * Experiment-controlled feature flag (v1 variant only). When true, the Kundli plan
+     * sheet renders full-screen and the astrologer-consultation plan opens a full-screen
+     * scheduling modal before payment. When false (default), behavior is unchanged.
+     */
+    enableConsultationScheduling?: boolean;
+    /**
+     * Fetches real consultation slot availability from the host app (no API/endpoint
+     * knowledge lives in this package). Passed through to `KundliContext` and used by
+     * `ConsultationSlotModal` when it opens.
+     */
+    fetchConsultationSlots?: import('../KundliPlanBottomSheet').FetchConsultationSlots;
     /** URL for the "200+ page Kundli Report" sample link in 3-SKU table. */
     kundliReportSampleHref?: string;
     /** URL for the "1 Question" sample link in 3-SKU table. */

package/dist/components/KundliPage/KundliPageV1.d.ts

@@ -15,6 +15,10 @@ export interface KundliPageProps {
     userId?: number;
     /** Whether the user is global (international) or domestic */
     isGlobal?: boolean;
+    /** Pre-fills form values on mount (e.g. from URL query params on a deep-linked SEO flow). */
+    initialFormValues?: Partial<KundliFormValues>;
+    /** When true, automatically opens the plan selection bottom sheet once on mount. Used for deep-linked flows where the form is already fully pre-filled. */
+    autoOpenPlanSheet?: boolean;
     /** Header logo URL */
     logoUrl?: string;
     /** Premium report cover image URL */
@@ -45,10 +49,27 @@ export interface KundliPageProps {
     analytics?: KundliAnalytics;
     /** Notify when user changes language (e.g. to keep form view in sync when switching from landing) */
     onLocaleChange?: (locale: SupportedLocale) => void;
-    /** Atlas localities search callback for birth place autocomplete */
+    /** Google Maps API key for birth place autocomplete */
+    googleMapsApiKey?: string;
+    /** Atlas localities search callback, used for Birth Place autocomplete when `googleMapsAutocompleteEnabled` is false. */
     atlasSearchLocalities?: AtlasSearchLocalities;
+    /** When true (default), birth place autocomplete uses Google Places. When false, uses Atlas via `atlasSearchLocalities`. */
+    googleMapsAutocompleteEnabled?: boolean;
     /** Enables 3-SKU experiment flow inside existing v1 page. */
     enableThreeSkuFlow?: boolean;
+    /**
+     * Experiment-controlled feature flag. When true, the Kundli plan sheet renders
+     * full-screen (matching header style) and the astrologer-consultation plan opens
+     * a full-screen date/time/topic scheduling modal before payment. When false
+     * (default), existing behavior is unchanged (bottom sheet, direct to payment).
+     */
+    enableConsultationScheduling?: boolean;
+    /**
+     * Fetches real consultation slot availability from the host app. Passed through
+     * to `KundliContext` and used by `ConsultationSlotModal` when it opens. No
+     * endpoint/URL knowledge lives in this package — the host app owns the API call.
+     */
+    fetchConsultationSlots?: import('../KundliPlanBottomSheet').FetchConsultationSlots;
     /** URL for the "200+ page Kundli Report" sample link in the 3-SKU table. */
     kundliReportSampleHref?: string;
     /** URL for the "1 Question" sample link in the 3-SKU table. */

package/dist/components/KundliPage/KundliPageVariant.d.ts

@@ -1,5 +1,10 @@
 import { KundliPageProps as BaseKundliPageProps } from './KundliPage';
+import { KundliFormValues } from '../KundliForm';
 export type KundliPageProps = BaseKundliPageProps & {
     variant?: "v1";
+    /** Pre-fills form values on mount (e.g. from URL query params on a deep-linked SEO flow). Only applies when `variant="v1"`. */
+    initialFormValues?: Partial<KundliFormValues>;
+    /** When true, automatically opens the plan selection bottom sheet once on mount. Only applies when `variant="v1"`. */
+    autoOpenPlanSheet?: boolean;
 };
 export declare const KundliPage: React.FC<KundliPageProps>;

package/dist/components/KundliPage/sections/UtmBannerSection/UtmBannerSection.d.ts

@@ -0,0 +1,8 @@
+import { KundliImageComponent } from '../../../../types/image';
+export interface UtmBannerSectionProps {
+    imageUrl: string;
+    altText: string;
+    imageComponent?: KundliImageComponent;
+    className?: string;
+}
+export declare const UtmBannerSection: React.FC<UtmBannerSectionProps>;

package/dist/components/KundliPage/sections/UtmBannerSection/index.d.ts

@@ -0,0 +1,2 @@
+export { UtmBannerSection } from './UtmBannerSection';
+export type { UtmBannerSectionProps } from './UtmBannerSection';

package/dist/components/KundliPage/sections/index.d.ts

@@ -1,5 +1,6 @@
 export { KundliHeader } from './KundliHeader';
 export { HeroSection } from './HeroSection';
+export { UtmBannerSection } from './UtmBannerSection';
 export { PremiumReportOverview } from './PremiumReportOverview';
 export { UniversityCertification } from './UniversityCertification';
 export { ThreeStepsProcess } from './ThreeStepsProcess';

package/dist/components/KundliPlanBottomSheet/ConsultationSlotModal.d.ts

@@ -0,0 +1,28 @@
+import { KundliPlanAstrologer, ConsultationSlotSelection } from './types';
+import { KundliAnalytics } from '../../analytics';
+export interface ConsultationSlotModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onProceed: (selection: ConsultationSlotSelection) => void;
+    astrologers: KundliPlanAstrologer[];
+    t?: (key: string, options?: any) => string | undefined;
+    analytics?: KundliAnalytics;
+    /**
+     * Report language the user selected in the kundli form (e.g. "hi", "te").
+     * Drives which consultation language is preselected (see
+     * `getDefaultConsultationLanguage`). Defaults to `KundliContext`'s live
+     * `formValues.language_code` when not passed explicitly — callers not
+     * connected to that context (e.g. a standalone retry flow) must pass it.
+     */
+    reportLanguage?: string;
+    /**
+     * True for the "Book slot again" retry flow on /payment_success (payment
+     * already succeeded, original slot booking failed) — false/omitted for the
+     * original pre-payment booking flow. Tags every analytics event fired by
+     * this modal with `status: "pre_payment" | "post_payment"`, and hides the
+     * guidance-topic picker in the retry case (topic was already captured
+     * during the original pre-payment flow).
+     */
+    isPostPayment?: boolean;
+}
+export declare const ConsultationSlotModal: React.FC<ConsultationSlotModalProps>;

package/dist/components/KundliPlanBottomSheet/KundliPlanBottomSheet.d.ts

@@ -1,14 +1,24 @@
-import { KundliPlan } from './types';
+import { KundliPlan, ConsultationSlotSelection } from './types';
 import { KundliAnalytics } from '../../analytics';
 export interface KundliPlanBottomSheetProps {
     isOpen: boolean;
     onClose: () => void;
     selectedPlan: KundliPlan | null;
     onSelectPlan: (plan: KundliPlan) => void;
-    onProceed: (plan: KundliPlan) => void;
+    onProceed: (plan: KundliPlan, consultationSlot?: ConsultationSlotSelection) => void;
     plans?: KundliPlan[];
     t?: (key: string) => string;
     analytics?: KundliAnalytics;
+    /**
+     * Feature flag (experiment-controlled). When true, renders full-screen with the
+     * left-aligned header style, and the astrologer-consultation plan opens the
+     * full-screen `ConsultationSlotModal` before proceeding to payment.
+     * When false/undefined (default), falls back to `KundliContext`'s
+     * `enableConsultationScheduling` config, and finally to `false` — preserving the
+     * original bottom-sheet behavior (astrologer-consultation plan proceeds straight
+     * to payment, no scheduling modal).
+     */
+    enableConsultationScheduling?: boolean;
 }
 /**
  * Slide-up bottom sheet that lets the user choose a Kundli plan.
@@ -17,9 +27,10 @@ export interface KundliPlanBottomSheetProps {
  * Shown exclusively for the `v1` variant — the context gates this.
  */
 export declare const KundliPlanBottomSheet: React.FC<KundliPlanBottomSheetProps>;
-export type { KundliPlan } from './types';
+export type { KundliPlan, ConsultationSlotSelection } from './types';
 export { getDefaultPlans } from './planDefaults';
 export { PlanCard } from './PlanCard';
 export { PlanSheetHeader } from './PlanSheetHeader';
 export { PlanFeatureList } from './PlanFeatureList';
 export { AstrologerCard } from './AstrologerCard';
+export { ConsultationSlotModal } from './ConsultationSlotModal';

package/dist/components/KundliPlanBottomSheet/PlanIcons.d.ts

@@ -2,7 +2,17 @@ export declare const CheckIcon: React.FC;
 export declare const CrossIcon: React.FC;
 /** Back arrow chevron */
 export declare const ChevronLeftIcon: React.FC;
+/** Down chevron, used by the consultation-language dropdown trigger */
+export declare const ChevronDownIcon: React.FC;
 /** Lightning bolt icon for "Most popular" badge */
 export declare const BoltIcon: React.FC;
 /** Trend up icon for "Most popular" badge */
 export declare const TrendUpIcon: React.FC;
+/** Sun icon for "Morning" period tab */
+export declare const MorningIcon: React.FC;
+/** Sun-cloud icon for "Afternoon" period tab */
+export declare const AfternoonIcon: React.FC;
+/** Moon icon for "Evening" period tab */
+export declare const EveningIcon: React.FC;
+/** Calendar-with-slash icon for the "No slots available" empty state */
+export declare const CalendarOffIcon: React.FC;

package/dist/components/KundliPlanBottomSheet/consultationSlotDefaults.d.ts

@@ -0,0 +1,44 @@
+import { ConsultationSlotDate, ConsultationSlotPeriod, ConsultationSlotsByLanguage } from './types';
+/**
+ * Formats an ISO datetime (e.g. "2026-08-03T09:00:00+05:30") into a short
+ * label like "9:00 AM". Reads the hour/minute directly off the string
+ * instead of going through `Date`, so the slot shows the exact wall-clock
+ * time the backend sent rather than being reinterpreted in the browser's
+ * local timezone.
+ */
+export declare const formatSlotTime: (isoDateTime: string) => string;
+/** Builds a short day-tab label ("Today" / "Tomorrow" / weekday) + day number for a "yyyy-MM-dd" date string. */
+export declare const formatSlotDayLabel: (isoDate: string, referenceDate?: Date) => ConsultationSlotDate;
+export declare const CONSULTATION_PERIOD_ORDER: ConsultationSlotPeriod[];
+/**
+ * Guidance topic chips shown before slot selection. Frontend-only, static
+ * list — never fetched from an API. `labelKey` resolves via the `t` prop
+ * (falls back to `label` when no translation is provided).
+ */
+export declare const GUIDANCE_TOPICS: {
+    id: string;
+    labelKey: string;
+    label: string;
+}[];
+/**
+ * Consultation-language dropdown options shown on the slot selection screen.
+ * Matches the report-language codes the host app's preselect API returns
+ * availability for (`ConsultationSlotsByLanguage` keys). `labelKey` resolves
+ * via the `t` prop, reusing the same keys as the kundli form's report
+ * language chips (falls back to `label` when no translation is provided).
+ */
+export declare const CONSULTATION_LANGUAGE_OPTIONS: {
+    code: string;
+    labelKey: string;
+    label: string;
+}[];
+export declare const languageHasAvailability: (language: ConsultationSlotsByLanguage[string] | undefined) => boolean;
+/**
+ * Picks which consultation language should be preselected when the slot
+ * modal opens, based on the report language the user selected in the form:
+ * try that report language's default consultation language first, then its
+ * fallback, then — if neither has availability — whichever other language
+ * does, in `CONSULTATION_LANGUAGE_OPTIONS` order. Falls back to the default
+ * language itself if nothing has availability at all.
+ */
+export declare const getDefaultConsultationLanguage: (slotsByLanguage: ConsultationSlotsByLanguage, reportLanguage: string | null | undefined, isGlobal: boolean) => string;

package/dist/components/KundliPlanBottomSheet/index.d.ts

@@ -1,2 +1,5 @@
 export { KundliPlanBottomSheet, getDefaultPlans } from './KundliPlanBottomSheet';
-export type { KundliPlanBottomSheetProps, KundliPlan } from './KundliPlanBottomSheet';
+export type { KundliPlanBottomSheetProps, KundliPlan, ConsultationSlotSelection } from './KundliPlanBottomSheet';
+export { ConsultationSlotModal } from './ConsultationSlotModal';
+export type { ConsultationSlotModalProps } from './ConsultationSlotModal';
+export type { KundliPlanAstrologer, ConsultationSlot, ConsultationSlotDay, ConsultationSlotPeriod, ConsultationSlotsPreselectData, ConsultationSlotsByLanguage, FetchConsultationSlots, } from './types';

package/dist/components/KundliPlanBottomSheet/types.d.ts

@@ -19,3 +19,49 @@ export interface KundliPlan {
     badge?: string;
     astrologers?: KundliPlanAstrologer[];
 }
+/** A single selectable date tab, e.g. "Tomorrow", "21" */
+export interface ConsultationSlotDate {
+    id: string;
+    dayLabel: string;
+    dayNum: string;
+}
+export type ConsultationSlotPeriod = "morning" | "afternoon" | "evening";
+/** A single bookable time slot for a given day, as returned by the host app's slots API. */
+export interface ConsultationSlot {
+    /** ISO datetime with offset, e.g. "2026-08-03T09:00:00+05:30" */
+    start: string;
+    /** ISO datetime with offset */
+    end: string;
+    period: ConsultationSlotPeriod;
+}
+/** A single day's availability, as returned by the host app's slots API. */
+export interface ConsultationSlotDay {
+    /** ISO "yyyy-MM-dd" */
+    date: string;
+    has_availability: boolean;
+    slots: ConsultationSlot[];
+}
+/** Response shape for the host app's GET consultation slots (preselect) API. */
+export interface ConsultationSlotsPreselectData {
+    start_date: string;
+    days: ConsultationSlotDay[];
+}
+/** Availability per report-language code (e.g. "en", "hi", "te", "ta", "kn", "gu", "mr"), as returned by the host app's slots API. */
+export type ConsultationSlotsByLanguage = Record<string, ConsultationSlotsPreselectData>;
+/** Callback provided by the host app to fetch real consultation slot availability for every report language at once. */
+export type FetchConsultationSlots = () => Promise<ConsultationSlotsByLanguage>;
+/** A guidance topic chip, e.g. "Career & work" */
+export interface ConsultationTopic {
+    id: string;
+    label: string;
+}
+/** Details captured once the user completes the consultation slot selection flow. */
+export interface ConsultationSlotSelection {
+    start: string;
+    end: string;
+    period: ConsultationSlotPeriod;
+    /** Guidance topic id the user picked (e.g. "career_work"). Frontend-only — never fetched from an API. */
+    topic?: string;
+    /** Report-language code the user picked in the slot modal's language dropdown (e.g. "en", "hi"). */
+    language?: string;
+}