@srimandir/kundli-matching-generator 7.47.0 → 11.5.0

package/dist/analytics.d.ts

@@ -82,29 +82,29 @@ export interface KundliMatchingAnalytics {
     trackBoyNameSectionClicked?(): void;
     trackBoyNameSectionFilled?(): void;
     trackBoyDobClicked?(): void;
-    trackBoyDobFilled?(): void;
+    trackBoyDobFilled?(dob: string): void;
     trackBoyTimeClicked?(): void;
-    trackBoyTimeFilled?(): void;
+    trackBoyTimeFilled?(birthTime: string): void;
     trackBoyTimeCheckboxClicked?(): void;
     trackBoyPlaceOfBirthClicked?(): void;
-    trackBoyPlaceOfBirthChosen?(): void;
+    trackBoyPlaceOfBirthChosen?(placeOfBirth: string): void;
     trackGirlNameSectionClicked?(): void;
     trackGirlNameSectionFilled?(): void;
     trackGirlDobClicked?(): void;
-    trackGirlDobFilled?(): void;
+    trackGirlDobFilled?(dob: string): void;
     trackGirlTimeClicked?(): void;
-    trackGirlTimeFilled?(): void;
+    trackGirlTimeFilled?(birthTime: string): void;
     trackGirlTimeCheckboxClicked?(): void;
     trackGirlPlaceOfBirthClicked?(): void;
-    trackGirlPlaceOfBirthChosen?(): void;
+    trackGirlPlaceOfBirthChosen?(placeOfBirth: string): void;
     trackLanguageOfReportClicked?(): void;
     trackLanguageOfReportSelected?(params: {
         language: string;
     }): void;
     trackPhoneSectionClicked?(): void;
-    trackPhoneSectionFilled?(): void;
+    trackPhoneSectionFilled?(phone: string): void;
     trackEmailSectionClicked?(): void;
-    trackEmailSectionFilled?(): void;
+    trackEmailSectionFilled?(email: string): void;
     trackKundliMatchingL0CtaClick?(params: {
         ctaText: string;
         isFormComplete: boolean;
@@ -137,6 +137,9 @@ export interface KundliMatchingAnalytics {
     trackHowItWorksSectionViewed?(): void;
     trackWhyUsSectionViewed?(): void;
     trackFaqSectionViewed?(): void;
+    trackBabaSuggestionsImpression?(): void;
+    trackBookVideoImpression?(): void;
+    trackAstrologersAreaImpression?(): void;
     trackSneakPeekCardViewed?(params: {
         cardNumber: number;
         cardTitle: string;
@@ -146,4 +149,13 @@ export interface KundliMatchingAnalytics {
         reviewerName: string;
         isManualScroll: boolean;
     }): void;
+    trackFunnelEvent?(event: KundliMatchingFunnelEvent, props?: KundliMatchingFunnelEventProps): void;
 }
+/**
+ * Kundli Matching PRD §6.2 event catalog. Fired verbatim alongside the events above
+ * via `trackFunnelEvent`; the host attaches the §6.1 common properties.
+ */
+export type KundliMatchingFunnelEvent = 'kundli_landing_view' | 'baba_rotation_view' | 'sample_report_open' | 'sample_report_page_view' | 'form_start' | 'form_field_complete' | 'form_field_error' | 'unknown_time_toggle' | 'birth_place_selected' | 'birth_place_fallback' | 'report_language_selected' | 'form_submit_attempt' | 'form_submit_success' | 'form_submit_error' | 'plan_view' | 'plan_select' | 'payment_start' | 'payment_success' | 'payment_failure' | 'payment_cancelled' | 'language_switched';
+export type KundliMatchingFunnelEventProps = Record<string, string | number | boolean>;
+/** PRD SKU for a plan id (see planDefaults / host catalog plans). */
+export declare const getPlanSku: (planId: string) => "kundli_plus_ast" | "kundli_only";

package/dist/components/AstrologersSection/AstrologersSection.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface AstrologersSectionProps {
+    t: (key: string) => string;
+    className?: string;
+}
+/** "Detailed Guidance from 15+ Years Experienced Astrologers" (Figma 7983:14325). */
+export declare const AstrologersSection: React.FC<AstrologersSectionProps>;

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

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

package/dist/components/BabaTestimonialSection/BabaTestimonialSection.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { SupportedLocale } from '../../i18n/translations';
+import { KundliMatchingAnalytics } from '../../analytics';
+export interface BabaTestimonialSectionProps {
+    t: (key: string) => string;
+    locale: SupportedLocale;
+    /** Messages to rotate through. Defaults to BABA_ROTATE_MESSAGES[locale]. */
+    messages?: string[];
+    className?: string;
+    analytics?: KundliMatchingAnalytics;
+}
+export declare const BABA_IMAGE_URL = "https://srm-cdn.a4b.io/yoda/1790753513124.png";
+export declare const BabaTestimonialSection: React.FC<BabaTestimonialSectionProps>;

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

@@ -0,0 +1,2 @@
+export { BabaTestimonialSection, BABA_IMAGE_URL } from './BabaTestimonialSection';
+export type { BabaTestimonialSectionProps } from './BabaTestimonialSection';

package/dist/components/ContactSection/ContactSection.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface ContactSectionProps {
+    t: (key: string) => string;
+    className?: string;
+}
+/** "Contact Us" (Figma 7983:13456; Hindi 8179:13654). */
+export declare const ContactSection: React.FC<ContactSectionProps>;

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

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

package/dist/components/FAQSection/FAQSection.d.ts

@@ -2,6 +2,8 @@ import { FC } from 'react';
 export interface FAQSectionProps {
     t: (key: string) => string;
     className?: string;
-    headingClassName?: string;
+    /** Index of the item open on first render (design opens the 3rd). */
+    defaultOpenIndex?: number;
 }
+/** "Frequently Asked Questions" (Figma 7983:13449). One item open at a time. */
 export declare const FAQSection: FC<FAQSectionProps>;

package/dist/components/HeroSection/HeroSection.d.ts

@@ -1,13 +1,39 @@
 import { default as React } from 'react';
+/** Hero image per `?variant=` slug. Headline + chips are baked into the image. */
+export declare const HERO_VARIANT_IMAGES: {
+    readonly v1: "https://srm-cdn.a4b.io/yoda/1790750877585.webp";
+    readonly v2: "https://srm-cdn.a4b.io/yoda/1790750877584.webp";
+    readonly v3: "https://srm-cdn.a4b.io/yoda/1790750877583.webp";
+};
+export type HeroVariant = keyof typeof HERO_VARIANT_IMAGES;
+/** Hero image URL for a variant in the given surface locale (English for anything but `hi`). */
+export declare const getHeroImageUrl: (variant: HeroVariant, locale?: string) => string;
+/** Used when the variant param is missing, empty, or unknown. */
+export declare const DEFAULT_HERO_VARIANT: HeroVariant;
 /**
- * Hero image URL - exported so host apps can preload this resource in document head for better performance (LCP):
- * <link rel="preload" as="image" href={HERO_IMAGE_URL} />
+ * Resolves the hero variant: URL `?variant=` wins (and is persisted to sessionStorage),
+ * else the session's sticky variant, else the default. Client-only.
+ * `source` is the PRD §6.2 `variant_source` analytics value.
  */
-export declare const HERO_IMAGE_URL = "https://srm-cdn.a4b.io/yoda/1774511296258.webp";
+export declare const resolveHeroVariantWithSource: () => {
+    variant: HeroVariant;
+    source: "variant_param" | "default_fallback";
+};
+export declare const resolveHeroVariant: () => HeroVariant;
+/**
+ * Default hero image URL - exported so host apps can preload it in document head (LCP):
+ * <link rel="preload" as="image" href={getHeroImageUrl(variant, locale)} />
+ */
+export declare const HERO_IMAGE_URL: "https://srm-cdn.a4b.io/yoda/1790750877585.webp";
 export interface HeroSectionProps {
     t: (key: string) => string;
     className?: string;
     /** When true, hero image loads with priority (for LCP). Default true. */
     heroImagePriority?: boolean;
+    /**
+     * Variant slug from the host (e.g. read from searchParams on the server) so SSR renders
+     * the right image without a swap. When omitted, it is resolved on the client after mount.
+     */
+    variant?: string;
 }
 export declare const HeroSection: React.FC<HeroSectionProps>;

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

@@ -1,2 +1,2 @@
-export { HeroSection, HERO_IMAGE_URL } from './HeroSection';
-export type { HeroSectionProps } from './HeroSection';
+export { HeroSection, HERO_IMAGE_URL, HERO_VARIANT_IMAGES, getHeroImageUrl, DEFAULT_HERO_VARIANT, resolveHeroVariant, resolveHeroVariantWithSource, } from './HeroSection';
+export type { HeroSectionProps, HeroVariant } from './HeroSection';

package/dist/components/KundliMatchingFormSection/KundliMatchingFormSection.d.ts

@@ -6,6 +6,8 @@ export interface PersonFormValues {
     birthTime: string;
     birthTimeUnknown: boolean;
     birthPlace: string;
+    /** True while `birthPlace` holds typed text that wasn't picked from the Places list (PRD §3.6). */
+    birthPlaceNeedsPick?: boolean;
 }
 export interface KundliMatchingFormValues {
     boy: PersonFormValues;
@@ -26,6 +28,8 @@ export interface KundliMatchingFormSectionProps {
     className?: string;
     phoneIsdCode: string;
     onPhoneIsdCodeChange: (code: string) => void;
+    /** Show inline errors on every field, not just touched ones (set after a CTA tap on an invalid form). */
+    showAllErrors?: boolean;
 }
 export declare const KundliMatchingFormSection: React.FC<KundliMatchingFormSectionProps>;
 export declare const getDefaultMatchingFormValues: () => KundliMatchingFormValues;

package/dist/components/KundliMatchingFormSection/LanguageSelector.d.ts

@@ -1,7 +1,6 @@
 import { default as React } from 'react';
 import { KundliMatchingAnalytics } from '../../analytics';
 export interface LanguageSelectorProps {
-    t: (key: string) => string;
     selectedLanguage: string;
     onChange: (language: string) => void;
     analytics?: KundliMatchingAnalytics;

package/dist/components/KundliMatchingFormSection/PersonFormSection.d.ts

@@ -9,6 +9,8 @@ export interface PersonFormSectionProps {
     googleMapsApiKey?: string;
     isGlobal?: boolean;
     analytics?: KundliMatchingAnalytics;
+    /** Show inline errors on every field, not just touched ones (set after a CTA tap on an invalid form). */
+    showAllErrors?: boolean;
     className?: string;
 }
 export declare const PersonFormSection: React.FC<PersonFormSectionProps>;

package/dist/components/KundliMatchingFormSection/constants.d.ts

@@ -206,4 +206,4 @@ export declare const ISD_COUNTRY_OPTIONS: readonly [{
     readonly code: "+977";
     readonly country: "Nepal";
 }];
-export declare const ISD_OPTIONS: ("+1" | "+7" | "+20" | "+27" | "+30" | "+31" | "+32" | "+33" | "+34" | "+36" | "+39" | "+40" | "+41" | "+43" | "+44" | "+45" | "+46" | "+47" | "+48" | "+49" | "+51" | "+52" | "+53" | "+54" | "+55" | "+56" | "+57" | "+60" | "+61" | "+62" | "+63" | "+64" | "+65" | "+66" | "+81" | "+82" | "+84" | "+86" | "+90" | "+91" | "+92" | "+93" | "+94" | "+95" | "+98" | "+211" | "+212" | "+213" | "+216" | "+218" | "+220" | "+221" | "+234" | "+254" | "+255" | "+256" | "+260" | "+263" | "+264" | "+265" | "+880" | "+886" | "+971" | "+972" | "+973" | "+974" | "+975" | "+976" | "+977")[];
+export declare const ISD_OPTIONS: ("+91" | "+1" | "+7" | "+20" | "+27" | "+30" | "+31" | "+32" | "+33" | "+34" | "+36" | "+39" | "+40" | "+41" | "+43" | "+44" | "+45" | "+46" | "+47" | "+48" | "+49" | "+51" | "+52" | "+53" | "+54" | "+55" | "+56" | "+57" | "+60" | "+61" | "+62" | "+63" | "+64" | "+65" | "+66" | "+81" | "+82" | "+84" | "+86" | "+90" | "+92" | "+93" | "+94" | "+95" | "+98" | "+211" | "+212" | "+213" | "+216" | "+218" | "+220" | "+221" | "+234" | "+254" | "+255" | "+256" | "+260" | "+263" | "+264" | "+265" | "+880" | "+886" | "+971" | "+972" | "+973" | "+974" | "+975" | "+976" | "+977")[];

package/dist/components/KundliMatchingFormSection/validation.d.ts

@@ -0,0 +1,27 @@
+import { PersonFormValues } from './KundliMatchingFormSection';
+export declare const validateFullName: (name: string) => string | null;
+/** Latest DOB that is still 18 today, as YYYY-MM-DD (for the date input's max). */
+export declare const getMaxDob: (today?: Date) => string;
+/** Earliest DOB that is still ≤ 100 today, as YYYY-MM-DD (for the date input's min). */
+export declare const getMinDob: (today?: Date) => string;
+/**
+ * `dob` is the native date input value (YYYY-MM-DD). The input itself only emits
+ * real calendar dates (or ''), so this checks the 18–100 age window only.
+ */
+export declare const validateDateOfBirth: (dob: string, today?: Date) => string | null;
+export declare const validateBirthPlace: (person: PersonFormValues) => string | null;
+/** +91 numbers must be 10-digit Indian mobiles (start 6/7/8/9); other ISD codes keep the plain 10-digit rule. */
+export declare const validatePhone: (phone: string, isdCode: string) => string | null;
+export type PersonField = 'fullName' | 'dateOfBirth' | 'birthTime' | 'birthPlace';
+/** First empty-or-invalid field for one partner, or null when the block is complete and valid. */
+export declare const getFirstInvalidPersonField: (person: PersonFormValues) => PersonField | null;
+/** Masks raw typing to DD/MM/YYYY. Slashes are only added before a following digit, so backspace never gets stuck on one. */
+export declare const maskDobInput: (raw: string) => string;
+/** "DD/MM/YYYY" → "YYYY-MM-DD", or '' when incomplete or not a real calendar date (e.g. 31/02/2000). */
+export declare const dobDisplayToIso: (display: string) => string;
+/** "YYYY-MM-DD" → "DD/MM/YYYY" ('' passes through). */
+export declare const dobIsoToDisplay: (iso: string) => string;
+/** A fully typed DD/MM/YYYY that isn't a real date — the only case the mask can't prevent. */
+export declare const validateDobDraft: (display: string) => string | null;
+/** Date the picker opens on when the field is empty: today minus 28 years, computed at runtime (PRD §3.5). */
+export declare const getDefaultPickerDob: (today?: Date) => string;

package/dist/components/KundliMatchingHeader/KundliMatchingHeader.d.ts

@@ -1,10 +1,10 @@
 import { default as React } from 'react';
 export interface KundliMatchingHeaderProps {
     t: (key: string) => string;
-    languageSelector?: React.ReactNode;
-    logoUrl?: string;
     className?: string;
-    isGlobal?: boolean;
-    imageComponent?: React.ComponentType<any>;
 }
+/**
+ * Transparent header overlaid on the hero image (Figma 7983:13462).
+ * Must render inside KundliMatchingProvider, in a `position: relative` parent.
+ */
 export declare const KundliMatchingHeader: React.FC<KundliMatchingHeaderProps>;

package/dist/components/KundliMatchingPage/KundliMatchingContext.d.ts

@@ -10,7 +10,7 @@ export interface KundliMatchingContextConfig {
     isGlobal?: boolean;
     googleMapsApiKey?: string;
     plans?: KundliMatchingPlan[];
-    onProceed?: (values: KundliMatchingFormValues, plan: KundliMatchingPlan) => void;
+    onProceed?: (values: KundliMatchingFormValues, plan: KundliMatchingPlan) => void | Promise<void>;
     analytics?: KundliMatchingAnalytics;
     onLocaleChange?: (locale: SupportedLocale) => void;
     /** Optional image component (e.g. next/image adapter) for optimized images. */

package/dist/components/KundliMatchingPage/KundliMatchingPage.d.ts

@@ -18,14 +18,19 @@ export interface KundliMatchingPageProps {
     googleMapsApiKey?: string;
     /** Optional plans override */
     plans?: KundliMatchingPlan[];
-    /** Callback when proceeding to payment */
-    onProceed?: (formValues: KundliMatchingFormValues, selectedPlan: KundliMatchingPlan) => void;
+    /**
+     * Callback when proceeding to payment. Return a promise that resolves once the
+     * gateway opens (or rejects on failure) to drive the CTA's loading / "Try again" states.
+     */
+    onProceed?: (formValues: KundliMatchingFormValues, selectedPlan: KundliMatchingPlan) => void | Promise<void>;
     /** Notify when user changes language */
     onLocaleChange?: (locale: SupportedLocale) => void;
     /** Pre-fills form values on mount (e.g. from URL query params on a deep-linked SEO flow). */
     initialFormValues?: Partial<KundliMatchingFormValues>;
     /** When true, automatically opens the plan selection bottom sheet once. Used for deep-linked flows where the form is already fully pre-filled. */
     autoOpenPlanSheet?: boolean;
+    /** Hero variant slug (`?variant=`), passed by the host for SSR. Resolved on the client when omitted. */
+    variant?: string;
 }
 /**
  * Complete Kundli Matching Generator page with all sections

package/dist/components/KundliMatchingPlanBottomSheet/KundliMatchingPlanBottomSheet.d.ts

@@ -4,8 +4,14 @@ export interface KundliMatchingPlanBottomSheetProps {
     isOpen: boolean;
     onClose: () => void;
     selectedPlan: KundliMatchingPlan | null;
-    onSelectPlan: (plan: KundliMatchingPlan) => void;
-    onProceed: (plan: KundliMatchingPlan) => void;
+    /** `byUser` is true for a tap, false/omitted for the default preselect on open. */
+    onSelectPlan: (plan: KundliMatchingPlan, byUser?: boolean) => void;
+    /**
+     * Return a promise to get the PRD §2.1 states: the button shows a spinner and is
+     * disabled while it's pending, the sheet closes when it resolves, and a rejection
+     * flips the label to "Try again" (tap retries). A plain `void` closes immediately.
+     */
+    onProceed: (plan: KundliMatchingPlan) => void | Promise<void>;
     plans?: KundliMatchingPlan[];
     isGlobal?: boolean;
     t?: (key: string) => string;

package/dist/components/ProceedFooter/ProceedFooter.d.ts

@@ -8,6 +8,10 @@ export interface ProceedFooterProps {
     t: (key: string) => string;
     values: KundliMatchingFormValues;
     onProceed: () => void;
+    /** Fired when the CTA is tapped while the form is incomplete or invalid — the page uses it to reveal all inline errors. */
+    onInvalidAttempt?: () => void;
+    /** ISD code shown next to the phone input; "+91" turns on the Indian-mobile rule. */
+    phoneIsdCode?: string;
     isGlobal?: boolean;
     analytics?: KundliMatchingAnalytics;
     className?: string;

package/dist/components/ReportHighlightsSection/ReportHighlightsSection.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+export interface ReportHighlightsSectionProps {
+    t: (key: string) => string;
+    /** "Get Your Matching Report" — scrolls to the form (PRD §3.3). */
+    onCtaClick?: () => void;
+    className?: string;
+}
+/** "Get your Kundli Matching Report" section (Figma 7983:12826). */
+export declare const ReportHighlightsSection: React.FC<ReportHighlightsSectionProps>;

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

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

package/dist/components/SneakPeekSection/SneakPeekSection.d.ts

@@ -1,8 +1,21 @@
 import { default as React } from 'react';
 import { KundliMatchingAnalytics } from '../../analytics';
+type T = (key: string) => string;
+/** Trust stats row values (labels are translation keys). */
+export declare const SNEAK_PEEK_TRUST_STATS: readonly [{
+    readonly value: "4.9★";
+    readonly labelKey: "trustRatings";
+}, {
+    readonly value: "12k +";
+    readonly labelKey: "trustUsers";
+}, {
+    readonly value: "200+";
+    readonly labelKey: "trustAstrologers";
+}];
 export interface SneakPeekSectionProps {
-    t: (key: string) => string;
+    t: T;
     analytics?: KundliMatchingAnalytics;
     className?: string;
 }
 export declare const SneakPeekSection: React.FC<SneakPeekSectionProps>;
+export {};

package/dist/components/ViewSampleReportButton/SampleReportModal.d.ts

@@ -4,5 +4,7 @@ export interface SampleReportModalProps {
     onClose: () => void;
     title: string;
     pdfUrl: string;
+    /** Fired once per page per open, when a rendered page crosses the middle of the viewport. */
+    onPageView?: (pageNumber: number) => void;
 }
 export declare const SampleReportModal: FC<SampleReportModalProps>;

package/dist/components/index.d.ts

@@ -2,7 +2,13 @@ export { KundliMatchingHeader } from './KundliMatchingHeader';
 export type { KundliMatchingHeaderProps } from './KundliMatchingHeader';
 export { HeroSection } from './HeroSection';
 export type { HeroSectionProps } from './HeroSection';
-export { FeaturesSection } from './FeaturesSection';
-export type { FeaturesSectionProps } from './FeaturesSection';
+export { ContactSection } from './ContactSection';
+export type { ContactSectionProps } from './ContactSection';
+export { AstrologersSection } from './AstrologersSection';
+export type { AstrologersSectionProps } from './AstrologersSection';
+export { ReportHighlightsSection } from './ReportHighlightsSection';
+export type { ReportHighlightsSectionProps } from './ReportHighlightsSection';
+export { BabaTestimonialSection } from './BabaTestimonialSection';
+export type { BabaTestimonialSectionProps } from './BabaTestimonialSection';
 export { SneakPeekSection } from './SneakPeekSection';
 export type { SneakPeekSectionProps } from './SneakPeekSection';