Dual Y-Axis Chart Configuration System

import { CartesianChartDisplay, AxisSide } from '@lightdash/common';

/**
 * Creates a CartesianChartDisplay configuration with dual y-axes.
 *
 * @param leftAxisLabel - Label for the left y-axis
 * @param rightAxisLabel - Label for the right y-axis
 * @param seriesConfig - Object mapping series IDs to their display configuration
 * @returns CartesianChartDisplay configuration object
 */
export function createDualAxisDisplay(
  leftAxisLabel: string,
  rightAxisLabel: string,
  seriesConfig: Record<string, {
    label: string;
    whichYAxis: AxisSide;
    type?: 'line' | 'bar';
    color?: string;
  }>
): CartesianChartDisplay;

/**
 * Generates a simplified ECharts specification from a CartesianChartDisplay config.
 * Should create an object with yAxis array and series array with yAxisIndex.
 *
 * @param display - CartesianChartDisplay configuration
 * @param seriesIds - Array of series IDs to include in the spec
 * @returns Simplified ECharts spec with yAxis and series arrays
 */
export function generateEChartsSpec(
  display: CartesianChartDisplay,
  seriesIds: string[]
): {
  yAxis: Array<{ position: string; name: string }>;
  series: Array<{ id: string; yAxisIndex: number; type: string }>;
};

/**
 * Filters series IDs by their assigned y-axis.
 * Series without whichYAxis property default to left axis (AxisSide.LEFT).
 *
 * @param display - CartesianChartDisplay configuration
 * @param seriesIds - Array of series IDs to filter
 * @param targetAxis - The axis to filter by (AxisSide.LEFT or AxisSide.RIGHT)
 * @returns Array of series IDs assigned to the target axis
 */
export function filterSeriesByAxis(
  display: CartesianChartDisplay,
  seriesIds: string[],
  targetAxis: AxisSide
): string[];