kundli-generator 1.0.3 → 1.0.4

package/dist/analytics.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Event names matching Kundli Generator Events taxonomy (Mixpanel).
+ * Host app (e.g. hanuman) should use these when calling logEvent.
+ */
+export declare const KUNDLI_ANALYTICS_EVENT_NAMES: {
+    readonly banner_clicked_fe: "banner_clicked_fe";
+    readonly primary_cta_clicked_fe: "primary_cta_clicked_fe";
+    readonly language_changed_fe: "language_changed_fe";
+    readonly language_clicked_fe: "language_clicked_fe";
+    readonly retry_payment: "retry_payment";
+    readonly detailed_kundli_report_impression_fe: "detailed_kundli_report_impression_fe";
+    readonly payment_partner_page_opened: "payment_partner_page_opened";
+    readonly view_sample_report_clicked: "view_sample_report_clicked";
+    readonly view_sample_report_closed: "view_sample_report_closed";
+    readonly l1_page_opened: "l1_page_opened";
+    readonly info_icon_clicked: "info_icon_clicked";
+    readonly name_section_clicked: "name_section_clicked";
+    readonly name_section_filled: "name_section_filled";
+    readonly phone_section_clicked: "phone_section_clicked";
+    readonly phone_section_filled: "phone_section_filled";
+    readonly email_section_clicked: "email_section_clicked";
+    readonly email_section_filled: "email_section_filled";
+    readonly dob_clicked: "dob_clicked";
+    readonly dob_filled: "dob_filled";
+    readonly time_clicked: "time_clicked";
+    readonly time_filled: "time_filled";
+    readonly time_checkbox_clicked: "time_checkbox_clicked";
+    readonly place_of_birth_clicked: "place_of_birth_clicked";
+    readonly place_of_birth_chosen: "place_of_birth_chosen";
+    readonly language_of_report_clicked: "language_of_report_clicked";
+    readonly primary_cta_clicked_l1: "primary_cta_clicked_l1";
+    /** 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) */
+    readonly kundli_form_view: "kundli_form_view";
+};
+export type KundliAnalyticsEventName = (typeof KUNDLI_ANALYTICS_EVENT_NAMES)[keyof typeof KUNDLI_ANALYTICS_EVENT_NAMES];
+/** Optional analytics implementation. Pass from host to KundliPage/KundliForm to track events. */
+export interface KundliAnalytics {
+    trackBannerClicked?(): void;
+    trackPrimaryCtaClickedFe?(params: {
+        ctaText?: string;
+    }): void;
+    trackLanguageChangedFe?(params: {
+        newLanguage: string;
+    }): void;
+    trackLanguageClickedFe?(params: {
+        language: string;
+    }): void;
+    trackDetailedKundliReportImpressionFe?(params: {
+        section: string;
+        timestamp?: string;
+    }): void;
+    trackViewSampleReportClicked?(): void;
+    trackViewSampleReportClosed?(): void;
+    trackL1PageOpened?(): void;
+    trackInfoIconClicked?(params: {
+        fieldName: string;
+    }): void;
+    trackNameSectionClicked?(): void;
+    trackNameSectionFilled?(): void;
+    trackPhoneSectionClicked?(): void;
+    trackPhoneSectionFilled?(): void;
+    trackEmailSectionClicked?(): void;
+    trackEmailSectionFilled?(): void;
+    trackDobClicked?(): void;
+    trackDobFilled?(): void;
+    trackTimeClicked?(): void;
+    trackTimeFilled?(): void;
+    trackTimeCheckboxClicked?(): void;
+    trackPlaceOfBirthClicked?(): void;
+    trackPlaceOfBirthChosen?(): void;
+    trackLanguageOfReportClicked?(): void;
+    trackPrimaryCtaClickedL1?(params: {
+        avenue?: string;
+    }): void;
+    trackKundliPageView?(): void;
+    trackKundliFormView?(): void;
+}

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

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { SupportedLocale } from '../../i18n/translations';
+import { KundliAnalytics } from '../../analytics';
 export interface KundliFormValues {
     fullName: string;
     phone?: string;
@@ -11,17 +12,15 @@ export interface KundliFormValues {
 }
 export interface KundliFormProps {
     className?: string;
-    /** Language (en, hi, ta, te). Overrides I18nProvider if set. */
+    /** Language (en, hi, ta, te). Overrides I18nProvider if set. Initial value when using dropdown. */
     locale?: SupportedLocale;
     /** Show language dropdown. Default true. */
     showLanguageSelector?: boolean;
-    /** Header logo URL */
-    logoUrl?: string;
-    /** Back button handler (e.g. go back to KundliPage) */
+    /** Back button handler in header */
     onBack?: () => void;
     /** Initial field values */
     initialValues?: Partial<KundliFormValues>;
-    /** Called when user clicks Proceed; receives form data. Use for payment/navigation in consumer. */
+    /** Called when user clicks Proceed to payment */
     onProceed?: (values: KundliFormValues) => void;
     /** If provided, proceed CTA becomes a link */
     proceedHref?: string;
@@ -29,6 +28,7 @@ export interface KundliFormProps {
     originalPriceLabel?: string;
     discountedPriceLabel?: string;
     discountPillLabel?: string;
+    /** Optional analytics for tracking form events */
+    analytics?: KundliAnalytics;
 }
-/** Standalone Kundli form. Use with onProceed callback to get form data; no context required. */
 export declare const KundliForm: React.FC<KundliFormProps>;

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

@@ -1,10 +1,12 @@
 import { default as React } from 'react';
 import { KundliFormValues } from '../../KundliForm';
+import { KundliAnalytics } from '../../../../../analytics';
 export interface ProceedFooterProps {
     t: (key: string) => string;
     values: KundliFormValues;
     onProceed?: (values: KundliFormValues) => void;
     href?: string;
+    analytics?: KundliAnalytics;
     className?: string;
     originalPriceLabel?: string;
     discountedPriceLabel?: string;

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

@@ -1,9 +1,11 @@
 import { default as React } from 'react';
 import { KundliFormValues } from '../../KundliForm';
+import { KundliAnalytics } from '../../../../../analytics';
 export interface UserInfoFormSectionProps {
     t: (key: string) => string;
     values: KundliFormValues;
     onChange: (values: KundliFormValues) => void;
+    analytics?: KundliAnalytics;
     className?: string;
 }
 export declare const UserInfoFormSection: React.FC<UserInfoFormSectionProps>;

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

@@ -0,0 +1,44 @@
+import { default as React } from 'react';
+import { SupportedLocale } from '../../i18n/translations';
+import { KundliFormValues } from '../KundliForm';
+import { KundliAnalytics } from '../../analytics';
+export type KundliView = "landing" | "form";
+export interface KundliContextConfig {
+    locale?: SupportedLocale;
+    showLanguageSelector?: boolean;
+    userId?: number;
+    logoUrl?: string;
+    reportImageUrl?: string;
+    universityLogoUrls?: [string?, string?];
+    sampleReportHref?: string;
+    onViewSampleReport?: () => void;
+    ctaHref?: string;
+    onCtaClick?: () => void;
+    readMoreReviewsHref?: string;
+    onProceed?: (values: KundliFormValues) => void;
+    proceedHref?: string;
+    originalPriceLabel?: string;
+    discountedPriceLabel?: string;
+    discountPillLabel?: string;
+    analytics?: KundliAnalytics;
+}
+export interface KundliContextValue {
+    view: KundliView;
+    locale: SupportedLocale;
+    setLocale: (locale: SupportedLocale) => void;
+    config: KundliContextConfig;
+    formValues: KundliFormValues;
+    setFormValues: React.Dispatch<React.SetStateAction<KundliFormValues>>;
+    goToForm: () => void;
+    goToPage: () => void;
+    onProceed?: (values: KundliFormValues) => void;
+}
+declare const KundliContext: React.Context<KundliContextValue | null>;
+export interface KundliProviderProps extends KundliContextConfig {
+    className?: string;
+    children?: React.ReactNode;
+}
+export declare const KundliProvider: React.FC<KundliProviderProps>;
+export declare function useKundliContext(): KundliContextValue | null;
+export declare function useKundliContextOrThrow(): KundliContextValue;
+export { KundliContext };

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

@@ -1,5 +1,7 @@
 import { default as React } from 'react';
 import { SupportedLocale } from '../../i18n/translations';
+import { KundliFormValues } from '../KundliForm';
+import { KundliAnalytics } from '../../analytics';
 export interface KundliPageProps {
     /** Optional CSS class name */
     className?: string;
@@ -11,8 +13,6 @@ export interface KundliPageProps {
     userId?: number;
     /** Header logo URL */
     logoUrl?: string;
-    /** A4B API instance (for consumer use; e.g. pass to form submit in Hanuman) */
-    a4bApi?: A4BApi;
     /** Premium report cover image URL */
     reportImageUrl?: string;
     /** University logo URLs [BHU, VSU] */
@@ -21,12 +21,21 @@ export interface KundliPageProps {
     sampleReportHref?: string;
     /** Called when "View Sample Report" is clicked (if sampleReportHref not set) */
     onViewSampleReport?: () => void;
-    /** CTA button link (e.g. checkout URL). If set, CTA is a link; otherwise CTA triggers onCtaClick. */
+    /** CTA button link (e.g. checkout URL). If set, CTA is a link; otherwise CTA shows the Kundli form. */
     ctaHref?: string;
-    /** Called when CTA button is clicked (when ctaHref is not set). Consumer can show KundliForm. */
+    /** Called when CTA button is clicked (if ctaHref not set). Also called after navigating to form when integrated. */
     onCtaClick?: () => void;
     /** Read more reviews link */
     readMoreReviewsHref?: string;
+    /** Called when user proceeds from the form (e.g. to payment) */
+    onProceed?: (values: KundliFormValues) => void;
+    /** Form: proceed CTA as link */
+    proceedHref?: string;
+    /** Form: pricing labels */
+    originalPriceLabel?: string;
+    discountedPriceLabel?: string;
+    discountPillLabel?: string;
+    /** Optional analytics implementation for Mixpanel/tracking events */
+    analytics?: KundliAnalytics;
 }
-/** Landing page content (hero, steps, CTA). Decoupled from form; use onCtaClick to show KundliForm in consumer. */
 export declare const KundliPage: React.FC<KundliPageProps>;

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

@@ -1,4 +1,5 @@
 import { default as React } from 'react';
+import { KundliAnalytics } from '../../../../../analytics';
 export interface ViewSampleReportButtonProps {
     t: (key: string) => string;
     /** PDF URL to display in modal. Defaults to a sample PDF. */
@@ -7,6 +8,8 @@ export interface ViewSampleReportButtonProps {
     href?: string;
     /** Called when button is clicked (e.g. for analytics). Modal opens regardless. */
     onClick?: () => void;
+    /** Optional analytics for tracking view sample clicked/closed */
+    analytics?: KundliAnalytics;
     className?: string;
 }
 export declare const ViewSampleReportButton: React.FC<ViewSampleReportButtonProps>;

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { KundliPage } from './components/KundliPage';
-export type { KundliPageProps } from './components/KundliPage';
+export { KundliProvider, useKundliContext, useKundliContextOrThrow, KundliContext, } from './components/KundliPage/KundliContext';
+export type { KundliView, KundliContextConfig, KundliContextValue, KundliProviderProps, } from './components/KundliPage/KundliContext';
+export { KUNDLI_ANALYTICS_EVENT_NAMES, type KundliAnalytics, type KundliAnalyticsEventName, } from './analytics';
 export { KundliForm } from './components/KundliForm';
-export type { KundliFormValues, KundliFormProps } from './components/KundliForm';
+export type { KundliFormValues } from './components/KundliForm';
 export { I18nProvider, useI18n, SUPPORTED_LOCALES, type SupportedLocale, } from './i18n';