@anpayeras/agnostic-checkout 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,321 +1,16 @@
-import React, { CSSProperties, ReactNode } from 'react';
-import { ClassValue } from 'clsx';
-
-type CheckoutState = "review" | "payment_method" | "payment_details" | "processing" | "pending" | "redirect" | "success" | "error";
-
-type CheckoutEvent = {
-    type: "CHECKOUT_VIEWED";
-} | {
-    type: "STEP_CHANGED";
-    step: CheckoutState;
-} | {
-    type: "PAYMENT_METHOD_SELECTED";
-    methodId: string;
-} | {
-    type: "PAYMENT_SUBMITTED";
-} | {
-    type: "PAYMENT_SUCCESS";
-    transactionId: string;
-} | {
-    type: "PAYMENT_ERROR";
-    error: string;
-} | {
-    type: "COUPON_APPLY_REQUESTED";
-    code: string;
-} | {
-    type: "COUPON_REMOVE_REQUESTED";
-} | {
-    type: "ITEM_QUANTITY_UPDATE_REQUESTED";
-    itemId: string;
-    quantity: number;
-} | {
-    type: "ITEM_REMOVE_REQUESTED";
-    itemId: string;
-};
-type EventHandler = (event: CheckoutEvent) => void;
-
-interface PaymentProvider {
-    initialize?(config: unknown): Promise<void>;
-    createPayment(data: PaymentPayload): Promise<PaymentResult>;
-    confirmPayment?(data: unknown): Promise<PaymentResult>;
-}
-
-interface CheckoutThemeColors {
-    primary: string;
-    background: string;
-    surface: string;
-    text: string;
-    border: string;
-    success: string;
-    error: string;
-}
-interface CheckoutTheme {
-    colors: Partial<CheckoutThemeColors>;
-    radius: string;
-    fontFamily: string;
-}
-type CheckoutThemeName = "light" | "dark" | "minimal" | "corporate" | "neon";
-declare const checkoutThemes: Record<CheckoutThemeName, CheckoutTheme>;
-declare const defaultTheme: CheckoutTheme;
-declare function mergeTheme(base: CheckoutTheme, overrides?: Partial<CheckoutTheme>): CheckoutTheme;
-declare function createCssVars(theme: CheckoutTheme): CSSProperties;
-/**
- * Generates a complete CheckoutTheme from a single brand color.
- * Uses the brand color as `primary` and auto-generates all other tokens.
- */
-declare function generateBrandTheme(brandColor: string): CheckoutTheme;
-/**
- * Priority chain: customTheme overrides → brandColor theme → preset theme
- */
-declare function resolveTheme(theme?: CheckoutThemeName | Partial<CheckoutTheme>, brandColor?: string, customTheme?: Partial<CheckoutTheme>): CheckoutTheme;
-
-interface CheckoutMessages {
-    orderSummary: string;
-    quantity: string;
-    quantityShort: string;
-    removeItem: string;
-    subtotal: string;
-    discount: string;
-    shipping: string;
-    shippingFree: string;
-    taxes: string;
-    total: string;
-    couponPlaceholder: string;
-    couponApply: string;
-    couponApplied: string;
-    couponInvalid: string;
-    couponRemove: string;
-    orderSummaryTitle: string;
-    securePayment: string;
-    continueToPay: string;
-    payNow: string;
-    pay: string;
-    processing: string;
-    continueNow: string;
-    paymentMethod: string;
-    back: string;
-    completeDetails: string;
-    selectMethod: string;
-    processingPayment: string;
-    processingDescription: string;
-    redirecting: string;
-    redirectDescription: string;
-    showOrderDetails: string;
-    hideOrderDetails: string;
-    continue: string;
-}
-type CheckoutLocale = "es" | "en" | "pt-BR" | "auto";
-type SupportedCurrency = "USD" | "EUR" | "GBP" | "BRL" | "ARS" | "MXN" | "CLP" | "COP" | "PEN" | "UYU" | "PYG" | "BOB" | "VES" | "DOP" | "CRC" | "GTQ" | "HNL" | "NIO" | "PAB" | "CAD" | "JPY" | "CNY" | "KRW" | "INR" | "AUD" | (string & {});
-interface CheckoutFormatters {
-    currency?: (amount: number) => string;
-}
-
-interface PluginSlotProps {
-    items: CheckoutItem[];
-    totals: CheckoutTotals;
-    step: string;
-    t: CheckoutMessages;
-    fmt: (amount: number) => string;
-}
-interface PluginItemSlotProps extends PluginSlotProps {
-    item: CheckoutItem;
-}
-interface PluginSlots {
-    orderItemActions?: (props: PluginItemSlotProps) => ReactNode;
-    /** Renders at the end of item row in OrderSummary (e.g. remove icon) */
-    orderItemEnd?: (props: PluginItemSlotProps) => ReactNode;
-    /** Renders before totals in sidebar (desktop) — e.g. coupon input */
-    sidebarBeforeTotals?: (props: PluginSlotProps) => ReactNode;
-    /** Renders next to discount line in totals — e.g. remove coupon */
-    totalsDiscountAction?: (props: PluginSlotProps) => ReactNode;
-    /** Renders inside mobile bar expandable section — e.g. coupon input */
-    mobileBarExpanded?: (props: PluginSlotProps) => ReactNode;
-}
-interface CheckoutPlugin {
-    id: string;
-    slots: PluginSlots;
-}
-
-interface CheckoutProps {
-    items: CheckoutItem[];
-    totals: CheckoutTotals;
-    paymentMethods: PaymentMethod[];
-    provider: PaymentProvider;
-    currency: SupportedCurrency;
-    locale?: CheckoutLocale;
-    theme?: CheckoutThemeName | Partial<CheckoutTheme>;
-    brandColor?: string;
-    customTheme?: Partial<CheckoutTheme>;
-    onEvent?: EventHandler;
-    cartController?: CartController;
-    initialState?: Extract<PaymentResult, {
-        status: "success" | "error" | "pending";
-    }>;
-    devTools?: boolean;
-    messages?: Partial<CheckoutMessages>;
-    formatters?: CheckoutFormatters;
-    plugins?: CheckoutPlugin[];
-}
-interface ButtonProps {
-    label: string;
-    onPress: () => void;
-    variant?: FractalButtonVariant;
-    icon?: ReactNode;
-    disabled?: boolean;
-    className?: string;
-    type?: "button" | "submit";
-}
-
-interface CheckoutItem {
-    id: string;
-    name: string;
-    quantity: number;
-    unitPrice: number;
-    discount?: {
-        type: "percentage" | "fixed";
-        value: number;
-        label?: string;
-    };
-    total: number;
-    image?: string;
-}
-interface CheckoutTotals {
-    subtotal: number;
-    discount?: number;
-    taxes?: number;
-    shipping?: number;
-    total: number;
-}
-interface CartState {
-    items: CheckoutItem[];
-    totals: CheckoutTotals;
-}
-interface CartController {
-    updateQuantity: (id: string, qty: number) => Promise<CartState>;
-    removeItem: (id: string) => Promise<CartState>;
-    applyCoupon: (code: string) => Promise<CartState>;
-    removeCoupon?: () => Promise<CartState>;
-}
-interface PaymentMethodComponentProps {
-    /** Call this to enable or disable the Pay button while the user fills in the form */
-    onReadyChange: (ready: boolean) => void;
-}
-interface PaymentMethod {
-    id: string;
-    label: string;
-    type: string;
-    icon?: string;
-    /**
-     * Optional renderer for inline payment UI (card form, wallet picker, etc.).
-     * If provided, the Pay button starts disabled until `onReadyChange(true)` is called.
-     */
-    renderComponent?: (props: PaymentMethodComponentProps) => ReactNode;
-}
-/**
- * Props the integrator can return from createPayment to control
- * what the FeedbackScreen displays after a payment attempt.
- * `variant` and `children` are always derived by the framework.
- */
-interface FeedbackProps {
-    title: string;
-    description?: string;
-    actions?: ButtonProps[];
-}
-type PaymentResult = {
-    status: "success";
-    feedback?: FeedbackProps;
-} | {
-    status: "pending";
-    feedback?: FeedbackProps;
-} | {
-    status: "error";
-    feedback?: FeedbackProps;
-} | {
-    status: "redirect";
-    url: string;
-    feedback?: FeedbackProps;
-};
-type FractalButtonVariant = "solid" | "outline" | "ghost";
-type PaymentPayload = unknown;
-
-/**
- * Color manipulation utilities for the Brand Auto Theme system.
- * All functions work with hex color strings (#RRGGBB or #RGB).
- */
-interface RGB {
-    r: number;
-    g: number;
-    b: number;
-}
-declare function hexToRgb(hex: string): RGB;
-declare function rgbToHex({ r, g, b }: RGB): string;
-/**
- * Calculates relative luminance using sRGB coefficients (W3C formula).
- * Returns a value between 0 (black) and 1 (white).
- */
-declare function getLuminance(hex: string): number;
-/**
- * Returns #000000 or #FFFFFF based on which provides better contrast
- * against the given background color.
- */
-declare function getContrastColor(hex: string): string;
-/**
- * Returns true if the color is considered "dark" (luminance < 0.5).
- */
-declare function isDark(hex: string): boolean;
-/**
- * Darkens a hex color by a given amount (0–100).
- */
-declare function darken(hex: string, amount: number): string;
-/**
- * Lightens a hex color by a given amount (0–100).
- */
-declare function lighten(hex: string, amount: number): string;
-/**
- * Mixes two hex colors by a given ratio (0 = first color, 1 = second color).
- */
-declare function mix(hex1: string, hex2: string, ratio: number): string;
-
-interface CartEditPluginOptions {
-    allowRemove?: boolean;
-    allowQuantityEdit?: boolean;
-    minQuantity?: number;
-    maxQuantity?: number;
-}
-declare function createCartEditPlugin(emit: EventHandler, options?: CartEditPluginOptions): CheckoutPlugin;
-
-declare function createDiscountPlugin(emit: EventHandler): CheckoutPlugin;
-
-declare const useCheckout: () => {
-    setStep: (step: CheckoutState) => void;
-    selectMethod: (methodId: string) => void;
-    submitPayment: (data: unknown) => Promise<void>;
-    setError: (error: string) => void;
-    updateQuantity: (id: string, qty: number) => Promise<void>;
-    removeItem: (id: string) => Promise<void>;
-    applyCoupon: (code: string) => Promise<boolean>;
-    removeCoupon: () => Promise<boolean>;
-    hasCartController: boolean;
-    hasRemoveCoupon: boolean;
-    items: CheckoutItem[];
-    paymentMethods: PaymentMethod[];
-    provider: PaymentProvider;
-    currency: string;
-    locale: string;
-    step: CheckoutState;
-    selectedMethodId: string | null;
-    totals: CheckoutTotals;
-    cartController?: CartController;
-    theme?: CheckoutTheme;
-    error: string | null;
-    paymentResult?: PaymentResult;
-};
-
-declare function cn(...inputs: ClassValue[]): string;
-declare const isPaymentStep: (step: string) => step is "payment_method" | "payment_details";
-declare const isReviewStep: (step: string) => step is "review";
-declare const formatNumber: (n: number, currency: string) => string;
-
-declare const Checkout: React.FC<CheckoutProps>;
-
-export { type CartController, type CartEditPluginOptions, type CartState, Checkout, type CheckoutEvent, type CheckoutFormatters, type CheckoutItem, type CheckoutLocale, type CheckoutMessages, type CheckoutPlugin, type CheckoutState, type CheckoutTheme, type CheckoutThemeColors, type CheckoutThemeName, type CheckoutTotals, type EventHandler, type FeedbackProps, type FractalButtonVariant, type PaymentMethod, type PaymentMethodComponentProps, type PaymentPayload, type PaymentProvider, type PaymentResult, type PluginItemSlotProps, type PluginSlotProps, type PluginSlots, type SupportedCurrency, checkoutThemes, cn, createCartEditPlugin, createCssVars, createDiscountPlugin, darken, defaultTheme, formatNumber, generateBrandTheme, getContrastColor, getLuminance, hexToRgb, isDark, isPaymentStep, isReviewStep, lighten, mergeTheme, mix, resolveTheme, rgbToHex, useCheckout };
+export type { CheckoutItem, CheckoutTotals, CartState, CartController, PaymentMethod, PaymentMethodComponentProps, PaymentResult, FeedbackProps, PaymentPayload, FractalButtonVariant } from './core/types';
+export type { PaymentProvider } from './core/provider.interface';
+export type { CheckoutEvent, EventHandler } from './core/event-system';
+export type { CheckoutState } from './core/checkout-machine';
+export type { CheckoutTheme, CheckoutThemeColors, CheckoutThemeName } from './theme/tokens';
+export { checkoutThemes, defaultTheme, mergeTheme, createCssVars, generateBrandTheme, resolveTheme } from './theme/tokens';
+export { hexToRgb, rgbToHex, getLuminance, getContrastColor, isDark, darken, lighten, mix } from './theme/color-utils';
+export type { CheckoutMessages, CheckoutFormatters, CheckoutLocale, SupportedCurrency } from './locales/types';
+export type { CheckoutPlugin, PluginSlots, PluginSlotProps, PluginItemSlotProps } from './plugins/types';
+export type { CartEditPluginOptions } from './plugins/cart-edit-plugin';
+export { createDiscountPlugin } from './plugins/discount-plugin';
+export { createCartEditPlugin } from './plugins/cart-edit-plugin';
+export { useCheckout } from './hooks/useCheckout';
+export { cn, formatNumber, isPaymentStep, isReviewStep } from './utils/utils';
+export { Checkout } from './components/Checkout';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAGtB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,2BAA2B,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5M,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3H,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAGvH,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzG,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG9E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}