@veevarts/design-system 1.12.7 → 1.13.0-alpha.1

package/dist/patterns/CashTenderForm/types.d.ts

@@ -60,6 +60,16 @@ export interface CashTenderFormProps {
      * Disable interactions (e.g. while submitting).
      */
     isDisabled?: boolean;
+    /**
+     * Hard upper bound for the received amount, in MAJOR units (same unit
+     * as `dueAmount.value`). A keystroke that would push the parsed value
+     * above this is REJECTED (the field keeps its prior value) — so a
+     * cashier can't enter a pathological amount that overflows the PSP
+     * integer range downstream. A character `maxLength` can't enforce this
+     * (e.g. `99999999` is only 8 chars yet far over a $999,999.99 cap), so
+     * the guard is value-based. Omit for no cap.
+     */
+    maxAmount?: number;
     /**
      * Auto-focus the Cash Received field when this component mounts.
      * Pair with `key={...}` from the host to re-trigger focus on every

package/dist/patterns/CatalogItemCard/CatalogItemCard.d.ts

@@ -0,0 +1,7 @@
+import { JSX } from 'react';
+import { CatalogItemCardProps } from './type';
+export declare const CatalogItemCard: {
+    ({ id, title, media, imageUrl, imageAlt, imageClassName, imageAspect, meta, price, action, footer, onPress, isPressable, isDisabled, compact, className, bodyClassName, footerClassName, dataTestId, }: CatalogItemCardProps): JSX.Element;
+    displayName: string;
+};
+export default CatalogItemCard;

package/dist/patterns/CatalogItemCard/index.d.ts

@@ -0,0 +1,2 @@
+export { default as CatalogItemCard } from './CatalogItemCard';
+export type * from './type';

package/dist/patterns/CatalogItemCard/type.d.ts

@@ -0,0 +1,82 @@
+import { ButtonProps } from '../../components';
+/**
+ * Metadata row displayed under the card title.
+ */
+export interface CatalogItemCardMetaItem {
+    /** Iconify icon name for the metadata row. */
+    icon: string;
+    /** Human-readable metadata value. */
+    label: string;
+}
+/**
+ * Optional price block shown in the card footer.
+ */
+export interface CatalogItemCardPrice {
+    /** Optional prefix before the value, typically `From` or `Starts at`. */
+    label: string;
+    /** Fully formatted amount to render. */
+    value: string;
+}
+/**
+ * Optional action shown in the card footer.
+ */
+export interface CatalogItemCardAction {
+    /** Action label for the button. */
+    label: string;
+    /** Iconify icon name. */
+    icon?: string;
+    /** Click handler for the action button. */
+    onPress?: () => void;
+    /** HeroUI button variant. */
+    variant?: ButtonProps['variant'];
+    /** HeroUI button color. */
+    color?: ButtonProps['color'];
+    /** HeroUI button size. */
+    size?: ButtonProps['size'];
+    /** Additional classes for action button. */
+    className?: string;
+    /** Disabled state for action button. */
+    isDisabled?: boolean;
+    /** Optional aria label override for action button. */
+    ariaLabel?: string;
+}
+export interface CatalogItemCardProps {
+    /** Optional card identifier used for data-testid and DOM debugging. */
+    id?: string;
+    /** Card title. */
+    title: string;
+    /** Optional custom media node. If not provided, `imageUrl` is used. */
+    media?: React.ReactNode;
+    /** Optional image URL used when `media` is not set. */
+    imageUrl?: string;
+    /** Optional image alt text used when `media` is not set. */
+    imageAlt?: string;
+    /** Optional className for the image wrapper. */
+    imageClassName?: string;
+    /** Optional aspect ratio class for media wrapper. */
+    imageAspect?: string;
+    /** Optional list of metadata rows. */
+    meta?: CatalogItemCardMetaItem[];
+    /** Optional price block. */
+    price?: CatalogItemCardPrice;
+    /** Optional root action button. */
+    action?: CatalogItemCardAction;
+    /** Optional custom footer content. If provided, `price` and `action` still render above it. */
+    footer?: React.ReactNode;
+    /** Set a press handler on the card root. */
+    onPress?: () => void;
+    /** Enables pressable visual behavior when combined with `onPress`. */
+    isPressable?: boolean;
+    /** Disable all card interactions. */
+    isDisabled?: boolean;
+    /** Compact layout mode. */
+    compact?: boolean;
+    /** Root className for the component. */
+    className?: string;
+    /** Root className for card body. */
+    bodyClassName?: string;
+    /** Footer container className. */
+    footerClassName?: string;
+    /** Optional root test id for QA. */
+    dataTestId?: string;
+}

package/dist/patterns/CheckTenderForm/types.d.ts

@@ -37,6 +37,16 @@ export interface CheckTenderFormProps {
     /** Hide the bank name field when the host doesn't care. */
     hideBankName?: boolean;
     isDisabled?: boolean;
+    /**
+     * Character cap for the Check Number field. Guards against pathological
+     * paste / extreme input. Default `34` (the length of the longest IBAN,
+     * a generous ceiling for any cheque / international reference).
+     */
+    checkNumberMaxLength?: number;
+    /**
+     * Character cap for the Bank Name field. Default `100`.
+     */
+    bankNameMaxLength?: number;
     /**
      * Auto-focus the Check Number field when this component mounts.
      * Pair with `key={...}` from the host to re-trigger focus on every

package/dist/patterns/CommitmentDetails/CommitmentDetails.d.ts

@@ -0,0 +1,16 @@
+import { JSX } from 'react';
+export type CommitmentDetailsLabels = {
+    totalAmount?: string;
+    remainingBalance?: string;
+    amountReceived?: string;
+};
+export type CommitmentDetailsProps = {
+    totalAmount: number;
+    remainingBalance: number;
+    amountReceived: number;
+    currency?: string;
+    locale?: string;
+    labels?: CommitmentDetailsLabels;
+    className?: string;
+};
+export declare function CommitmentDetails({ totalAmount, remainingBalance, amountReceived, currency, locale, labels: customLabels, className, }: CommitmentDetailsProps): JSX.Element;

package/dist/patterns/CommitmentDetails/index.d.ts

@@ -0,0 +1,2 @@
+export { CommitmentDetails } from './CommitmentDetails';
+export type { CommitmentDetailsLabels, CommitmentDetailsProps } from './CommitmentDetails';

package/dist/patterns/ConfirmationModal/ConfirmationModal.d.ts

@@ -0,0 +1,22 @@
+import { JSX, ReactNode } from 'react';
+import { ModalProps } from '../../components';
+export type ConfirmationModalLabels = {
+    title: string;
+    description: ReactNode;
+    cancel: string;
+    confirm: string;
+};
+export type ConfirmationModalProps = {
+    isOpen: boolean;
+    labels: ConfirmationModalLabels;
+    icon?: ReactNode;
+    isConfirming?: boolean;
+    confirmColor?: 'primary' | 'danger';
+    iconTone?: 'danger' | 'warning';
+    portalContainer?: Element;
+    shouldBlockScroll?: boolean;
+    classNames?: ModalProps['classNames'];
+    onClose: () => void;
+    onConfirm: () => void;
+};
+export declare function ConfirmationModal({ isOpen, labels, icon, isConfirming, confirmColor, iconTone, portalContainer, shouldBlockScroll, classNames, onClose, onConfirm, }: ConfirmationModalProps): JSX.Element;

package/dist/patterns/ConfirmationModal/index.d.ts

@@ -0,0 +1,2 @@
+export { ConfirmationModal } from './ConfirmationModal';
+export type { ConfirmationModalLabels, ConfirmationModalProps } from './ConfirmationModal';

package/dist/patterns/EventDetails/EventDetails.d.ts

@@ -18,6 +18,8 @@ export interface EventDetailsProps {
     description?: string;
     /** @property {string} [classes] - Optional Tailwind CSS utility classes for custom styling. */
     classes?: string;
+    /** @property {boolean} [compact] - Dense spacing mode for compact side layouts. */
+    compact?: boolean;
     /** @property {boolean} [showImage] - Optional flag to show or hide the event image. Defaults to true. */
     showImage?: boolean;
     /** @property {'lazy' | 'eager'} [imageLoading] - Optional loading strategy for the event image. Use `'lazy'` for off-screen placements (long lists, below-the-fold). Defaults to `'eager'` since the banner is typically above-the-fold. */
@@ -35,5 +37,5 @@ export interface EventDetailsProps {
  * @function EventDetails
  * @description Displays a card with event information such as name, image, date, time, location, and description.
  */
-export declare const EventDetails: ({ classes, name, imageUrl, eventDate, eventTime, location, description, showImage, imageLoading, showMoreButtonClassName, labels, }: EventDetailsProps) => JSX.Element;
+export declare const EventDetails: ({ classes, name, imageUrl, eventDate, eventTime, location, description, showImage, compact, imageLoading, showMoreButtonClassName, labels, }: EventDetailsProps) => JSX.Element;
 export default EventDetails;

package/dist/patterns/FeedbackState/FeedbackState.d.ts

@@ -0,0 +1,23 @@
+import { JSX } from 'react';
+import { EmptyStateProps, ErrorStateProps, FeedbackStateProps, LoadingStateProps, SuccessStateProps } from './type';
+export declare function FeedbackState({ variant, title, titleAs: TitleElement, description, icon, actions, role, ariaLive, iconSize, className, classNames, 'data-testid': dataTestId, }: FeedbackStateProps): JSX.Element;
+export declare namespace FeedbackState {
+    var displayName: string;
+}
+export declare function EmptyState(props: EmptyStateProps): JSX.Element;
+export declare namespace EmptyState {
+    var displayName: string;
+}
+export declare function ErrorState(props: ErrorStateProps): JSX.Element;
+export declare namespace ErrorState {
+    var displayName: string;
+}
+export declare function LoadingState(props: LoadingStateProps): JSX.Element;
+export declare namespace LoadingState {
+    var displayName: string;
+}
+export declare function SuccessState(props: SuccessStateProps): JSX.Element;
+export declare namespace SuccessState {
+    var displayName: string;
+}
+export default FeedbackState;

package/dist/patterns/FeedbackState/index.d.ts

@@ -0,0 +1,2 @@
+export { FeedbackState, EmptyState, ErrorState, LoadingState, SuccessState } from './FeedbackState';
+export type * from './type';

package/dist/patterns/FeedbackState/type.d.ts

@@ -0,0 +1,40 @@
+import { AriaRole, ReactNode } from 'react';
+export type FeedbackStateVariant = 'empty' | 'error' | 'success' | 'loading';
+export interface FeedbackStateClassNames {
+    base?: string;
+    iconWrapper?: string;
+    icon?: string;
+    spinner?: string;
+    title?: string;
+    description?: string;
+    actions?: string;
+}
+export interface FeedbackStateProps {
+    /** Visual tone and default accessibility role. */
+    variant?: FeedbackStateVariant;
+    /** Main state message. */
+    title: ReactNode;
+    /** Semantic element used for the title. Defaults to a paragraph for inline states. */
+    titleAs?: 'p' | 'h1' | 'h2' | 'h3' | 'h4' | 'div';
+    /** Supporting copy rendered under the title. */
+    description?: ReactNode;
+    /** Iconify name, custom React node, or false to hide the icon. Loading defaults to a spinner. */
+    icon?: string | ReactNode | false;
+    /** Optional CTA area; pass buttons, links, or any custom action group. */
+    actions?: ReactNode;
+    /** Overrides the default role: error => alert, otherwise status. */
+    role?: AriaRole;
+    /** Overrides the default live-region politeness. */
+    ariaLive?: 'off' | 'polite' | 'assertive';
+    /** Icon size in pixels when icon is an Iconify name. */
+    iconSize?: number;
+    /** Root className shortcut. */
+    className?: string;
+    /** Slot-level className overrides. */
+    classNames?: FeedbackStateClassNames;
+    'data-testid'?: string;
+}
+export type EmptyStateProps = Omit<FeedbackStateProps, 'variant'>;
+export type ErrorStateProps = Omit<FeedbackStateProps, 'variant'>;
+export type LoadingStateProps = Omit<FeedbackStateProps, 'variant'>;
+export type SuccessStateProps = Omit<FeedbackStateProps, 'variant'>;

package/dist/patterns/FilterPopover/FilterPopover.d.ts

@@ -0,0 +1,6 @@
+import { FilterPopoverProps } from './type';
+export declare const FilterPopover: {
+    ({ triggerLabel, triggerAriaLabel, triggerIcon, triggerVariant, triggerColor, triggerSize, triggerClassName, popoverClassName, className, sections, onConfirm, onClear, appliedCount, countAriaLabel, countDisplay, confirmLabel, clearLabel, isOpen, defaultOpen, onOpenChange, isDisabled, closeOnConfirm, keepOpenAfterClear, }: FilterPopoverProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export default FilterPopover;

package/dist/patterns/FilterPopover/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FilterPopover } from './FilterPopover';
+export type * from './type';

package/dist/patterns/FilterPopover/type.d.ts

@@ -0,0 +1,85 @@
+import { ButtonProps } from '../../components';
+export interface FilterOption {
+    /** Option value used in payload. */
+    value: string;
+    /** Label for the option. */
+    label: string;
+    /** Option disabled state. */
+    isDisabled?: boolean;
+}
+export interface FilterSectionBase {
+    /** Unique identifier for this filter section. */
+    id: string;
+    /** Section label above its options. */
+    label: string;
+}
+export interface CheckboxFilterSection extends FilterSectionBase {
+    /** Render options as multi-select checkboxes. */
+    type: 'checkbox';
+    /** Currently selected values for this section. */
+    selectedValues: readonly string[];
+    /** Checkbox section options. */
+    options: readonly FilterOption[];
+}
+export interface RadioFilterSection extends FilterSectionBase {
+    /** Render options as mutually exclusive radio buttons. */
+    type: 'radio';
+    /** Currently selected value; empty when no option selected. */
+    selectedValue: string | null;
+    /** Radio section options. */
+    options: readonly FilterOption[];
+}
+export type FilterSection = CheckboxFilterSection | RadioFilterSection;
+export type AppliedFilterValues = Record<string, string | string[] | null>;
+export type DraftFilterValues = Record<string, string[]>;
+export interface FilterPopoverProps {
+    /** Label for popover trigger button. */
+    triggerLabel: string;
+    /** Optional accessible label for the popover trigger. */
+    triggerAriaLabel?: string;
+    /** Optional icon for trigger button. */
+    triggerIcon?: string;
+    /** Text for confirmation button. */
+    confirmLabel?: string;
+    /** Text for clear button. */
+    clearLabel?: string;
+    /** Count badge accessibility label. */
+    countAriaLabel?: (count: number) => string;
+    /**
+     * How to render the applied filter count on the trigger.
+     * Defaults to compact badge rendering for buyer-flow toolbar usage.
+     */
+    countDisplay?: 'summary' | 'badge';
+    /** Applied sections to initialize draft state. */
+    sections: readonly FilterSection[];
+    /** Called with normalized values when user clicks Confirm. */
+    onConfirm: (values: AppliedFilterValues) => void | Promise<void>;
+    /** Clears all filters. */
+    onClear: () => void | Promise<void>;
+    /** Optional external count override. */
+    appliedCount?: number;
+    /** Control popover open state. */
+    isOpen?: boolean;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean;
+    /** Controlled open-state change handler. */
+    onOpenChange?: (isOpen: boolean) => void;
+    /** Trigger variant. */
+    triggerVariant?: ButtonProps['variant'];
+    /** Trigger color. */
+    triggerColor?: ButtonProps['color'];
+    /** Trigger size. */
+    triggerSize?: ButtonProps['size'];
+    /** Trigger button className. */
+    triggerClassName?: string;
+    /** Popover content className. */
+    popoverClassName?: string;
+    /** Container className. */
+    className?: string;
+    /** Disable entire control. */
+    isDisabled?: boolean;
+    /** Close popover when confirm is clicked. */
+    closeOnConfirm?: boolean;
+    /** Keep popover open after clearing. */
+    keepOpenAfterClear?: boolean;
+}

package/dist/patterns/InstallmentFundAssignment/InstallmentFundAssignment.d.ts

@@ -0,0 +1,3 @@
+import { JSX } from 'react';
+import { InstallmentFundAssignmentProps } from './types';
+export declare function InstallmentFundAssignment({ assignments, funds, labels: customLabels, classNames, isSaving, hasSavedAssignments, isFundPickerOpen, activeAssignmentId, footer, onAssignmentsChange, onOpenFundPicker, onCloseFundPicker, onCollapseChange, onSave, }: InstallmentFundAssignmentProps): JSX.Element;

package/dist/patterns/InstallmentFundAssignment/InstallmentFundAssignmentSkeleton.d.ts

@@ -0,0 +1,2 @@
+import { JSX } from 'react';
+export declare function InstallmentFundAssignmentSkeleton(): JSX.Element;

package/dist/patterns/InstallmentFundAssignment/index.d.ts

@@ -0,0 +1,3 @@
+export { InstallmentFundAssignment } from './InstallmentFundAssignment';
+export { InstallmentFundAssignmentSkeleton } from './InstallmentFundAssignmentSkeleton';
+export type { InstallmentFundAssignmentClassNames, InstallmentFundAssignmentLabels, InstallmentFundAssignmentMode, InstallmentFundAssignmentProps, InstallmentFund, InstallmentFundAssignmentEntry, } from './types';

package/dist/patterns/InstallmentFundAssignment/types.d.ts

@@ -0,0 +1,67 @@
+import { ReactNode } from 'react';
+export type InstallmentFundAssignmentMode = 'single' | 'split';
+export type InstallmentFund = {
+    id: string;
+    glCode: string;
+    accountName: string;
+    type: string;
+};
+export type InstallmentFundAssignmentEntry = {
+    id: string;
+    fund: InstallmentFund | null;
+    percentage: number;
+    sortOrder?: number;
+};
+export type InstallmentFundAssignmentLabels = {
+    title?: string;
+    singleFund?: string;
+    splitFunds?: string;
+    saveAssignment?: string;
+    assignSpecificFund?: string;
+    addFund?: string;
+    emptySingle?: string;
+    emptySplit?: string;
+    selectedFund?: string;
+    percentage?: string;
+    total?: string;
+    totalError?: string;
+    removeFund?: string;
+    modalTitle?: string;
+    searchPlaceholder?: string;
+    glCode?: string;
+    accountName?: string;
+    type?: string;
+    actions?: string;
+    select?: string;
+    noFunds?: string;
+    modifyAssignedFundsTitle?: string;
+    modifyAssignedFundsDescription?: string;
+    modifyAssignedFundsWarning?: string;
+    modifyAssignedFundsCancel?: string;
+    modifyAssignedFundsConfirm?: string;
+};
+export type InstallmentFundAssignmentClassNames = {
+    root?: string;
+    panel?: string;
+    header?: string;
+    tabs?: string;
+    content?: string;
+};
+export type InstallmentFundAssignmentProps = {
+    mode?: InstallmentFundAssignmentMode;
+    assignments: InstallmentFundAssignmentEntry[];
+    funds: InstallmentFund[];
+    labels?: InstallmentFundAssignmentLabels;
+    classNames?: InstallmentFundAssignmentClassNames;
+    isSaving?: boolean;
+    hasSavedAssignments?: boolean;
+    isFundPickerOpen?: boolean;
+    activeAssignmentId?: string | null;
+    footer?: ReactNode;
+    onModeChange?: (mode: InstallmentFundAssignmentMode) => void;
+    onAssignmentsChange: (assignments: InstallmentFundAssignmentEntry[]) => void;
+    onOpenFundPicker: (assignmentId?: string) => void;
+    onCloseFundPicker: () => void;
+    onCollapseChange?: (isCollapsed: boolean) => void;
+    onSave: () => void;
+};

package/dist/patterns/InstallmentFundAssignment/utils.d.ts

@@ -0,0 +1,12 @@
+import { InstallmentFundAssignmentEntry, InstallmentFundAssignmentMode } from './types';
+export declare const createEmptyAssignment: () => InstallmentFundAssignmentEntry;
+export declare function getAssignmentsForModeChange({ nextMode, assignments, previousSingleAssignments, previousSplitAssignments, }: {
+    nextMode: InstallmentFundAssignmentMode;
+    assignments: InstallmentFundAssignmentEntry[];
+    previousSingleAssignments: InstallmentFundAssignmentEntry[];
+    previousSplitAssignments: InstallmentFundAssignmentEntry[];
+}): InstallmentFundAssignmentEntry[];
+export declare function isAssignmentSaveValid({ mode, assignments, }: {
+    mode: InstallmentFundAssignmentMode;
+    assignments: InstallmentFundAssignmentEntry[];
+}): boolean;

package/dist/patterns/InstallmentSchedule/InstallmentSchedule.d.ts

@@ -0,0 +1,3 @@
+import { JSX } from 'react';
+import { InstallmentScheduleProps } from './types';
+export declare function InstallmentSchedule({ mode, donationAmount, currency, locale, installments, automaticSettings, labels: customLabels, classNames, isSaving, isModeSwitchDisabled, onModeChange, onAutomaticSettingsChange, onInstallmentsChange, onSave, }: InstallmentScheduleProps): JSX.Element;

package/dist/patterns/InstallmentSchedule/InstallmentScheduleSkeleton.d.ts

@@ -0,0 +1,2 @@
+import { JSX } from 'react';
+export declare function InstallmentScheduleSkeleton(): JSX.Element;

package/dist/patterns/InstallmentSchedule/InstallmentTable.d.ts

@@ -0,0 +1,3 @@
+import { JSX } from 'react';
+import { InstallmentTableProps } from './types';
+export declare function InstallmentTable({ installments, currency, locale, labels: customLabels, isSaving, onEditInstallments, onPayInstallment, onDeleteInstallment, }: InstallmentTableProps): JSX.Element;

package/dist/patterns/InstallmentSchedule/index.d.ts

@@ -0,0 +1,5 @@
+export { InstallmentSchedule } from './InstallmentSchedule';
+export { InstallmentScheduleSkeleton } from './InstallmentScheduleSkeleton';
+export { InstallmentTable } from './InstallmentTable';
+export { generateAutomaticInstallments } from './utils';
+export type { AutomaticScheduleSettings, InstallmentFrequency, InstallmentTableLabels, InstallmentTableProps, InstallmentScheduleClassNames, InstallmentScheduleLabels, InstallmentScheduleMode, InstallmentScheduleProps, ScheduledInstallment, } from './types';

package/dist/patterns/InstallmentSchedule/types.d.ts

@@ -0,0 +1,100 @@
+import { ReactNode } from 'react';
+export type InstallmentScheduleMode = 'automatic' | 'manual';
+export type InstallmentFrequency = 'monthly' | 'quarterly' | 'annual';
+export type ScheduledInstallment = {
+    id: string;
+    dueDate: string;
+    amount: number;
+    status?: 'scheduled' | 'fulfilled' | 'failed' | 'cancelled' | 'refunded' | 'paid';
+};
+export type AutomaticScheduleSettings = {
+    numberOfInstallments: number;
+    frequency: InstallmentFrequency;
+    firstInstallmentDate: string;
+};
+export type InstallmentScheduleLabels = {
+    title?: string;
+    automaticMode?: string;
+    manualMode?: string;
+    createInstallments?: string;
+    generateSchedule?: string;
+    saveInstallments?: string;
+    addInstallment?: string;
+    emptyAutomatic?: string;
+    emptyManual?: string;
+    numberOfInstallments?: string;
+    frequency?: string;
+    firstInstallmentDate?: string;
+    installment?: string;
+    dueDate?: string;
+    amount?: string;
+    total?: string;
+    remaining?: string;
+    deleteInstallment?: string;
+    monthly?: string;
+    quarterly?: string;
+    annual?: string;
+    totalError?: string;
+    totalIncreaseWarning?: string;
+    totalIncreaseConfirmationTitle?: string;
+    totalIncreaseConfirmationDescription?: string;
+    totalIncreaseConfirmationCancel?: string;
+    totalIncreaseConfirmationConfirm?: string;
+    dateOrderError?: string;
+    amountGreaterThanZeroError?: string;
+};
+export type InstallmentScheduleClassNames = {
+    root?: string;
+    panel?: string;
+    header?: string;
+    tabs?: string;
+    content?: string;
+};
+export type InstallmentScheduleProps = {
+    mode: InstallmentScheduleMode;
+    donationAmount: number;
+    currency?: string;
+    locale?: string;
+    installments: ScheduledInstallment[];
+    automaticSettings: AutomaticScheduleSettings;
+    labels?: InstallmentScheduleLabels;
+    classNames?: InstallmentScheduleClassNames;
+    isSaving?: boolean;
+    isModeSwitchDisabled?: boolean;
+    onModeChange: (mode: InstallmentScheduleMode) => void;
+    onAutomaticSettingsChange: (settings: AutomaticScheduleSettings) => void;
+    onInstallmentsChange: (installments: ScheduledInstallment[]) => void;
+    onSave: () => void;
+};
+export type InstallmentTableLabels = {
+    title?: string;
+    searchLabel?: string;
+    searchPlaceholder?: string;
+    editInstallments?: string;
+    installmentId?: string;
+    amount?: string;
+    scheduledDate?: string;
+    status?: string;
+    actions?: string;
+    payNow?: string;
+    sendLink?: string;
+    sendLinkDescription?: string;
+    dangerZone?: string;
+    deleteInstallment?: string;
+    deleteInstallmentDescription?: string;
+    deleteInstallmentConfirmationTitle?: string;
+    deleteInstallmentConfirmationDescription?: ReactNode;
+    deleteInstallmentConfirmationCancel?: string;
+    deleteInstallmentConfirmationConfirm?: string;
+    noInstallmentsFound?: string;
+};
+export type InstallmentTableProps = {
+    installments: ScheduledInstallment[];
+    currency: string;
+    locale?: string;
+    labels?: InstallmentTableLabels;
+    isSaving?: boolean;
+    onEditInstallments: () => void;
+    onPayInstallment?: (installment: ScheduledInstallment) => void;
+    onDeleteInstallment: (installmentId: string) => void;
+};

package/dist/patterns/InstallmentSchedule/utils.d.ts

@@ -0,0 +1,3 @@
+import { AutomaticScheduleSettings, ScheduledInstallment } from './types';
+export declare function generateAutomaticInstallments(donationAmount: number, settings: AutomaticScheduleSettings): ScheduledInstallment[];
+export declare function getInvalidDateRowIds(installments: ScheduledInstallment[]): Set<string>;

package/dist/patterns/ItemCard/type.d.ts

@@ -3,12 +3,64 @@ export interface ItemCardProps {
      * Selection key. Pass as `itemKey` in JSX (React reserves `key` and does not forward it).
      */
     itemKey: string;
+    /**
+     * Display name
+     */
     name: string;
+    /**
+     * Raw price value
+     */
     price: number;
+    /**
+     * Whether to render the price column.
+     * Useful for buyer-flow selection cards where the value is represented by a status badge.
+     * @default true
+     */
+    showPrice?: boolean;
+    /**
+     * Locale for price formatting
+     */
     locale?: string;
+    /**
+     * Currency code
+     */
     currency?: string;
+    /**
+     * Optional type label
+     */
     type?: string;
+    /**
+     * Whether this item is selected
+     */
     isSelected?: boolean;
+    /**
+     * Compact rendering mode
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * Whether card actions are disabled
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Optional label describing disabled reason
+     */
+    disabledReason?: string;
+    /**
+     * Optional status label used in compact/badged states
+     */
+    statusLabel?: string;
+    /**
+     * Status tone for disabled state
+     */
+    statusTone?: 'default' | 'success' | 'warning' | 'danger';
+    /**
+     * Selection handler, turns card pressable
+     */
     onSelect?: (key: string) => void;
+    /**
+     * Optional custom class
+     */
     className?: string;
 }

package/dist/patterns/OfferCard/OfferCard.d.ts

@@ -6,7 +6,7 @@ import { OfferCardProps } from './types';
  * Supports slot-based customization for all rendered elements.
  */
 export declare const OfferCard: {
-    ({ offer, quantity: quantityProp, defaultQuantity, onQuantityChange, currency, locale, labels: customLabels, slots, isDisabled, buttonVariant, buttonColor, showCard, showDescription, showPeopleCount, showPrice, classNames, "data-testid": dataTestId, selectedColor, }: OfferCardProps): JSX.Element;
+    ({ offer, quantity: quantityProp, defaultQuantity, onQuantityChange, currency, locale, labels: customLabels, slots, isDisabled, buttonVariant, buttonColor, showCard, showDescription, showPeopleCount, showPrice, classNames, "data-testid": dataTestId, selectedColor, compact, isSoldOut: isSoldOutProp, isMaxReached: isMaxReachedProp, isRuleBlocked: isRuleBlockedProp, statusTone: statusToneProp, statusLabel, disabledReason, disabled, }: OfferCardProps): JSX.Element;
     displayName: string;
 };
 export default OfferCard;