@nice2dev/ui-money 1.0.10

package/dist/money.d.ts

@@ -0,0 +1,35 @@
+import { Money } from './types';
+
+/**
+ * Convert a major-unit decimal (e.g. `12.34`) to a `Money` object in minor units.
+ * Uses the currency's declared decimals to avoid float drift; rounds half-away-from-zero.
+ */
+export declare function toMoney(major: number, currency: string): Money;
+/** Inverse of {@link toMoney}. */
+export declare function fromMoney(m: Money): number;
+export declare function addMoney(a: Money, b: Money): Money;
+export declare function subtractMoney(a: Money, b: Money): Money;
+/** Multiply by a scalar (rounded half-away-from-zero). */
+export declare function multiplyMoney(a: Money, factor: number): Money;
+export declare function compareMoney(a: Money, b: Money): number;
+export declare function isZero(m: Money): boolean;
+export declare function isNegative(m: Money): boolean;
+export declare function negateMoney(m: Money): Money;
+/**
+ * Locale-aware Intl-based formatter. Falls back to `${symbol}${amount}` if Intl rejects.
+ */
+export declare function formatMoney(m: Money, opts?: {
+    locale?: string;
+    /** Override decimals (default = catalog decimals). */
+    decimals?: number;
+    /** Force symbol display vs ISO code. Default `'symbol'`. */
+    currencyDisplay?: 'symbol' | 'code' | 'name' | 'narrowSymbol';
+}): string;
+/**
+ * Parse a localized money string back into a `Money` object.
+ *
+ * Best-effort: strips currency symbols / whitespace / NBSP, treats the **last**
+ * `.` or `,` as the decimal separator, all earlier separators as thousands grouping.
+ * Returns `null` on irrecoverable input.
+ */
+export declare function parseMoney(input: string, currency: string): Money | null;

package/dist/processors.d.ts

@@ -0,0 +1,84 @@
+import { PaymentRequest, PaymentResponse } from './types';
+
+/**
+ * Provider-agnostic payment processor abstraction.
+ *
+ * Wrap any PSP (Stripe, PayPal, Adyen, Square, Mollie, BLIK / PayU, Przelewy24,
+ * Braintree, Razorpay, …) behind this interface. UI components depend only on the
+ * shape, not on any specific SDK. Real implementations call processor SDKs / REST APIs.
+ *
+ * The bundled adapters in this file are **scaffolds** — they describe the contract
+ * each integrator must satisfy and provide working in-memory `'mock'` mode so the UI
+ * can be exercised end-to-end without credentials.
+ */
+export interface PaymentProcessor {
+    /** Stable identifier (`stripe`, `paypal`, `adyen`, `square`, `mollie`, `payu`, …). */
+    readonly id: string;
+    /** Display name. */
+    readonly name: string;
+    /** Currencies the processor accepts (uppercase ISO 4217). `'*'` = all. */
+    readonly supportedCurrencies: string[] | '*';
+    /** Minimum charge in minor units, per currency. Use for client-side guard. */
+    readonly minimums?: Record<string, number>;
+    /**
+     * Authorize a payment. Returns an authorization id; capture in a follow-up call.
+     * Implementations MAY auto-capture if the processor's API does so by default.
+     */
+    authorize(req: PaymentRequest): Promise<PaymentResponse>;
+    /** Capture a previously authorized payment. */
+    capture(authorizationId: string, amount?: PaymentRequest['amount']): Promise<PaymentResponse>;
+    /** Cancel an unauthorized / authorized but uncaptured payment. */
+    cancel(paymentId: string): Promise<PaymentResponse>;
+    /** Refund a captured payment (full or partial). */
+    refund(paymentId: string, amount?: PaymentRequest['amount']): Promise<PaymentResponse>;
+}
+/**
+ * Mock processor — accepts everything, returns deterministic ids. Use in tests / demos.
+ */
+export declare class MockPaymentProcessor implements PaymentProcessor {
+    readonly id: string;
+    readonly name: string;
+    readonly supportedCurrencies: string[] | '*';
+    readonly minimums?: Record<string, number>;
+    private counter;
+    constructor(opts?: {
+        id?: string;
+        name?: string;
+        supportedCurrencies?: string[] | '*';
+    });
+    private newId;
+    authorize(req: PaymentRequest): Promise<PaymentResponse>;
+    capture(authorizationId: string, amount?: PaymentRequest['amount']): Promise<PaymentResponse>;
+    cancel(paymentId: string): Promise<PaymentResponse>;
+    refund(paymentId: string, amount?: PaymentRequest['amount']): Promise<PaymentResponse>;
+}
+export interface ProcessorExecutor {
+    authorize(req: PaymentRequest): Promise<PaymentResponse>;
+    capture(authorizationId: string, amount?: PaymentRequest['amount']): Promise<PaymentResponse>;
+    cancel(paymentId: string): Promise<PaymentResponse>;
+    refund(paymentId: string, amount?: PaymentRequest['amount']): Promise<PaymentResponse>;
+}
+/** Stripe (https://stripe.com). */
+export declare function makeStripeAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** PayPal (https://www.paypal.com). */
+export declare function makePayPalAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Adyen (https://www.adyen.com). */
+export declare function makeAdyenAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Square (https://squareup.com). */
+export declare function makeSquareAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Mollie (https://www.mollie.com) — strong EU coverage including iDEAL, Bancontact. */
+export declare function makeMollieAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Braintree (https://www.braintreepayments.com). */
+export declare function makeBraintreeAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Razorpay (https://razorpay.com) — India / South Asia. */
+export declare function makeRazorpayAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** PayU (https://corporate.payu.com) — covers BLIK / Przelewy24 / card in PL/CZ/RO/HU. */
+export declare function makePayUAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Przelewy24 (https://www.przelewy24.pl) — Polish bank-transfer aggregator + BLIK. */
+export declare function makePrzelewy24Adapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Klarna (https://www.klarna.com) — pay-later / instalments. */
+export declare function makeKlarnaAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Coinbase Commerce — crypto payments (BTC, ETH, USDC, …). */
+export declare function makeCoinbaseCommerceAdapter(executor?: Partial<ProcessorExecutor>): PaymentProcessor;
+/** Convenient registry of every bundled adapter (mock by default). */
+export declare const NICE_PAYMENT_PROCESSORS: Record<string, () => PaymentProcessor>;

package/dist/style.css

@@ -0,0 +1 @@
+.nice-money{font-variant-numeric:tabular-nums}.nice-money--negative .nice-money__value{color:var(--nice-color-danger, #dc2626)}.nice-money__converted{margin-left:.25em;opacity:.7;font-size:.875em}.nice-currency-selector{display:inline-flex;align-items:center;gap:.25rem}.nice-currency-selector__select{font:inherit;padding:.375rem .5rem;border:1px solid var(--nice-color-border, #d1d5db);border-radius:var(--nice-radius-sm, 4px);background:var(--nice-color-bg, #fff);color:inherit}.nice-currency-selector__search{font:inherit;padding:.25rem .5rem;border:1px solid var(--nice-color-border, #d1d5db);border-radius:var(--nice-radius-sm, 4px);width:8rem}.nice-currency-selector--compact .nice-currency-selector__search{display:none}.nice-money-input{display:flex;flex-direction:column;gap:.25rem}.nice-money-input__label{font-size:.875rem;font-weight:500}.nice-money-input__required{color:var(--nice-color-danger, #dc2626);margin-left:.125rem}.nice-money-input__row{display:flex;align-items:stretch;gap:.25rem;border:1px solid var(--nice-color-border, #d1d5db);border-radius:var(--nice-radius-md, 6px);background:var(--nice-color-bg, #fff);padding:.125rem}.nice-money-input--error .nice-money-input__row{border-color:var(--nice-color-danger, #dc2626)}.nice-money-input--disabled{opacity:.6;pointer-events:none}.nice-money-input__currency .nice-currency-selector__select{border:none;background:transparent;padding:.5rem}.nice-money-input__symbol{display:inline-flex;align-items:center;padding:0 .5rem;color:var(--nice-color-muted, #6b7280);font-weight:600}.nice-money-input__amount{flex:1;border:none;background:transparent;font:inherit;padding:.5rem;outline:none;font-variant-numeric:tabular-nums;text-align:right;min-width:0}.nice-money-input__step{border:none;background:var(--nice-color-bg-soft, #f3f4f6);border-radius:var(--nice-radius-sm, 4px);width:2rem;font-size:1.125rem;cursor:pointer}.nice-money-input__step:disabled{opacity:.4;cursor:not-allowed}.nice-money-input--sm .nice-money-input__amount{padding:.25rem;font-size:.875rem}.nice-money-input--lg .nice-money-input__amount{padding:.75rem;font-size:1.125rem}.nice-money-input__preview{font-size:.8125rem;color:var(--nice-color-muted, #6b7280)}.nice-money-input__error{font-size:.8125rem;color:var(--nice-color-danger, #dc2626)}.nice-money-input__helper{font-size:.8125rem;color:var(--nice-color-muted, #6b7280)}.nice-credit-card{display:flex;flex-direction:column;gap:.5rem}.nice-credit-card__row{display:flex;flex-direction:column;gap:.25rem}.nice-credit-card__row--split{flex-direction:row;gap:.5rem}.nice-credit-card__row--split .nice-credit-card__field{flex:1}.nice-credit-card__field{display:flex;flex-direction:column;gap:.125rem}.nice-credit-card__label{font-size:.8125rem;font-weight:500;color:var(--nice-color-muted, #4b5563)}.nice-credit-card__input-wrapper{position:relative;display:flex;align-items:center}.nice-credit-card__input{font:inherit;font-variant-numeric:tabular-nums;padding:.5rem .75rem;border:1px solid var(--nice-color-border, #d1d5db);border-radius:var(--nice-radius-md, 6px);background:var(--nice-color-bg, #fff);width:100%;outline:none}.nice-credit-card__input:focus{border-color:var(--nice-color-primary, #2563eb);box-shadow:0 0 0 2px var(--nice-color-primary-soft, #bfdbfe)}.nice-credit-card__input[aria-invalid=true]{border-color:var(--nice-color-danger, #dc2626)}.nice-credit-card__brand{position:absolute;right:.5rem;top:50%;transform:translateY(-50%);font-size:.75rem;font-weight:700;letter-spacing:.05em;padding:.125rem .375rem;border-radius:var(--nice-radius-sm, 4px);background:var(--nice-color-bg-soft, #f3f4f6);color:var(--nice-color-muted, #4b5563);pointer-events:none}.nice-credit-card__brand--visa{background:#1a1f71;color:#fff}.nice-credit-card__brand--mastercard{background:#eb001b;color:#fff}.nice-credit-card__brand--amex{background:#2e77bb;color:#fff}.nice-credit-card__brand--discover{background:#ff6000;color:#fff}.nice-credit-card__error{font-size:.75rem;color:var(--nice-color-danger, #dc2626)}.nice-payment-form{display:flex;flex-direction:column;gap:.75rem;max-width:28rem}.nice-payment-form__total{display:flex;justify-content:space-between;align-items:baseline;padding:.75rem 1rem;background:var(--nice-color-bg-soft, #f9fafb);border-radius:var(--nice-radius-md, 6px);font-size:1.125rem;font-weight:600}.nice-payment-form__total-label{color:var(--nice-color-muted, #6b7280);font-size:.875rem;font-weight:500}.nice-payment-form__description{font-size:.875rem;color:var(--nice-color-muted, #4b5563);margin:0}.nice-payment-form__warning,.nice-payment-form__error{padding:.5rem .75rem;border-radius:var(--nice-radius-md, 6px);font-size:.875rem}.nice-payment-form__warning{background:var(--nice-color-warning-soft, #fef3c7);color:var(--nice-color-warning-fg, #92400e)}.nice-payment-form__error{background:var(--nice-color-danger-soft, #fee2e2);color:var(--nice-color-danger-fg, #991b1b)}.nice-payment-form__submit{font:inherit;font-weight:600;padding:.75rem 1rem;border:none;border-radius:var(--nice-radius-md, 6px);background:var(--nice-color-primary, #2563eb);color:var(--nice-color-primary-fg, #fff);cursor:pointer}.nice-payment-form__submit:disabled{opacity:.5;cursor:not-allowed}.nice-payment-form__processor{text-align:center;font-size:.75rem;color:var(--nice-color-muted, #6b7280);margin:0}.nice-price-tag{display:inline-flex;align-items:baseline;gap:.5rem;font-variant-numeric:tabular-nums}.nice-price-tag__amount{font-weight:700}.nice-price-tag--sm{font-size:.875rem}.nice-price-tag--md{font-size:1rem}.nice-price-tag--lg{font-size:1.25rem}.nice-price-tag--xl{font-size:1.75rem}.nice-price-tag__period{font-size:.75em;color:var(--nice-color-muted, #6b7280);margin-left:.125em}.nice-price-tag__original{color:var(--nice-color-muted, #9ca3af);font-size:.875em}.nice-price-tag__discount{background:var(--nice-color-success, #16a34a);color:var(--nice-color-success-fg, #fff);border-radius:var(--nice-radius-sm, 4px);padding:.125em .375em;font-size:.75em;font-weight:700}.nice-currency-converter{display:flex;flex-direction:column;gap:.5rem}.nice-currency-converter__output{display:flex;align-items:center;gap:.5rem;padding:.5rem;border:1px solid var(--nice-color-border, #d1d5db);border-radius:var(--nice-radius-md, 6px)}.nice-currency-converter__amount{font-weight:600;font-variant-numeric:tabular-nums;margin-left:auto}.nice-currency-converter__rate{font-size:.8125rem;color:var(--nice-color-muted, #6b7280);margin:0}.nice-currency-converter__inverse{opacity:.7}.nice-currency-converter__error{color:var(--nice-color-danger, #dc2626);font-size:.8125rem}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Money domain types and core utilities.
+ *
+ * Money is stored as integer **minor units** (e.g. cents) to avoid floating-point error.
+ * `100 USD` = `{ amount: 10000, currency: 'USD' }`.
+ */
+export interface Money {
+    /** Amount in minor units (integer). */
+    amount: number;
+    /** ISO 4217 alphabetic code, e.g. `USD`, `EUR`, `JPY`. */
+    currency: string;
+}
+export interface CurrencyDef {
+    /** ISO 4217 alphabetic code. */
+    code: string;
+    /** ISO 4217 numeric code (3-digit). */
+    numeric: number;
+    /** Common symbol, e.g. `$`, `€`, `zł`. */
+    symbol: string;
+    /** English name. */
+    name: string;
+    /** Number of fractional decimals (ISO 4217 e), default 2. JPY=0, BHD=3. */
+    decimals: number;
+    /** Whether the symbol is placed before the amount in en-US (heuristic only — Intl handles real cases). */
+    symbolFirst?: boolean;
+}
+export type CardBrand = 'visa' | 'mastercard' | 'amex' | 'discover' | 'diners' | 'jcb' | 'unionpay' | 'maestro' | 'mir' | 'elo' | 'hipercard' | 'unknown';
+export interface CreditCardData {
+    number: string;
+    /** MM/YY or MM/YYYY. Stored normalised as `MM/YY`. */
+    expiry: string;
+    cvc: string;
+    holderName?: string;
+    postalCode?: string;
+}
+export interface CreditCardValidation {
+    brand: CardBrand;
+    numberValid: boolean;
+    expiryValid: boolean;
+    cvcValid: boolean;
+    holderValid: boolean;
+    isValid: boolean;
+    errors: Partial<Record<keyof CreditCardData, string>>;
+}
+export interface ExchangeRate {
+    base: string;
+    quote: string;
+    /** rate such that `1 base = rate quote`. */
+    rate: number;
+    /** ISO timestamp of the quote. */
+    asOf: string;
+}
+export type PaymentStatus = 'idle' | 'validating' | 'authorizing' | 'authorized' | 'capturing' | 'captured' | 'failed' | 'cancelled' | 'refunded';
+export interface PaymentRequest {
+    amount: Money;
+    description?: string;
+    customer?: {
+        id?: string;
+        email?: string;
+        name?: string;
+    };
+    metadata?: Record<string, string>;
+    /** Card for direct authorization. Token-based flows ignore this. */
+    card?: CreditCardData;
+    /** Pre-tokenized payment method (Stripe `pm_…`, PayPal order id, …). */
+    paymentMethodToken?: string;
+    /** Idempotency key — most processors recommend it. */
+    idempotencyKey?: string;
+}
+export interface PaymentResponse {
+    id: string;
+    status: PaymentStatus;
+    processor: string;
+    /** Processor-native raw response for debugging / receipts. */
+    raw?: unknown;
+    errorCode?: string;
+    errorMessage?: string;
+    /** Authorized / captured amount (may differ from request, e.g. partial capture). */
+    amount?: Money;
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@nice2dev/ui-money",
+  "version": "1.0.10",
+  "description": "Nice2Dev Money & Payments — Money / MoneyInput / CurrencySelector / CreditCardInput / PaymentForm + ISO 4217 catalog, Luhn validation, exchange-rate & payment-processor adapters",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@nice2dev/ui-core": "^1.0.10",
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "devDependencies": {
+    "@nice2dev/ui-core": "^1.0.10",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^14.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "nice2dev",
+    "money",
+    "currency",
+    "payment",
+    "credit-card",
+    "stripe",
+    "paypal",
+    "adyen",
+    "exchange-rate",
+    "iso-4217",
+    "luhn",
+    "react"
+  ],
+  "author": "Nice2Dev Team",
+  "license": "SEE LICENSE IN LICENSE"
+}