import type { JSX } from "@solidjs/web";
import { type Accessor } from "solid-js";
import { type MaybeAccessor } from "../internals/maybe-accessor.js";
/**
 * Options for {@link createMeter}. Every reactive input is `MaybeAccessor<T>`.
 *
 * Headless primitive — `<Meter.Root>` layers the label-id registry and the
 * NVDA-pump span on top.
 */
export interface CreateMeterOptions {
    /** Current value. */
    value: MaybeAccessor<number>;
    /** Minimum value. @default 0 */
    min?: MaybeAccessor<number | undefined>;
    /** Maximum value. @default 100 */
    max?: MaybeAccessor<number | undefined>;
    /** `Intl.NumberFormat` options forwarded to {@link formatNumberValue}. */
    format?: MaybeAccessor<Intl.NumberFormatOptions | undefined>;
    /** Locale for {@link Intl.NumberFormat}. */
    locale?: MaybeAccessor<Intl.LocalesArgument | undefined>;
    /**
     * Compute `aria-valuetext`. Receives the formatted value and the raw
     * value. Default returns the formatted string when `format` is provided,
     * otherwise `"<value>%"`.
     */
    getAriaValueText?: (formattedValue: string, value: number) => string;
}
/** Slot bag for the `<div role="meter">` element. */
export interface MeterRootSlotProps {
    role: "meter";
    "aria-valuemin": number;
    "aria-valuemax": number;
    "aria-valuenow": number;
    "aria-valuetext": string;
}
/** Public api returned by {@link createMeter}. */
export interface MeterApi {
    /** Current value. */
    value: Accessor<number>;
    /** Minimum (defaults to 0). */
    min: Accessor<number>;
    /** Maximum (defaults to 100). */
    max: Accessor<number>;
    /** Formatted value string. */
    formattedValue: Accessor<string>;
    /** Resolved `aria-valuetext`. */
    ariaValueText: Accessor<string>;
    /** Slot bag for the root element. */
    root: <U extends object | undefined = undefined>(userProps?: U) => MeterRootSlotProps & (U extends object ? U : object);
    /** Context provider — pair with {@link useMeter}. */
    Provider: (props: {
        children: JSX.Element;
    }) => JSX.Element;
}
/**
 * Read the nearest {@link MeterApi} provided by `c.Provider`. Throws if
 * called outside a Provider.
 */
export declare function useMeter(): MeterApi;
/**
 * Solid-native headless meter primitive — pure derivations from
 * value/min/max + format options. No internal state.
 */
export declare function createMeter(options: CreateMeterOptions): MeterApi;
//# sourceMappingURL=create-meter.d.ts.map