/**
 * Responsive Breakpoint Manager
 * -----------------------------
 * Watches design tokens to derive breakpoint values, exposes helpers to build
 * media queries, and keeps CSS custom properties in sync.
 */
export interface BreakpointDescriptor {
    name: string;
    min?: number;
    max?: number;
    container?: number;
}
export type BreakpointInput = Array<BreakpointDescriptor> | Record<string, number | Partial<BreakpointDescriptor>>;
interface BreakpointListener {
    unsubscribe: () => void;
}
export declare class BreakpointManager {
    /**
     * Ensures the registry is populated with defaults and token synchronisation
     * is in place.
     */
    static initialize(): void;
    /**
     * Replaces the current breakpoint registry with the provided definitions.
     */
    static configure(input: BreakpointInput): void;
    /**
     * Returns a shallow copy of the current breakpoint descriptors.
     */
    static all(): BreakpointDescriptor[];
    /**
     * Retrieves a breakpoint by name.
     */
    static get(name: string): BreakpointDescriptor | undefined;
    /**
     * Returns the container width associated with a breakpoint, if available.
     */
    static containerWidth(name: string): number | undefined;
    /**
     * Returns the minimum width in pixels for the given breakpoint.
     */
    static min(name: string): number | undefined;
    /**
     * Returns the maximum width in pixels for the given breakpoint. If the
     * descriptor does not specify a max, the method derives one from the next
     * registered breakpoint.
     */
    static max(name: string): number | undefined;
    /**
     * Produces a media query string for the specified breakpoint and comparison.
     */
    static query(name: string, comparison?: 'min' | 'max' | 'between', to?: string): string;
    /**
     * Produces a container condition string compatible with container queries.
     */
    static condition(name: string, comparison?: 'min' | 'max' | 'between', to?: string): string;
    /**
     * Observes a single breakpoint using matchMedia.
     */
    static observe(name: string, comparison: "min" | "max" | undefined, listener: (matches: boolean) => void): BreakpointListener;
    /**
     * Generates a map suitable for the responsive helpers (`responsiveSpacing`,
     * `responsiveSizing`, etc.) in the layout system.
     */
    static mapResponsive<T>(mapper: (descriptor: BreakpointDescriptor) => T | undefined, comparison?: 'min' | 'max'): Record<string, T>;
    /**
     * Disposes internal listeners (used primarily for testing).
     */
    static teardown(): void;
}
export {};
//# sourceMappingURL=breakpoints.d.ts.map