import { Axis } from 'd3-axis';
import { NumberValue, ScaleBand, ScaleLinear } from 'd3-scale';
import { ComputedRef, MaybeRefOrGetter } from '../../node_modules/vue';
/**
 * The geometry of a single rendered column, in canvas pixels, carrying its
 * source datum and (for waterfall charts) a flag marking the total column.
 */
export interface ColumnChartBar {
    datum: Record<string, any>;
    width: number;
    height: number;
    x: number;
    y: number;
    isTotal?: boolean;
}
/**
 * The chart's margins, in canvas pixels.
 */
export interface ColumnChartMargin {
    left: number;
    right: number;
    top: number;
    bottom: number;
}
/**
 * The chart's inner padding box, once the axis margins are subtracted.
 */
export interface ColumnChartPadded {
    width: number;
    height: number;
}
/**
 * A value formatter compatible with `useChart`'s `d3Formatter`: applies a d3
 * format string or a custom function, returning the value untouched otherwise.
 */
export type ColumnChartFormatter = (value: number | string, formatter?: ((v: number | string) => string) | string) => string | number;
/**
 * Reactive inputs driving {@link useColumnChart}. They mirror the `ColumnChart`
 * component's loaded data, its measured dimensions and the geometry-affecting
 * props, accepted as plain values, refs or getters so the composable adapts to
 * how the caller wires its state.
 */
export interface UseColumnChartOptions {
    /**
     * The chart's loaded data (inline array or fetched), as exposed by `useChart`.
     */
    loadedData: MaybeRefOrGetter<Record<string, unknown>[] | null>;
    /**
     * Measured outer width of the chart, in pixels.
     */
    width: MaybeRefOrGetter<number>;
    /**
     * Measured outer height of the chart, in pixels.
     */
    height: MaybeRefOrGetter<number>;
    /**
     * Measured (or fixed) width reserved for the y-axis labels, in pixels.
     */
    labelWidth: MaybeRefOrGetter<number>;
    /**
     * Measured height of the y-axis labels, in pixels.
     */
    labelHeight: MaybeRefOrGetter<number>;
    /**
     * Measured height of the x-axis tick labels, in pixels.
     */
    bucketHeight: MaybeRefOrGetter<number>;
    /**
     * Measured width of the x-axis tick labels, in pixels.
     */
    bucketWidth: MaybeRefOrGetter<number>;
    /**
     * The `d3Formatter` helper exposed by `useChart`, used to format axis ticks.
     */
    d3Formatter: ColumnChartFormatter;
    sortBy: MaybeRefOrGetter<string | string[] | null | undefined>;
    seriesName: MaybeRefOrGetter<string>;
    timeseriesKey: MaybeRefOrGetter<string>;
    maxValue: MaybeRefOrGetter<number | null>;
    barPadding: MaybeRefOrGetter<number>;
    barMargin: MaybeRefOrGetter<number>;
    noXAxis: MaybeRefOrGetter<boolean>;
    noYAxis: MaybeRefOrGetter<boolean>;
    xAxisTickCollapse: MaybeRefOrGetter<boolean>;
    xAxisTickFormat: MaybeRefOrGetter<((v: any) => string) | string>;
    xAxisTicks: MaybeRefOrGetter<string[] | null>;
    yAxisTickFormat: MaybeRefOrGetter<((v: any) => string) | string>;
    yAxisTicks: MaybeRefOrGetter<number | object>;
    waterfall: MaybeRefOrGetter<boolean>;
    waterfallTotal: MaybeRefOrGetter<boolean>;
    waterfallTotalLabel: MaybeRefOrGetter<string>;
}
/**
 * Reactive API returned by {@link useColumnChart}.
 */
export interface UseColumnChart {
    sortedData: ComputedRef<Record<string, unknown>[]>;
    margin: ComputedRef<ColumnChartMargin>;
    padded: ComputedRef<ColumnChartPadded>;
    scaleX: ComputedRef<ScaleBand<string>>;
    scaleY: ComputedRef<ScaleLinear<number, number>>;
    waterfallTotalValue: ComputedRef<number>;
    bars: ComputedRef<ColumnChartBar[]>;
    xAxisHiddenTicks: ComputedRef<number>;
    /**
     * Ticks to actually render on the x-axis: the collapsed, surviving subset
     * of `sortedData`'s keys, not one entry per datum. Do not zip this with
     * {@link bars} by index to derive your own labels — their lengths diverge
     * as soon as `xAxisTickCollapse` yields a stride above 1; match by value
     * against each bar's `datum` instead.
     */
    xAxisTickValues: ComputedRef<string[]>;
    xAxis: ComputedRef<Axis<string>>;
    yAxis: ComputedRef<Axis<NumberValue>>;
}
/**
 * Owns the pure d3 geometry of the `ColumnChart` component: it sorts the data,
 * builds the band and linear scales, derives every column (including the
 * waterfall layout and its optional total), and configures the x/y axes. It
 * holds no DOM state — the measured dimensions are passed in, and the axis
 * rendering and tooltips stay in the component.
 *
 * @param options - Reactive geometry options (see {@link UseColumnChartOptions}).
 * @returns The {@link UseColumnChart} API of derived geometry and axis builders.
 * @example
 * // Internal building block of the `ColumnChart` component; not exported from
 * // the package root. Inside a `<script setup>` block:
 * import { toRef } from 'vue'
 * import { useColumnChart } from '@/composables/useColumnChart'
 *
 * const { bars, scaleX, xAxis } = useColumnChart({
 *   loadedData,
 *   width,
 *   height,
 *   labelWidth,
 *   labelHeight,
 *   bucketHeight,
 *   bucketWidth,
 *   d3Formatter,
 *   seriesName: toRef(() => props.seriesName),
 *   timeseriesKey: toRef(() => props.timeseriesKey)
 *   // ...remaining geometry props
 * })
 */
export declare function useColumnChart(options: UseColumnChartOptions): UseColumnChart;
export default useColumnChart;