@srimandir/pitru-paksh-common 1.0.12 → 2.0.0

package/dist/components/AudioQuestionCard/AudioQuestionCard.d.ts

@@ -1,7 +1,10 @@
 import { default as React } from 'react';
 export interface AudioQuestionCardProps extends React.HTMLAttributes<HTMLDivElement> {
     avatarUrl: string;
-    question: string;
+    /** Fully-styled question content — typography (size/weight/highlights) is the caller's responsibility. */
+    question: React.ReactNode;
+    /** Optional fully-styled caption shown below the question, e.g. context for why it's being asked. */
+    description?: React.ReactNode;
     /** When provided, plays once automatically on mount. */
     audioSrc?: string;
 }

package/dist/components/BillDetails/BillDetails.d.ts

@@ -0,0 +1,48 @@
+import { default as React } from 'react';
+export interface BillDetailsRow {
+    /** Stable key for the row, e.g. "kartas-fee". */
+    id: string | number;
+    /** Row label, e.g. "Narayan Bali Ritual Fee". */
+    label: React.ReactNode;
+    labelClassName?: string;
+    /** Muted helper text under the label, e.g. "₹100/day at Gokarna". */
+    subLabel?: React.ReactNode;
+    subLabelClassName?: string;
+    /** Muted parenthetical shown before the value, e.g. "(2x₹100)". */
+    note?: React.ReactNode;
+    /** Struck-through value shown before the final value, e.g. "₹851". */
+    originalValue?: React.ReactNode;
+    /** Final value, e.g. "₹200.0/-" or "FREE". Style it (e.g. green for FREE) via `valueClassName`. */
+    value: React.ReactNode;
+    valueClassName?: string;
+}
+export interface BillDetailsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React.ReactNode;
+    titleClassName?: string;
+    rows: BillDetailsRow[];
+    rowClassName?: string;
+    /** Set to `false` to hide the accent bar before the title. */
+    showTitleAccent?: boolean;
+    totalLabel?: React.ReactNode;
+    /** Omit to hide the total row entirely. */
+    totalValue?: React.ReactNode;
+    totalClassName?: string;
+}
+/**
+ * Itemized price breakdown used at the bottom of a cart/review screen:
+ * a titled list of fee rows (each with an optional muted sub-label,
+ * parenthetical note, and struck-through original value) followed by a
+ * dashed-border total row.
+ *
+ * @example
+ * <BillDetails
+ *   rows={[
+ *     { id: 'kartas', label: '2-Kartas Fee', value: '₹400.0/-' },
+ *     { id: 'mandap', label: 'Mandap Arrangement Fee', originalValue: '₹851', value: '₹651.0/-' },
+ *     { id: 'narayan-bali', label: 'Narayan Bali Ritual Fee', subLabel: '₹100/day at Gokarna', note: '(2x₹100)', value: '₹200.0/-' },
+ *     { id: 'pandit', label: 'Pandit Fee', labelClassName: 'text-gray-400', originalValue: '₹51.0', value: 'FREE', valueClassName: 'text-emerald-600 font-semibold' },
+ *   ]}
+ *   totalValue="₹1648.0/-"
+ * />
+ */
+export declare const BillDetails: React.FC<BillDetailsProps>;

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

@@ -0,0 +1,2 @@
+export { BillDetails } from './BillDetails';
+export type { BillDetailsProps, BillDetailsRow } from './BillDetails';

package/dist/components/BookingSummaryBanner/BookingSummaryBanner.d.ts

@@ -0,0 +1,32 @@
+import { default as React } from 'react';
+export interface BookingSummaryBannerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Leading icon, e.g. a star. Defaults to `<FaStar />`. Pass `null` to hide it. */
+    icon?: React.ReactNode;
+    iconClassName?: string;
+    /** Headline, e.g. "Pitru Paksha Special Rituals". */
+    title: React.ReactNode;
+    titleClassName?: string;
+    /**
+     * Stat line under the title, e.g. "4 Ancestors • 2 Rituals • 2 Performers".
+     * Pass a ready-made string/node here, or use `subtitleItems` to have the
+     * "•" separators inserted for you.
+     */
+    subtitle?: React.ReactNode;
+    /** Alternative to `subtitle` — an array of stats auto-joined with " • ". */
+    subtitleItems?: React.ReactNode[];
+    subtitleClassName?: string;
+    /** className for the inner white card. */
+    cardClassName?: string;
+}
+/**
+ * Pink-tinted "booking summary" banner shown at the top of a cart/review
+ * screen: a star + headline, and a stat line like "4 Ancestors • 2 Rituals •
+ * 2 Performers" inside a white card.
+ *
+ * @example
+ * <BookingSummaryBanner
+ *   title="Pitru Paksha Special Rituals"
+ *   subtitleItems={['4 Ancestors', '2 Rituals', '2 Performers']}
+ * />
+ */
+export declare const BookingSummaryBanner: React.FC<BookingSummaryBannerProps>;

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

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

package/dist/components/CartReviewItem/CartReviewItem.d.ts

@@ -0,0 +1,43 @@
+import { default as React } from 'react';
+export interface CartReviewItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Line item name, e.g. "Performers-Karta (2)" or "Narayan Bali Ritual". */
+    title: React.ReactNode;
+    /** Helper text under the title, e.g. who the ritual is performed for. Wraps onto multiple lines. */
+    description?: React.ReactNode;
+    /** Final price for this line item, e.g. "₹400". */
+    price: React.ReactNode;
+    /** Original price shown struck-through before `price`, e.g. "₹1899" for a discounted line. */
+    originalPrice?: React.ReactNode;
+    /**
+     * Trailing control under the price — typically `CartReviewChangeButton`,
+     * `CartReviewAddedBadge`, or nothing for a read-only line like taxes/fees.
+     */
+    action?: React.ReactNode;
+}
+/**
+ * Read-only line item row used on cart/booking-review screens: a title +
+ * optional description on the left, price (with optional struck-through
+ * original) and an optional action (Change/Added/etc.) on the right.
+ *
+ * @example
+ * <CartReviewItem
+ *   title="Performers-Karta (2)"
+ *   description="On behalf of two family members"
+ *   price="₹400"
+ *   action={<CartReviewChangeButton onClick={...} />}
+ * />
+ */
+export declare const CartReviewItem: React.FC<CartReviewItemProps>;
+export interface CartReviewChangeButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+}
+/** Pencil "Change" pill used as a `CartReviewItem` `action`, e.g. to edit performer count. */
+export declare const CartReviewChangeButton: React.FC<CartReviewChangeButtonProps>;
+export interface CartReviewAddedBadgeProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+}
+/**
+ * Green checkmark "Added" pill used as a `CartReviewItem` `action` once an
+ * optional ritual/service has been included. Renders as a `<button>` so it
+ * can double as a "remove" toggle if you pass `onClick`; drop `onClick` for
+ * a purely informational badge.
+ */
+export declare const CartReviewAddedBadge: React.FC<CartReviewAddedBadgeProps>;

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

@@ -0,0 +1,2 @@
+export { CartReviewItem, CartReviewChangeButton, CartReviewAddedBadge } from './CartReviewItem';
+export type { CartReviewItemProps, CartReviewChangeButtonProps, CartReviewAddedBadgeProps, } from './CartReviewItem';

package/dist/components/CartView/CartView.d.ts

@@ -0,0 +1,65 @@
+import { default as React } from 'react';
+import { CartReviewItemProps } from '../CartReviewItem';
+import { ServiceOfferCardProps } from '../ServiceOfferCard';
+import { BookingSummaryBannerProps } from '../BookingSummaryBanner';
+import { BillDetailsProps } from '../BillDetails';
+import { FAQSectionProps } from '../FAQSection';
+/** One row in the booking summary list — every `CartReviewItem` prop is available, plus a stable `id` for the React key. */
+export interface CartViewItem extends Omit<CartReviewItemProps, 'id'> {
+    id: string | number;
+}
+/** One upsell card in the "add services" list — every `ServiceOfferCard` prop is available, plus a stable `id` for the React key. */
+export interface CartViewUpsell extends Omit<ServiceOfferCardProps, 'id'> {
+    id: string | number;
+}
+export interface CartViewProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Header title, e.g. "Review your booking". Set to `null`/omit `onBack` and this to hide the header entirely. */
+    headerTitle?: React.ReactNode;
+    onBack?: () => void;
+    backButtonAriaLabel?: string;
+    headerClassName?: string;
+    backButtonClassName?: string;
+    headerTitleClassName?: string;
+    /** Pink "Pitru Paksha Special Rituals" style banner. Omit to hide it. All `BookingSummaryBanner` props are available. */
+    summary?: BookingSummaryBannerProps;
+    /** Read-only booking line items (Performers-Karta, rituals, fees, ...). Omit/empty to hide the section. */
+    items?: CartViewItem[];
+    itemsClassName?: string;
+    /** className applied to every item; per-item `className` (via the item object) wins/merges on top. */
+    itemClassName?: string;
+    /** "Add services for all ancestors" section heading. Omit to hide the heading (upsells can still render). */
+    upsellsTitle?: React.ReactNode;
+    upsellsDescription?: React.ReactNode;
+    /** Upsell `ServiceOfferCard`s (tarpan, cow service, public service, ...). Omit/empty to hide the section. */
+    upsells?: CartViewUpsell[];
+    upsellsSectionClassName?: string;
+    upsellsHeaderClassName?: string;
+    upsellsTitleClassName?: string;
+    upsellsDescriptionClassName?: string;
+    upsellsClassName?: string;
+    /** className applied to every upsell card; per-card `className` (via the upsell object) wins/merges on top. */
+    upsellClassName?: string;
+    /** Price breakdown. Omit to hide it. All `BillDetails` props are available. */
+    billDetails?: BillDetailsProps;
+    /** FAQ accordion. Omit to hide it. All `FAQSection` props are available. */
+    faq?: FAQSectionProps;
+}
+/**
+ * Complete "review your booking" cart page, composed entirely from existing
+ * building blocks (`BookingSummaryBanner`, `CartReviewItem`, `ServiceOfferCard`,
+ * `BillDetails`, `FAQSection`). Every underlying component's props are
+ * forwarded through dedicated slots (`summary`, `items`, `upsells`,
+ * `billDetails`, `faq`) so nothing needs to be re-declared here — pass
+ * whatever those components accept and it flows straight through.
+ *
+ * @example
+ * <CartView
+ *   onBack={() => history.back()}
+ *   summary={{ title: 'Pitru Paksha Special Rituals', subtitleItems: ['4 Ancestors', '2 Rituals', '2 Performers'] }}
+ *   items={[{ id: 'karta', title: 'Performers-Karta (2)', description: 'On behalf of two family members', price: '₹400', action: <CartReviewChangeButton /> }]}
+ *   upsells={[{ id: 'tarpan', image: photo, title: 'Offer tarpan donation...', price: '₹199', originalPrice: '₹250', action: <QuantityStepper value={2} onIncrement={inc} onDecrement={dec} /> }]}
+ *   billDetails={{ rows: [{ id: 'kartas', label: '2-Kartas Fee', value: '₹400.0/-' }], totalValue: '₹1648.0/-' }}
+ *   faq={{ items: faqItems }}
+ * />
+ */
+export declare const CartView: React.FC<CartViewProps>;

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

@@ -0,0 +1,2 @@
+export { CartView } from './CartView';
+export type { CartViewProps, CartViewItem, CartViewUpsell } from './CartView';

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

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+import { ButtonProps } from '../Button';
+export interface CheckoutBarProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Final amount, e.g. "₹1451.0/-". */
+    amount: React.ReactNode;
+    amountClassName?: string;
+    /** Muted line under the amount, e.g. "2 Rituals". */
+    subtitle?: React.ReactNode;
+    subtitleClassName?: string;
+    /** Info icon shown next to the amount — click to reveal a bill breakdown, etc. Pass `null` to hide it, or `onInfoClick` to make it interactive. */
+    showInfoIcon?: boolean;
+    onInfoClick?: () => void;
+    infoIconClassName?: string;
+    /** CTA label, e.g. "Proceed". */
+    proceedLabel?: React.ReactNode;
+    /** Trailing icon on the CTA. Defaults to an arrow. Pass `null` to hide it. */
+    proceedIcon?: React.ReactNode;
+    onProceed?: () => void;
+    /** Extra props forwarded to the underlying `Button` (variant, size, disabled, loading, ...). */
+    proceedButtonProps?: Omit<ButtonProps, 'children' | 'onClick'>;
+    buttonWrapperClassName?: string;
+}
+/**
+ * Sticky-friendly checkout bar shown at the bottom of a package-selection or
+ * cart screen: the final amount (with an optional info icon) + a short
+ * subtitle like "2 Rituals" on the left, and a "Proceed →" CTA on the right.
+ * Wrap this in your own `sticky bottom-0` container to pin it — this
+ * component itself stays layout-agnostic so it can be reused inline too.
+ *
+ * @example
+ * <CheckoutBar amount="₹1451.0/-" subtitle="2 Rituals" onProceed={() => nav.push('/checkout')} />
+ */
+export declare const CheckoutBar: React.FC<CheckoutBarProps>;

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

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

package/dist/components/DatePickerSheet/DatePickerSheet.d.ts

@@ -0,0 +1,22 @@
+export interface PickedDate {
+    day: number;
+    /** 1-12 */
+    month: number;
+    year: number;
+}
+export interface DatePickerSheetProps {
+    isOpen: boolean;
+    onClose: () => void;
+    avatarUrl: string;
+    heading: string;
+    /** 12 translated month names, January first. */
+    monthLabels: string[];
+    confirmLabel: string;
+    onConfirm: (date: PickedDate) => void;
+    /** Shown next to the CTA, e.g. "Timezone: IST". Omit to hide. */
+    timezoneLabel?: string;
+    initialDate?: PickedDate;
+    minYear?: number;
+    maxYear?: number;
+}
+export declare function DatePickerSheet({ isOpen, onClose, avatarUrl, heading, monthLabels, confirmLabel, onConfirm, timezoneLabel, initialDate, minYear, maxYear, }: DatePickerSheetProps): import("react").JSX.Element;

package/dist/components/DatePickerSheet/WheelColumn.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface WheelColumnProps {
+    options: string[];
+    selectedIndex: number;
+    onChange: (index: number) => void;
+}
+export declare function WheelColumn({ options, selectedIndex, onChange }: WheelColumnProps): React.JSX.Element;

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

@@ -0,0 +1,2 @@
+export { DatePickerSheet } from './DatePickerSheet';
+export type { DatePickerSheetProps, PickedDate } from './DatePickerSheet';

package/dist/components/IconBadge/IconBadge.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export interface IconBadgeProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Icon (or any node) rendered centered inside the badge. Ignored when avatarUrl is set. */
+    icon?: React.ReactNode;
+    /** Photo/illustration to render instead of an icon, e.g. a family member avatar. */
+    avatarUrl?: string;
+    alt?: string;
+    /** Badge diameter. Defaults to 'md'. */
+    size?: 'sm' | 'md' | 'lg';
+}
+/**
+ * Round badge used as the leading visual on selector rows/cards: either a
+ * tinted circle holding an icon, or a photo/illustration avatar.
+ */
+export declare const IconBadge: React.ForwardRefExoticComponent<IconBadgeProps & React.RefAttributes<HTMLDivElement>>;

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

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

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

@@ -0,0 +1,73 @@
+import { default as React } from 'react';
+import { SelectorCardProps, SelectorCardNoteProps, SelectorCardPriceBadgeProps } from '../SelectorCard';
+import { TrustBadgesBarProps } from '../TrustBadgesBar';
+import { CheckoutBarProps } from '../CheckoutBar';
+export interface PackageSelectOption extends Omit<SelectorCardProps, 'id' | 'selected' | 'onSelect' | 'badge' | 'children'> {
+    /** Unique id for this option, passed back via `onChange`. */
+    id: string | number;
+    /** Price label, e.g. "+₹400" or "₹0". Ignored when `badge` is set directly. */
+    price?: React.ReactNode;
+    /**
+     * Renders `price` as muted plain text (e.g. "₹0") instead of the green
+     * pill badge — use this for the included/base option that costs nothing
+     * extra.
+     */
+    free?: boolean;
+    /** Full override for the trailing badge slot — takes precedence over `price`/`free`/`priceBadgeProps`. */
+    badge?: React.ReactNode;
+    /** Extra props forwarded to the price badge (`SelectorCardPriceBadge`, or the plain muted `<span>` when `free`). */
+    priceBadgeProps?: Omit<SelectorCardPriceBadgeProps, 'value'>;
+    /** Highlighted strip rendered under this option only while it's selected, e.g. "Rituals will be performed on behalf of 2 family members". Ignored when `children` is set directly. */
+    note?: React.ReactNode;
+    /** Extra props forwarded to the `SelectorCardNote` wrapping `note`. */
+    noteProps?: Omit<SelectorCardNoteProps, 'children'>;
+    /** Full override for the card's children slot — takes precedence over `note`/`noteProps`. */
+    children?: React.ReactNode;
+}
+export interface PackageSelectProps {
+    /** Screen/section heading, e.g. "Select the number of people performing the Puja (Karta)". */
+    title: React.ReactNode;
+    /** Helper copy shown under the heading. */
+    description?: React.ReactNode;
+    /** Checklist of what's included with this package, each rendered with a green checkmark. */
+    benefits?: React.ReactNode[];
+    /** The selectable package options, rendered as a `SelectorCard` radio group. */
+    options: PackageSelectOption[];
+    /** Currently selected option's `id`. */
+    value: PackageSelectOption['id'];
+    /** Called with the newly selected option's `id`. */
+    onChange: (id: PackageSelectOption['id']) => void;
+    /** Style of the selected indicator on each option. Defaults to `'dot'`; override per-option via the option's own `radioVariant`. */
+    radioVariant?: 'dot' | 'check';
+    /** Accessible label for the options radiogroup. Defaults to `title` when it's a plain string. */
+    radiogroupLabel?: string;
+    className?: string;
+    headerClassName?: string;
+    benefitsClassName?: string;
+    optionsClassName?: string;
+    /** Trust badges strip (money-back guarantee, no hidden cost, ...) shown above the checkout bar. All `TrustBadgesBarProps` are available. Omit to hide it. */
+    trustBadges?: TrustBadgesBarProps;
+    /** Bottom amount + Proceed CTA bar. All `CheckoutBarProps` are available (amount, subtitle, onProceed, proceedButtonProps, ...). Omit to hide the whole footer. */
+    checkout?: CheckoutBarProps;
+    /** Wraps `trustBadges` + `checkout` together. Set to `false` to render them inline instead of `sticky bottom-0`. Defaults to `true`. */
+    stickyFooter?: boolean;
+    footerClassName?: string;
+}
+/**
+ * Complete "choose a package" screen used across Pitru Paksha flows: a
+ * heading + description, an optional benefits checklist, a group of
+ * selectable `SelectorCard` options (with price badges and a reveal-on-select
+ * note), and an optional bottom footer (`TrustBadgesBar` + `CheckoutBar`)
+ * with the final amount and a "Proceed" CTA.
+ *
+ * Built entirely from `SelectorCard` + friends, so it's a drop-in composed
+ * screen you can import into any app that already depends on
+ * `pitru-paksh-common`, without having to hand-assemble the header/benefits/
+ * options/footer yourself each time. Every `SelectorCard` prop (icon, avatar,
+ * tag, disabled, showRadio, className, native button attributes, ...) is
+ * available directly on each `PackageSelectOption` and forwarded as-is, and
+ * `trustBadges`/`checkout` forward every `TrustBadgesBarProps`/
+ * `CheckoutBarProps` respectively, so nothing the underlying pieces support
+ * is locked away by this wrapper.
+ */
+export declare const PackageSelect: React.FC<PackageSelectProps>;

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

@@ -0,0 +1,2 @@
+export { PackageSelect } from './PackageSelect';
+export type { PackageSelectProps, PackageSelectOption } from './PackageSelect';

package/dist/components/PhoneNumberSheet/PhoneNumberSheet.d.ts

@@ -0,0 +1,16 @@
+import { Country } from '../../../../common/dist/common.js';
+export interface PhoneNumberSheetProps {
+    isOpen: boolean;
+    onClose: () => void;
+    heading: string;
+    subtext?: string;
+    confirmLabel: string;
+    onConfirm: (phoneNumber: string, country: Country) => void;
+    /** Pre-fills the field, e.g. with a value already saved elsewhere. */
+    initialValue?: string;
+    /** Defaults to `DEFAULT_COUNTRIES`. */
+    countries?: Country[];
+    /** ISO alpha-2 of the pre-selected country. Defaults to India. */
+    initialCountryIso?: string;
+}
+export declare function PhoneNumberSheet({ isOpen, onClose, heading, subtext, confirmLabel, onConfirm, initialValue, countries, initialCountryIso, }: PhoneNumberSheetProps): import("react").JSX.Element;

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

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

package/dist/components/QuantityStepper/QuantityStepper.d.ts

@@ -0,0 +1,23 @@
+import { default as React } from 'react';
+export interface QuantityStepperProps {
+    /** Current quantity. */
+    value: number;
+    /** Called when + is pressed (also fires from the zero-state "Add" button). */
+    onIncrement: () => void;
+    /** Called when - is pressed. Not called while at `min`. */
+    onDecrement: () => void;
+    /** Floor for the count; at/below this the control collapses to an "Add" button. Defaults to 0. */
+    min?: number;
+    /** Optional ceiling; disables + once reached. */
+    max?: number;
+    /** Label shown on the zero-state button. Defaults to "Add". */
+    addLabel?: React.ReactNode;
+    className?: string;
+}
+/**
+ * Add-to-cart quantity control: renders a filled "+ Add" button while
+ * `value <= min` (typically 0), and swaps to a "- value +" pill once a
+ * quantity has been picked. Used as the `action` for `ServiceOfferCard`,
+ * but generic enough for any add-with-quantity flow.
+ */
+export declare const QuantityStepper: React.FC<QuantityStepperProps>;

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

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

package/dist/components/SelectorCard/SelectorCard.d.ts

@@ -0,0 +1,85 @@
+import { default as React } from 'react';
+export interface SelectorCardProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onSelect' | 'title'> {
+    /** Whether this card is the chosen option within its selector group. */
+    selected?: boolean;
+    /** Called when the user picks this card (click, Enter or Space). */
+    onSelect?: () => void;
+    /** Leading icon, rendered inside a tinted circular badge. Ignored when avatarUrl is set. */
+    icon?: React.ReactNode;
+    /** Leading photo/illustration (e.g. a family member avatar) instead of an icon badge. */
+    avatarUrl?: string;
+    /** Size of the leading icon/avatar badge. Defaults to 'md'. */
+    iconSize?: 'sm' | 'md' | 'lg';
+    /** Extra classes for the icon/avatar badge, e.g. `iconClassName="size-10"` for a one-off 40x40 badge. Overrides `iconSize`. */
+    iconClassName?: string;
+    /** Main label. */
+    title: React.ReactNode;
+    /** Secondary helper text shown under the title (hidden once `children` is provided, unless you render both yourself via `description`). Wraps onto multiple lines. */
+    description?: React.ReactNode;
+    /** Trailing pill/value, e.g. a price delta like "+₹400". */
+    badge?: React.ReactNode;
+    /** Hide the radio indicator, e.g. for single, non-grouped confirmations. Defaults to visible. */
+    showRadio?: boolean;
+    /** Style of the selected indicator: a filled dot (default) or a filled circle with a checkmark. */
+    radioVariant?: 'dot' | 'check';
+    /** Extra classes for the filled selected indicator (dot or check circle), e.g. to change its color. */
+    radioClassName?: string;
+    /**
+     * Corner ribbon rendered above the top-left edge of the card, e.g.
+     * "Recommended" or "As per Scriptures". Accepts any React node — a plain
+     * string renders inside the default pill container, or pass your own
+     * element (e.g. an icon + label) for a fully custom ribbon. Use
+     * `tagClassName` to restyle the pill container (color, shape, etc.).
+     */
+    tag?: React.ReactNode;
+    /** Extra classes for the corner ribbon, e.g. to change its color/theme. */
+    tagClassName?: string;
+    /**
+     * Extra content rendered below the header row: an editable value, an info
+     * row, a highlighted note, or any custom node. Typically shown only while
+     * `selected` is true, but that's left to the caller so both "always
+     * visible" and "reveal on select" patterns are supported.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * A selectable option row/card used across Pitru Paksha flows: an icon or
+ * avatar, a title + optional description, an optional trailing badge, and a
+ * radio indicator. Supports an optional content area below the header for
+ * editable values, info rows or highlighted notes (see `SelectorCardEditableField`,
+ * `SelectorCardInfoRow` and `SelectorCardNote`), as well as an optional corner
+ * ribbon (`tag`) for "Recommended"/"As per Scriptures"-style callouts.
+ */
+export declare const SelectorCard: React.ForwardRefExoticComponent<SelectorCardProps & React.RefAttributes<HTMLButtonElement>>;
+export interface SelectorCardEditableFieldProps extends React.HTMLAttributes<HTMLDivElement> {
+    value: React.ReactNode;
+    onClick?: () => void;
+}
+/**
+ * Pencil-prefixed value row used below a `SelectorCard` to show/edit the
+ * chosen value, e.g. a picked date or tithi.
+ */
+export declare const SelectorCardEditableField: React.FC<SelectorCardEditableFieldProps>;
+export interface SelectorCardInfoRowProps extends React.HTMLAttributes<HTMLDivElement> {
+    value: React.ReactNode;
+    onInfoClick?: () => void;
+    infoLabel?: string;
+}
+/**
+ * Value row with a trailing info icon, e.g. showing which tithi rituals will
+ * default to, with an (i) affordance to explain why.
+ */
+export declare const SelectorCardInfoRow: React.FC<SelectorCardInfoRowProps>;
+export interface SelectorCardPriceBadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** Pre-formatted price delta, e.g. "+₹400" or "₹0". */
+    value: React.ReactNode;
+}
+/** Rounded price/value pill used as a `SelectorCard` `badge`, e.g. "+₹400". */
+export declare const SelectorCardPriceBadge: React.FC<SelectorCardPriceBadgeProps>;
+export interface SelectorCardNoteProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+/**
+ * Full-bleed highlighted banner rendered at the bottom of a selected
+ * `SelectorCard`, e.g. "Rituals will be performed on behalf of two family members".
+ */
+export declare const SelectorCardNote: React.FC<SelectorCardNoteProps>;

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

@@ -0,0 +1,2 @@
+export { SelectorCard, SelectorCardEditableField, SelectorCardInfoRow, SelectorCardNote, SelectorCardPriceBadge } from './SelectorCard';
+export type { SelectorCardProps, SelectorCardEditableFieldProps, SelectorCardInfoRowProps, SelectorCardNoteProps, SelectorCardPriceBadgeProps, } from './SelectorCard';

package/dist/components/ServiceOfferCard/ServiceOfferCard.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+export interface ServiceOfferCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Illustration/photo shown top-right, e.g. the ritual/service photo. */
+    image: string;
+    imageAlt?: string;
+    /** Service name, e.g. "Offer tarpan donation for the peace of your ancestors". */
+    title: React.ReactNode;
+    /** Helper copy under the title, typically ending in a "...and see"/"Read more" affordance you compose yourself. */
+    description?: React.ReactNode;
+    /** Current price, e.g. "₹199". */
+    price: React.ReactNode;
+    /** Original price shown struck-through before `price`, e.g. "₹250". */
+    originalPrice?: React.ReactNode;
+    /**
+     * Flush corner banner rendered above the content, e.g. "Contribute to cow
+     * service". Accepts any React node — pass an icon + label for a custom
+     * banner. Use `tagClassName` to change its color/theme.
+     */
+    tag?: React.ReactNode;
+    tagClassName?: string;
+    /**
+     * Control anchored over the bottom edge of the image — typically a
+     * `QuantityStepper`, but accepts any node so a plain CTA button works too.
+     */
+    action?: React.ReactNode;
+}
+/**
+ * Upsell/add-on card used on "review your booking" screens: an image with a
+ * floating quantity control, title + description, and a price (with
+ * optional struck-through original), plus an optional flush corner banner
+ * (`tag`) like "Contribute to cow service".
+ */
+export declare const ServiceOfferCard: React.FC<ServiceOfferCardProps>;

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

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

package/dist/components/TextField/TextField.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+export interface TextFieldProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'prefix'> {
+    label?: string;
+    value: string;
+    onChange: (value: string) => void;
+    /** Fixed, non-editable text shown before the value, e.g. "Late". */
+    prefix?: string;
+    /** Shows a live `value.length` counter below the field; appends `/maxLength` when that's set too. */
+    showCharCount?: boolean;
+    /** Overrides the char-count helper text, e.g. for an error message. */
+    supportingText?: string;
+    error?: boolean;
+    containerClassName?: string;
+    /** Overrides the bordered input box itself, e.g. to match a fixed height elsewhere in a design. */
+    wrapperClassName?: string;
+}
+export declare const TextField: React.ForwardRefExoticComponent<TextFieldProps & React.RefAttributes<HTMLInputElement>>;

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

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

package/dist/components/TithiPickerSheet/TithiPickerSheet.d.ts

@@ -0,0 +1,12 @@
+export interface TithiPickerSheetProps {
+    isOpen: boolean;
+    onClose: () => void;
+    avatarUrl: string;
+    heading: string;
+    tithis: string[];
+    confirmLabel: string;
+    onConfirm: (tithi: string) => void;
+    /** Pre-selects a tithi when the sheet opens, e.g. to edit a previous choice. */
+    initialTithi?: string;
+}
+export declare function TithiPickerSheet({ isOpen, onClose, avatarUrl, heading, tithis, confirmLabel, onConfirm, initialTithi, }: TithiPickerSheetProps): import("react").JSX.Element;

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

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