@veevarts/design-system 0.1.22 → 0.1.23

package/dist/patterns/DonationAmounts/DonationAmounts.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { DonationAmountsProps } from './types';
+/**
+ * DonationAmounts component for selecting donation values
+ */
+export declare const DonationAmounts: React.FC<DonationAmountsProps>;
+export default DonationAmounts;

package/dist/patterns/DonationAmounts/DonationAmounts.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * DonationAmounts Component Tests
+ */
+export {};

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

@@ -0,0 +1,9 @@
+/**
+ * DonationAmounts Pattern
+ *
+ * A component for selecting donation amounts with preset options and custom input.
+ * Ensures exclusive selection (preset OR custom).
+ */
+export { DonationAmounts } from './DonationAmounts';
+export type { DonationAmount, SelectedDonation, DonationLabels, DonationAmountsProps, } from './types';
+export { formatCurrency, parseCurrency } from './utils/currency';

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

@@ -0,0 +1,145 @@
+/**
+ * DonationAmounts - Type Definitions
+ */
+/**
+ * Represents a preset donation amount option
+ */
+export interface DonationAmount {
+    /**
+     * Unique identifier for the amount
+     */
+    id: string;
+    /**
+     * The numerical value of the donation
+     */
+    amount: number;
+    /**
+     * Optional label to display instead of the amount
+     * If not provided, the formatted currency will be used
+     */
+    label?: string;
+}
+/**
+ * Selected donation value (can be preset or custom)
+ */
+export interface SelectedDonation {
+    /**
+     * The selected amount
+     */
+    amount: number;
+    /**
+     * Whether this is a custom amount
+     */
+    isCustom: boolean;
+    /**
+     * ID of the preset (if not custom)
+     */
+    presetId?: string;
+}
+/**
+ * Labels for internationalization
+ */
+export interface DonationLabels {
+    /**
+     * Title text (e.g., "Donation Amount")
+     */
+    title?: string;
+    /**
+     * Placeholder for custom amount input
+     */
+    customAmountPlaceholder?: string;
+    /**
+     * Aria label for custom amount input
+     */
+    customAmountAriaLabel?: string;
+}
+/**
+ * Props for DonationAmounts component
+ */
+export interface DonationAmountsProps {
+    /**
+     * Array of preset donation amounts to display as buttons
+     * @default [100, 250, 500, 1000, 2000]
+     */
+    presetAmounts?: DonationAmount[];
+    /**
+     * Currently selected donation (controlled mode)
+     */
+    selectedDonation?: SelectedDonation | null;
+    /**
+     * Default selected donation (uncontrolled mode)
+     */
+    defaultSelectedDonation?: SelectedDonation | null;
+    /**
+     * Callback fired when donation selection changes
+     */
+    onChange?: (donation: SelectedDonation | null) => void;
+    /**
+     * Currency code (ISO 4217)
+     * @default 'USD'
+     */
+    currency?: string;
+    /**
+     * Locale for currency formatting
+     * @default 'en-US'
+     */
+    locale?: string;
+    /**
+     * Whether to show the custom amount input
+     * @default true
+     */
+    showCustomAmount?: boolean;
+    /**
+     * Minimum allowed custom amount
+     * @default 0.5
+     */
+    minCustomAmount?: number;
+    /**
+     * Maximum allowed custom amount
+     * @default 1000000
+     */
+    maxCustomAmount?: number;
+    /**
+     * Labels for internationalization
+     */
+    labels?: DonationLabels;
+    /**
+     * Number of columns for preset buttons on mobile
+     * @default 2
+     */
+    mobileColumns?: 2 | 3;
+    /**
+     * Number of columns for preset buttons on desktop
+     * @default 3
+     */
+    desktopColumns?: 3 | 4 | 5 | 6;
+    /**
+     * Whether the component is disabled
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Button variant for preset amounts
+     * @default 'bordered'
+     */
+    buttonVariant?: 'solid' | 'bordered' | 'light' | 'flat' | 'faded' | 'shadow' | 'ghost';
+    /**
+     * Button color for preset amounts
+     * @default 'default'
+     */
+    buttonColor?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
+    /**
+     * Input variant for custom amount
+     * @default 'bordered'
+     */
+    inputVariant?: 'flat' | 'bordered' | 'faded' | 'underlined';
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+    /**
+     * Whether to show the component inside a Card
+     * @default true
+     */
+    showCard?: boolean;
+}

package/dist/patterns/DonationAmounts/utils/currency.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Currency formatting utilities
+ */
+/**
+ * Formats a number as currency
+ * @param amount - The amount to format
+ * @param locale - The locale to use for formatting (e.g., 'en-US', 'es-ES')
+ * @param currency - The currency code (ISO 4217, e.g., 'USD', 'EUR')
+ * @returns Formatted currency string
+ *
+ * @example
+ * formatCurrency(1000, 'en-US', 'USD') // "$1,000.00"
+ * formatCurrency(1000, 'es-ES', 'EUR') // "1.000,00 €"
+ */
+export declare function formatCurrency(amount: number, locale?: string, currency?: string): string;
+/**
+ * Parses a currency string to a number
+ * @param value - The currency string to parse
+ * @returns Parsed number or null if invalid
+ *
+ * @example
+ * parseCurrency('$1,000.00') // 1000
+ * parseCurrency('1.000,00 €') // 1000
+ */
+export declare function parseCurrency(value: string): number | null;

package/dist/patterns/index.d.ts

@@ -3,6 +3,8 @@ export { Stepper } from './Stepper';
 export { Footer } from './Footer';
 export type { RichTextAreaProps } from './RichText';
 export { RichTextArea, RICH_TEXT_PRESETS } from './RichText';
+export { DonationAmounts } from './DonationAmounts';
 export type { NavbarProps, NavbarLink, NavbarLanguage } from './Navbar';
 export type { StepperProps } from './Stepper';
 export type { FooterProps, FooterSection, FooterLink, SocialLink } from './Footer';
+export type { DonationAmountsProps, DonationAmount, SelectedDonation, DonationLabels } from './DonationAmounts';

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@veevarts/design-system",
     "private": false,
-    "version": "0.1.22",
+    "version": "0.1.23",
     "type": "module",
     "main": "dist/index.js",
     "module": "dist/index.js",
@@ -22,7 +22,12 @@
         "test:coverage": "vitest --coverage --run",
         "storybook": "storybook dev -p 6006",
         "build-storybook": "storybook build",
-        "deploy-storybook": "npm run build-storybook && npx vercel storybook-static --prod"
+        "deploy-storybook": "npm run build-storybook && npx vercel storybook-static --prod",
+        "prepublishOnly": "npm run test && npm run lint && npm run build",
+        "publish:patch": "npm version patch && npm publish && git push origin main --tags",
+        "publish:minor": "npm version minor && npm publish && git push origin main --tags",
+        "publish:major": "npm version major && npm publish && git push origin main --tags",
+        "publish:beta": "npm version prerelease --preid=beta && npm publish --tag beta && git push origin main --tags"
     },
     "peerDependencies": {
         "@heroui/react": ">=2.7.0",