/**
 * Canonical number / currency registers (LC-12 render channel, Axiom 9).
 *
 * One formatter owns every number the catalog renders — table aggregates,
 * KPI values, report cells, chart value labels — so the same data class
 * never speaks in two voices ("15400" in a group header beside "15,400" in
 * the cell two rows below).
 *
 * Content class picks the register:
 *   - cardinal / aggregate → `formatNumber` (grouped, ≤2 fraction digits)
 *   - money                → `formatCurrency` (grouped, 2 fraction digits;
 *                            `fractionDigits: "auto"` elides a whole-value
 *                            `.00` for summary tiles)
 *   - rate                 → `formatPercent` (value already carries percent
 *                            units: 94.2 → "94.2%")
 *
 * Not covered (declared exemptions): chart AXIS tick labels, whose
 * density-driven register is owned by `charts/math.ts#formatAxisTick`;
 * app-land `useFormatNumber` / `useFormatCurrency` (i18n package), which
 * bind the active UI language outside the catalog; and machine formats
 * (export/serialization).
 */
export type NumberInput = number | string | null | undefined;
export interface NumberFormatOptions {
    /** BCP-47 locale forwarded to Intl. Default: system locale. */
    locale?: string;
    /** Pins min and max fraction digits together (fixed-precision columns). */
    precision?: number;
    minimumFractionDigits?: number;
    /** House cap for the cardinal register. Default 2. */
    maximumFractionDigits?: number;
    /** Thousands grouping. Default true. */
    grouping?: boolean;
}
export interface CurrencyFormatOptions extends NumberFormatOptions {
    /** ISO 4217 code, e.g. "USD" — renders through Intl's currency style. */
    currency?: string;
    /**
     * Currency symbol as handed over by Frappe-style adapters. Resolved to an
     * ISO code when known, otherwise prefixed literally.
     */
    symbol?: string;
    /**
     * `"always"` (default) pins 2 fraction digits — the money register that
     * keeps columns aligned. `"auto"` drops them for whole values — the
     * summary-tile register (KPI cards read "$48,250", not "$48,250.00")
     * while still showing cents when a value has them.
     */
    fractionDigits?: "always" | "auto";
}
export type PercentFormatOptions = NumberFormatOptions;
/**
 * ISO 4217 code for a currency symbol (or a code passed straight through).
 * `undefined` when the symbol has no known code — callers prefix it.
 */
export declare function resolveCurrencyCode(symbol: string | undefined): string | undefined;
/**
 * Cardinal / aggregate register — grouped digits, at most two fraction
 * digits ("15,400", "5,133.33"). Empty input renders "" and an unparseable
 * string passes through unchanged (honest passthrough — never invents).
 */
export declare function formatNumber(value: NumberInput, options?: NumberFormatOptions): string;
/**
 * Money register — grouped digits with two fraction digits, rendered with
 * the currency's own symbol placement when the code is known ("$15,400.00",
 * "₹15,400.00") and symbol-prefixed otherwise.
 */
export declare function formatCurrency(value: NumberInput, options?: CurrencyFormatOptions): string;
/**
 * Rate register — the value already carries percent units (94.2 → "94.2%"),
 * never a 0..1 ratio; ratios are converted by the caller that owns the unit.
 */
export declare function formatPercent(value: NumberInput, options?: PercentFormatOptions): string;
//# sourceMappingURL=numbers.d.ts.map