@tuicomponents/chart 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,2165 @@
+import * as zod from 'zod';
+import { z } from 'zod';
+import { BaseTuiComponent, ComponentMetadata, RenderContext, RenderResult, TuiTheme } from '@tuicomponents/core';
+
+/**
+ * Zod schemas for chart input validation.
+ */
+
+/**
+ * Chart type variants.
+ */
+declare const chartTypeSchema: z.ZodEnum<["bar", "bar-vertical", "bar-stacked", "bar-stacked-vertical", "line", "area", "area-stacked", "scatter", "pie", "donut", "heatmap"]>;
+/**
+ * Style options for bar fill.
+ */
+declare const barStyleSchema: z.ZodEnum<["block", "shaded", "light", "hash", "equals", "arrow"]>;
+/**
+ * Style options for line rendering.
+ */
+declare const lineStyleSchema: z.ZodEnum<["blocks", "braille", "dots"]>;
+/**
+ * Style options for scatter plot rendering.
+ */
+declare const scatterStyleSchema: z.ZodEnum<["dots", "braille"]>;
+/**
+ * Marker shapes for scatter plot series distinction.
+ */
+declare const scatterMarkerSchema: z.ZodEnum<["circle", "square", "triangle", "diamond", "plus"]>;
+/**
+ * Style options for heatmap rendering.
+ */
+declare const heatmapStyleSchema: z.ZodEnum<["blocks", "ascii", "numeric"]>;
+/**
+ * Value format options.
+ */
+declare const valueFormatSchema: z.ZodEnum<["number", "percent", "compact", "currency"]>;
+/**
+ * Legend position options.
+ */
+declare const legendPositionSchema: z.ZodEnum<["none", "top", "bottom", "right", "inline"]>;
+/**
+ * A single data point in a chart.
+ */
+declare const dataPointSchema: z.ZodObject<{
+    /**
+     * Category or x-value.
+     * Can be a string (categorical) or number (continuous).
+     */
+    x: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    /**
+     * Numeric y-value.
+     */
+    y: z.ZodNumber;
+    /**
+     * Optional custom label for this data point.
+     */
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    x: string | number;
+    y: number;
+    label?: string | undefined;
+}, {
+    x: string | number;
+    y: number;
+    label?: string | undefined;
+}>;
+/**
+ * A series of data points.
+ */
+declare const dataSeriesSchema: z.ZodObject<{
+    /**
+     * Series name (used in legend).
+     */
+    name: z.ZodString;
+    /**
+     * Data points in this series.
+     */
+    data: z.ZodArray<z.ZodObject<{
+        /**
+         * Category or x-value.
+         * Can be a string (categorical) or number (continuous).
+         */
+        x: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        /**
+         * Numeric y-value.
+         */
+        y: z.ZodNumber;
+        /**
+         * Optional custom label for this data point.
+         */
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        x: string | number;
+        y: number;
+        label?: string | undefined;
+    }, {
+        x: string | number;
+        y: number;
+        label?: string | undefined;
+    }>, "many">;
+    /**
+     * Optional style for this series.
+     */
+    style: z.ZodOptional<z.ZodEnum<["block", "shaded", "light", "hash", "equals", "arrow"]>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    data: {
+        x: string | number;
+        y: number;
+        label?: string | undefined;
+    }[];
+    style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+}, {
+    name: string;
+    data: {
+        x: string | number;
+        y: number;
+        label?: string | undefined;
+    }[];
+    style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+}>;
+/**
+ * Axis configuration.
+ */
+declare const axisConfigSchema: z.ZodObject<{
+    /**
+     * Axis title/label.
+     */
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * Explicit minimum value (auto-computed if not set).
+     */
+    min: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Explicit maximum value (auto-computed if not set).
+     */
+    max: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Number of tick marks.
+     * @default 5
+     */
+    tickCount: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Whether to show tick marks.
+     * @default true
+     */
+    showTicks: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Value format for tick labels.
+     * @default "number"
+     */
+    format: z.ZodDefault<z.ZodEnum<["number", "percent", "compact", "currency"]>>;
+    /**
+     * Number of decimal places.
+     */
+    decimals: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tickCount: number;
+    showTicks: boolean;
+    format: "number" | "percent" | "compact" | "currency";
+    label?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    decimals?: number | undefined;
+}, {
+    label?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    tickCount?: number | undefined;
+    showTicks?: boolean | undefined;
+    format?: "number" | "percent" | "compact" | "currency" | undefined;
+    decimals?: number | undefined;
+}>;
+/**
+ * Legend configuration.
+ */
+declare const legendConfigSchema: z.ZodObject<{
+    /**
+     * Legend position.
+     * @default "bottom"
+     */
+    position: z.ZodDefault<z.ZodEnum<["none", "top", "bottom", "right", "inline"]>>;
+    /**
+     * Whether to use boxed style.
+     * @default false
+     */
+    boxed: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    position: "none" | "top" | "bottom" | "right" | "inline";
+    boxed: boolean;
+}, {
+    position?: "none" | "top" | "bottom" | "right" | "inline" | undefined;
+    boxed?: boolean | undefined;
+}>;
+/**
+ * Grid configuration.
+ */
+declare const gridConfigSchema: z.ZodObject<{
+    /**
+     * Show horizontal grid lines.
+     * @default false
+     */
+    horizontal: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Show vertical grid lines.
+     * @default false
+     */
+    vertical: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Grid character.
+     * @default "·"
+     */
+    char: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    horizontal: boolean;
+    vertical: boolean;
+    char: string;
+}, {
+    horizontal?: boolean | undefined;
+    vertical?: boolean | undefined;
+    char?: string | undefined;
+}>;
+/**
+ * Main chart input schema.
+ */
+declare const chartInputSchema: z.ZodObject<{
+    /**
+     * Chart type.
+     */
+    type: z.ZodEnum<["bar", "bar-vertical", "bar-stacked", "bar-stacked-vertical", "line", "area", "area-stacked", "scatter", "pie", "donut", "heatmap"]>;
+    /**
+     * Data series to display.
+     */
+    series: z.ZodArray<z.ZodObject<{
+        /**
+         * Series name (used in legend).
+         */
+        name: z.ZodString;
+        /**
+         * Data points in this series.
+         */
+        data: z.ZodArray<z.ZodObject<{
+            /**
+             * Category or x-value.
+             * Can be a string (categorical) or number (continuous).
+             */
+            x: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            /**
+             * Numeric y-value.
+             */
+            y: z.ZodNumber;
+            /**
+             * Optional custom label for this data point.
+             */
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            x: string | number;
+            y: number;
+            label?: string | undefined;
+        }, {
+            x: string | number;
+            y: number;
+            label?: string | undefined;
+        }>, "many">;
+        /**
+         * Optional style for this series.
+         */
+        style: z.ZodOptional<z.ZodEnum<["block", "shaded", "light", "hash", "equals", "arrow"]>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        data: {
+            x: string | number;
+            y: number;
+            label?: string | undefined;
+        }[];
+        style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+    }, {
+        name: string;
+        data: {
+            x: string | number;
+            y: number;
+            label?: string | undefined;
+        }[];
+        style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+    }>, "many">;
+    /**
+     * Chart title.
+     */
+    title: z.ZodOptional<z.ZodString>;
+    /**
+     * X-axis configuration.
+     */
+    xAxis: z.ZodOptional<z.ZodObject<{
+        /**
+         * Axis title/label.
+         */
+        label: z.ZodOptional<z.ZodString>;
+        /**
+         * Explicit minimum value (auto-computed if not set).
+         */
+        min: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Explicit maximum value (auto-computed if not set).
+         */
+        max: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Number of tick marks.
+         * @default 5
+         */
+        tickCount: z.ZodDefault<z.ZodNumber>;
+        /**
+         * Whether to show tick marks.
+         * @default true
+         */
+        showTicks: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Value format for tick labels.
+         * @default "number"
+         */
+        format: z.ZodDefault<z.ZodEnum<["number", "percent", "compact", "currency"]>>;
+        /**
+         * Number of decimal places.
+         */
+        decimals: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        tickCount: number;
+        showTicks: boolean;
+        format: "number" | "percent" | "compact" | "currency";
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        decimals?: number | undefined;
+    }, {
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        tickCount?: number | undefined;
+        showTicks?: boolean | undefined;
+        format?: "number" | "percent" | "compact" | "currency" | undefined;
+        decimals?: number | undefined;
+    }>>;
+    /**
+     * Y-axis configuration.
+     */
+    yAxis: z.ZodOptional<z.ZodObject<{
+        /**
+         * Axis title/label.
+         */
+        label: z.ZodOptional<z.ZodString>;
+        /**
+         * Explicit minimum value (auto-computed if not set).
+         */
+        min: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Explicit maximum value (auto-computed if not set).
+         */
+        max: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Number of tick marks.
+         * @default 5
+         */
+        tickCount: z.ZodDefault<z.ZodNumber>;
+        /**
+         * Whether to show tick marks.
+         * @default true
+         */
+        showTicks: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Value format for tick labels.
+         * @default "number"
+         */
+        format: z.ZodDefault<z.ZodEnum<["number", "percent", "compact", "currency"]>>;
+        /**
+         * Number of decimal places.
+         */
+        decimals: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        tickCount: number;
+        showTicks: boolean;
+        format: "number" | "percent" | "compact" | "currency";
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        decimals?: number | undefined;
+    }, {
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        tickCount?: number | undefined;
+        showTicks?: boolean | undefined;
+        format?: "number" | "percent" | "compact" | "currency" | undefined;
+        decimals?: number | undefined;
+    }>>;
+    /**
+     * Legend configuration.
+     */
+    legend: z.ZodOptional<z.ZodObject<{
+        /**
+         * Legend position.
+         * @default "bottom"
+         */
+        position: z.ZodDefault<z.ZodEnum<["none", "top", "bottom", "right", "inline"]>>;
+        /**
+         * Whether to use boxed style.
+         * @default false
+         */
+        boxed: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        position: "none" | "top" | "bottom" | "right" | "inline";
+        boxed: boolean;
+    }, {
+        position?: "none" | "top" | "bottom" | "right" | "inline" | undefined;
+        boxed?: boolean | undefined;
+    }>>;
+    /**
+     * Grid configuration.
+     */
+    grid: z.ZodOptional<z.ZodObject<{
+        /**
+         * Show horizontal grid lines.
+         * @default false
+         */
+        horizontal: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Show vertical grid lines.
+         * @default false
+         */
+        vertical: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Grid character.
+         * @default "·"
+         */
+        char: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        horizontal: boolean;
+        vertical: boolean;
+        char: string;
+    }, {
+        horizontal?: boolean | undefined;
+        vertical?: boolean | undefined;
+        char?: string | undefined;
+    }>>;
+    /**
+     * Chart width in characters.
+     * @default 40
+     */
+    width: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Chart height in lines.
+     * @default 10
+     */
+    height: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Show values on data points.
+     * @default false
+     */
+    showValues: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Show axes.
+     * @default true
+     */
+    showAxes: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Line/area rendering style.
+     * @default "blocks"
+     */
+    lineStyle: z.ZodDefault<z.ZodEnum<["blocks", "braille", "dots"]>>;
+    /**
+     * Default bar style for series without explicit style.
+     * @default "block"
+     */
+    barStyle: z.ZodDefault<z.ZodEnum<["block", "shaded", "light", "hash", "equals", "arrow"]>>;
+    /**
+     * Scatter plot rendering style.
+     * @default "dots"
+     */
+    scatterStyle: z.ZodDefault<z.ZodEnum<["dots", "braille"]>>;
+    /**
+     * Heatmap rendering style.
+     * @default "blocks"
+     */
+    heatmapStyle: z.ZodDefault<z.ZodEnum<["blocks", "ascii", "numeric"]>>;
+    /**
+     * Center label for donut charts.
+     * Displayed in the center of the donut.
+     */
+    centerLabel: z.ZodOptional<z.ZodString>;
+    /**
+     * Inner radius ratio for donut charts (0-0.9).
+     * 0 = pie chart, 0.5 = typical donut.
+     * @default 0.5
+     */
+    innerRadius: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "bar" | "bar-vertical" | "bar-stacked" | "bar-stacked-vertical" | "line" | "area" | "area-stacked" | "scatter" | "pie" | "donut" | "heatmap";
+    series: {
+        name: string;
+        data: {
+            x: string | number;
+            y: number;
+            label?: string | undefined;
+        }[];
+        style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+    }[];
+    width: number;
+    height: number;
+    showValues: boolean;
+    showAxes: boolean;
+    lineStyle: "blocks" | "braille" | "dots";
+    barStyle: "block" | "shaded" | "light" | "hash" | "equals" | "arrow";
+    scatterStyle: "braille" | "dots";
+    heatmapStyle: "blocks" | "ascii" | "numeric";
+    innerRadius: number;
+    title?: string | undefined;
+    xAxis?: {
+        tickCount: number;
+        showTicks: boolean;
+        format: "number" | "percent" | "compact" | "currency";
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        decimals?: number | undefined;
+    } | undefined;
+    yAxis?: {
+        tickCount: number;
+        showTicks: boolean;
+        format: "number" | "percent" | "compact" | "currency";
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        decimals?: number | undefined;
+    } | undefined;
+    legend?: {
+        position: "none" | "top" | "bottom" | "right" | "inline";
+        boxed: boolean;
+    } | undefined;
+    grid?: {
+        horizontal: boolean;
+        vertical: boolean;
+        char: string;
+    } | undefined;
+    centerLabel?: string | undefined;
+}, {
+    type: "bar" | "bar-vertical" | "bar-stacked" | "bar-stacked-vertical" | "line" | "area" | "area-stacked" | "scatter" | "pie" | "donut" | "heatmap";
+    series: {
+        name: string;
+        data: {
+            x: string | number;
+            y: number;
+            label?: string | undefined;
+        }[];
+        style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+    }[];
+    title?: string | undefined;
+    xAxis?: {
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        tickCount?: number | undefined;
+        showTicks?: boolean | undefined;
+        format?: "number" | "percent" | "compact" | "currency" | undefined;
+        decimals?: number | undefined;
+    } | undefined;
+    yAxis?: {
+        label?: string | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        tickCount?: number | undefined;
+        showTicks?: boolean | undefined;
+        format?: "number" | "percent" | "compact" | "currency" | undefined;
+        decimals?: number | undefined;
+    } | undefined;
+    legend?: {
+        position?: "none" | "top" | "bottom" | "right" | "inline" | undefined;
+        boxed?: boolean | undefined;
+    } | undefined;
+    grid?: {
+        horizontal?: boolean | undefined;
+        vertical?: boolean | undefined;
+        char?: string | undefined;
+    } | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    showValues?: boolean | undefined;
+    showAxes?: boolean | undefined;
+    lineStyle?: "blocks" | "braille" | "dots" | undefined;
+    barStyle?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+    scatterStyle?: "braille" | "dots" | undefined;
+    heatmapStyle?: "blocks" | "ascii" | "numeric" | undefined;
+    centerLabel?: string | undefined;
+    innerRadius?: number | undefined;
+}>;
+
+/**
+ * Shared TypeScript types for the chart system.
+ */
+
+/**
+ * Chart type variants.
+ */
+type ChartType = z.infer<typeof chartTypeSchema>;
+/**
+ * Style options for bar fill characters.
+ */
+type BarStyle = z.infer<typeof barStyleSchema>;
+/**
+ * Style options for line rendering.
+ */
+type LineStyle = z.infer<typeof lineStyleSchema>;
+/**
+ * Value format options for axis labels.
+ */
+type ValueFormat = z.infer<typeof valueFormatSchema>;
+/**
+ * Style options for scatter plot rendering.
+ */
+type ScatterStyle = z.infer<typeof scatterStyleSchema>;
+/**
+ * Marker shapes for scatter plot series.
+ */
+type ScatterMarker = z.infer<typeof scatterMarkerSchema>;
+/**
+ * Style options for heatmap rendering.
+ */
+type HeatmapStyle = z.infer<typeof heatmapStyleSchema>;
+/**
+ * A single data point in a chart.
+ */
+type DataPoint = z.infer<typeof dataPointSchema>;
+/**
+ * A series of data points with styling.
+ */
+type DataSeries = z.infer<typeof dataSeriesSchema>;
+/**
+ * Axis configuration.
+ */
+type AxisConfig = z.infer<typeof axisConfigSchema>;
+/**
+ * Legend configuration.
+ */
+type LegendConfig = z.infer<typeof legendConfigSchema>;
+/**
+ * Grid configuration.
+ */
+type GridConfig = z.infer<typeof gridConfigSchema>;
+/**
+ * Chart input (before defaults applied).
+ */
+type ChartInput = z.input<typeof chartInputSchema>;
+/**
+ * Chart input with defaults applied.
+ */
+type ChartInputWithDefaults = z.output<typeof chartInputSchema>;
+/**
+ * Computed layout for a single bar.
+ */
+interface BarLayout {
+    /** Series index */
+    seriesIndex: number;
+    /** Data point index within series */
+    pointIndex: number;
+    /** Category label or x value */
+    label: string;
+    /** Numeric value */
+    value: number;
+    /** Scaled bar length (in characters) */
+    length: number;
+    /** Formatted value string */
+    formattedValue: string;
+    /** Bar fill character */
+    barChar: string;
+    /** Whether to use backticks for markdown */
+    useBackticks: boolean;
+    /** Percentage of max (0-100) */
+    percentage: number;
+}
+/**
+ * Computed layout for stacked bars at a single category.
+ */
+interface StackedBarLayout {
+    /** Category label */
+    label: string;
+    /** Segments from bottom to top */
+    segments: BarLayout[];
+    /** Total value */
+    total: number;
+}
+/**
+ * Computed layout for a line chart row.
+ */
+interface LineRowLayout {
+    /** Y-axis label for this row (optional) */
+    yLabel?: string;
+    /** Characters for each column */
+    chars: string[];
+    /** Whether each column uses backticks */
+    useBackticks: boolean[];
+}
+/**
+ * Computed layout for the entire chart.
+ */
+interface ChartLayout {
+    /** Chart type */
+    type: ChartType;
+    /** Width of chart area (characters) */
+    width: number;
+    /** Height of chart area (lines) */
+    height: number;
+    /** Y-axis label width (for alignment) */
+    yAxisWidth: number;
+    /** Whether to show axes */
+    showAxes: boolean;
+    /** Content rows (from top to bottom) */
+    rows: string[][];
+    /** Title line (if present) */
+    title?: string;
+}
+
+/**
+ * Chart component for rendering various chart types.
+ */
+declare class ChartComponent extends BaseTuiComponent<ChartInput, typeof chartInputSchema> {
+    readonly metadata: ComponentMetadata<ChartInput>;
+    readonly schema: zod.ZodObject<{
+        type: zod.ZodEnum<["bar", "bar-vertical", "bar-stacked", "bar-stacked-vertical", "line", "area", "area-stacked", "scatter", "pie", "donut", "heatmap"]>;
+        series: zod.ZodArray<zod.ZodObject<{
+            name: zod.ZodString;
+            data: zod.ZodArray<zod.ZodObject<{
+                x: zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>;
+                y: zod.ZodNumber;
+                label: zod.ZodOptional<zod.ZodString>;
+            }, "strip", zod.ZodTypeAny, {
+                x: string | number;
+                y: number;
+                label?: string | undefined;
+            }, {
+                x: string | number;
+                y: number;
+                label?: string | undefined;
+            }>, "many">;
+            style: zod.ZodOptional<zod.ZodEnum<["block", "shaded", "light", "hash", "equals", "arrow"]>>;
+        }, "strip", zod.ZodTypeAny, {
+            name: string;
+            data: {
+                x: string | number;
+                y: number;
+                label?: string | undefined;
+            }[];
+            style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+        }, {
+            name: string;
+            data: {
+                x: string | number;
+                y: number;
+                label?: string | undefined;
+            }[];
+            style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+        }>, "many">;
+        title: zod.ZodOptional<zod.ZodString>;
+        xAxis: zod.ZodOptional<zod.ZodObject<{
+            label: zod.ZodOptional<zod.ZodString>;
+            min: zod.ZodOptional<zod.ZodNumber>;
+            max: zod.ZodOptional<zod.ZodNumber>;
+            tickCount: zod.ZodDefault<zod.ZodNumber>;
+            showTicks: zod.ZodDefault<zod.ZodBoolean>;
+            format: zod.ZodDefault<zod.ZodEnum<["number", "percent", "compact", "currency"]>>;
+            decimals: zod.ZodOptional<zod.ZodNumber>;
+        }, "strip", zod.ZodTypeAny, {
+            tickCount: number;
+            showTicks: boolean;
+            format: "number" | "percent" | "compact" | "currency";
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            decimals?: number | undefined;
+        }, {
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            tickCount?: number | undefined;
+            showTicks?: boolean | undefined;
+            format?: "number" | "percent" | "compact" | "currency" | undefined;
+            decimals?: number | undefined;
+        }>>;
+        yAxis: zod.ZodOptional<zod.ZodObject<{
+            label: zod.ZodOptional<zod.ZodString>;
+            min: zod.ZodOptional<zod.ZodNumber>;
+            max: zod.ZodOptional<zod.ZodNumber>;
+            tickCount: zod.ZodDefault<zod.ZodNumber>;
+            showTicks: zod.ZodDefault<zod.ZodBoolean>;
+            format: zod.ZodDefault<zod.ZodEnum<["number", "percent", "compact", "currency"]>>;
+            decimals: zod.ZodOptional<zod.ZodNumber>;
+        }, "strip", zod.ZodTypeAny, {
+            tickCount: number;
+            showTicks: boolean;
+            format: "number" | "percent" | "compact" | "currency";
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            decimals?: number | undefined;
+        }, {
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            tickCount?: number | undefined;
+            showTicks?: boolean | undefined;
+            format?: "number" | "percent" | "compact" | "currency" | undefined;
+            decimals?: number | undefined;
+        }>>;
+        legend: zod.ZodOptional<zod.ZodObject<{
+            position: zod.ZodDefault<zod.ZodEnum<["none", "top", "bottom", "right", "inline"]>>;
+            boxed: zod.ZodDefault<zod.ZodBoolean>;
+        }, "strip", zod.ZodTypeAny, {
+            position: "none" | "top" | "bottom" | "right" | "inline";
+            boxed: boolean;
+        }, {
+            position?: "none" | "top" | "bottom" | "right" | "inline" | undefined;
+            boxed?: boolean | undefined;
+        }>>;
+        grid: zod.ZodOptional<zod.ZodObject<{
+            horizontal: zod.ZodDefault<zod.ZodBoolean>;
+            vertical: zod.ZodDefault<zod.ZodBoolean>;
+            char: zod.ZodDefault<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            horizontal: boolean;
+            vertical: boolean;
+            char: string;
+        }, {
+            horizontal?: boolean | undefined;
+            vertical?: boolean | undefined;
+            char?: string | undefined;
+        }>>;
+        width: zod.ZodDefault<zod.ZodNumber>;
+        height: zod.ZodDefault<zod.ZodNumber>;
+        showValues: zod.ZodDefault<zod.ZodBoolean>;
+        showAxes: zod.ZodDefault<zod.ZodBoolean>;
+        lineStyle: zod.ZodDefault<zod.ZodEnum<["blocks", "braille", "dots"]>>;
+        barStyle: zod.ZodDefault<zod.ZodEnum<["block", "shaded", "light", "hash", "equals", "arrow"]>>;
+        scatterStyle: zod.ZodDefault<zod.ZodEnum<["dots", "braille"]>>;
+        heatmapStyle: zod.ZodDefault<zod.ZodEnum<["blocks", "ascii", "numeric"]>>;
+        centerLabel: zod.ZodOptional<zod.ZodString>;
+        innerRadius: zod.ZodDefault<zod.ZodNumber>;
+    }, "strip", zod.ZodTypeAny, {
+        type: "bar" | "bar-vertical" | "bar-stacked" | "bar-stacked-vertical" | "line" | "area" | "area-stacked" | "scatter" | "pie" | "donut" | "heatmap";
+        series: {
+            name: string;
+            data: {
+                x: string | number;
+                y: number;
+                label?: string | undefined;
+            }[];
+            style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+        }[];
+        width: number;
+        height: number;
+        showValues: boolean;
+        showAxes: boolean;
+        lineStyle: "blocks" | "braille" | "dots";
+        barStyle: "block" | "shaded" | "light" | "hash" | "equals" | "arrow";
+        scatterStyle: "braille" | "dots";
+        heatmapStyle: "blocks" | "ascii" | "numeric";
+        innerRadius: number;
+        title?: string | undefined;
+        xAxis?: {
+            tickCount: number;
+            showTicks: boolean;
+            format: "number" | "percent" | "compact" | "currency";
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            decimals?: number | undefined;
+        } | undefined;
+        yAxis?: {
+            tickCount: number;
+            showTicks: boolean;
+            format: "number" | "percent" | "compact" | "currency";
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            decimals?: number | undefined;
+        } | undefined;
+        legend?: {
+            position: "none" | "top" | "bottom" | "right" | "inline";
+            boxed: boolean;
+        } | undefined;
+        grid?: {
+            horizontal: boolean;
+            vertical: boolean;
+            char: string;
+        } | undefined;
+        centerLabel?: string | undefined;
+    }, {
+        type: "bar" | "bar-vertical" | "bar-stacked" | "bar-stacked-vertical" | "line" | "area" | "area-stacked" | "scatter" | "pie" | "donut" | "heatmap";
+        series: {
+            name: string;
+            data: {
+                x: string | number;
+                y: number;
+                label?: string | undefined;
+            }[];
+            style?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+        }[];
+        title?: string | undefined;
+        xAxis?: {
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            tickCount?: number | undefined;
+            showTicks?: boolean | undefined;
+            format?: "number" | "percent" | "compact" | "currency" | undefined;
+            decimals?: number | undefined;
+        } | undefined;
+        yAxis?: {
+            label?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            tickCount?: number | undefined;
+            showTicks?: boolean | undefined;
+            format?: "number" | "percent" | "compact" | "currency" | undefined;
+            decimals?: number | undefined;
+        } | undefined;
+        legend?: {
+            position?: "none" | "top" | "bottom" | "right" | "inline" | undefined;
+            boxed?: boolean | undefined;
+        } | undefined;
+        grid?: {
+            horizontal?: boolean | undefined;
+            vertical?: boolean | undefined;
+            char?: string | undefined;
+        } | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        showValues?: boolean | undefined;
+        showAxes?: boolean | undefined;
+        lineStyle?: "blocks" | "braille" | "dots" | undefined;
+        barStyle?: "block" | "shaded" | "light" | "hash" | "equals" | "arrow" | undefined;
+        scatterStyle?: "braille" | "dots" | undefined;
+        heatmapStyle?: "blocks" | "ascii" | "numeric" | undefined;
+        centerLabel?: string | undefined;
+        innerRadius?: number | undefined;
+    }>;
+    getJsonSchema(): object;
+    render(input: ChartInput, context: RenderContext): RenderResult;
+}
+/**
+ * Factory function to create a chart component.
+ */
+declare function createChart(): ChartComponent;
+
+/**
+ * Auto-scaling and nice number algorithms for axis ticks.
+ *
+ * Implements the standard D3.js-style nice interval algorithm
+ * for producing human-readable axis tick values.
+ */
+/**
+ * Configuration for nice number computation.
+ */
+interface NiceTicksOptions {
+    /** Minimum data value */
+    dataMin: number;
+    /** Maximum data value */
+    dataMax: number;
+    /** Desired number of ticks (default: 5) */
+    tickCount?: number | undefined;
+    /** Whether to include zero if data is all positive (default: true) */
+    includeZero?: boolean | undefined;
+    /** Explicit minimum (overrides computed) */
+    forceMin?: number | undefined;
+    /** Explicit maximum (overrides computed) */
+    forceMax?: number | undefined;
+}
+/**
+ * Result from nice tick computation.
+ */
+interface NiceTicksResult {
+    /** Computed nice minimum */
+    min: number;
+    /** Computed nice maximum */
+    max: number;
+    /** Tick step size */
+    step: number;
+    /** Array of tick values */
+    ticks: number[];
+}
+/**
+ * Compute nice axis ticks for a data range.
+ *
+ * This implements the standard algorithm for producing readable tick values:
+ * 1. Compute raw step from range and desired tick count
+ * 2. Round step to a nice interval (1, 2, 2.5, 5, 10 × 10^n)
+ * 3. Round min/max to nice boundaries
+ * 4. Generate evenly spaced tick values
+ *
+ * @param options - Configuration options
+ * @returns Computed ticks with nice min/max/step
+ *
+ * @example
+ * ```ts
+ * computeNiceTicks({ dataMin: 3, dataMax: 97 })
+ * // Returns { min: 0, max: 100, step: 20, ticks: [0, 20, 40, 60, 80, 100] }
+ *
+ * computeNiceTicks({ dataMin: 0.003, dataMax: 0.097, tickCount: 4 })
+ * // Returns { min: 0, max: 0.1, step: 0.025, ticks: [0, 0.025, 0.05, 0.075, 0.1] }
+ * ```
+ */
+declare function computeNiceTicks(options: NiceTicksOptions): NiceTicksResult;
+/**
+ * Format a tick value for display.
+ *
+ * @param value - Numeric value
+ * @param format - Format type
+ * @param decimals - Number of decimal places
+ * @returns Formatted string
+ */
+declare function formatTickValue(value: number, format?: "number" | "percent" | "compact" | "currency", decimals?: number): string;
+/**
+ * Compute the scale factor to map a value to a pixel position.
+ *
+ * @param value - Data value
+ * @param min - Scale minimum
+ * @param max - Scale maximum
+ * @param size - Available size (pixels/characters)
+ * @returns Position in range [0, size]
+ */
+declare function scaleValue(value: number, min: number, max: number, size: number): number;
+/**
+ * Inverse of scaleValue - map a position back to data value.
+ *
+ * @param position - Position in range [0, size]
+ * @param min - Scale minimum
+ * @param max - Scale maximum
+ * @param size - Available size (pixels/characters)
+ * @returns Data value
+ */
+declare function unscaleValue(position: number, min: number, max: number, size: number): number;
+
+/**
+ * Axis layout computation for chart rendering.
+ */
+
+/**
+ * Axis orientation.
+ */
+type AxisOrientation = "horizontal" | "vertical";
+/**
+ * Axis position relative to the chart area.
+ */
+type AxisPosition = "left" | "right" | "top" | "bottom";
+/**
+ * Configuration for axis layout computation.
+ */
+interface AxisLayoutOptions {
+    /** Data minimum value */
+    dataMin: number;
+    /** Data maximum value */
+    dataMax: number;
+    /** Available space for the axis (characters) */
+    size: number;
+    /** Axis orientation */
+    orientation: AxisOrientation;
+    /** Axis position */
+    position: AxisPosition;
+    /** Desired number of ticks */
+    tickCount?: number;
+    /** Whether to show tick marks */
+    showTicks?: boolean;
+    /** Label format */
+    format?: "number" | "percent" | "compact" | "currency";
+    /** Decimal places for labels */
+    decimals?: number;
+    /** Axis title */
+    label?: string;
+    /** Force minimum value */
+    forceMin?: number;
+    /** Force maximum value */
+    forceMax?: number;
+    /** Include zero in range */
+    includeZero?: boolean;
+}
+/**
+ * A single tick mark on an axis.
+ */
+interface AxisTick {
+    /** Tick value */
+    value: number;
+    /** Formatted label string */
+    label: string;
+    /** Position along axis (0 to size) */
+    position: number;
+}
+/**
+ * Computed axis layout.
+ */
+interface AxisLayout {
+    /** Axis orientation */
+    orientation: AxisOrientation;
+    /** Axis position */
+    position: AxisPosition;
+    /** Nice scale information */
+    scale: NiceTicksResult;
+    /** Computed tick marks */
+    ticks: AxisTick[];
+    /** Maximum label width (for alignment) */
+    maxLabelWidth: number;
+    /** Axis title */
+    title?: string | undefined;
+    /** Total axis width (including labels and padding) */
+    totalWidth: number;
+    /** Total axis height (including labels and padding) */
+    totalHeight: number;
+}
+/**
+ * Compute the layout for an axis.
+ *
+ * @param options - Axis configuration
+ * @returns Computed axis layout
+ */
+declare function computeAxisLayout(options: AxisLayoutOptions): AxisLayout;
+/**
+ * Compute layouts for both axes of a chart.
+ */
+interface DualAxisLayoutOptions {
+    /** X-axis data min */
+    xMin: number;
+    /** X-axis data max */
+    xMax: number;
+    /** Y-axis data min */
+    yMin: number;
+    /** Y-axis data max */
+    yMax: number;
+    /** Chart width (characters) */
+    chartWidth: number;
+    /** Chart height (characters) */
+    chartHeight: number;
+    /** X-axis configuration */
+    xAxis?: Partial<AxisLayoutOptions>;
+    /** Y-axis configuration */
+    yAxis?: Partial<AxisLayoutOptions>;
+}
+/**
+ * Result of dual axis computation.
+ */
+interface DualAxisLayout {
+    /** X-axis layout */
+    xAxis: AxisLayout;
+    /** Y-axis layout */
+    yAxis: AxisLayout;
+    /** Available chart area width after axis labels */
+    chartAreaWidth: number;
+    /** Available chart area height after axis labels */
+    chartAreaHeight: number;
+    /** X offset of chart area */
+    chartAreaX: number;
+    /** Y offset of chart area */
+    chartAreaY: number;
+}
+/**
+ * Compute layouts for both X and Y axes.
+ *
+ * @param options - Dual axis configuration
+ * @returns Both axis layouts and chart area dimensions
+ */
+declare function computeDualAxisLayout(options: DualAxisLayoutOptions): DualAxisLayout;
+
+/**
+ * Box-drawing and block characters for chart rendering.
+ */
+/**
+ * Axis line characters using Unicode box-drawing.
+ */
+declare const AXIS_CHARS: {
+    /** Y-axis line (│) */
+    readonly vertical: "│";
+    /** X-axis line (─) */
+    readonly horizontal: "─";
+    /** Origin corner (└) */
+    readonly origin: "└";
+    /** Y-axis tick (├) - points right */
+    readonly yTick: "├";
+    /** X-axis tick (┬) - points up */
+    readonly xTick: "┬";
+    /** Grid intersection (┼) */
+    readonly cross: "┼";
+    /** Y-axis with grid (┤) - points left */
+    readonly yTickLeft: "┤";
+    /** X-axis tick (┴) - points down */
+    readonly xTickDown: "┴";
+};
+/**
+ * Height blocks for line/area charts.
+ * 8 levels of vertical fill from 1/8 to full.
+ */
+declare const HEIGHT_BLOCKS: readonly ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"];
+/**
+ * Bar fill characters for different visual styles.
+ */
+declare const BAR_CHARS: {
+    /** Solid block █ */
+    readonly block: "█";
+    /** Dark shade ▓ */
+    readonly shaded: "▓";
+    /** Light shade ░ */
+    readonly light: "░";
+    /** Hash # */
+    readonly hash: "#";
+    /** Equals = */
+    readonly equals: "=";
+    /** Arrow > */
+    readonly arrow: ">";
+};
+/**
+ * Braille base character for high-resolution rendering.
+ * Unicode U+2800 (blank braille pattern).
+ */
+declare const BRAILLE_BASE = 10240;
+/**
+ * Dot positions in a braille cell (standard Unicode layout):
+ * ```
+ *   1 4
+ *   2 5
+ *   3 6
+ *   7 8
+ * ```
+ * Each dot adds 2^(position-1) to the base.
+ */
+declare const BRAILLE_DOTS: {
+    readonly topLeft: 1;
+    readonly upperLeft: 2;
+    readonly lowerLeft: 3;
+    readonly bottomLeft: 7;
+    readonly topRight: 4;
+    readonly upperRight: 5;
+    readonly lowerRight: 6;
+    readonly bottomRight: 8;
+};
+/**
+ * Convert a value (0-1) to a height block character.
+ *
+ * @param normalized - Value between 0 and 1
+ * @returns Appropriate height block character
+ */
+declare function valueToBlock(normalized: number): string;
+/**
+ * Get the bar fill character for a given style.
+ *
+ * @param style - Bar style name
+ * @returns Corresponding fill character
+ */
+declare function getBarChar(style: "block" | "shaded" | "light" | "hash" | "equals" | "arrow"): string;
+/**
+ * Convert an array of dot positions to a braille character.
+ *
+ * @param dots - Array of dot positions (1-8)
+ * @returns Unicode braille character
+ */
+declare function toBrailleChar(dots: number[]): string;
+/**
+ * Series visual distinction styles.
+ * Uses combination of fill characters and markdown highlighting.
+ */
+declare const SERIES_STYLES: readonly [{
+    readonly char: "█";
+    readonly useBackticks: false;
+}, {
+    readonly char: "█";
+    readonly useBackticks: true;
+}, {
+    readonly char: "▓";
+    readonly useBackticks: false;
+}, {
+    readonly char: "░";
+    readonly useBackticks: true;
+}];
+/**
+ * Scatter plot marker characters for multi-series distinction.
+ */
+declare const SCATTER_MARKERS: {
+    readonly circle: "●";
+    readonly square: "■";
+    readonly triangle: "▲";
+    readonly diamond: "◆";
+    readonly plus: "+";
+};
+/**
+ * Array of scatter markers for series rotation.
+ */
+declare const SCATTER_MARKER_SEQUENCE: readonly ["●", "■", "▲", "◆", "+"];
+/**
+ * Heatmap intensity characters (low to high).
+ * 5 levels from empty to full.
+ */
+declare const HEATMAP_BLOCKS: readonly [" ", "░", "▒", "▓", "█"];
+/**
+ * ASCII-safe heatmap characters (low to high).
+ * 5 levels for markdown-friendly output.
+ */
+declare const HEATMAP_ASCII: readonly [" ", ".", ":", "*", "#"];
+/**
+ * Convert a normalized value (0-1) to a heatmap character.
+ *
+ * @param normalized - Value between 0 and 1
+ * @param style - "blocks" for Unicode blocks, "ascii" for ASCII chars
+ * @returns Appropriate intensity character
+ */
+declare function valueToHeatmapChar(normalized: number, style: "blocks" | "ascii"): string;
+/**
+ * Line-drawing characters for connecting points.
+ */
+declare const LINE_CHARS: {
+    /** Point marker */
+    readonly point: "●";
+    /** Horizontal line */
+    readonly horizontal: "─";
+    /** Vertical line */
+    readonly vertical: "│";
+    /** Rising diagonal (approximation) */
+    readonly rising: "╱";
+    /** Falling diagonal (approximation) */
+    readonly falling: "╲";
+};
+/**
+ * A braille canvas for drawing high-resolution graphics.
+ * Each character cell contains a 2x4 grid of dots.
+ */
+declare class BrailleCanvas {
+    /** Width in character cells */
+    readonly width: number;
+    /** Height in character cells */
+    readonly height: number;
+    /** Dot grid (width*2 x height*4) */
+    private dots;
+    /** Series index for each dot (for coloring) */
+    private seriesIndices;
+    constructor(width: number, height: number);
+    /**
+     * Set a dot at the given dot coordinates.
+     */
+    setDot(dotX: number, dotY: number, seriesIndex?: number): void;
+    /**
+     * Draw a line between two points using Bresenham's algorithm.
+     * Coordinates are in dot space (width*2 x height*4).
+     */
+    drawLine(x0: number, y0: number, x1: number, y1: number, seriesIndex?: number): void;
+    /**
+     * Draw a point marker (fills more dots for visibility).
+     */
+    drawPoint(dotX: number, dotY: number, seriesIndex?: number): void;
+    /**
+     * Draw a circle outline using the midpoint circle algorithm.
+     * Coordinates are in dot space (width*2 x height*4).
+     *
+     * @param centerX - Center X in dot coordinates
+     * @param centerY - Center Y in dot coordinates
+     * @param radius - Radius in dot units
+     * @param seriesIndex - Series index for coloring
+     */
+    drawCircle(centerX: number, centerY: number, radius: number, seriesIndex?: number): void;
+    /**
+     * Draw an arc (portion of a circle).
+     * Angles are in radians, 0 = top (12 o'clock), increasing clockwise.
+     *
+     * @param centerX - Center X in dot coordinates
+     * @param centerY - Center Y in dot coordinates
+     * @param radius - Radius in dot units
+     * @param startAngle - Start angle in radians (0 = top)
+     * @param endAngle - End angle in radians
+     * @param seriesIndex - Series index for coloring
+     */
+    drawArc(centerX: number, centerY: number, radius: number, startAngle: number, endAngle: number, seriesIndex?: number): void;
+    /**
+     * Fill a wedge (pie slice) from center to edge.
+     * Angles are in radians, 0 = top (12 o'clock), increasing clockwise.
+     *
+     * @param centerX - Center X in dot coordinates
+     * @param centerY - Center Y in dot coordinates
+     * @param radius - Outer radius in dot units
+     * @param startAngle - Start angle in radians (0 = top)
+     * @param endAngle - End angle in radians
+     * @param seriesIndex - Series index for coloring
+     * @param innerRadius - Inner radius for donut (0 for pie)
+     */
+    fillWedge(centerX: number, centerY: number, radius: number, startAngle: number, endAngle: number, seriesIndex?: number, innerRadius?: number): void;
+    /**
+     * Get the braille character at the given character cell.
+     */
+    getChar(charX: number, charY: number): string;
+    /**
+     * Get the dominant series index for a character cell.
+     */
+    getSeriesIndex(charX: number, charY: number): number | null;
+    /**
+     * Render the entire canvas to a 2D array of characters.
+     */
+    render(): {
+        chars: string[][];
+        seriesIndices: (number | null)[][];
+    };
+}
+
+/**
+ * Grid line computation for chart backgrounds.
+ */
+
+/**
+ * Configuration for grid computation.
+ */
+interface GridOptions {
+    /** Chart area width */
+    width: number;
+    /** Chart area height */
+    height: number;
+    /** X-axis layout (for vertical grid lines) */
+    xAxis?: AxisLayout;
+    /** Y-axis layout (for horizontal grid lines) */
+    yAxis?: AxisLayout;
+    /** Show horizontal grid lines */
+    showHorizontal?: boolean;
+    /** Show vertical grid lines */
+    showVertical?: boolean;
+    /** Grid character */
+    char?: string;
+}
+/**
+ * A single grid line.
+ */
+interface GridLine {
+    /** Line orientation */
+    orientation: "horizontal" | "vertical";
+    /** Position along perpendicular axis */
+    position: number;
+    /** Start position */
+    start: number;
+    /** End position */
+    end: number;
+}
+/**
+ * Computed grid layout.
+ */
+interface GridLayout {
+    /** Horizontal grid lines */
+    horizontalLines: GridLine[];
+    /** Vertical grid lines */
+    verticalLines: GridLine[];
+    /** Grid character */
+    char: string;
+}
+/**
+ * Default grid character (center dot).
+ */
+declare const DEFAULT_GRID_CHAR = "\u00B7";
+/**
+ * Compute grid lines for a chart.
+ *
+ * @param options - Grid configuration
+ * @returns Computed grid layout
+ */
+declare function computeGridLayout(options: GridOptions): GridLayout;
+/**
+ * Create a 2D character grid with grid lines.
+ *
+ * @param width - Grid width
+ * @param height - Grid height
+ * @param grid - Grid layout
+ * @returns 2D array of characters
+ */
+declare function createGridBuffer(width: number, height: number, grid: GridLayout): string[][];
+
+/**
+ * Legend layout computation.
+ */
+/**
+ * Legend position options.
+ */
+type LegendPosition = "none" | "top" | "bottom" | "right" | "inline";
+/**
+ * A single legend item.
+ */
+interface LegendItem {
+    /** Series name */
+    name: string;
+    /** Symbol character */
+    symbol: string;
+    /** Whether to use inline code (backticks) for markdown */
+    useBackticks: boolean;
+}
+/**
+ * Configuration for legend layout.
+ */
+interface LegendOptions {
+    /** Legend items */
+    items: LegendItem[];
+    /** Legend position */
+    position: LegendPosition;
+    /** Whether to use boxed style */
+    boxed?: boolean;
+    /** Maximum width for wrapping */
+    maxWidth?: number;
+}
+/**
+ * A row of legend items.
+ */
+interface LegendRow {
+    /** Items in this row */
+    items: LegendItem[];
+    /** Total width of this row */
+    width: number;
+}
+/**
+ * Computed legend layout.
+ */
+interface LegendLayout {
+    /** Position of the legend */
+    position: LegendPosition;
+    /** Whether legend is boxed */
+    boxed: boolean;
+    /** Legend rows */
+    rows: LegendRow[];
+    /** Total width of legend */
+    totalWidth: number;
+    /** Total height of legend (rows) */
+    totalHeight: number;
+}
+/**
+ * Get the display width of a single legend item.
+ *
+ * Format: "█ Name" or "`█` Name" (with backticks)
+ *
+ * @param item - Legend item
+ * @returns Display width in characters
+ */
+declare function getLegendItemWidth(item: LegendItem): number;
+/**
+ * Format a legend item as a string.
+ *
+ * @param item - Legend item
+ * @param forMarkdown - Whether to format for markdown
+ * @returns Formatted string
+ */
+declare function formatLegendItem(item: LegendItem, forMarkdown: boolean): string;
+/**
+ * Compute the layout for a legend.
+ *
+ * @param options - Legend configuration
+ * @returns Computed legend layout
+ */
+declare function computeLegendLayout(options: LegendOptions): LegendLayout;
+/**
+ * Render a legend row as a string.
+ *
+ * @param row - Legend row
+ * @param forMarkdown - Whether to render for markdown
+ * @returns Rendered string
+ */
+declare function renderLegendRow(row: LegendRow, forMarkdown: boolean): string;
+
+/**
+ * Shared axis rendering utilities for vertical charts.
+ *
+ * Provides consistent Y-axis and X-axis rendering with tick marks
+ * across all chart types (bar, stacked bar, line, area).
+ */
+/**
+ * Y-axis scale information.
+ */
+interface YAxisScale {
+    min: number;
+    max: number;
+    ticks: number[];
+}
+/**
+ * Configuration for Y-axis rendering.
+ */
+interface YAxisConfig {
+    /** Scale with min, max, and tick values */
+    scale: YAxisScale;
+    /** Total chart height in rows */
+    chartHeight: number;
+    /** Width reserved for Y-axis labels */
+    labelWidth: number;
+    /** Number format */
+    format?: "number" | "percent" | "currency" | "compact" | undefined;
+    /** Decimal places */
+    decimals?: number | undefined;
+}
+/**
+ * Result of Y-axis label computation for a single row.
+ */
+interface YAxisRowResult {
+    /** Formatted label (padded to labelWidth) or spaces if no tick */
+    label: string;
+    /** Whether this row has a tick mark */
+    hasTick: boolean;
+    /** The axis character to use (┤ for tick, │ otherwise) */
+    axisChar: string;
+}
+/**
+ * Compute Y-axis label and tick mark for a given row.
+ *
+ * @param row - Row index (0 = bottom, chartHeight-1 = top)
+ * @param config - Y-axis configuration
+ * @returns Label, tick status, and axis character for this row
+ */
+declare function computeYAxisRow(row: number, config: YAxisConfig): YAxisRowResult;
+/**
+ * Configuration for X-axis rendering.
+ */
+interface XAxisConfig {
+    /** Category labels */
+    categories: string[];
+    /** Width of each bar/category area */
+    barWidth: number;
+    /** Width reserved for Y-axis (for alignment) */
+    yAxisWidth: number;
+    /** Total chart width */
+    chartWidth: number;
+    /** Minimum value for zero label */
+    minValue: number;
+    /** Number format for zero label */
+    format?: "number" | "percent" | "currency" | "compact" | undefined;
+    /** Decimal places for zero label */
+    decimals?: number | undefined;
+}
+/**
+ * Result of X-axis rendering.
+ */
+interface XAxisResult {
+    /** The X-axis line with origin and tick marks */
+    axisLine: string;
+    /** The category labels line (centered under ticks) */
+    labelLine: string;
+}
+/**
+ * Render the X-axis with tick marks and centered labels.
+ *
+ * @param config - X-axis configuration
+ * @returns Axis line and label line
+ */
+declare function renderXAxis(config: XAxisConfig): XAxisResult;
+/**
+ * Configuration for a complete chart area with axes.
+ */
+interface ChartAreaConfig {
+    /** Y-axis configuration */
+    yAxis: YAxisConfig;
+    /** X-axis configuration */
+    xAxis: XAxisConfig;
+}
+/**
+ * Helper to build a complete row with Y-axis and content.
+ *
+ * @param row - Row index
+ * @param content - The chart content for this row
+ * @param config - Y-axis configuration
+ * @returns Complete row string with Y-axis label and content
+ */
+declare function buildChartRow(row: number, content: string, config: YAxisConfig): string;
+
+/**
+ * Layout computation for horizontal and vertical bar charts.
+ */
+
+/**
+ * Computed layout for a bar chart.
+ */
+interface BarChartLayout {
+    /** Chart type */
+    type: "bar" | "bar-vertical";
+    /** Individual bar layouts */
+    bars: BarLayout[];
+    /** Categories (x-axis labels) */
+    categories: string[];
+    /** Maximum label width */
+    maxLabelWidth: number;
+    /** Maximum value width */
+    maxValueWidth: number;
+    /** Bar area width (for horizontal) or height (for vertical) */
+    barAreaSize: number;
+    /** Y-axis scale info */
+    yScale: ReturnType<typeof computeNiceTicks>;
+    /** Y-axis layout */
+    yAxis?: AxisLayout;
+    /** Whether to show values */
+    showValues: boolean;
+    /** Chart dimensions */
+    width: number;
+    height: number;
+}
+/**
+ * Compute layout for a horizontal or vertical bar chart.
+ *
+ * @param input - Chart input with defaults
+ * @returns Computed bar chart layout
+ */
+declare function computeBarLayout(input: ChartInputWithDefaults): BarChartLayout;
+/**
+ * Group bars by category for multi-series charts.
+ *
+ * @param layout - Bar chart layout
+ * @returns Map of category to bars
+ */
+declare function groupBarsByCategory(layout: BarChartLayout): Map<string, BarLayout[]>;
+
+/**
+ * Layout computation for stacked bar charts.
+ */
+
+/**
+ * Computed layout for a stacked bar chart.
+ */
+interface StackedBarChartLayout {
+    /** Chart type */
+    type: "bar-stacked" | "bar-stacked-vertical";
+    /** Stacked bars by category */
+    stacks: StackedBarLayout[];
+    /** Series names for legend */
+    seriesNames: string[];
+    /** Series styles for legend */
+    seriesStyles: {
+        char: string;
+        useBackticks: boolean;
+    }[];
+    /** Maximum label width */
+    maxLabelWidth: number;
+    /** Maximum total value width */
+    maxValueWidth: number;
+    /** Bar area width/height */
+    barAreaSize: number;
+    /** Y-scale */
+    yScale: ReturnType<typeof computeNiceTicks>;
+    /** Whether to show values */
+    showValues: boolean;
+    /** Chart dimensions */
+    width: number;
+    height: number;
+}
+/**
+ * Compute layout for a stacked bar chart.
+ *
+ * @param input - Chart input with defaults
+ * @returns Computed stacked bar layout
+ */
+declare function computeStackedBarLayout(input: ChartInputWithDefaults): StackedBarChartLayout;
+
+/**
+ * Layout computation for line charts.
+ *
+ * Supports multiple rendering styles:
+ * - "blocks": Simple line-drawing characters (●, ╱, ╲, ─)
+ * - "braille": High-resolution braille dot patterns
+ * - "dots": Point markers only
+ */
+
+/**
+ * A single point in the line chart.
+ */
+interface LinePoint {
+    /** X position (column index) */
+    x: number;
+    /** Y value (data value) */
+    value: number;
+    /** Normalized Y (0-1) */
+    normalizedY: number;
+    /** Series index */
+    seriesIndex: number;
+}
+/**
+ * A row in the line chart display.
+ */
+interface LineRow {
+    /** Y-axis label for this row */
+    yLabel?: string | undefined;
+    /** Y-axis value at this row */
+    yValue: number;
+    /** Characters for each column */
+    chars: string[];
+    /** Whether each char uses backticks (for multi-series distinction) */
+    useBackticks: boolean[];
+    /** Series index for each column (for ANSI coloring) */
+    seriesIndices: (number | null)[];
+}
+/**
+ * Computed layout for a line chart.
+ */
+interface LineChartLayout {
+    /** Chart type */
+    type: "line";
+    /** Line style */
+    lineStyle: LineStyle;
+    /** X-axis categories */
+    categories: string[];
+    /** Series names */
+    seriesNames: string[];
+    /** Points per series */
+    points: LinePoint[][];
+    /** Display rows (top to bottom) */
+    rows: LineRow[];
+    /** Y-scale */
+    yScale: ReturnType<typeof computeNiceTicks>;
+    /** X-axis label width */
+    maxXLabelWidth: number;
+    /** Y-axis label width */
+    yAxisWidth: number;
+    /** Chart dimensions */
+    width: number;
+    height: number;
+    /** Whether to show values */
+    showValues: boolean;
+}
+/**
+ * Compute layout for a line chart.
+ */
+declare function computeLineLayout(input: ChartInputWithDefaults): LineChartLayout;
+
+/**
+ * Layout computation for area and stacked area charts.
+ */
+
+/**
+ * A column in the area chart with stacked values.
+ */
+interface AreaColumn {
+    /** X position */
+    x: number;
+    /** Category label */
+    label: string;
+    /** Cumulative values per series (bottom to top) */
+    cumulativeValues: number[];
+    /** Normalized cumulative heights (0-1) */
+    normalizedHeights: number[];
+}
+/**
+ * A row in the area chart display.
+ */
+interface AreaRow {
+    /** Y-axis label */
+    yLabel?: string | undefined;
+    /** Characters for each column */
+    chars: string[];
+    /** Whether each char uses backticks */
+    useBackticks: boolean[];
+    /** Fill character for each column */
+    fillChars: string[];
+}
+/**
+ * Computed layout for an area chart.
+ */
+interface AreaChartLayout {
+    /** Chart type */
+    type: "area" | "area-stacked";
+    /** Line style */
+    lineStyle: LineStyle;
+    /** X-axis categories */
+    categories: string[];
+    /** Series names */
+    seriesNames: string[];
+    /** Series styles */
+    seriesStyles: {
+        char: string;
+        useBackticks: boolean;
+    }[];
+    /** Column data */
+    columns: AreaColumn[];
+    /** Display rows (top to bottom) */
+    rows: AreaRow[];
+    /** Y-scale */
+    yScale: ReturnType<typeof computeNiceTicks>;
+    /** Y-axis label width */
+    yAxisWidth: number;
+    /** Chart dimensions */
+    width: number;
+    height: number;
+    /** Whether to show values */
+    showValues: boolean;
+}
+/**
+ * Compute layout for an area or stacked area chart.
+ *
+ * @param input - Chart input with defaults
+ * @returns Computed area chart layout
+ */
+declare function computeAreaLayout(input: ChartInputWithDefaults): AreaChartLayout;
+
+/**
+ * Layout computation for scatter plots.
+ *
+ * Supports multiple rendering styles:
+ * - "dots": Simple character markers (●, ■, ▲, ◆, +)
+ * - "braille": High-resolution braille dot patterns
+ */
+
+/**
+ * A single point in the scatter plot.
+ */
+interface ScatterPoint {
+    /** Original X data value */
+    dataX: number;
+    /** Original Y data value */
+    dataY: number;
+    /** Character column position */
+    charX: number;
+    /** Character row position */
+    charY: number;
+    /** Series index for coloring/marker */
+    seriesIndex: number;
+}
+/**
+ * Computed layout for a scatter chart.
+ */
+interface ScatterChartLayout {
+    /** Chart type */
+    type: "scatter";
+    /** Scatter rendering style */
+    scatterStyle: ScatterStyle;
+    /** Series names */
+    seriesNames: string[];
+    /** All points across series */
+    points: ScatterPoint[];
+    /** X-axis scale */
+    xScale: NiceTicksResult;
+    /** Y-axis scale */
+    yScale: NiceTicksResult;
+    /** Y-axis label width */
+    yAxisWidth: number;
+    /** Chart area width (excluding Y-axis) */
+    chartWidth: number;
+    /** Chart area height (excluding X-axis) */
+    chartHeight: number;
+    /** Total width */
+    width: number;
+    /** Total height */
+    height: number;
+    /** Character grid for dots mode */
+    grid?: string[][];
+    /** Series indices for each grid cell */
+    seriesIndices?: (number | null)[][];
+    /** Braille canvas render result (for braille mode) */
+    brailleChars?: string[][];
+    /** Braille series indices */
+    brailleSeriesIndices?: (number | null)[][];
+}
+/**
+ * Compute layout for a scatter plot.
+ */
+declare function computeScatterLayout(input: ChartInputWithDefaults): ScatterChartLayout;
+
+/**
+ * Layout computation for pie and donut charts.
+ *
+ * Uses braille characters to draw circular charts with filled wedges.
+ */
+
+/**
+ * A single slice in a pie chart.
+ */
+interface PieSlice {
+    /** Slice label */
+    label: string;
+    /** Slice value */
+    value: number;
+    /** Percentage of total (0-100) */
+    percentage: number;
+    /** Start angle in radians (0 = top, clockwise) */
+    startAngle: number;
+    /** End angle in radians */
+    endAngle: number;
+    /** Display character for legend */
+    barChar: string;
+    /** Whether to use backticks in markdown */
+    useBackticks: boolean;
+    /** Series index */
+    seriesIndex: number;
+}
+/**
+ * Computed layout for a pie or donut chart.
+ */
+interface PieChartLayout {
+    /** Chart type */
+    type: "pie" | "donut";
+    /** Slices data */
+    slices: PieSlice[];
+    /** Total value */
+    total: number;
+    /** Radius in character cells */
+    radius: number;
+    /** Center X in character cells */
+    centerX: number;
+    /** Center Y in character cells */
+    centerY: number;
+    /** Inner radius (0 for pie, >0 for donut) */
+    innerRadius: number;
+    /** Center label for donut */
+    centerLabel?: string;
+    /** Chart width */
+    width: number;
+    /** Chart height */
+    height: number;
+    /** Braille canvas rendered characters */
+    brailleChars: string[][];
+    /** Series indices for each character */
+    brailleSeriesIndices: (number | null)[][];
+    /** Series styles */
+    seriesStyles: readonly {
+        char: string;
+        useBackticks: boolean;
+    }[];
+}
+/**
+ * Compute layout for a pie or donut chart.
+ */
+declare function computePieLayout(input: ChartInputWithDefaults): PieChartLayout;
+
+/**
+ * Layout computation for heatmap charts.
+ *
+ * Renders a 2D grid with intensity shading based on values.
+ */
+
+/**
+ * A single cell in the heatmap.
+ */
+interface HeatmapCell {
+    /** Row index */
+    row: number;
+    /** Column index */
+    col: number;
+    /** Raw value */
+    value: number;
+    /** Normalized value (0-1) */
+    normalizedValue: number;
+    /** Display character */
+    displayChar: string;
+}
+/**
+ * Computed layout for a heatmap chart.
+ */
+interface HeatmapChartLayout {
+    /** Chart type */
+    type: "heatmap";
+    /** Heatmap rendering style */
+    heatmapStyle: HeatmapStyle;
+    /** Row labels */
+    rowLabels: string[];
+    /** Column labels */
+    colLabels: string[];
+    /** Cell data grid (rows x cols) */
+    cells: HeatmapCell[][];
+    /** Value range */
+    valueRange: {
+        min: number;
+        max: number;
+    };
+    /** Width of each cell in characters */
+    cellWidth: number;
+    /** Width for column spacing (max of cellWidth and longest column label) */
+    colLabelWidth: number;
+    /** Width of row labels */
+    rowLabelWidth: number;
+    /** Total width */
+    width: number;
+    /** Total height */
+    height: number;
+}
+/**
+ * Compute layout for a heatmap chart.
+ */
+declare function computeHeatmapLayout(input: ChartInputWithDefaults): HeatmapChartLayout;
+
+/**
+ * ANSI renderer for charts.
+ *
+ * Produces ANSI escape code output for rich terminal rendering.
+ */
+
+/**
+ * Render options for ANSI output.
+ */
+interface AnsiRenderOptions {
+    /** Theme for colors */
+    theme?: TuiTheme | undefined;
+    /** Chart input for configuration */
+    input: ChartInputWithDefaults;
+}
+/**
+ * Render a horizontal bar chart to ANSI.
+ */
+declare function renderBarChartAnsi(layout: BarChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render a vertical bar chart to ANSI.
+ */
+declare function renderVerticalBarChartAnsi(layout: BarChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render a stacked bar chart to ANSI.
+ */
+declare function renderStackedBarChartAnsi(layout: StackedBarChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render a line chart to ANSI.
+ */
+declare function renderLineChartAnsi(layout: LineChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render an area chart to ANSI.
+ */
+declare function renderAreaChartAnsi(layout: AreaChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render a scatter chart to ANSI.
+ */
+declare function renderScatterChartAnsi(layout: ScatterChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render a pie or donut chart to ANSI.
+ */
+declare function renderPieChartAnsi(layout: PieChartLayout, options: AnsiRenderOptions): string;
+/**
+ * Render a heatmap chart to ANSI.
+ */
+declare function renderHeatmapAnsi(layout: HeatmapChartLayout, options: AnsiRenderOptions): string;
+
+/**
+ * Markdown renderer for charts.
+ *
+ * Produces markdown-friendly output using a two-color system:
+ * - Primary: Plain text
+ * - Secondary: Inline code (backticks)
+ */
+
+/**
+ * Render options for markdown output.
+ */
+interface MarkdownRenderOptions {
+    /** Chart input for configuration */
+    input: ChartInputWithDefaults;
+}
+/**
+ * Render a horizontal bar chart to markdown.
+ */
+declare function renderBarChartMarkdown(layout: BarChartLayout, _options: MarkdownRenderOptions): string;
+/**
+ * Render a vertical bar chart to markdown.
+ */
+declare function renderVerticalBarChartMarkdown(layout: BarChartLayout, options: MarkdownRenderOptions): string;
+/**
+ * Render a stacked bar chart to markdown.
+ */
+declare function renderStackedBarChartMarkdown(layout: StackedBarChartLayout, options: MarkdownRenderOptions): string;
+/**
+ * Render a line chart to markdown.
+ */
+declare function renderLineChartMarkdown(layout: LineChartLayout, options: MarkdownRenderOptions): string;
+/**
+ * Render an area chart to markdown.
+ */
+declare function renderAreaChartMarkdown(layout: AreaChartLayout, options: MarkdownRenderOptions): string;
+/**
+ * Render a scatter chart to markdown.
+ */
+declare function renderScatterChartMarkdown(layout: ScatterChartLayout, options: MarkdownRenderOptions): string;
+/**
+ * Render a pie or donut chart to markdown.
+ */
+declare function renderPieChartMarkdown(layout: PieChartLayout, options: MarkdownRenderOptions): string;
+/**
+ * Render a heatmap chart to markdown.
+ */
+declare function renderHeatmapMarkdown(layout: HeatmapChartLayout, options: MarkdownRenderOptions): string;
+
+export { AXIS_CHARS, type AnsiRenderOptions, type AreaChartLayout, type AreaColumn, type AreaRow, type AxisConfig, type AxisLayout, type AxisLayoutOptions, type AxisOrientation, type AxisPosition, type AxisTick, BAR_CHARS, BRAILLE_BASE, BRAILLE_DOTS, type BarChartLayout, type BarLayout, type BarStyle, BrailleCanvas, type ChartAreaConfig, ChartComponent, type ChartInput, type ChartInputWithDefaults, type ChartLayout, type ChartType, DEFAULT_GRID_CHAR, type DataPoint, type DataSeries, type DualAxisLayout, type DualAxisLayoutOptions, type GridConfig, type GridLayout, type GridLine, type GridOptions, HEATMAP_ASCII, HEATMAP_BLOCKS, HEIGHT_BLOCKS, type HeatmapCell, type HeatmapChartLayout, type HeatmapStyle, LINE_CHARS, type LegendConfig, type LegendItem, type LegendLayout, type LegendOptions, type LegendPosition, type LegendRow, type LineChartLayout, type LinePoint, type LineRow, type LineRowLayout, type LineStyle, type MarkdownRenderOptions, type NiceTicksOptions, type NiceTicksResult, type PieChartLayout, type PieSlice, SCATTER_MARKERS, SCATTER_MARKER_SEQUENCE, SERIES_STYLES, type ScatterChartLayout, type ScatterMarker, type ScatterPoint, type ScatterStyle, type StackedBarChartLayout, type StackedBarLayout, type ValueFormat, type XAxisConfig, type XAxisResult, type YAxisConfig, type YAxisRowResult, type YAxisScale, axisConfigSchema, barStyleSchema, buildChartRow, chartInputSchema, chartTypeSchema, computeAreaLayout, computeAxisLayout, computeBarLayout, computeDualAxisLayout, computeGridLayout, computeHeatmapLayout, computeLegendLayout, computeLineLayout, computeNiceTicks, computePieLayout, computeScatterLayout, computeStackedBarLayout, computeYAxisRow, createChart, createGridBuffer, dataPointSchema, dataSeriesSchema, formatLegendItem, formatTickValue, getBarChar, getLegendItemWidth, gridConfigSchema, groupBarsByCategory, heatmapStyleSchema, legendConfigSchema, legendPositionSchema, lineStyleSchema, renderAreaChartAnsi, renderAreaChartMarkdown, renderBarChartAnsi, renderBarChartMarkdown, renderHeatmapAnsi, renderHeatmapMarkdown, renderLegendRow, renderLineChartAnsi, renderLineChartMarkdown, renderPieChartAnsi, renderPieChartMarkdown, renderScatterChartAnsi, renderScatterChartMarkdown, renderStackedBarChartAnsi, renderStackedBarChartMarkdown, renderVerticalBarChartAnsi, renderVerticalBarChartMarkdown, renderXAxis, scaleValue, scatterMarkerSchema, scatterStyleSchema, toBrailleChar, unscaleValue, valueFormatSchema, valueToBlock, valueToHeatmapChar };