@elaraai/east-ui 0.0.1-beta.16 → 0.0.1-beta.18

package/dist/src/charts/types.d.ts

@@ -12,6 +12,25 @@
  * @packageDocumentation
  */
 import { type SubtypeExprOrValue, OptionType, StructType, ArrayType, DictType, StringType, FloatType, BooleanType, VariantType, NullType, IntegerType, type ExprType } from "@elaraai/east";
+/**
+ * Y-axis identifier for dual y-axis charts.
+ *
+ * @remarks
+ * Used to bind series to either the primary (left) or secondary (right) y-axis.
+ *
+ * @property left - Bind to primary y-axis (yAxis, left side)
+ * @property right - Bind to secondary y-axis (yAxis2, right side)
+ */
+export declare const YAxisIdType: VariantType<{
+    left: NullType;
+    right: NullType;
+}>;
+/**
+ * Type representing y-axis identifier.
+ */
+export type YAxisIdType = typeof YAxisIdType;
+/** String literal type for y-axis ID */
+export type YAxisIdLiteral = "left" | "right";
 /**
  * Series configuration for multi-series charts.
  *
@@ -28,6 +47,7 @@ import { type SubtypeExprOrValue, OptionType, StructType, ArrayType, DictType, S
  * @property fill - Fill color (defaults to color)
  * @property fillOpacity - Fill opacity (0-1)
  * @property strokeDasharray - Dash pattern for dashed lines (e.g., "5 5")
+ * @property yAxisId - Y-axis binding (left = primary yAxis, right = secondary yAxis2)
  */
 export declare const ChartSeriesType: StructType<{
     name: StringType;
@@ -39,6 +59,10 @@ export declare const ChartSeriesType: StructType<{
     fill: OptionType<StringType>;
     fillOpacity: OptionType<FloatType>;
     strokeDasharray: OptionType<StringType>;
+    yAxisId: OptionType<VariantType<{
+        left: NullType;
+        right: NullType;
+    }>>;
 }>;
 /**
  * Type representing chart series configuration.
@@ -66,6 +90,8 @@ export interface ChartSeries {
     fillOpacity?: SubtypeExprOrValue<FloatType>;
     /** Dash pattern for dashed lines (e.g., "5 5") */
     strokeDasharray?: SubtypeExprOrValue<StringType>;
+    /** Y-axis binding (left = primary yAxis, right = secondary yAxis2) */
+    yAxisId?: SubtypeExprOrValue<YAxisIdType> | YAxisIdLiteral;
 }
 export declare function ChartSeries(series: ChartSeries): ExprType<ChartSeriesType>;
 /**
@@ -1732,6 +1758,110 @@ export interface ChartAxis {
     axisId?: SubtypeExprOrValue<StringType>;
 }
 export declare function ChartAxis(axis: ChartAxis): ExprType<typeof ChartAxisType>;
+/**
+ * Type-safe axis configuration interface for chart factories.
+ *
+ * @remarks
+ * This interface provides full axis configuration with type-safe dataKey validation.
+ * Used by chart style interfaces (BarChartStyle, LineChartStyle, etc.) to allow
+ * plain object configuration instead of requiring Chart.Axis() helper.
+ *
+ * @typeParam DataKey - Union of valid field names from the data struct
+ *
+ * @property dataKey - Data key for axis values (type-safe to data field names)
+ * @property label - Axis label text
+ * @property tickFormat - Format for tick values
+ * @property domain - Value range [min, max]
+ * @property hide - Hide the axis entirely
+ * @property axisLine - Show/hide axis line
+ * @property tickLine - Show/hide tick lines
+ * @property tickMargin - Margin between tick and label
+ * @property orientation - Axis position (top/bottom for X, left/right for Y)
+ * @property axisId - Identifier for biaxial charts
+ *
+ * @example
+ * ```ts
+ * // Type-safe - only valid field names allowed for dataKey
+ * const style: BarChartStyle<"month" | "sales"> = {
+ *     xAxis: { dataKey: "month", label: "Month" },
+ *     yAxis: { label: "Sales ($)", tickFormat: "currency" },
+ * };
+ * ```
+ */
+export interface ChartAxisStyle<DataKey extends string = string> {
+    /** Data key for axis values (type-safe to data field names) */
+    dataKey?: DataKey;
+    /** Axis label text */
+    label?: SubtypeExprOrValue<StringType>;
+    /** Format for tick values - use string literals or TickFormat helpers */
+    tickFormat?: SubtypeExprOrValue<TickFormatType> | SimpleTickFormatLiteral;
+    /** Value range [min, max] */
+    domain?: SubtypeExprOrValue<ArrayType<FloatType>>;
+    /** Hide the axis entirely */
+    hide?: SubtypeExprOrValue<BooleanType>;
+    /** Show/hide axis line */
+    axisLine?: SubtypeExprOrValue<BooleanType>;
+    /** Show/hide tick lines */
+    tickLine?: SubtypeExprOrValue<BooleanType>;
+    /** Margin between tick and label */
+    tickMargin?: SubtypeExprOrValue<IntegerType>;
+    /** Axis position (top/bottom for X, left/right for Y) */
+    orientation?: SubtypeExprOrValue<AxisOrientationType> | AxisOrientationLiteral;
+    /** Identifier for biaxial charts (e.g., "left", "right") */
+    axisId?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Type-safe grid configuration interface for chart factories.
+ */
+export interface ChartGridStyle {
+    /** Enable/disable entire grid */
+    show?: SubtypeExprOrValue<BooleanType>;
+    /** Show vertical grid lines */
+    vertical?: SubtypeExprOrValue<BooleanType>;
+    /** Show horizontal grid lines */
+    horizontal?: SubtypeExprOrValue<BooleanType>;
+    /** Grid line color (Chakra color token, e.g., "border.muted") */
+    strokeColor?: SubtypeExprOrValue<StringType>;
+    /** Dash pattern (e.g., "3 3" for dashed lines) */
+    strokeDasharray?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Type-safe tooltip configuration interface for chart factories.
+ */
+export interface ChartTooltipStyle {
+    /** Enable/disable tooltip */
+    show?: SubtypeExprOrValue<BooleanType>;
+    /** Cursor style configuration */
+    cursor?: SubtypeExprOrValue<TooltipCursorType>;
+    /** Animation duration in milliseconds */
+    animationDuration?: SubtypeExprOrValue<IntegerType>;
+}
+/**
+ * Type-safe legend configuration interface for chart factories.
+ */
+export interface ChartLegendStyle {
+    /** Enable/disable legend */
+    show?: SubtypeExprOrValue<BooleanType>;
+    /** Horizontal or vertical arrangement */
+    layout?: SubtypeExprOrValue<LegendLayoutType> | LegendLayoutLiteral;
+    /** Horizontal alignment */
+    align?: SubtypeExprOrValue<LegendAlignType> | LegendAlignLiteral;
+    /** Vertical alignment */
+    verticalAlign?: SubtypeExprOrValue<LegendVerticalAlignType> | LegendVerticalAlignLiteral;
+}
+/**
+ * Type-safe margin configuration interface for chart factories.
+ */
+export interface ChartMarginStyle {
+    /** Top margin in pixels */
+    top?: SubtypeExprOrValue<IntegerType>;
+    /** Right margin in pixels */
+    right?: SubtypeExprOrValue<IntegerType>;
+    /** Bottom margin in pixels */
+    bottom?: SubtypeExprOrValue<IntegerType>;
+    /** Left margin in pixels */
+    left?: SubtypeExprOrValue<IntegerType>;
+}
 /**
  * Base chart dimensions and display options.
  */
@@ -1769,13 +1899,13 @@ export interface ChartMargin {
 export declare function ChartMargin(margin: ChartMargin): ExprType<ChartMarginType>;
 export interface BaseChartStyle {
     /** Grid configuration */
-    grid?: SubtypeExprOrValue<ChartGridType>;
+    grid?: ChartGridStyle;
     /** Tooltip configuration */
-    tooltip?: SubtypeExprOrValue<ChartTooltipType>;
+    tooltip?: ChartTooltipStyle;
     /** Legend configuration */
-    legend?: SubtypeExprOrValue<ChartLegendType>;
+    legend?: ChartLegendStyle;
     /** Chart margin configuration */
-    margin?: SubtypeExprOrValue<ChartMarginType>;
+    margin?: ChartMarginStyle;
     /**
      * Value key for multi-series data (record form).
      * Specifies which field in each series array contains the Y value.
@@ -1827,6 +1957,72 @@ export declare const BaseChartStyleType: StructType<{
         left: OptionType<IntegerType>;
     }>>;
 }>;
+/**
+ * Brush configuration for chart data range selection.
+ *
+ * @remarks
+ * The Brush component allows users to select a range of data to display.
+ * It renders a small preview chart with draggable handles for range selection.
+ * Maps to Recharts Brush component.
+ *
+ * @property dataKey - Data key for brush labels (defaults to xAxis dataKey)
+ * @property height - Brush height in pixels (default: 40)
+ * @property travellerWidth - Width of slider handles in pixels (default: 5)
+ * @property startIndex - Initial start index of selection
+ * @property endIndex - Initial end index of selection
+ * @property stroke - Stroke color for brush area
+ * @property fill - Fill color for brush area
+ */
+export declare const ChartBrushType: StructType<{
+    dataKey: OptionType<StringType>;
+    height: OptionType<IntegerType>;
+    travellerWidth: OptionType<IntegerType>;
+    startIndex: OptionType<IntegerType>;
+    endIndex: OptionType<IntegerType>;
+    stroke: OptionType<StringType>;
+    fill: OptionType<StringType>;
+}>;
+/**
+ * Type representing chart brush configuration.
+ */
+export type ChartBrushType = typeof ChartBrushType;
+/**
+ * Base TypeScript interface for chart brush configuration.
+ *
+ * @remarks
+ * This base interface contains all brush options except dataKey.
+ * Chart-specific interfaces extend this to add type-safe dataKey.
+ *
+ * @property height - Brush height in pixels (default: 40)
+ * @property travellerWidth - Width of slider handles in pixels (default: 5)
+ * @property startIndex - Initial start index of selection
+ * @property endIndex - Initial end index of selection
+ * @property stroke - Stroke color for brush area
+ * @property fill - Fill color for brush area
+ */
+export interface ChartBrushStyleBase {
+    /** Brush height in pixels (default: 40) */
+    height?: SubtypeExprOrValue<IntegerType>;
+    /** Width of slider handles in pixels (default: 5) */
+    travellerWidth?: SubtypeExprOrValue<IntegerType>;
+    /** Initial start index of selection */
+    startIndex?: SubtypeExprOrValue<IntegerType>;
+    /** Initial end index of selection */
+    endIndex?: SubtypeExprOrValue<IntegerType>;
+    /** Stroke color for brush area */
+    stroke?: SubtypeExprOrValue<StringType>;
+    /** Fill color for brush area */
+    fill?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Creates a chart brush configuration.
+ *
+ * @param brush - Brush configuration options
+ * @returns An East expression representing the brush configuration
+ */
+export declare function ChartBrush(brush: ChartBrushStyleBase & {
+    dataKey?: SubtypeExprOrValue<StringType>;
+}): ExprType<ChartBrushType>;
 /**
  * Type for multi-series data storage.
  *
@@ -1844,8 +2040,433 @@ export declare const MultiSeriesDataType: DictType<StringType, ArrayType<DictTyp
     DateTime: import("@elaraai/east").DateTimeType;
     Blob: import("@elaraai/east").BlobType;
 }>>>>;
+/**
+ * Overflow behavior when reference annotation extends beyond chart bounds.
+ *
+ * @property discard - Don't render if outside bounds
+ * @property hidden - Clip at chart boundary
+ * @property visible - Render completely (may overflow)
+ * @property extendDomain - Extend axis domain to include the reference
+ */
+export declare const ReferenceOverflowType: VariantType<{
+    discard: NullType;
+    hidden: NullType;
+    visible: NullType;
+    extendDomain: NullType;
+}>;
+/**
+ * Type representing reference overflow behavior.
+ */
+export type ReferenceOverflowType = typeof ReferenceOverflowType;
+/**
+ * String literal type for reference overflow values.
+ */
+export type ReferenceOverflowLiteral = "discard" | "hidden" | "visible" | "extendDomain";
+/**
+ * Label position options for reference annotations.
+ *
+ * @property top - Above the reference point
+ * @property bottom - Below the reference point
+ * @property left - To the left of the reference point
+ * @property right - To the right of the reference point
+ * @property center - Centered on the reference point
+ * @property insideTop - Inside, at the top
+ * @property insideBottom - Inside, at the bottom
+ * @property insideLeft - Inside, at the left
+ * @property insideRight - Inside, at the right
+ */
+export declare const LabelPositionType: VariantType<{
+    top: NullType;
+    bottom: NullType;
+    left: NullType;
+    right: NullType;
+    center: NullType;
+    insideTop: NullType;
+    insideBottom: NullType;
+    insideLeft: NullType;
+    insideRight: NullType;
+    insideTopLeft: NullType;
+    insideTopRight: NullType;
+    insideBottomLeft: NullType;
+    insideBottomRight: NullType;
+}>;
+/**
+ * Type representing label position.
+ */
+export type LabelPositionType = typeof LabelPositionType;
+/**
+ * String literal type for label position values.
+ */
+export type LabelPositionLiteral = "top" | "bottom" | "left" | "right" | "center" | "insideTop" | "insideBottom" | "insideLeft" | "insideRight" | "insideTopLeft" | "insideTopRight" | "insideBottomLeft" | "insideBottomRight";
+/**
+ * Reference line configuration for charts.
+ *
+ * @remarks
+ * Draws horizontal or vertical lines at specific values to mark
+ * thresholds, targets, or other reference points.
+ * Set `x` for a vertical line, `y` for a horizontal line.
+ *
+ * @property x - X value for vertical line (number or category string)
+ * @property y - Y value for horizontal line (number or category string)
+ * @property stroke - Line color (Chakra color token)
+ * @property strokeWidth - Line width in pixels
+ * @property strokeDasharray - Dash pattern (e.g., "5 5" for dashed)
+ * @property label - Label text for the line
+ * @property ifOverflow - Behavior when line extends beyond bounds
+ */
+export declare const ReferenceLineType: StructType<{
+    x: OptionType<VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>>;
+    y: OptionType<VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>>;
+    stroke: OptionType<StringType>;
+    strokeWidth: OptionType<IntegerType>;
+    strokeDasharray: OptionType<StringType>;
+    label: OptionType<StringType>;
+    labelPosition: OptionType<VariantType<{
+        top: NullType;
+        bottom: NullType;
+        left: NullType;
+        right: NullType;
+        center: NullType;
+        insideTop: NullType;
+        insideBottom: NullType;
+        insideLeft: NullType;
+        insideRight: NullType;
+        insideTopLeft: NullType;
+        insideTopRight: NullType;
+        insideBottomLeft: NullType;
+        insideBottomRight: NullType;
+    }>>;
+    labelOffset: OptionType<IntegerType>;
+    ifOverflow: OptionType<VariantType<{
+        discard: NullType;
+        hidden: NullType;
+        visible: NullType;
+        extendDomain: NullType;
+    }>>;
+}>;
+/**
+ * Type representing reference line configuration.
+ */
+export type ReferenceLineType = typeof ReferenceLineType;
+/**
+ * TypeScript interface for reference line style.
+ */
+/** Coordinate value type for reference annotations (accepts East expressions or literals) */
+export type CoordinateValue = SubtypeExprOrValue<FloatType> | SubtypeExprOrValue<IntegerType> | SubtypeExprOrValue<StringType>;
+export interface ReferenceLineStyle {
+    /** X value for vertical line (number or category string) */
+    x?: CoordinateValue;
+    /** Y value for horizontal line (number or category string) */
+    y?: CoordinateValue;
+    /** Line color (Chakra color token) */
+    stroke?: SubtypeExprOrValue<StringType>;
+    /** Line width in pixels */
+    strokeWidth?: SubtypeExprOrValue<IntegerType>;
+    /** Dash pattern (e.g., "5 5" for dashed) */
+    strokeDasharray?: SubtypeExprOrValue<StringType>;
+    /** Label text for the line */
+    label?: SubtypeExprOrValue<StringType>;
+    /** Label position relative to the line */
+    labelPosition?: SubtypeExprOrValue<LabelPositionType> | LabelPositionLiteral;
+    /** Label offset from the line in pixels */
+    labelOffset?: SubtypeExprOrValue<IntegerType>;
+    /** Behavior when line extends beyond bounds */
+    ifOverflow?: SubtypeExprOrValue<ReferenceOverflowType> | ReferenceOverflowLiteral;
+}
+/**
+ * Reference dot configuration for charts.
+ *
+ * @remarks
+ * Marks a specific point on the chart with a dot.
+ * Both x and y are required to position the dot.
+ *
+ * @property x - X coordinate (number or category string)
+ * @property y - Y coordinate (number or category string)
+ * @property r - Radius of the dot in pixels
+ * @property fill - Fill color (Chakra color token)
+ * @property stroke - Stroke color (Chakra color token)
+ * @property strokeWidth - Stroke width in pixels
+ * @property label - Label text for the dot
+ * @property ifOverflow - Behavior when dot extends beyond bounds
+ */
+export declare const ReferenceDotType: StructType<{
+    x: VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>;
+    y: VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>;
+    r: OptionType<IntegerType>;
+    fill: OptionType<StringType>;
+    stroke: OptionType<StringType>;
+    strokeWidth: OptionType<IntegerType>;
+    label: OptionType<StringType>;
+    labelPosition: OptionType<VariantType<{
+        top: NullType;
+        bottom: NullType;
+        left: NullType;
+        right: NullType;
+        center: NullType;
+        insideTop: NullType;
+        insideBottom: NullType;
+        insideLeft: NullType;
+        insideRight: NullType;
+        insideTopLeft: NullType;
+        insideTopRight: NullType;
+        insideBottomLeft: NullType;
+        insideBottomRight: NullType;
+    }>>;
+    labelOffset: OptionType<IntegerType>;
+    ifOverflow: OptionType<VariantType<{
+        discard: NullType;
+        hidden: NullType;
+        visible: NullType;
+        extendDomain: NullType;
+    }>>;
+}>;
+/**
+ * Type representing reference dot configuration.
+ */
+export type ReferenceDotType = typeof ReferenceDotType;
+/**
+ * TypeScript interface for reference dot style.
+ */
+export interface ReferenceDotStyle {
+    /** X coordinate (required) */
+    x: CoordinateValue;
+    /** Y coordinate (required) */
+    y: CoordinateValue;
+    /** Radius of the dot in pixels */
+    r?: SubtypeExprOrValue<IntegerType>;
+    /** Fill color (Chakra color token) */
+    fill?: SubtypeExprOrValue<StringType>;
+    /** Stroke color (Chakra color token) */
+    stroke?: SubtypeExprOrValue<StringType>;
+    /** Stroke width in pixels */
+    strokeWidth?: SubtypeExprOrValue<IntegerType>;
+    /** Label text for the dot */
+    label?: SubtypeExprOrValue<StringType>;
+    /** Label position relative to the dot */
+    labelPosition?: SubtypeExprOrValue<LabelPositionType> | LabelPositionLiteral;
+    /** Label offset from the dot in pixels */
+    labelOffset?: SubtypeExprOrValue<IntegerType>;
+    /** Behavior when dot extends beyond bounds */
+    ifOverflow?: SubtypeExprOrValue<ReferenceOverflowType> | ReferenceOverflowLiteral;
+}
+/**
+ * Reference area configuration for charts.
+ *
+ * @remarks
+ * Highlights a rectangular region on the chart to mark zones,
+ * ranges, or bands. Omitting a bound means it extends to the axis edge.
+ *
+ * @property x1 - Left bound (omit = start of x-axis)
+ * @property x2 - Right bound (omit = end of x-axis)
+ * @property y1 - Bottom bound (omit = start of y-axis)
+ * @property y2 - Top bound (omit = end of y-axis)
+ * @property fill - Fill color (Chakra color token)
+ * @property fillOpacity - Fill opacity (0-1)
+ * @property stroke - Stroke color (Chakra color token)
+ * @property label - Label text for the area
+ * @property ifOverflow - Behavior when area extends beyond bounds
+ */
+export declare const ReferenceAreaType: StructType<{
+    x1: OptionType<VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>>;
+    x2: OptionType<VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>>;
+    y1: OptionType<VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>>;
+    y2: OptionType<VariantType<{
+        Null: NullType;
+        Boolean: BooleanType;
+        Integer: IntegerType;
+        Float: FloatType;
+        String: StringType;
+        DateTime: import("@elaraai/east").DateTimeType;
+        Blob: import("@elaraai/east").BlobType;
+    }>>;
+    fill: OptionType<StringType>;
+    fillOpacity: OptionType<FloatType>;
+    stroke: OptionType<StringType>;
+    label: OptionType<StringType>;
+    labelPosition: OptionType<VariantType<{
+        top: NullType;
+        bottom: NullType;
+        left: NullType;
+        right: NullType;
+        center: NullType;
+        insideTop: NullType;
+        insideBottom: NullType;
+        insideLeft: NullType;
+        insideRight: NullType;
+        insideTopLeft: NullType;
+        insideTopRight: NullType;
+        insideBottomLeft: NullType;
+        insideBottomRight: NullType;
+    }>>;
+    labelOffset: OptionType<IntegerType>;
+    ifOverflow: OptionType<VariantType<{
+        discard: NullType;
+        hidden: NullType;
+        visible: NullType;
+        extendDomain: NullType;
+    }>>;
+}>;
+/**
+ * Type representing reference area configuration.
+ */
+export type ReferenceAreaType = typeof ReferenceAreaType;
+/**
+ * TypeScript interface for reference area style.
+ */
+export interface ReferenceAreaStyle {
+    /** Left bound (omit = start of x-axis) */
+    x1?: CoordinateValue;
+    /** Right bound (omit = end of x-axis) */
+    x2?: CoordinateValue;
+    /** Bottom bound (omit = start of y-axis) */
+    y1?: CoordinateValue;
+    /** Top bound (omit = end of y-axis) */
+    y2?: CoordinateValue;
+    /** Fill color (Chakra color token) */
+    fill?: SubtypeExprOrValue<StringType>;
+    /** Fill opacity (0-1) */
+    fillOpacity?: SubtypeExprOrValue<FloatType>;
+    /** Stroke color (Chakra color token) */
+    stroke?: SubtypeExprOrValue<StringType>;
+    /** Label text for the area */
+    label?: SubtypeExprOrValue<StringType>;
+    /** Label position within the area */
+    labelPosition?: SubtypeExprOrValue<LabelPositionType> | LabelPositionLiteral;
+    /** Label offset in pixels */
+    labelOffset?: SubtypeExprOrValue<IntegerType>;
+    /** Behavior when area extends beyond bounds */
+    ifOverflow?: SubtypeExprOrValue<ReferenceOverflowType> | ReferenceOverflowLiteral;
+}
 /**
  * Type representing multi-series data.
  */
 export type MultiSeriesDataType = typeof MultiSeriesDataType;
+/**
+ * Converts a ChartAxisStyle plain object to a ChartAxisType expression.
+ *
+ * @param axis - The axis style configuration
+ * @returns An expression representing the axis configuration, or undefined if axis is undefined
+ *
+ * @internal
+ */
+export declare function axisStyleToType(axis: ChartAxisStyle | undefined): ExprType<ChartAxisType> | undefined;
+/**
+ * Converts a ChartGridStyle plain object to a ChartGridType expression.
+ *
+ * @param grid - The grid style configuration
+ * @returns An expression representing the grid configuration, or undefined if grid is undefined
+ *
+ * @internal
+ */
+export declare function gridStyleToType(grid: ChartGridStyle | undefined): ExprType<ChartGridType> | undefined;
+/**
+ * Converts a ChartTooltipStyle plain object to a ChartTooltipType expression.
+ *
+ * @param tooltip - The tooltip style configuration
+ * @returns An expression representing the tooltip configuration, or undefined if tooltip is undefined
+ *
+ * @internal
+ */
+export declare function tooltipStyleToType(tooltip: ChartTooltipStyle | undefined): ExprType<ChartTooltipType> | undefined;
+/**
+ * Converts a ChartLegendStyle plain object to a ChartLegendType expression.
+ *
+ * @param legend - The legend style configuration
+ * @returns An expression representing the legend configuration, or undefined if legend is undefined
+ *
+ * @internal
+ */
+export declare function legendStyleToType(legend: ChartLegendStyle | undefined): ExprType<ChartLegendType> | undefined;
+/**
+ * Converts a ChartMarginStyle plain object to a ChartMarginType expression.
+ *
+ * @param margin - The margin style configuration
+ * @returns An expression representing the margin configuration, or undefined if margin is undefined
+ *
+ * @internal
+ */
+export declare function marginStyleToType(margin: ChartMarginStyle | undefined): ExprType<ChartMarginType> | undefined;
+/**
+ * Converts a ReferenceLineStyle to a ReferenceLineType expression.
+ *
+ * @param line - The reference line style
+ * @returns An expression representing the reference line
+ *
+ * @internal
+ */
+export declare function referenceLineStyleToType(line: ReferenceLineStyle): ExprType<ReferenceLineType>;
+/**
+ * Converts a ReferenceDotStyle to a ReferenceDotType expression.
+ *
+ * @param dot - The reference dot style
+ * @returns An expression representing the reference dot
+ *
+ * @internal
+ */
+export declare function referenceDotStyleToType(dot: ReferenceDotStyle): ExprType<ReferenceDotType>;
+/**
+ * Converts a ReferenceAreaStyle to a ReferenceAreaType expression.
+ *
+ * @param area - The reference area style
+ * @returns An expression representing the reference area
+ *
+ * @internal
+ */
+export declare function referenceAreaStyleToType(area: ReferenceAreaStyle): ExprType<ReferenceAreaType>;
 //# sourceMappingURL=types.d.ts.map