import type { CurveFactory } from 'd3-shape';
export type ChartValue = string | number | Date;
export type ChartKey = string | number;
export type ChartDataIntent = 'brand' | 'caution' | 'negative' | 'neutral' | 'positive' | 'warning';
export type ChartChannel<TDatum, TValue> = Extract<keyof TDatum, string> | ((datum: TDatum, index: number, data: readonly TDatum[]) => TValue);
export type ChartVisual<TDatum, TValue> = TValue | ((datum: TDatum, index: number, data: readonly TDatum[]) => TValue);
/** Structural boundary accepted by the chart compiler for native D3 scales. */
export type ChartScale = ((value: ChartValue) => unknown) & {
    copy?: () => ChartScale;
    domain: (...values: unknown[]) => unknown;
    range: (...values: unknown[]) => unknown;
    bandwidth?: () => number;
    ticks?: (count?: number) => ChartValue[];
    tickFormat?: (count?: number) => (value: ChartValue) => string;
    nice?: (count?: number) => unknown;
};
/** A configured D3 scale or a zero-argument D3 scale factory. */
export type ChartScaleSource = ChartScale | (() => unknown);
export interface ChartTickOptions {
    count?: number;
    values?: readonly ChartValue[];
    format?: (value: ChartValue, locale: string) => string;
    /** Minimum measured gap between adjacent tick labels, in CSS pixels. */
    spacing?: number;
    /** Length of the tick stub extending away from the plot, in CSS pixels. */
    size?: number;
    /** Gap between the end of a tick stub and its label, in CSS pixels. */
    padding?: number;
    /** Rotation in degrees. Negative values rotate counter-clockwise. */
    rotate?: number;
}
export interface ChartAxisPresentation {
    label?: string;
    /** Render the axis baseline. Defaults to true. */
    line?: boolean;
    ticks?: ChartTickOptions;
}
export interface ChartAxisOptions {
    scale: ChartScaleSource;
    nice?: boolean;
    grid?: boolean;
    axis?: false | ChartAxisPresentation;
}
export interface ChartMargin {
    top?: number;
    right?: number;
    bottom?: number;
    left?: number;
}
export type ChartFocusMode = 'none' | 'nearest' | 'nearest-x' | 'nearest-y' | 'group-x' | 'group-y';
export interface ChartPoint<TDatum = unknown> {
    key: ChartKey;
    sceneKey: string;
    markId: string;
    datum: TDatum;
    datumIndex: number;
    groupValue?: ChartValue;
    groupLabel?: string;
    xValue: ChartValue;
    yValue: ChartValue;
    /** Primary semantic value for polar, heatmap, and distribution marks. */
    value?: ChartValue;
    angleValue?: ChartValue;
    radiusValue?: ChartValue;
    x: number;
    y: number;
    color: string;
}
export interface ChartTooltipItem {
    label: string;
    value: string;
    color?: string;
}
export interface ChartTooltipContext<TDatum = unknown> {
    locale: string;
    primary: ChartPoint<TDatum>;
    points: readonly ChartPoint<TDatum>[];
}
export interface ChartTooltipOptions<TDatum = unknown> {
    format?: (point: ChartPoint<TDatum>, locale: string) => string;
    formatGroupHeading?: (points: readonly ChartPoint<TDatum>[], locale: string) => string;
    formatGroupItem?: (point: ChartPoint<TDatum>, locale: string) => ChartTooltipItem;
}
export type ChartTooltip<TDatum = unknown> = boolean | ChartTooltipOptions<TDatum>;
export interface ChartColorOptions {
    domain?: readonly ChartValue[];
    range?: readonly string[];
}
export interface ChartBuildContext {
    width: number;
    height: number;
}
export interface ChartCartesianCoordinate {
    type?: 'cartesian';
}
export interface ChartPolarCoordinate {
    type: 'polar';
    /** Radians measured clockwise from twelve o'clock. */
    startAngle?: number;
    /** Radians measured clockwise from twelve o'clock. */
    endAngle?: number;
    /** Default inner radius as a fraction of the available radius. */
    innerRadius?: number;
    /** Outer radius as a fraction of the available radius. */
    outerRadius?: number;
    grid?: 'none' | 'polygon';
}
export type ChartCoordinate = ChartCartesianCoordinate | ChartPolarCoordinate;
export interface ChartPolarAxisOptions {
    domain?: readonly ChartValue[];
    label?: string;
    ticks?: ChartTickOptions;
    grid?: boolean;
}
export interface ChartCenterContent {
    value?: string;
    caption?: string;
}
export interface ChartCenterOptions extends ChartCenterContent {
    /** Optional focused content. Authored content remains the default. */
    focused?: (point: ChartPoint, locale: string) => ChartCenterContent;
}
export type ChartMarkKind = 'polar' | 'line-y' | 'area-y' | 'bar-x' | 'bar-y' | 'box-y' | 'dot' | 'rule-x' | 'rule-y' | 'band-x' | 'band-y' | 'rect' | 'cell' | 'text' | 'arc' | 'radial-line' | 'radial-area' | 'radial-dot';
export interface ChartMark<TDatum = unknown> {
    kind: ChartMarkKind;
    data: readonly TDatum[];
    options: ChartMarkOptions<TDatum>;
}
export interface ChartPolarContainerOptions {
    id?: string;
    marks: readonly ChartMark[];
    angle?: ChartPolarAxisOptions;
    radius?: ChartAxisOptions;
    /** Radians measured clockwise from twelve o'clock. */
    startAngle?: number;
    /** Radians measured clockwise from twelve o'clock. */
    endAngle?: number;
    innerRadius?: number;
    outerRadius?: number;
    grid?: 'none' | 'polygon';
    center?: ChartCenterOptions;
}
export interface ChartBaseMarkOptions<TDatum> {
    id?: string;
    /** Exclude decorative layers from semantic focus while retaining rendering. */
    interactive?: boolean;
    key?: ChartChannel<TDatum, ChartKey>;
    z?: ChartChannel<TDatum, ChartValue | null | undefined>;
    color?: ChartChannel<TDatum, ChartValue | null | undefined>;
    value?: ChartChannel<TDatum, ChartValue | null | undefined>;
    fill?: ChartVisual<TDatum, string>;
    stroke?: ChartVisual<TDatum, string>;
    opacity?: ChartVisual<TDatum, number>;
    fillOpacity?: ChartVisual<TDatum, number>;
    strokeOpacity?: ChartVisual<TDatum, number>;
    strokeWidth?: ChartVisual<TDatum, number | string>;
    strokeDasharray?: ChartVisual<TDatum, string>;
}
export interface ChartLineYOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, number | null | undefined>;
    curve?: CurveFactory;
}
export interface ChartAreaYOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, number | null | undefined>;
    y1?: ChartChannel<TDatum, number | null | undefined>;
    y2?: ChartChannel<TDatum, number | null | undefined>;
    curve?: CurveFactory;
}
export type ChartBarLayout = 'single' | 'grouped' | 'stacked';
export interface ChartBarOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, ChartValue | null | undefined>;
    x1?: ChartChannel<TDatum, number | null | undefined>;
    x2?: ChartChannel<TDatum, number | null | undefined>;
    y1?: ChartChannel<TDatum, number | null | undefined>;
    y2?: ChartChannel<TDatum, number | null | undefined>;
    layout?: ChartBarLayout;
    inset?: ChartVisual<TDatum, number>;
    radius?: ChartVisual<TDatum, number | string>;
}
export interface ChartBoxYOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, number | null | undefined>;
    /** Tukey whisker multiplier. */
    whisker?: number;
    inset?: number;
    radius?: number | string;
}
export interface ChartDotOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, ChartValue | null | undefined>;
    r?: ChartVisual<TDatum, number | string>;
}
export interface ChartRuleOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, ChartValue | null | undefined>;
}
export interface ChartBandOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x1?: ChartChannel<TDatum, number | null | undefined>;
    x2?: ChartChannel<TDatum, number | null | undefined>;
    y1?: ChartChannel<TDatum, number | null | undefined>;
    y2?: ChartChannel<TDatum, number | null | undefined>;
}
export interface ChartRectOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x1?: ChartChannel<TDatum, number | null | undefined>;
    x2?: ChartChannel<TDatum, number | null | undefined>;
    y1?: ChartChannel<TDatum, number | null | undefined>;
    y2?: ChartChannel<TDatum, number | null | undefined>;
    radius?: ChartVisual<TDatum, number | string>;
    inset?: ChartVisual<TDatum, number>;
}
export interface ChartCellOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, ChartValue | null | undefined>;
    intensity?: ChartChannel<TDatum, number | null | undefined>;
    intent?: ChartDataIntent;
    minimumOpacity?: number;
    maximumOpacity?: number;
    inset?: number;
    radius?: number | string;
}
export interface ChartTextOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    x?: ChartChannel<TDatum, ChartValue | null | undefined>;
    y?: ChartChannel<TDatum, ChartValue | null | undefined>;
    text?: ChartChannel<TDatum, string | number | null | undefined>;
    fontFamily?: ChartVisual<TDatum, string>;
    fontSize?: ChartVisual<TDatum, number | string>;
    fontWeight?: ChartVisual<TDatum, number | string>;
    textAnchor?: ChartVisual<TDatum, 'start' | 'middle' | 'end'>;
    dx?: ChartVisual<TDatum, number>;
    dy?: ChartVisual<TDatum, number>;
}
export interface ChartArcOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    theta1?: ChartChannel<TDatum, number | null | undefined>;
    theta2?: ChartChannel<TDatum, number | null | undefined>;
    innerRadius?: ChartVisual<TDatum, number>;
    outerRadius?: ChartVisual<TDatum, number>;
    cornerRadius?: ChartVisual<TDatum, number>;
    padAngle?: ChartVisual<TDatum, number>;
    label?: ChartChannel<TDatum, string | null | undefined>;
}
export interface ChartRadialOptions<TDatum> extends ChartBaseMarkOptions<TDatum> {
    angle?: ChartChannel<TDatum, ChartValue | null | undefined>;
    radius?: ChartChannel<TDatum, number | null | undefined>;
    radius1?: ChartChannel<TDatum, number | null | undefined>;
    radius2?: ChartChannel<TDatum, number | null | undefined>;
    curve?: CurveFactory;
    r?: ChartVisual<TDatum, number | string>;
}
export type ChartMarkOptions<TDatum> = ChartLineYOptions<TDatum> | ChartAreaYOptions<TDatum> | ChartBarOptions<TDatum> | ChartBoxYOptions<TDatum> | ChartDotOptions<TDatum> | ChartRuleOptions<TDatum> | ChartBandOptions<TDatum> | ChartRectOptions<TDatum> | ChartCellOptions<TDatum> | ChartTextOptions<TDatum> | ChartArcOptions<TDatum> | ChartRadialOptions<TDatum>;
export interface ChartSpec<TDatum = unknown> {
    marks: readonly ChartMark<TDatum>[] | readonly ChartMark<unknown>[];
    coordinate?: ChartCoordinate;
    x?: ChartAxisOptions;
    y?: ChartAxisOptions;
    angle?: ChartPolarAxisOptions;
    radius?: ChartAxisOptions;
    center?: ChartCenterOptions;
    margin?: number | ChartMargin;
    guides?: boolean;
    /** Clip graphical marks to the solved plot rectangle. Defaults to true. */
    clip?: boolean;
    color?: ChartColorOptions;
    focus?: ChartFocusMode;
    tooltip?: ChartTooltip<TDatum>;
    maxFocusDistance?: number;
}
export type ChartSpecBuilder<TDatum = unknown> = (context: ChartBuildContext) => ChartSpec<TDatum>;
export interface ChartDefinition<TDatum = unknown> {
    chart: ChartSpec<TDatum> | ChartSpecBuilder<TDatum>;
}
export interface NormalizedStackDatum<TDatum> {
    data: TDatum;
    group: ChartKey;
    series: ChartKey;
    value: number;
    proportion: number;
}
export interface NormalizeStackOptions<TDatum> {
    group: ChartChannel<TDatum, ChartKey>;
    series: ChartChannel<TDatum, ChartKey>;
    value: ChartChannel<TDatum, number>;
}
export interface ChartPieDatum<TDatum> {
    data: TDatum;
    index: number;
    key: ChartKey;
    label: string;
    value: number;
    theta1: number;
    theta2: number;
}
export interface ChartPieOptions<TDatum> {
    value: ChartChannel<TDatum, number>;
    key?: ChartChannel<TDatum, ChartKey>;
    label?: ChartChannel<TDatum, string>;
    sort?: (a: TDatum, b: TDatum) => number;
}
export interface ChartBinDatum<TDatum> {
    key: string;
    x1: number;
    x2: number;
    x: number;
    count: number;
    cumulative: number;
    rows: readonly TDatum[];
}
export interface ChartBinOptions<TDatum> {
    value: ChartChannel<TDatum, number>;
    thresholds?: number | readonly number[];
}
export interface ChartDensityDatum {
    key: string;
    x: number;
    density: number;
}
export interface ChartDensityOptions<TDatum> {
    value: ChartChannel<TDatum, number>;
    samples?: number;
    bandwidth?: number;
}
export declare function defineChart<TDatum>(chart: ChartSpec<TDatum> | ChartSpecBuilder<TDatum>): ChartDefinition<TDatum>;
/** Compose polar marks and guides inside the shared chart scene. */
export declare function polar(options: ChartPolarContainerOptions): ChartMark;
export declare function lineY<TDatum>(data: readonly TDatum[], options?: ChartLineYOptions<TDatum>): ChartMark<TDatum>;
export declare function areaY<TDatum>(data: readonly TDatum[], options?: ChartAreaYOptions<TDatum>): ChartMark<TDatum>;
export declare function barY<TDatum>(data: readonly TDatum[], options?: ChartBarOptions<TDatum>): ChartMark<TDatum>;
export declare function barX<TDatum>(data: readonly TDatum[], options?: ChartBarOptions<TDatum>): ChartMark<TDatum>;
export declare function boxY<TDatum>(data: readonly TDatum[], options?: ChartBoxYOptions<TDatum>): ChartMark<TDatum>;
export declare function dot<TDatum>(data: readonly TDatum[], options?: ChartDotOptions<TDatum>): ChartMark<TDatum>;
export declare function ruleX<TDatum>(data: readonly TDatum[], options?: ChartRuleOptions<TDatum>): ChartMark<TDatum>;
export declare function ruleY<TDatum>(data: readonly TDatum[], options?: ChartRuleOptions<TDatum>): ChartMark<TDatum>;
export declare function bandX<TDatum>(data: readonly TDatum[], options: ChartBandOptions<TDatum>): ChartMark<TDatum>;
export declare function bandY<TDatum>(data: readonly TDatum[], options: ChartBandOptions<TDatum>): ChartMark<TDatum>;
export declare function rect<TDatum>(data: readonly TDatum[], options: ChartRectOptions<TDatum>): ChartMark<TDatum>;
export declare function cell<TDatum>(data: readonly TDatum[], options: ChartCellOptions<TDatum>): ChartMark<TDatum>;
export declare function textMark<TDatum>(data: readonly TDatum[], options?: ChartTextOptions<TDatum>): ChartMark<TDatum>;
export declare function arcMark<TDatum>(data: readonly TDatum[], options?: ChartArcOptions<TDatum>): ChartMark<TDatum>;
export declare function radialLine<TDatum>(data: readonly TDatum[], options?: ChartRadialOptions<TDatum>): ChartMark<TDatum>;
export declare function radialArea<TDatum>(data: readonly TDatum[], options?: ChartRadialOptions<TDatum>): ChartMark<TDatum>;
export declare function radialDot<TDatum>(data: readonly TDatum[], options?: ChartRadialOptions<TDatum>): ChartMark<TDatum>;
export declare function channelValue<TDatum, TValue>(datum: TDatum, index: number, data: readonly TDatum[], channel: ChartChannel<TDatum, TValue> | undefined): TValue | undefined;
export declare function visualValue<TDatum, TValue>(datum: TDatum, index: number, data: readonly TDatum[], value: ChartVisual<TDatum, TValue> | undefined, fallback: TValue): TValue;
export declare function normalizeStack<TDatum>(data: readonly TDatum[], options: NormalizeStackOptions<TDatum>): NormalizedStackDatum<TDatum>[];
export declare function pieLayout<TDatum>(data: readonly TDatum[], options: ChartPieOptions<TDatum>): ChartPieDatum<TDatum>[];
export declare function binX<TDatum>(data: readonly TDatum[], options: ChartBinOptions<TDatum>): ChartBinDatum<TDatum>[];
export declare function cumulativeBins<TDatum>(bins: readonly ChartBinDatum<TDatum>[]): ChartBinDatum<TDatum>[];
export declare function densityX<TDatum>(data: readonly TDatum[], options: ChartDensityOptions<TDatum>): ChartDensityDatum[];
export declare function boxStatistics(values: readonly number[], whisker?: number): {
    q1: number;
    median: number;
    q3: number;
    lower: number;
    upper: number;
    outliers: number[];
} | undefined;
export declare function chartValueKey(value: unknown): string;