@srimandir/pitru-paksh-common 2.0.19 → 2.0.24

package/dist/components/CheckoutBar/CheckoutBar.translations.d.ts

@@ -5,7 +5,7 @@
  * re-computing/re-translating it. Pass `proceedLabel` explicitly to override
  * it for a one-off usage.
  */
-export type CheckoutBarLocale = 'en' | 'hi';
+export type CheckoutBarLocale = 'en' | 'hi' | 'te';
 export interface CheckoutBarDefaultCopy {
     proceedLabel: string;
 }

package/dist/components/ConfirmPujaDetailsModal/ConfirmPujaDetailsModal.d.ts

@@ -0,0 +1,11 @@
+import { ConfirmPujaDetailsModalProps } from './ConfirmPujaDetailsModal.types';
+/**
+ * "Check the details to book your puja procedure" confirmation sheet shown
+ * after `PujaDetailsForm` is filled in and the devotee taps the checkout
+ * bar's CTA: a read-only summary of the ancestors, Karta (performer) names,
+ * Gotra and WhatsApp number/email, plus "Edit Details" (back to the form)
+ * and a "Pay" CTA that hands off to the payment flow via `onProceedPayment`.
+ *
+ * All labels default to locale-specific copy (`locale`, `'en'`/`'hi'`/`'te'`).
+ */
+export declare function ConfirmPujaDetailsModal({ isOpen, onClose, locale, ancestors, kartaNames, gotra, whatsappNumber, amount, onEditDetailsClick, onProceedPayment, className, }: ConfirmPujaDetailsModalProps): import("react").JSX.Element;

package/dist/components/ConfirmPujaDetailsModal/ConfirmPujaDetailsModal.translations.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Default copy for `ConfirmPujaDetailsModal`, keyed by locale. This "check
+ * the details to book your puja" confirmation sheet shows the same labels
+ * everywhere it's used across Pitru Paksha flows, so the copy (and its
+ * translation) lives here once instead of every consuming page
+ * re-computing/re-translating it.
+ */
+export type ConfirmPujaDetailsModalLocale = 'en' | 'hi' | 'te';
+export interface ConfirmPujaDetailsModalDefaultCopy {
+    heading: string;
+    subtext: string;
+    ancestorsLabel: string;
+    performerLabel: string;
+    gotraLabel: string;
+    whatsappLabel: string;
+    editDetailsLabel: string;
+    /** e.g. "Pay {amount}" — `{amount}` is replaced with the `amount` prop (already formatted, e.g. "₹1648/-"). Word order varies by locale. */
+    payButtonTemplate: string;
+}
+export declare const CONFIRM_PUJA_DETAILS_MODAL_DEFAULT_COPY: Record<ConfirmPujaDetailsModalLocale, ConfirmPujaDetailsModalDefaultCopy>;
+/** Resolves the default copy for `locale`, falling back to `'en'` when unsupported. */
+export declare const getConfirmPujaDetailsModalDefaultCopy: (locale?: string) => ConfirmPujaDetailsModalDefaultCopy;

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

@@ -0,0 +1,25 @@
+import { AncestorNameEntry } from '../PujaDetailsForm';
+import { ConfirmPujaDetailsModalLocale } from './ConfirmPujaDetailsModal.translations';
+export interface ConfirmPujaDetailsModalProps {
+    isOpen: boolean;
+    /** Called by the close (X) button, backdrop tap and Escape. */
+    onClose: () => void;
+    /**
+     * Locale used to resolve all the labels below. Defaults to `'en'`.
+     */
+    locale?: ConfirmPujaDetailsModalLocale;
+    /** Ancestors this puja is for — reuses `PujaDetailsForm`'s shape (`label` = relation, e.g. "Grandfather"; `value` = name), so the same data filled in there can be passed straight through. Each renders as a "{value} ({label})" pill. */
+    ancestors: AncestorNameEntry[];
+    /** Karta (performer) names, in order — each renders as a "{n}. {name}" pill. */
+    kartaNames: string[];
+    gotra: string;
+    /** 10-digit Indian mobile number, or the email when the devotee filled that in instead (see `PujaDetailsForm`'s `isGlobal`). */
+    whatsappNumber: string;
+    /** Final amount shown on the Pay button, e.g. "₹1648/-". */
+    amount: string;
+    /** Fired when "Edit Details" is clicked — typically closes the modal and returns to `PujaDetailsForm`. */
+    onEditDetailsClick?: () => void;
+    /** Fired when the Pay button is clicked, to hand off to the payment flow. */
+    onProceedPayment: () => void;
+    className?: string;
+}

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

@@ -0,0 +1,4 @@
+export { ConfirmPujaDetailsModal } from './ConfirmPujaDetailsModal';
+export type { ConfirmPujaDetailsModalProps } from './ConfirmPujaDetailsModal.types';
+export { CONFIRM_PUJA_DETAILS_MODAL_DEFAULT_COPY, getConfirmPujaDetailsModalDefaultCopy, } from './ConfirmPujaDetailsModal.translations';
+export type { ConfirmPujaDetailsModalLocale, ConfirmPujaDetailsModalDefaultCopy, } from './ConfirmPujaDetailsModal.translations';

package/dist/components/GotraInfoModal/GotraInfoModal.d.ts

@@ -0,0 +1,9 @@
+import { GotraInfoModalProps } from './GotraInfoModal.types';
+/**
+ * "I do not know my Lineage (Gotra), what should I do?" info sheet opened
+ * from the info icon next to `PujaDetailsForm`'s Gotra field: explains the
+ * Kashyap-Gotra fallback per scripture, with a single "Okay" CTA to dismiss.
+ *
+ * All copy defaults to locale-specific text (`locale`, `'en'`/`'hi'`/`'te'`).
+ */
+export declare function GotraInfoModal({ isOpen, onClose, locale, className }: GotraInfoModalProps): import("react").JSX.Element;

package/dist/components/GotraInfoModal/GotraInfoModal.translations.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default copy for `GotraInfoModal`, keyed by locale. Explains what to do
+ * when a devotee doesn't know their Gotra (lineage) — opened from the
+ * Gotra field's info icon in `PujaDetailsForm`.
+ */
+export type GotraInfoModalLocale = 'en' | 'hi' | 'te';
+export interface GotraInfoModalDefaultCopy {
+    heading: string;
+    body: string;
+    okayLabel: string;
+    closeButtonAriaLabel: string;
+}
+export declare const GOTRA_INFO_MODAL_DEFAULT_COPY: Record<GotraInfoModalLocale, GotraInfoModalDefaultCopy>;
+/** Resolves the default copy for `locale`, falling back to `'en'` when unsupported. */
+export declare const getGotraInfoModalDefaultCopy: (locale?: string) => GotraInfoModalDefaultCopy;

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

@@ -0,0 +1,12 @@
+import { GotraInfoModalLocale } from './GotraInfoModal.translations';
+export interface GotraInfoModalProps {
+    isOpen: boolean;
+    /** Called by the close (X) button, backdrop tap, Escape and the "Okay" button. */
+    onClose: () => void;
+    /**
+     * Locale used to resolve the heading/body/button copy below. Defaults to
+     * `'en'`.
+     */
+    locale?: GotraInfoModalLocale;
+    className?: string;
+}

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

@@ -0,0 +1,4 @@
+export { GotraInfoModal } from './GotraInfoModal';
+export type { GotraInfoModalProps } from './GotraInfoModal.types';
+export { GOTRA_INFO_MODAL_DEFAULT_COPY, getGotraInfoModalDefaultCopy, } from './GotraInfoModal.translations';
+export type { GotraInfoModalLocale, GotraInfoModalDefaultCopy } from './GotraInfoModal.translations';

package/dist/components/PackageSelect/PackageSelect.translations.d.ts

@@ -7,7 +7,7 @@
  * `title`/`description`/`benefits`/`trustBadges` explicitly to override any
  * of it for a one-off usage.
  */
-export type PackageSelectLocale = 'en' | 'hi';
+export type PackageSelectLocale = 'en' | 'hi' | 'te';
 export interface PackageSelectDefaultCopy {
     title: string;
     description: string;

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

@@ -0,0 +1,6 @@
+/** Max length enforced on every free-text name field (Karta, ancestor, Gotra). */
+export declare const MAX_NAME_LENGTH = 40;
+/** This form only ever collects an Indian mobile number — there's no country selector. */
+export declare const INDIA_COUNTRY_CODE = "+91";
+/** Basic email shape check used for the `isGlobal` email field's error state. */
+export declare const EMAIL_PATTERN: RegExp;

package/dist/components/PujaDetailsForm/PujaDetailsForm.d.ts

@@ -0,0 +1,25 @@
+import { AncestorNameEntry, PujaDetailsFormProps, PujaDetailsFormValues } from './PujaDetailsForm.types';
+/**
+ * Complete "fill in Karta, Gotra, WhatsApp number and ancestor details"
+ * screen used across Pitru Paksha flows: a WhatsApp number field (or email,
+ * see `isGlobal`), up to N Karta (performer) names, the Karta's Gotra (with
+ * an "unknown Gotra" fallback), and the ancestors' + their parents' names —
+ * each rendered with the "Late" prefix. Ends with a sticky `CheckoutBar`
+ * footer.
+ *
+ * Most section headings/field labels default to locale-specific copy
+ * (`locale`, `'en'`/`'hi'`/`'te'`) and can be overridden per-prop for a
+ * one-off usage. The WhatsApp/email field copy and the "Late" prefix are
+ * always the fixed, translated copy (not overridable) since this form only
+ * ever collects an Indian mobile number or an email.
+ */
+export declare function PujaDetailsForm({ locale, values, onValuesChange, isGlobal, gotraOptions, isSarvaPitru, onBackClick, amount, ritualsCountLabel, onPriceInfoClick, canProceed, proceedCtaLabel, proceedButtonProps, onProceedPayment, className, }: PujaDetailsFormProps): import("react").JSX.Element;
+/**
+ * Convenience factory for a blank `PujaDetailsFormValues`, e.g. to seed local
+ * component state. `kartaCount` sets how many Karta name fields render —
+ * pass whatever number of performers the devotee selected upstream (e.g. via
+ * `PackageSelect`). Defaults to `3`. `ancestors` seeds the ancestor name
+ * fields — pass the relation `label`s (and any pre-filled `value`s) carried
+ * over from the earlier ancestor-selection step; defaults to an empty list.
+ */
+export declare function createEmptyPujaDetailsFormValues(kartaCount?: number, ancestors?: AncestorNameEntry[]): PujaDetailsFormValues;

package/dist/components/PujaDetailsForm/PujaDetailsForm.translations.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Default copy for `PujaDetailsForm`, keyed by locale. This "fill in Karta,
+ * Gotra, WhatsApp number and ancestor details" screen shows the same labels
+ * everywhere it's used across Pitru Paksha flows, so the copy (and its
+ * translation) lives here once instead of every consuming page
+ * re-computing/re-translating it. Pass any of the corresponding
+ * `PujaDetailsFormProps` explicitly to override a piece of it for a one-off
+ * usage.
+ */
+export type PujaDetailsFormLocale = 'en' | 'hi' | 'te';
+export interface PujaDetailsFormDefaultCopy {
+    topBarTitle: string;
+    backButtonAriaLabel: string;
+    whatsappNumberLabel: string;
+    whatsappNumberPlaceholder: string;
+    whatsappNumberHelperText: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    emailHelperText: string;
+    kartaNameSectionTitle: string;
+    /** e.g. "Karta's name" — combined with a per-position ordinal (see `getKartaOrdinalLabel`) and, for every position after the first, `kartaNameOptionalSuffix`. */
+    kartaNameLabel: string;
+    /** e.g. "(optional)" — appended after `kartaNameLabel` for every Karta name field after the first (which is always required). */
+    kartaNameOptionalSuffix: string;
+    kartaNamePlaceholder: string;
+    gotraFieldLabel: string;
+    gotraFieldPlaceholder: string;
+    gotraUnknownCheckboxLabel: string;
+    gotraUnknownHelperText: string;
+    ancestorNameSectionTitle: string;
+    ancestorNameSectionSubtitle: string;
+    /** e.g. "name" — appended after an ancestor's relation `label` (from the ancestor-selection step) to build that field's label, e.g. "Grandfather (Maternal) name". */
+    ancestorNameFieldSuffix: string;
+    /** Subtitle shown under the ancestor section's heading when `isSarvaPitru` is set, instead of `ancestorNameSectionSubtitle`. */
+    sarvaPitruSectionSubtitle: string;
+    /** Read-only field value shown when `isSarvaPitru` is set, e.g. "For all ancestors" — replaces the editable ancestor name fields entirely. */
+    sarvaPitruFieldValue: string;
+    /** Helper text shown under the `sarvaPitruFieldValue` field. */
+    sarvaPitruHelperText: string;
+    latePrefixLabel: string;
+    proceedCtaLabel: string;
+    /** Displayed as the Gotra in `ConfirmPujaDetailsModal` when `isGotraUnknown` is set, per `gotraUnknownHelperText`. */
+    kashyapGotraLabel: string;
+}
+export declare const PUJA_DETAILS_FORM_DEFAULT_COPY: Record<PujaDetailsFormLocale, PujaDetailsFormDefaultCopy>;
+/** Resolves the default copy for `locale`, falling back to `'en'` when unsupported. */
+export declare const getPujaDetailsFormDefaultCopy: (locale?: string) => PujaDetailsFormDefaultCopy;
+/** Resolves the ordinal word/numeral for a 1-based Karta field `position`, falling back to `'en'` when `locale` is unsupported. */
+export declare const getKartaOrdinalLabel: (position: number, locale?: string) => string;

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

@@ -0,0 +1,77 @@
+import { CheckoutBarProps } from '../CheckoutBar';
+import { PujaDetailsFormLocale } from './PujaDetailsForm.translations';
+/** A single ancestor whose name is read in the sankalp. */
+export interface AncestorNameEntry {
+    id: string;
+    /**
+     * Relation label chosen in the earlier ancestor-selection step, e.g.
+     * "Grandfather (Maternal)", "Mother", "Father". Combined with a translated
+     * "name" suffix to build this field's label (e.g. "Grandfather (Maternal)
+     * name") — not editable here.
+     */
+    label: string;
+    /**
+     * The ancestor's name. May arrive pre-filled from the ancestor-selection
+     * step, or empty for the devotee to fill in here — editable either way.
+     */
+    value: string;
+}
+export interface PujaDetailsFormValues {
+    /** 10-digit Indian mobile number, collected when `isGlobal` is false. */
+    whatsappNumber: string;
+    /** Collected instead of `whatsappNumber` when `isGlobal` is true. */
+    email: string;
+    /** Karta (performer) names — the 1st is required, every position after it is optional. Render as many fields as the parent needs (e.g. based on a "number of Kartas" selection elsewhere). */
+    kartaNames: string[];
+    gotra: string;
+    isGotraUnknown: boolean;
+    /** Ancestors this puja is being performed for; each renders as an editable "Late <name>" field labeled from `label`. */
+    ancestors: AncestorNameEntry[];
+}
+export interface PujaDetailsFormProps {
+    /**
+     * Locale used to resolve all the default labels/placeholders below when
+     * they aren't passed explicitly. Defaults to `'en'`.
+     */
+    locale?: PujaDetailsFormLocale;
+    values: PujaDetailsFormValues;
+    onValuesChange: (values: PujaDetailsFormValues) => void;
+    /**
+     * Passed in from the parent based on the devotee's location. When `true`,
+     * an email field is shown instead of the India-only mobile number field
+     * (there's no country selector — non-Indian numbers aren't supported).
+     * Defaults to `false`.
+     */
+    isGlobal?: boolean;
+    /**
+     * Gotra suggestions shown in the Gotra field's dropdown (e.g. fetched from
+     * the backend by the parent). The field stays a free-text input — the
+     * devotee can pick one of these or type a Gotra that isn't listed.
+     * Defaults to an empty list (dropdown hidden).
+     */
+    gotraOptions?: string[];
+    /**
+     * When `true`, this puja is for all ancestors ("Sarva Pitru") — the
+     * editable ancestor name fields are hidden entirely and replaced with a
+     * single read-only "For all ancestors" field. Defaults to `false`.
+     */
+    isSarvaPitru?: boolean;
+    onBackClick?: () => void;
+    /** Final amount shown in the sticky bottom bar, e.g. "₹1648.0/-". */
+    amount: string;
+    /** Muted line under the amount in the sticky bottom bar, e.g. "2 Rituals". */
+    ritualsCountLabel?: string;
+    onPriceInfoClick?: () => void;
+    /** Overrides the computed required-fields check for enabling the CTA. */
+    canProceed?: boolean;
+    /** Defaults to locale-specific copy. */
+    proceedCtaLabel?: string;
+    proceedButtonProps?: CheckoutBarProps['proceedButtonProps'];
+    /**
+     * Fired when the `ConfirmPujaDetailsModal`'s Pay button is clicked (opened
+     * automatically when the checkout bar's CTA is tapped) — hand off to the
+     * payment flow here.
+     */
+    onProceedPayment: () => void;
+    className?: string;
+}

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

@@ -0,0 +1,4 @@
+export { PujaDetailsForm, createEmptyPujaDetailsFormValues } from './PujaDetailsForm';
+export type { PujaDetailsFormProps, PujaDetailsFormValues, AncestorNameEntry } from './PujaDetailsForm.types';
+export { PUJA_DETAILS_FORM_DEFAULT_COPY, getPujaDetailsFormDefaultCopy, getKartaOrdinalLabel, } from './PujaDetailsForm.translations';
+export type { PujaDetailsFormLocale, PujaDetailsFormDefaultCopy } from './PujaDetailsForm.translations';

package/dist/index.d.ts

@@ -56,6 +56,18 @@ export { L2Card } from './components/L2Card';
 export type { L2CardProps, L2CardImageProps } from './components/L2Card';
 export { OutcomeButton, PlusIcon, CheckIcon } from './components/OutcomeButton';
 export type { OutcomeButtonProps, OutcomeButtonVariant, IconProps } from './components/OutcomeButton';
+export { PujaDetailsForm, createEmptyPujaDetailsFormValues } from './components/PujaDetailsForm';
+export type { PujaDetailsFormProps, PujaDetailsFormValues, AncestorNameEntry, } from './components/PujaDetailsForm';
+export { PUJA_DETAILS_FORM_DEFAULT_COPY, getPujaDetailsFormDefaultCopy, getKartaOrdinalLabel, } from './components/PujaDetailsForm';
+export type { PujaDetailsFormLocale, PujaDetailsFormDefaultCopy, } from './components/PujaDetailsForm';
+export { ConfirmPujaDetailsModal } from './components/ConfirmPujaDetailsModal';
+export type { ConfirmPujaDetailsModalProps } from './components/ConfirmPujaDetailsModal';
+export { CONFIRM_PUJA_DETAILS_MODAL_DEFAULT_COPY, getConfirmPujaDetailsModalDefaultCopy, } from './components/ConfirmPujaDetailsModal';
+export type { ConfirmPujaDetailsModalLocale, ConfirmPujaDetailsModalDefaultCopy, } from './components/ConfirmPujaDetailsModal';
+export { GotraInfoModal } from './components/GotraInfoModal';
+export type { GotraInfoModalProps } from './components/GotraInfoModal';
+export { GOTRA_INFO_MODAL_DEFAULT_COPY, getGotraInfoModalDefaultCopy, } from './components/GotraInfoModal';
+export type { GotraInfoModalLocale, GotraInfoModalDefaultCopy, } from './components/GotraInfoModal';
 export { OutcomeSummary } from './components/OutcomeSummary';
 export type { OutcomeSummaryProps, OutcomeTrustItem, OutcomeTrustIconVariant } from './components/OutcomeSummary';
 export { SarvaPitruCard } from './components/SarvaPitruCard';

package/dist/pitru-paksh-common.d.ts

@@ -56,6 +56,18 @@ export { L2Card } from './components/L2Card';
 export type { L2CardProps, L2CardImageProps } from './components/L2Card';
 export { OutcomeButton, PlusIcon, CheckIcon } from './components/OutcomeButton';
 export type { OutcomeButtonProps, OutcomeButtonVariant, IconProps } from './components/OutcomeButton';
+export { PujaDetailsForm, createEmptyPujaDetailsFormValues } from './components/PujaDetailsForm';
+export type { PujaDetailsFormProps, PujaDetailsFormValues, AncestorNameEntry, } from './components/PujaDetailsForm';
+export { PUJA_DETAILS_FORM_DEFAULT_COPY, getPujaDetailsFormDefaultCopy, getKartaOrdinalLabel, } from './components/PujaDetailsForm';
+export type { PujaDetailsFormLocale, PujaDetailsFormDefaultCopy, } from './components/PujaDetailsForm';
+export { ConfirmPujaDetailsModal } from './components/ConfirmPujaDetailsModal';
+export type { ConfirmPujaDetailsModalProps } from './components/ConfirmPujaDetailsModal';
+export { CONFIRM_PUJA_DETAILS_MODAL_DEFAULT_COPY, getConfirmPujaDetailsModalDefaultCopy, } from './components/ConfirmPujaDetailsModal';
+export type { ConfirmPujaDetailsModalLocale, ConfirmPujaDetailsModalDefaultCopy, } from './components/ConfirmPujaDetailsModal';
+export { GotraInfoModal } from './components/GotraInfoModal';
+export type { GotraInfoModalProps } from './components/GotraInfoModal';
+export { GOTRA_INFO_MODAL_DEFAULT_COPY, getGotraInfoModalDefaultCopy, } from './components/GotraInfoModal';
+export type { GotraInfoModalLocale, GotraInfoModalDefaultCopy, } from './components/GotraInfoModal';
 export { OutcomeSummary } from './components/OutcomeSummary';
 export type { OutcomeSummaryProps, OutcomeTrustItem, OutcomeTrustIconVariant } from './components/OutcomeSummary';
 export { SarvaPitruCard } from './components/SarvaPitruCard';