import { Color, Shape } from "./dancer.js";
import { Geometry } from "./geometry.js";
import { Simplify } from "./utils.js";
/**
 * Sizes can be specified as:
 * - the number of pixels, e.g. 30 represents 30 px.
 * - a scale factor, e.g. "*2" represents twice the default.
 * - a percentage, e.g. "50%" represents half the default.
 */
type Size = number | `*${number}` | `${number}%`;
type BodyOptions = {
    /**
     * Shape of the dancer's bodies.
     * Default: square.
     */
    shape?: Shape;
    /**
     * Diameter of the dancer's bodies.
     * Default: 30.
     */
    size?: Size;
    /**
     * Stroke color of the dancer's bodies, as a preset color, or a CSS string.
     * Default: black.
     */
    strokeColor?: Color | string;
    /**
     * Stroke width of the dancer's bodies.
     * Default: max(1, body size / 12).
     */
    strokeWidth?: Size;
    /**
     * The stroke dash array of a phantom dancer's body.
     * Default: [body size / 5]
     */
    phantomDashArray?: Size[];
    /**
     * Fill color of the dancer's bodies, as a preset color, or a CSS string.
     * Default: stroke color.
     */
    fillColor?: Color | string;
    /**
     * Fill opacity of the dancer's bodies, as a number between 0 and 1.
     * Default: 0.
     */
    fillOpacity?: number;
};
type BodyOptionsResolved = Simplify<Required<Omit<BodyOptions, "phantomDashArray">> & {
    size: number;
    strokeWidth: number;
    phantomDashArray: number[];
}>;
type NoseOptions = {
    /**
     * Shape of the dancer's noses.
     * Default: circle.
     */
    shape?: Shape;
    /**
     * Diameter of the dancer's noses.
     * Default: body size / 3.
     */
    size?: Size;
    /**
     * Distance from the edge of the dancer's body to the center of their nose.
     * Default: nose size / 4.
     */
    distance?: Size;
    /**
     * Stroke color of the dancer's noses, as a preset color, or a CSS string.
     * Default: body stroke color.
     */
    strokeColor?: Color | string;
    /**
     * Stroke width of the dancer's noses.
     * Default: 0.
     */
    strokeWidth?: number;
    /**
     * Fill color of the dancer's noses, as a preset color, or a CSS string.
     * Default: stroke color.
     */
    fillColor?: Color | string;
    /**
     * Fill opacity of the dancer's noses, as a number between 0 and 1.
     * Default: 1.
     */
    fillOpacity?: number;
};
type NoseOptionsResolved = Simplify<Required<NoseOptions> & {
    size: number;
    distance: number;
}>;
type LabelOptions = {
    /**
     * Font size of the dancer labels.
     * Default: 0.8 * body size.
     */
    size?: Size;
    /**
     * Font family of the dancer labels.
     * Default: Open Sans.
     */
    family?: string;
    /**
     * Color of the dancer labels.
     * Default: body stroke color.
     */
    color?: Color | string;
    /**
     * Opacity of the dancer labels, as a number between 0 and 1.
     * Default: 1.
     */
    opacity?: number;
};
type LabelOptionsResolved = Simplify<Required<LabelOptions> & {
    size: number;
}>;
type LayoutOptions = {
    /**
     * Default spacing unit, used for padding and gap sizes.
     * Default: nose size * 2.
     */
    space?: Size;
    /**
     * Padding around generated SVG. You probably don't want this to be 0, as it
     * would cut off the dancer noses. I think?
     * Default: space.
     */
    padding?: Size;
    /**
     * Space between dancer edges. If an array is given, it's [vertical gap,
     * horizontal gap].
     * Default: space.
     */
    gap?: Size | [Size, Size];
    /**
     * Horizontal space between dancer edges. Overrides gap.
     * Default: space.
     */
    horizontalGap?: Size;
    /**
     * Vertical space between dancer edges. Overrides gap.
     * Default: space.
     */
    verticalGap?: Size;
    /**
     * Used to add additional dancers by symmetry, according to geometry.
     * Default: none.
     */
    geometry?: Geometry;
    /**
     * Origin used for computing positions with dancer geometry.
     * Default: { x: 0, y: 0 }.
     */
    origin?: {
        x: number;
        y: number;
    };
};
type LayoutOptionsResolved = Simplify<Required<Omit<LayoutOptions, "space" | "gap">> & {
    padding: number;
    horizontalGap: number;
    verticalGap: number;
}>;
type RenderOptions = {
    /**
     * Prefix for generated element IDs (e.g. mask IDs). Use this to avoid ID
     * collisions when rendering multiple formations on the same page.
     */
    idPrefix?: string;
};
type RenderOptionsResolved = Required<RenderOptions>;
export type Options = {
    /** Options for drawing the dancer's bodies. */
    body?: BodyOptions;
    /** Options for drawing the dancer's noses. */
    nose?: NoseOptions;
    /** Options for drawing the dancer labels. */
    label?: LabelOptions;
    /** Options for the dancers' layout. */
    layout?: LayoutOptions;
    /** Options for SVG rendering. */
    render?: RenderOptions;
};
export declare function defineOptions(options: Options): Options;
export type OptionsResolved = {
    body: BodyOptionsResolved;
    nose: NoseOptionsResolved;
    label: LabelOptionsResolved;
    layout: LayoutOptionsResolved;
    render: RenderOptionsResolved;
};
export declare function resolveOptions(options: Readonly<Options>): OptionsResolved;
export declare const defaultOptions: Readonly<OptionsResolved>;
export {};