/** Locale por defecto del producto. */
export declare const DEFAULT_LOCALE = "es-MX";
/** Moneda cuando ni la org ni el llamador dan una (mismo fallback que las celdas). */
export declare const FALLBACK_CURRENCY = "USD";
export interface FormatOptions {
    /** BCP-47. Default `es-MX`. */
    locale?: string;
    /** ISO-4217 de la org. Default: contexto → `USD`. */
    currency?: string;
    /** IANA de la org. Default: contexto → zona del navegador. */
    timeZone?: string;
}
/** Redondea a centavos evitando el error binario (1.005 → 1.01). */
export declare function roundMoney(n: number, decimals?: number): number;
/** Número (string con símbolo/separadores, o number) → number; NaN → 0. */
export declare function toAmount(v: unknown): number;
/**
 * Monto con símbolo de la moneda de la org: `formatMoney(1060, {currency:'MXN'})`
 * → `$1,060.00`. Un valor no numérico devuelve `''` (nunca «NaN»).
 */
export declare function formatMoney(amount: unknown, opts?: FormatOptions): string;
/** Número plano localizado (`1,234.5`). */
export declare function formatQuantity(n: unknown, opts?: {
    locale?: string;
    maximumFractionDigits?: number;
}): string;
/**
 * Fecha (`29 sep 2026`). Un `YYYY-MM-DD` es fecha de calendario: se formatea en
 * UTC para que no retroceda un día en zonas con offset negativo.
 */
export declare function formatDate(input: unknown, opts?: FormatOptions & {
    style?: Intl.DateTimeFormatOptions['dateStyle'];
}): string;
/** Fecha y hora en la zona de la org (`29 sep 2026, 14:05`). */
export declare function formatDateTime(input: unknown, opts?: FormatOptions): string;
export interface Formatter {
    locale: string;
    currency: string;
    timeZone: string | undefined;
    money: (amount: unknown, currency?: string) => string;
    quantity: (n: unknown) => string;
    date: (input: unknown) => string;
    dateTime: (input: unknown) => string;
}
/** Formateador ligado a un locale/moneda/zona fijos (para tickets y PDFs fuera de React). */
export declare function createFormatter(opts?: FormatOptions): Formatter;
/** Formateador con la moneda y zona de la org tomadas del runtime provider. */
export declare function useFormatter(overrides?: FormatOptions): Formatter;
//# sourceMappingURL=format.d.ts.map