@chartts/core 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,594 @@
+import { b as ChartOptions, a as ChartData, C as ChartInstance, i as Renderer, T as ThemeConfig, j as ChartArea, k as Scale, E as EventBus, P as PreparedData, d as RenderNode, l as RenderAttrs, c as ChartTypePlugin, h as ScaleType, m as ScaleFactory, R as RenderContext } from './engine-CNukbv7k.cjs';
+export { n as ChartEvents, o as CrosshairConfig, p as CurveType, D as DataBounds, q as DataPoint, s as EventHandler, H as HitResult, L as LegendPosition, t as PreparedSeries, u as RendererRoot, v as ResolvedOptions, S as Series, w as Tick, x as TooltipConfig, U as Unsubscribe, e as applyTheme, f as createChart, r as renderToString, g as resolveTheme } from './engine-CNukbv7k.cjs';
+export { l as lineChartType } from './line-type-B8lgTFjb.cjs';
+export { b as barChartType } from './bar-type-CkI-kkrC.cjs';
+export { s as stackedBarChartType } from './stacked-bar-type-Ct6HK2A0.cjs';
+export { h as horizontalBarChartType } from './horizontal-bar-type-0mqnyMUR.cjs';
+export { d as donutChartType, p as pieChartType } from './pie-type-duX5xkfQ.cjs';
+export { s as scatterChartType } from './scatter-type-CD7X1pZb.cjs';
+export { s as sparklineChartType } from './sparkline-type-qt3yoLs7.cjs';
+export { a as areaChartType } from './area-type-B3CtuIIP.cjs';
+export { r as radarChartType } from './radar-type-Dgyr13Zd.cjs';
+export { b as bubbleChartType } from './bubble-type-Dxb2JCKv.cjs';
+export { c as candlestickChartType } from './candlestick-type-CazXUb77.cjs';
+export { g as gaugeChartType } from './gauge-type-DmjDdfsY.cjs';
+export { w as waterfallChartType } from './waterfall-type-hm5ylGgW.cjs';
+export { f as funnelChartType } from './funnel-type-BeVl3ohX.cjs';
+export { h as heatmapChartType } from './heatmap-type-D0shkxK7.cjs';
+export { b as boxplotChartType } from './boxplot-type-Da8_smoe.cjs';
+export { h as histogramChartType } from './histogram-type-BWil-Rb7.cjs';
+export { t as treemapChartType } from './treemap-type-OBCGexiK.cjs';
+export { p as polarChartType } from './polar-type-CI6-I8Yg.cjs';
+export { r as radialBarChartType } from './radialbar-type-C_SBXoaa.cjs';
+export { l as lollipopChartType } from './lollipop-type-CoTzKLSu.cjs';
+export { b as bulletChartType } from './bullet-type-khCmwFqH.cjs';
+export { d as dumbbellChartType } from './dumbbell-type-w424KzI2.cjs';
+export { c as calendarChartType } from './calendar-type-Br5mpdea.cjs';
+export { c as comboChartType } from './combo-type-wodyLq1f.cjs';
+export { s as sankeyChartType } from './sankey-type-DfkTUnXB.cjs';
+export { s as sunburstChartType } from './sunburst-type-BOztb_Px.cjs';
+export { t as treeChartType } from './tree-type-Cz84wHnR.cjs';
+export { g as graphChartType } from './graph-type-DkdAB6Vc.cjs';
+export { p as parallelChartType } from './parallel-type-D-S-EqeC.cjs';
+export { t as themeRiverChartType } from './themeriver-type-BnRSsyal.cjs';
+export { p as pictorialBarChartType } from './pictorialbar-type-CnJEH9GZ.cjs';
+export { c as chordChartType } from './chord-type-ChIZaOZd.cjs';
+export { W as WORLD_REGIONS, b as WORLD_SIMPLE, g as geoChartType } from './world-regions-cMulhqDW.cjs';
+export { l as linesChartType } from './lines-type-CGrg_mDi.cjs';
+export { m as matrixChartType } from './matrix-type-Crb_NwUJ.cjs';
+export { c as customChartType } from './custom-type-B6w1n5Ua.cjs';
+export { o as ohlcChartType } from './ohlc-type-BQBHvVJO.cjs';
+export { s as stepChartType } from './step-type-BSL-CUny.cjs';
+export { v as volumeChartType } from './volume-type-CfERBN5g.cjs';
+export { r as rangeChartType } from './range-type-CkriEnLm.cjs';
+export { b as baselineChartType } from './baseline-type-BAPrZJ5W.cjs';
+export { k as kagiChartType } from './kagi-type-aG-Q1bWk.cjs';
+export { r as renkoChartType } from './renko-type-43OXCtZ3.cjs';
+export { BollingerResult, MACDResult, OHLCAggregation, StochasticResult, atr, bollingerBands, cumulativeReturns, drawdown, ema, logReturns, macd, maxDrawdown, obv, rsi, sharpeRatio, simpleReturns, sma, stochastic, toBollingerData, toMACDData, toOHLC, volatility, volumeDirections, vwap, wma } from './finance.cjs';
+
+interface ChartConfig extends ChartOptions {
+    data: ChartData;
+    debug?: boolean;
+}
+declare function Line(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Bar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function StackedBar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function HorizontalBar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Pie(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Donut(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Scatter(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Sparkline(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Area(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Radar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Bubble(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Candlestick(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Gauge(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Waterfall(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Funnel(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Heatmap(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Boxplot(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Histogram(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Treemap(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Polar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function RadialBar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Lollipop(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Bullet(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Dumbbell(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Calendar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Combo(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Sankey(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Sunburst(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Tree(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Graph(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Parallel(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function ThemeRiver(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function PictorialBar(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Chord(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Geo(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Lines(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Matrix(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Custom(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function OHLC(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Step(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Volume(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Range(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Baseline(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Kagi(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+declare function Renko(target: string | HTMLElement, config: ChartConfig): ChartInstance;
+
+/**
+ * SVG DOM Renderer.
+ *
+ * Converts render tree nodes into real SVG elements.
+ * All color attributes reference CSS custom properties (var(--chartts-*))
+ * so they're overridable via CSS, Tailwind, or theme config.
+ */
+declare function createSVGRenderer(): Renderer;
+
+declare function createCanvasRenderer(theme: ThemeConfig): Renderer;
+
+/**
+ * WebGL Renderer.
+ *
+ * GPU-accelerated rendering for 100k–1M+ data points.
+ * Uses a dual-layer approach:
+ *   - WebGL canvas: lines, points, bars (data-heavy elements)
+ *   - 2D canvas overlay: axes, text, grid, legends (needs Canvas2D text API)
+ *
+ * Falls back to the Canvas 2D renderer if WebGL is not available.
+ */
+
+declare function createWebGLRenderer(theme: ThemeConfig): Renderer;
+
+/**
+ * Data decimation algorithms for large datasets.
+ *
+ * Reduces data point count while preserving visual shape.
+ * Sits in the pipeline between raw data and render.
+ */
+
+interface DecimateOptions {
+    /** Decimation algorithm. Default 'lttb'. */
+    algorithm?: 'lttb' | 'min-max';
+    /** Target number of output points. Default: 2x container pixel width. */
+    threshold?: number;
+}
+/**
+ * Decimate chart data to `threshold` points per series.
+ * Returns original data if already below threshold.
+ */
+declare function decimateData(data: ChartData, opts: DecimateOptions): ChartData;
+
+/**
+ * Zoom & Pan interaction module.
+ *
+ * Works with all renderers — modifies scale domains, not DOM elements.
+ * Wheel zoom on the x-axis, drag to pan. Touch pinch support.
+ */
+
+interface ZoomPanConfig {
+    /** Enable x-axis zoom. Default true. */
+    x?: boolean;
+    /** Enable y-axis zoom. Default false. */
+    y?: boolean;
+    /** Enable wheel zoom. Default true. */
+    wheel?: boolean;
+    /** Enable drag pan. Default true. */
+    drag?: boolean;
+    /** Enable pinch zoom. Default true. */
+    pinch?: boolean;
+    /** Minimum zoom level (1 = no zoom). Default 1. */
+    minZoom?: number;
+    /** Maximum zoom level. Default 20. */
+    maxZoom?: number;
+}
+interface ZoomPanState {
+    zoomX: number;
+    zoomY: number;
+    panX: number;
+    panY: number;
+}
+interface ZoomPanInstance {
+    attach(el: HTMLElement | SVGElement, getArea: () => ChartArea, getScales: () => {
+        xScale: Scale;
+        yScale: Scale;
+    }): void;
+    reset(): void;
+    getState(): ZoomPanState;
+    applyToScales(xScale: Scale, yScale: Scale, area: ChartArea): void;
+    destroy(): void;
+}
+/**
+ * Create a zoom & pan controller.
+ *
+ * Usage:
+ * ```ts
+ * const zp = createZoomPan({ x: true, y: false }, () => render())
+ * zp.attach(svgElement, () => chartArea, () => ({ xScale, yScale }))
+ * // On each render, apply to scales:
+ * zp.applyToScales(xScale, yScale, area)
+ * ```
+ */
+declare function createZoomPan(config: ZoomPanConfig, onUpdate: () => void, interactionState?: {
+    isPanning: boolean;
+}): ZoomPanInstance;
+
+/**
+ * Linked charts — sync crosshair position across multiple chart instances.
+ *
+ * Usage:
+ * ```ts
+ * const unlink = linkCharts(chart1, chart2, chart3)
+ * // Later:
+ * unlink()
+ * ```
+ */
+
+/**
+ * Link multiple chart instances so their crosshair positions stay in sync.
+ * When one chart emits a crosshair:move event, all others receive it.
+ *
+ * Returns an unlink function to disconnect the charts.
+ */
+declare function linkCharts(...charts: ChartInstance[]): () => void;
+
+/**
+ * Brush selection module.
+ *
+ * Click-drag to select a data range on the chart area.
+ * When pan is also enabled, requires Shift+drag to activate.
+ * Emits brush:end event with start/end label indices.
+ */
+
+interface BrushConfig {
+    /** Fill color of selection rect. Default rgba(59,130,246,0.15). */
+    fillColor?: string;
+    /** Border color of selection rect. Default rgba(59,130,246,0.5). */
+    strokeColor?: string;
+}
+interface BrushInstance {
+    destroy(): void;
+}
+declare function createBrush(config: BrushConfig, bus: EventBus, el: HTMLElement | SVGElement, getArea: () => ChartArea, getXScale: () => Scale, getData: () => PreparedData, isPanEnabled: boolean): BrushInstance;
+
+/**
+ * Realtime streaming data module.
+ *
+ * Provides a circular buffer + rolling window for live data feeds.
+ * Throttled re-render via requestAnimationFrame.
+ *
+ * Usage:
+ * ```ts
+ * const stream = createStreamingChart(chart, {
+ *   windowSize: 100,     // show last 100 points
+ *   seriesCount: 3,      // 3 data series
+ *   seriesNames: ['CPU', 'Memory', 'Disk'],
+ * })
+ *
+ * // Push single data point (one value per series)
+ * stream.push([45, 72, 30], 'now')
+ *
+ * // Push batch of data points
+ * stream.pushBatch([
+ *   { values: [45, 72, 30], label: '10:00' },
+ *   { values: [46, 71, 31], label: '10:01' },
+ * ])
+ *
+ * // Pause / resume
+ * stream.pause()
+ * stream.resume()
+ *
+ * // Clean up
+ * stream.destroy()
+ * ```
+ */
+
+interface StreamingConfig {
+    /** Number of data points visible in the rolling window. Default 100. */
+    windowSize?: number;
+    /** Number of data series. Default 1. */
+    seriesCount?: number;
+    /** Series names. Default ['Series 1', 'Series 2', ...] */
+    seriesNames?: string[];
+    /** Series colors (optional — falls back to chart palette). */
+    seriesColors?: string[];
+    /** Maximum buffer size (oldest data is discarded beyond this). Default 10x windowSize. */
+    maxBufferSize?: number;
+    /** Throttle interval in ms (0 = use rAF). Default 0. */
+    throttleMs?: number;
+}
+interface StreamingInstance {
+    /** Push one data point (one value per series). */
+    push(values: number[], label?: string | number | Date): void;
+    /** Push a batch of data points at once. */
+    pushBatch(points: Array<{
+        values: number[];
+        label?: string | number | Date;
+    }>): void;
+    /** Pause streaming (stops re-renders but still accepts data). */
+    pause(): void;
+    /** Resume streaming re-renders. */
+    resume(): void;
+    /** Clear all buffered data. */
+    clear(): void;
+    /** Get current buffer size. */
+    getBufferSize(): number;
+    /** Destroy the streaming instance and clean up. */
+    destroy(): void;
+}
+declare function createStreamingChart(chart: ChartInstance, config?: StreamingConfig): StreamingInstance;
+
+/** Filter series by a predicate on values. */
+declare function filterData(data: ChartData, predicate: (value: number, index: number, seriesIndex: number) => boolean): ChartData;
+/** Filter to keep only specific series by name or index. */
+declare function filterSeries(data: ChartData, keep: (string | number)[]): ChartData;
+/** Filter to keep only specific labels/categories. */
+declare function filterLabels(data: ChartData, keep: (string | number | Date)[]): ChartData;
+/** Sort data by label or by a specific series' values. */
+declare function sortData(data: ChartData, by: 'label' | number, direction?: 'asc' | 'desc'): ChartData;
+type AggFn = 'sum' | 'avg' | 'min' | 'max' | 'count';
+/** Aggregate all series values per label into a single series. */
+declare function aggregateData(data: ChartData, fn?: AggFn): ChartData;
+type TransformFn = (data: ChartData) => ChartData;
+/** Apply a chain of transforms to chart data. */
+declare function transformData(data: ChartData, ...transforms: TransformFn[]): ChartData;
+/** Transpose rows and columns — series become labels and vice versa. */
+declare function pivotData(data: ChartData): ChartData;
+/** Take a slice of the data (for pagination or windowing). */
+declare function sliceData(data: ChartData, start: number, end?: number): ChartData;
+
+/**
+ * DataZoom — interactive data range selection and filtering.
+ *
+ * Provides utilities to:
+ * 1. Filter chart data to a visible window (applyDataZoom)
+ * 2. Render a zoom slider control (renderDataZoomSlider)
+ * 3. Manage zoom state (createDataZoomState)
+ */
+interface DataZoomRange {
+    /** Start percentage 0..1 */
+    start: number;
+    /** End percentage 0..1 */
+    end: number;
+}
+interface DataZoomState {
+    range: DataZoomRange;
+    setRange(start: number, end: number): void;
+    reset(): void;
+    zoomIn(factor?: number): void;
+    zoomOut(factor?: number): void;
+    panLeft(amount?: number): void;
+    panRight(amount?: number): void;
+}
+interface DataZoomSliderOptions {
+    x: number;
+    y: number;
+    width: number;
+    height?: number;
+    trackColor?: string;
+    handleColor?: string;
+    selectedColor?: string;
+    showMinimap?: boolean;
+}
+/** Create a DataZoom state manager. */
+declare function createDataZoomState(initial?: Partial<DataZoomRange>, onChange?: (range: DataZoomRange) => void): DataZoomState;
+/** Apply DataZoom range to filter chart data. */
+declare function applyDataZoom(data: ChartData, range: DataZoomRange): ChartData;
+/** Render a DataZoom slider as RenderNode[]. */
+declare function renderDataZoomSlider(data: ChartData, range: DataZoomRange, opts: DataZoomSliderOptions): RenderNode[];
+
+/**
+ * Interactive DataZoom slider widget.
+ *
+ * A real DOM element with draggable handles and minimap sparkline.
+ * Lives outside the chart render loop — manages its own pointer events.
+ *
+ * Usage:
+ * ```ts
+ * const widget = createDataZoomWidget({
+ *   data: fullData,
+ *   onChange: (range) => {
+ *     chart.setData(applyDataZoom(fullData, range))
+ *   },
+ * })
+ * container.appendChild(widget.element)
+ * ```
+ */
+
+interface DataZoomWidgetOptions {
+    /** Chart data (first series used for minimap sparkline). */
+    data: ChartData;
+    /** Height of the slider in pixels. Default 40. */
+    height?: number;
+    /** Initial visible range. Default { start: 0, end: 1 }. */
+    initialRange?: Partial<DataZoomRange>;
+    /** Called when range changes via user interaction. */
+    onChange?: (range: DataZoomRange) => void;
+    /** Track background color. */
+    trackColor?: string;
+    /** Handle color. */
+    handleColor?: string;
+    /** Selected region color. */
+    selectedColor?: string;
+    /** Minimap line color. */
+    minimapColor?: string;
+}
+interface DataZoomWidget {
+    /** The DOM element to insert into the page. */
+    element: HTMLElement;
+    /** The state manager (setRange, reset, zoomIn, zoomOut, panLeft, panRight). */
+    state: DataZoomState;
+    /** Update minimap sparkline data. */
+    setData(data: ChartData): void;
+    /** Destroy and clean up. */
+    destroy(): void;
+}
+declare function createDataZoomWidget(options: DataZoomWidgetOptions): DataZoomWidget;
+
+/**
+ * Graphic — create custom SVG overlay elements for charts.
+ *
+ * Provides a declarative API to define arbitrary shapes, text, and groups
+ * that can be overlaid on any chart. Positions can be absolute (px)
+ * or relative (0..1 proportion of chart area).
+ */
+interface GraphicElement {
+    type: 'rect' | 'circle' | 'path' | 'text' | 'line' | 'group' | 'image';
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    r?: number;
+    d?: string;
+    content?: string;
+    x2?: number;
+    y2?: number;
+    src?: string;
+    children?: GraphicElement[];
+    position?: 'absolute' | 'relative';
+    attrs?: Record<string, unknown>;
+}
+interface GraphicArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Convert an array of GraphicElement definitions into RenderNode[].
+ * Use `area` to resolve relative positions.
+ */
+declare function createGraphicElements(elements: GraphicElement[], area?: GraphicArea): RenderNode[];
+/**
+ * Convenience: create a horizontal guideline.
+ */
+declare function horizontalLine(y: number, area: GraphicArea, attrs?: RenderAttrs): RenderNode;
+/**
+ * Convenience: create a vertical guideline.
+ */
+declare function verticalLine(x: number, area: GraphicArea, attrs?: RenderAttrs): RenderNode;
+/**
+ * Convenience: create a text annotation at a position.
+ */
+declare function annotation(x: number, y: number, content: string, attrs?: RenderAttrs): RenderNode;
+
+/**
+ * Rich Text — parse simple markup into multi-styled text elements.
+ *
+ * Supports a simple markup syntax:
+ * - {b}bold{/b} or **bold**
+ * - {i}italic{/i} or *italic*
+ * - {color:red}colored{/color}
+ * - {size:16}sized{/size}
+ * - {style:name}custom{/style} — uses named styles
+ *
+ * Returns a RenderNode (text element with tspan children).
+ */
+interface RichTextStyle {
+    fontWeight?: number | string;
+    fontStyle?: string;
+    fill?: string;
+    fontSize?: number | string;
+    fontFamily?: string;
+    textDecoration?: string;
+}
+interface RichTextOptions {
+    /** Default text attributes */
+    defaults?: RichTextStyle;
+    /** Named styles for {style:name} syntax */
+    styles?: Record<string, RichTextStyle>;
+    /** X position */
+    x?: number;
+    /** Y position */
+    y?: number;
+    /** Additional attributes for the parent text element */
+    attrs?: RenderAttrs;
+}
+/**
+ * Parse rich text markup and return a RenderNode with tspan children.
+ */
+declare function parseRichText(input: string, options?: RichTextOptions): RenderNode;
+/**
+ * Format a value with rich text markup.
+ * E.g., richLabel("Revenue", 1234, { valueColor: "#3b82f6" })
+ * → "{b}Revenue{/b}: {color:#3b82f6}1,234{/color}"
+ */
+declare function richLabel(label: string, value: number | string, opts?: {
+    valueColor?: string;
+    valueWeight?: string;
+}): string;
+
+declare function registerChart(plugin: ChartTypePlugin): void;
+declare function getChart(type: string): ChartTypePlugin;
+declare function registerScale(type: ScaleType, factory: ScaleFactory): void;
+declare function getScaleFactory(type: ScaleType): ScaleFactory;
+declare function clearRegistry(): void;
+
+interface LinearScaleOpts {
+    domain?: [number, number];
+    range?: [number, number];
+    nice?: boolean;
+    clamp?: boolean;
+    format?: (value: number) => string;
+}
+declare function createLinearScale(opts?: LinearScaleOpts): Scale;
+
+interface CategoricalScaleOpts {
+    categories?: (string | number | Date)[];
+    range?: [number, number];
+    format?: (value: string | number | Date) => string;
+    /**
+     * When true, distributes categories into equal-width bands with
+     * each category centered in its band. This prevents items at
+     * the edges from overflowing the chart area (critical for bar charts).
+     * When false (default), positions are edge-to-edge.
+     */
+    band?: boolean;
+}
+declare function createCategoricalScale(opts?: CategoricalScaleOpts): Scale & {
+    setCategories(cats: (string | number | Date)[]): void;
+    /** Get the width of one band (only meaningful in band mode) */
+    bandwidth(): number;
+};
+
+interface TimeScaleOpts {
+    domain?: [number | Date, number | Date];
+    range?: [number, number];
+    format?: (value: Date) => string;
+}
+declare function createTimeScale(opts?: TimeScaleOpts): Scale;
+
+/**
+ * Chartts constants and default values.
+ *
+ * RULES:
+ * - Imports ONLY from types.ts.
+ * - Single source of truth for all default values.
+ * - Colors use var(--color-*) with hex fallbacks — Tailwind-first.
+ * - Every other module reads defaults from here. No duplicates.
+ */
+
+declare const CSS_PREFIX: "--chartts";
+declare const PALETTE: readonly ["var(--color-blue-500, #3b82f6)", "var(--color-red-500, #ef4444)", "var(--color-emerald-500, #10b981)", "var(--color-amber-500, #f59e0b)", "var(--color-violet-500, #8b5cf6)", "var(--color-pink-500, #ec4899)", "var(--color-cyan-500, #06b6d4)", "var(--color-lime-500, #84cc16)", "var(--color-orange-500, #f97316)", "var(--color-indigo-500, #6366f1)"];
+declare const LIGHT_THEME: ThemeConfig;
+declare const DARK_THEME: ThemeConfig;
+
+/**
+ * Named theme presets for different use cases.
+ *
+ * Each preset defines a complete ThemeConfig with a curated color palette,
+ * typography, and styling tuned for a specific aesthetic.
+ */
+declare const CORPORATE_THEME: ThemeConfig;
+declare const SAAS_THEME: ThemeConfig;
+declare const STARTUP_THEME: ThemeConfig;
+declare const EDITORIAL_THEME: ThemeConfig;
+declare const OCEAN_THEME: ThemeConfig;
+/** All named presets keyed by name */
+declare const THEME_PRESETS: Record<string, ThemeConfig>;
+
+/**
+ * Human-readable value formatter with SI suffixes.
+ * 1500 → "1.5K", 2000000 → "2M", 3000000000 → "3B"
+ */
+declare function formatValue(value: number): string;
+/**
+ * Percentage formatter: 0.75 → "75%", 42 → "42%"
+ * Values <= 1 are treated as ratios and multiplied by 100.
+ */
+declare function formatPercent(value: number): string;
+
+declare function createEventBus(): EventBus;
+
+/**
+ * Debug utilities for Chartts.
+ * Attach to a chart to get render tree inspection, event logging, and an overlay panel.
+ */
+interface DebugPanel {
+    attach(container: HTMLElement, svg: SVGElement): void;
+    update(ctx: RenderContext, nodes: RenderNode[]): void;
+    destroy(): void;
+}
+declare function createDebugPanel(): DebugPanel;
+
+export { Area, Bar, Baseline, Boxplot, type BrushConfig, type BrushInstance, Bubble, Bullet, CORPORATE_THEME, CSS_PREFIX, Calendar, Candlestick, ChartArea, ChartData, ChartInstance, ChartOptions, ChartTypePlugin, Chord, Combo, Custom, DARK_THEME, type DataZoomRange, type DataZoomSliderOptions, type DataZoomState, type DataZoomWidget, type DataZoomWidgetOptions, Donut, Dumbbell, EDITORIAL_THEME, EventBus, Funnel, Gauge, Geo, Graph, type GraphicArea, type GraphicElement, Heatmap, Histogram, HorizontalBar, Kagi, LIGHT_THEME, Line, Lines, Lollipop, Matrix, OCEAN_THEME, OHLC, PALETTE, Parallel, PictorialBar, Pie, Polar, PreparedData, Radar, RadialBar, Range, RenderAttrs, RenderContext, RenderNode, Renderer, Renko, type RichTextOptions, type RichTextStyle, SAAS_THEME, STARTUP_THEME, Sankey, Scale, ScaleFactory, ScaleType, Scatter, Sparkline, StackedBar, Step, type StreamingConfig, type StreamingInstance, Sunburst, THEME_PRESETS, ThemeConfig, ThemeRiver, Tree, Treemap, Volume, Waterfall, type ZoomPanConfig, type ZoomPanInstance, type ZoomPanState, aggregateData, annotation, applyDataZoom, clearRegistry, createBrush, createCanvasRenderer, createCategoricalScale, createDataZoomState, createDataZoomWidget, createDebugPanel, createEventBus, createGraphicElements, createLinearScale, createSVGRenderer, createStreamingChart, createTimeScale, createWebGLRenderer, createZoomPan, decimateData, filterData, filterLabels, filterSeries, formatPercent, formatValue, getChart, getScaleFactory, horizontalLine, linkCharts, parseRichText, pivotData, registerChart, registerScale, renderDataZoomSlider, richLabel, sliceData, sortData, transformData, verticalLine };