import type { ColorInput } from "bun";
import type { Effect } from "./animated.js";
/** A value, or an accessor for one — so effect colors can themselves animate. */
export type MaybeAccessor<T> = T | (() => T);
export type ShimmerOptions = {
    /** Resting color. */
    baseColor: MaybeAccessor<ColorInput>;
    /** Color at the crest of the sweep. */
    highlightColor: MaybeAccessor<ColorInput>;
    /** Milliseconds per cell. Lower = faster. Default 200. */
    speed?: number;
    /** Sweep direction. Default "ltr". */
    direction?: "ltr" | "rtl";
};
/**
 * A highlight crest that sweeps across the region by column, with a soft
 * two-cell falloff. The classic "thinking" shimmer.
 */
export declare function shimmer(opts: ShimmerOptions): Effect;
export type WaveOptions = {
    from: MaybeAccessor<ColorInput>;
    to: MaybeAccessor<ColorInput>;
    /** Milliseconds per full cycle. Default 1500. */
    speed?: number;
    /** Cells per wave. Lower = tighter bands. Default 6. */
    wavelength?: number;
};
/**
 * A smooth color gradient that scrolls along the region by column — each cell
 * sits at a different point on a sine between `from` and `to`, so color "flows"
 * through the content. A gentler, continuous alternative to {@link shimmer}.
 */
export declare function wave(opts: WaveOptions): Effect;
export type PulseOptions = {
    baseColor: MaybeAccessor<ColorInput>;
    flashColor: MaybeAccessor<ColorInput>;
    /** Full cycle period in ms. Default 2000. */
    period?: number;
};
/**
 * A uniform pulse — the whole region breathes between two colors in unison
 * (position-independent).
 */
export declare function pulse(opts: PulseOptions): Effect;
//# sourceMappingURL=effects.d.ts.map