react-candlesticks 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jason Wilson, trendingcandles.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# React Candlesticks
+
+[![npm version](https://img.shields.io/npm/v/react-candlesticks)](https://www.npmjs.com/package/react-candlesticks)
+[![license](https://img.shields.io/npm/l/react-candlesticks)](./LICENSE)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/react-candlesticks)](https://bundlephobia.com/package/react-candlesticks)
+[![types included](https://img.shields.io/badge/types-included-3178C6?logo=typescript&logoColor=white)](https://www.npmjs.com/package/react-candlesticks)
+[![react 18%2B](https://img.shields.io/badge/react-18%2B-61DAFB?logo=react&logoColor=white)](https://react.dev/)
+[![docs](https://img.shields.io/badge/docs-trendingcandles.com-0A66C2)](https://docs.trendingcandles.com/)
+[![CI](https://github.com/trendingcandles/react-candlesticks/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/trendingcandles/react-candlesticks/actions/workflows/ci.yml)
+![Coverage total](./badges/coverage-total.svg)
+
+Canvas-powered, composable candlestick charts for React — built for serious trading UIs.
+
+Build responsive trading charts in React with candlesticks, indicators, crosshairs, zoom, and theming — rendered on Canvas for smooth performance on large datasets.
+
+`react-candlesticks` is in an early public release / soft launch phase. Feedback, bug reports, and edge-case reproductions are especially helpful right now.
+
+<!-- [![demo](./demo/demo-v3.gif)](https://stackblitz.com/edit/react-candlesticks?file=src%2FApp.tsx) -->
+[![demo](./demo/screenshot.png)](https://stackblitz.com/edit/react-candlesticks?file=src%2FApp.tsx)
+
+[![StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/edit/react-candlesticks?file=src%2FApp.tsx)
+
+[Website](https://trendingcandles.com/) • [Documentation](https://docs.trendingcandles.com/)
+
+For bugs and feature requests, [open an issue](https://github.com/trendingcandles/react-candlesticks/issues). For usage questions, [start a discussion](https://github.com/trendingcandles/react-candlesticks/discussions/new?category=q-a).
+
+---
+
+## Installation
+
+```bash
+npm install react-candlesticks
+```
+
+## Quick Start
+
+Paste this into your React app for a basic candlestick chart with volume:
+
+```tsx
+import 'react-candlesticks/style.css';
+import { Chart, Panel, Candlesticks, VolumeBars, exampleData }
+  from 'react-candlesticks';
+
+export default function App() {
+  return (
+    <Chart
+      width={800}
+      height={500}
+      granularity="d1"
+      data={exampleData} // demo data
+    >
+      <Panel heightRatio={3}>
+        <Candlesticks />
+      </Panel>
+      <Panel>
+        <VolumeBars />
+      </Panel>
+    </Chart>
+  );
+}
+```
+
+`granularity` is optional if your dataset uses a consistent interval and you want the library to infer it automatically. For empty/loading states, pass `granularity` explicitly.
+
+## Why React Candlesticks?
+
+- **Canvas rendering** — smooth zoom, pan, and hover with predictable performance on large datasets
+- **Composable like React** — build charts using JSX (React components)
+- **Trading-focused** — indicators, crosshairs, multi-panel layouts
+- **Precise interactions** — zoom, scroll, and hover tuned for financial UX
+- **Fully themeable** — light and dark mode, or provide a custom theme
+- **Lightweight & dependency-free** — no bloat, easy to ship
+
+---
+
+## Usage Patterns
+
+### Declarative (JSX) ✅ recommended
+
+The recommended approach for most use cases. Compose panels and layers declaratively using JSX.
+```tsx
+import { Chart, Panel, Candlesticks, VolumeBars, BollingerBands, EMA, MACD, RSI }
+  from 'react-candlesticks';
+
+<Chart granularity="d1" data={data}>
+  <Panel heightRatio={3}>
+    <Candlesticks />
+    <EMA period={50} />
+    <BollingerBands />
+  </Panel>
+  <Panel>
+    <VolumeBars />
+  </Panel>
+  <Panel>
+    <MACD />
+  </Panel>
+  <Panel>
+    <RSI />
+  </Panel>
+</Chart>
+```
+
+### Config-driven (panels prop)
+
+```tsx
+import { Chart } from 'react-candlesticks';
+
+<Chart
+  granularity="d1"
+  data={data}
+  panels={[
+    {
+      heightRatio: 3,
+      layers: [
+        { type: 'price:candlesticks' },
+        { type: 'ema', period: 20 },
+        { type: 'bollinger-bands' },
+      ]
+    },
+    {
+      layers: [{ type: 'volume:bars' }]
+    },
+    {
+      layers: [{ type: 'macd' }]
+    },
+    {
+      layers: [{ type: 'rsi' }]
+    }
+  ]}
+/>
+```
+
+### Theming
+
+Use the built-in `'light'` or `'dark'` theme, or provide a custom `Theme` object.
+```tsx
+import type { Theme } from 'react-candlesticks';
+
+// Named theme
+<Chart theme="dark" ... />
+
+// Custom theme
+<Chart theme={myCustomTheme} ... />
+```
+
+See the [Theme documentation](https://docs.trendingcandles.com/docs/api/theme/theme) for the full theme shape.
+
+---
+
+## Compatibility and Limitations
+
+- Supports React 18+ and React 19.
+- Ships ESM only; CommonJS/UMD consumers are not supported.
+- Intended for modern browser-based React apps.
+- Chart rendering and interaction are client-side. In SSR frameworks, render the chart from a client component or client-only boundary.
+- Runtime behavior depends on standard browser APIs including Canvas, `ResizeObserver`, `matchMedia`, `devicePixelRatio`, and Pointer Events for touch and pinch interactions.
+- If you target older browsers or restricted webviews, you may need compatibility checks or polyfills for APIs such as `ResizeObserver`.
+- Current chart time display defaults to `UTC`. A public chart-level timezone configuration API is not exposed yet, so if your UI requires exchange-local or user-local time labels, treat that as a current limitation.
+- Mouse, trackpad, touch, and pinch interactions are covered in modern evergreen browsers. If you rely on embedded webviews, older Safari/WebKit builds, or custom kiosk environments, verify pointer and wheel behavior in your exact target runtime before rollout.
+- Data should use a consistent interval if you want automatic `granularity` inference. For irregular datasets, pass `granularity` explicitly.
+
+---
+
+## Layers
+
+| Layer | Type string | Description |
+|---|---|---|
+| `<Candlesticks>` | `'price:candlesticks'` | OHLC candlestick chart |
+| `<PriceLine>` | `'price:line'` | Line chart of a single price field |
+| `<VolumeBars>` | `'volume:bars'` | Volume bar chart |
+| `<ATR>` | `'atr'` | Average True Range |
+| `<BollingerBands>` | `'bollinger-bands'` | Bollinger Bands overlay |
+| `<EMA>` | `'ema'` | Exponential Moving Average |
+| `<MACD>` | `'macd'` | MACD oscillator |
+| `<RSI>` | `'rsi'` | Relative Strength Index |
+| `<SMA>` | `'sma'` | Simple Moving Average |
+| `<Stochastic>` | `'stochastic'` | Stochastic Oscillator |
+
+---
+
+## API Reference
+
+- [`API Reference Home`](https://docs.trendingcandles.com/docs/api/)
+- [`ChartProps`](https://docs.trendingcandles.com/docs/api/chart/chart#properties)
+- [`PanelConfig`](https://docs.trendingcandles.com/docs/api/panel/panel-config)
+- [`LayerConfig`](https://docs.trendingcandles.com/docs/api/layer/layer-config)
+- [`Theme`](https://docs.trendingcandles.com/docs/api/theme/theme)
+- [`DataPoint`](https://docs.trendingcandles.com/docs/api/chart/data-point)
+- [`Granularity`](https://docs.trendingcandles.com/docs/api/chart/granularity)
+
+---
+
+## Project Notes
+
+- [`CHANGELOG.md`](./CHANGELOG.md)
+- [`SECURITY.md`](./SECURITY.md)
+- [`CONTRIBUTING.md`](./CONTRIBUTING.md)
+
+---
+
+## Prop Types
+
+If you want runtime prop validation in a JavaScript app, install the optional peer dependency too:
+
+```bash
+npm install react-candlesticks prop-types
+```
+
+Then import `Chart` from the opt-in `propTypes` entrypoint:
+
+```js
+import { Chart } from 'react-candlesticks/propTypes';
+```
+
+---
+
+## License
+
+[MIT](./LICENSE)

package/dist/components/Chart/Chart.d.ts

@@ -0,0 +1,36 @@
+import { HTMLAttributes, JSX, ReactNode } from 'react';
+import { DataPoint } from '../../domain/types/DataPoint';
+import { PanelConfig } from '../../config/panel/PanelConfig';
+import { Theme } from '../../domain/types/Theme';
+import { ThemeName } from '../../themes/themes';
+import { Granularity } from '../../domain/types/Granularity';
+import { GridConfig } from '../../config/chart/grid/GridConfig';
+import { CrosshairsConfig } from '../../config/chart/crosshairs/CrosshairsConfig';
+import { XAxisConfig } from '../../config/chart/xAxis/XAxisConfig';
+interface ChartPropsBase extends Omit<HTMLAttributes<HTMLDivElement>, 'onScroll'> {
+    width?: number | 'auto';
+    height?: number | 'auto';
+    intervalWidthPx?: number;
+    granularity?: Granularity;
+    backgroundColor?: string;
+    xAxis?: false | XAxisConfig;
+    grid?: false | GridConfig;
+    crosshairs?: false | CrosshairsConfig;
+    theme?: Theme | ThemeName;
+    data: DataPoint[];
+    scrollToLatestMargin?: number;
+    onScroll?: (newScrollOffset: number) => void;
+    onZoom?: (newIntervalWidthPx: number) => void;
+}
+interface PanelsAsPropChartProps extends ChartPropsBase {
+    panels?: readonly [PanelConfig, ...PanelConfig[]];
+    children?: never;
+}
+interface PanelsAsChildrenChartProps extends ChartPropsBase {
+    panels?: never;
+    children?: ReactNode;
+}
+type PanelsProps = PanelsAsPropChartProps | PanelsAsChildrenChartProps;
+export type ChartProps = ChartPropsBase & PanelsProps;
+declare const _default: import('react').MemoExoticComponent<({ width, height, intervalWidthPx, granularity, backgroundColor, xAxis, grid, crosshairs, theme, panels, data, scrollToLatestMargin, onScroll, onZoom, children, ...props }: ChartProps) => JSX.Element>;
+export default _default;

package/dist/components/Chart/ChartWithPropTypes.d.ts

@@ -0,0 +1,7 @@
+import { NamedExoticComponent } from 'react';
+import { ChartProps } from './Chart';
+type ChartWithPropTypesComponent = NamedExoticComponent<ChartProps> & {
+    propTypes?: Record<string, unknown>;
+};
+declare const ChartWithPropTypes: ChartWithPropTypesComponent;
+export default ChartWithPropTypes;

package/dist/components/Chart/chartPropTypes.d.ts

@@ -0,0 +1,21 @@
+import { default as PropTypes } from 'prop-types';
+import { ThemeName } from '../../themes/themes';
+type InternalPropTypeValidator = (props: Record<string, unknown>, propName: string, componentName: string, location: string, propFullName: string, secret?: string) => Error | null;
+declare const chartPropTypes: {
+    width: InternalPropTypeValidator;
+    height: InternalPropTypeValidator;
+    intervalWidthPx: PropTypes.Requireable<number>;
+    granularity: PropTypes.Requireable<string>;
+    backgroundColor: PropTypes.Requireable<string>;
+    xAxis: PropTypes.Requireable<NonNullable<boolean | object | null | undefined>>;
+    grid: PropTypes.Requireable<NonNullable<boolean | object | null | undefined>>;
+    crosshairs: PropTypes.Requireable<NonNullable<boolean | object | null | undefined>>;
+    theme: PropTypes.Requireable<NonNullable<object | ThemeName | null | undefined>>;
+    data: PropTypes.Validator<object[]>;
+    scrollToLatestMargin: PropTypes.Requireable<number>;
+    onScroll: PropTypes.Requireable<(...args: any[]) => any>;
+    onZoom: PropTypes.Requireable<(...args: any[]) => any>;
+    panels: InternalPropTypeValidator;
+    children: InternalPropTypeValidator;
+};
+export default chartPropTypes;

package/dist/components/Chart/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export { default } from './Chart';
+export type { ChartProps } from './Chart';

package/dist/components/Chart/parseConfigComponents.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { PanelConfig } from '../../config/panel/PanelConfig';
+import { LayerConfig } from '../../config/layer/LayerConfig';
+export interface ConfigNode {
+    type: string;
+    props: Record<string, any>;
+    children?: ConfigNode[];
+}
+export interface LayerConfigNode {
+    props: Record<string, any>;
+}
+export interface PanelConfigNode {
+    props: Record<string, any>;
+    layers?: LayerConfigNode[];
+}
+export declare function mapLayerElementToConfig(element: ReactNode): LayerConfig | null;
+export declare function mapPanelElementsToConfig(element: ReactNode): PanelConfig | null;
+declare const parseConfigComponents: (chartChildElements: ReactNode) => PanelConfig[];
+export default parseConfigComponents;

package/dist/components/ChartCanvases/ChartCanvases.d.ts

@@ -0,0 +1,26 @@
+import { ChartConfigComplete } from '../../config/chart/ChartConfig';
+import { Layout } from '../../domain/types/Layout';
+import { PanelConfigComplete } from '../../config/panel/PanelConfig';
+import { LayerMetrics } from '../../domain/types/metrics/LayerMetrics';
+import { PanelMetrics } from '../../domain/types/metrics/PanelMetrics';
+import { LayerScale } from '../../config/layer/BaseLayerConfig';
+import { default as DataPointInfo } from '../../domain/types/DataPointInfo';
+import { default as ViewportData } from '../../domain/types/ViewportData';
+export type ChartCanvasesHandle = {
+    requestDraw: (viewportData: ViewportData, layout: Layout, updatePanelMetrics?: (metricsByPanel: Record<string, {
+        panelMetrics: PanelMetrics;
+        layerMetricsByScale: Record<LayerScale['key'], LayerMetrics>;
+    }>) => void) => void;
+    requestDrawCrosshairs: (layout: Layout, viewportData: ViewportData, clientX: number, clientY: number, onCrosshairsMove?: (ts: number | null, dataPoint: DataPointInfo | null) => void) => void;
+    updateCrosshairsCanvas: (layout: Layout) => void;
+    hideCrosshairs: (layout: Layout) => void;
+};
+export interface ChartCanvasesProps {
+    width: number;
+    height: number;
+    layout: Layout;
+    config: ChartConfigComplete;
+    panels: PanelConfigComplete[];
+}
+declare const ChartCanvases: import('react').ForwardRefExoticComponent<ChartCanvasesProps & import('react').RefAttributes<ChartCanvasesHandle>>;
+export default ChartCanvases;

package/dist/components/ChartCanvases/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export { default } from './ChartCanvases';
+export type { ChartCanvasesProps } from './ChartCanvases';

package/dist/components/InteractiveArea/InteractiveArea.d.ts

@@ -0,0 +1,13 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export interface InteractiveAreaProps {
+    onScroll: (deltaX: number, deltaY: number, wheel?: boolean) => void;
+    onMouseMove: (clientX: number, clientY: number, isOverButton?: boolean) => void;
+    onZoom: (delta: number) => void;
+}
+declare const _default: import('react').MemoExoticComponent<({ onScroll, onMouseMove, onZoom, }: InteractiveAreaProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/InteractiveArea/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export { default } from './InteractiveArea';
+export type { InteractiveAreaProps } from './InteractiveArea';

package/dist/components/StatefulChart/StatefulChart.d.ts

@@ -0,0 +1,26 @@
+import { ChartConfigComplete } from '../../config/chart/ChartConfig';
+import { Layout } from '../../domain/types/Layout';
+import { PanelConfigComplete } from '../../config/panel/PanelConfig';
+import { Granularity } from '../../domain/types/Granularity';
+import { LayersData } from '../../domain/types/LayersData';
+import { IndexProvider } from '../../domain/types/IndexProvider';
+import { DataMap } from '../../domain/types/DataMap';
+export interface StatefulChartProps {
+    chartWidth: number;
+    chartHeight: number;
+    intervalSize: number;
+    granularity: Granularity;
+    config: ChartConfigComplete;
+    panels: PanelConfigComplete[];
+    layout: Layout;
+    indexProvider: IndexProvider;
+    dataMap: DataMap;
+    initialLayersData: LayersData;
+    maxLookback: number;
+    maxLookForward: number;
+    scrollToLatestMargin: number;
+    onScroll?: (newScrollOffset: number) => void;
+    onZoom?: (newIntervalSize: number) => void;
+}
+declare const _default: import('react').MemoExoticComponent<({ chartWidth, chartHeight, intervalSize, granularity, config, panels, layout, indexProvider, dataMap, initialLayersData, maxLookback, maxLookForward, scrollToLatestMargin, onScroll, onZoom, }: StatefulChartProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/StatefulChart/getViewportData.d.ts

@@ -0,0 +1,6 @@
+import { IndexProvider } from '../../domain/types/IndexProvider';
+import { TimeScale } from '../../domain/types/TimeScale';
+import { default as ViewportData } from '../../domain/types/ViewportData';
+import { LayersData } from '../../domain/types/LayersData';
+declare function getViewportData(indexProvider: IndexProvider, timeScale: TimeScale, layersData: LayersData, scrollOffset: number, viewportWidth: number, intervalSize: number): ViewportData;
+export default getViewportData;

package/dist/components/StatefulChart/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export { default } from './StatefulChart';
+export type { StatefulChartProps } from './StatefulChart';

package/dist/components/UIs/PanelUIs/Legend/Legend.d.ts

@@ -0,0 +1,13 @@
+import { LegendConfigComplete } from '../../../../config/legend/LegendConfig';
+import { DataPoint } from '../../../../domain/types/DataPoint';
+import { LayerConfigComplete } from '../../../../config/layer/LayerConfig';
+import { default as DataPointInfo } from '../../../../domain/types/DataPointInfo';
+export interface LegendHandle {
+    update: (dataPoint: DataPointInfo | null, latestDataPoint?: DataPoint) => void;
+}
+export interface LegendProps {
+    layer: LayerConfigComplete;
+    legend: LegendConfigComplete;
+}
+declare const _default: import('react').MemoExoticComponent<import('react').ForwardRefExoticComponent<LegendProps & import('react').RefAttributes<LegendHandle>>>;
+export default _default;

package/dist/components/UIs/PanelUIs/PanelControls/PanelControls.d.ts

@@ -0,0 +1,13 @@
+import { PanelControlsConfigComplete } from '../../../../config/panel/controls/PanelControlsConfig';
+import { PanelMetrics } from '../../../../domain/types/metrics/PanelMetrics';
+export interface PanelControlsHandle {
+    updateGoToLatestButton: (show: boolean) => void;
+}
+export interface PanelControlsProps {
+    panelMetrics: PanelMetrics;
+    panelControls: PanelControlsConfigComplete;
+    onGoToLatestButtonClick: () => void;
+    onButtonMouseEnterLeave: (enter: boolean) => void;
+}
+declare const _default: import('react').MemoExoticComponent<import('react').ForwardRefExoticComponent<PanelControlsProps & import('react').RefAttributes<PanelControlsHandle>>>;
+export default _default;

package/dist/components/UIs/PanelUIs/PanelUIs.d.ts

@@ -0,0 +1,16 @@
+import { DataPoint } from '../../../domain/types/DataPoint';
+import { PanelConfigComplete } from '../../../config/panel/PanelConfig';
+import { PanelMetrics } from '../../../domain/types/metrics/PanelMetrics';
+import { default as DataPointInfo } from '../../../domain/types/DataPointInfo';
+export interface PanelUIsHandle {
+    updateLegends: (dataPoint: DataPointInfo | null, latestDataPoint?: DataPoint) => void;
+    updateGoToLatestButton: (show: boolean) => void;
+}
+export interface PanelUIsProps {
+    panel: PanelConfigComplete;
+    panelMetrics?: PanelMetrics;
+    onGoToLatest: () => void;
+    onButtonMouseEnterLeave: (enter: boolean) => void;
+}
+declare const _default: import('react').MemoExoticComponent<import('react').ForwardRefExoticComponent<PanelUIsProps & import('react').RefAttributes<PanelUIsHandle>>>;
+export default _default;

package/dist/components/UIs/UIs.d.ts

@@ -0,0 +1,23 @@
+import { PanelConfigComplete } from '../../config/panel/PanelConfig';
+import { Layout } from '../../domain/types/Layout';
+import { DataPoint } from '../../domain/types/DataPoint';
+import { PanelMetrics } from '../../domain/types/metrics/PanelMetrics';
+import { LayerMetrics } from '../../domain/types/metrics/LayerMetrics';
+import { LayerScale } from '../../config/layer/BaseLayerConfig';
+import { default as DataPointInfo } from '../../domain/types/DataPointInfo';
+export type UisHandle = {
+    updatePanelMetrics?: (metricsByPanel: Record<string, {
+        panelMetrics: PanelMetrics;
+        layerMetricsByScale: Record<LayerScale['key'], LayerMetrics>;
+    }>) => void;
+    updateLegends: (dataPoint: DataPointInfo | null, latestDataPoint?: DataPoint) => void;
+    updateGoToLatestButton: (show: boolean) => void;
+};
+export interface UIsProps {
+    layout: Layout;
+    panels: PanelConfigComplete[];
+    onGoToLatest: () => void;
+    onButtonMouseEnterLeave: (enter: boolean) => void;
+}
+declare const _default: import('react').MemoExoticComponent<import('react').ForwardRefExoticComponent<UIsProps & import('react').RefAttributes<UisHandle>>>;
+export default _default;

package/dist/components/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export { default as Chart } from './Chart';
+export { type ChartProps } from './Chart';

package/dist/config/chart/ChartConfig.d.ts

@@ -0,0 +1,19 @@
+import { BordersConfig, BordersConfigComplete } from './borders/BordersConfig';
+import { CrosshairsConfig, CrosshairsConfigComplete } from './crosshairs/CrosshairsConfig';
+import { GridConfig, GridConfigComplete } from './grid/GridConfig';
+import { XAxisConfig, XAxisConfigComplete } from './xAxis/XAxisConfig';
+export interface ChartConfigComplete {
+    backgroundColor: string;
+    borders: null | BordersConfigComplete;
+    xAxis: null | XAxisConfigComplete;
+    grid: null | GridConfigComplete;
+    crosshairs: null | CrosshairsConfigComplete;
+}
+export interface ChartConfig {
+    backgroundColor?: string;
+    borders?: false | BordersConfig;
+    xAxis?: false | XAxisConfig;
+    grid?: false | GridConfig;
+    crosshairs?: false | CrosshairsConfig;
+}
+export declare const chartDefaults: Pick<ChartConfigComplete, 'backgroundColor'>;

package/dist/config/chart/borders/BordersConfig.d.ts

@@ -0,0 +1,21 @@
+import { LineConfig, LineConfigComplete } from '../../elements/line/LineConfig';
+export interface BordersConfigComplete {
+    left: null | LineConfigComplete;
+    right: null | LineConfigComplete;
+    top: null | LineConfigComplete;
+    bottom: null | LineConfigComplete;
+}
+export interface BordersConfig {
+    left?: false | LineConfig;
+    right?: false | LineConfig;
+    top?: false | LineConfig;
+    bottom?: false | LineConfig;
+}
+export interface BordersTheme {
+    left: LineConfigComplete;
+    right: LineConfigComplete;
+    top: LineConfigComplete;
+    bottom: LineConfigComplete;
+}
+export declare const bordersDefaults: BordersConfigComplete;
+export declare const themeDefaultBorders: BordersTheme;

package/dist/config/chart/borders/parseBordersConfig.d.ts

@@ -0,0 +1,3 @@
+import { BordersConfig, BordersConfigComplete, BordersTheme } from './BordersConfig';
+declare const parseBordersConfig: (partialConfig?: false | BordersConfig, defaults?: BordersTheme, color?: string) => null | BordersConfigComplete;
+export default parseBordersConfig;

package/dist/config/chart/crosshairs/CrosshairsConfig.d.ts

@@ -0,0 +1,14 @@
+import { TimeCrosshairConfig, TimeCrosshairConfigComplete, TimeCrosshairTheme } from './timeCrosshair/TimeCrosshairConfig';
+import { ValueCrosshairConfig, ValueCrosshairConfigComplete, ValueCrosshairTheme } from './valueCrosshair/ValueCrosshairConfig';
+export interface CrosshairsConfigComplete {
+    value: null | ValueCrosshairConfigComplete;
+    time: null | TimeCrosshairConfigComplete;
+}
+export interface CrosshairsConfig {
+    value?: false | ValueCrosshairConfig;
+    time?: false | TimeCrosshairConfig;
+}
+export interface CrosshairsTheme {
+    time: TimeCrosshairTheme;
+    value: ValueCrosshairTheme;
+}

package/dist/config/chart/crosshairs/parseCrosshairsConfig.d.ts

@@ -0,0 +1,3 @@
+import { CrosshairsConfigComplete, CrosshairsConfig, CrosshairsTheme } from './CrosshairsConfig';
+declare const parseCrosshairsConfig: (partialConfig: (false | CrosshairsConfig) | undefined, crosshairsTheme: CrosshairsTheme) => null | CrosshairsConfigComplete;
+export default parseCrosshairsConfig;

package/dist/config/chart/crosshairs/timeCrosshair/TimeCrosshairConfig.d.ts

@@ -0,0 +1,14 @@
+import { LineConfig, LineConfigComplete } from '../../../elements/line/LineConfig';
+import { TimeCrosshairLabelConfig, TimeCrosshairLabelConfigComplete } from './timeCrosshairLabel/TimeCrosshairLabelConfig';
+export interface TimeCrosshairConfigComplete {
+    line: null | LineConfigComplete;
+    label: null | TimeCrosshairLabelConfigComplete;
+}
+export interface TimeCrosshairConfig {
+    line?: false | LineConfig;
+    label?: false | TimeCrosshairLabelConfig;
+}
+export interface TimeCrosshairTheme {
+    line: LineConfigComplete;
+    label: Omit<TimeCrosshairLabelConfigComplete, 'formatter'>;
+}

package/dist/config/chart/crosshairs/timeCrosshair/parseTimeCrosshairConfig.d.ts

@@ -0,0 +1,3 @@
+import { TimeCrosshairConfig, TimeCrosshairConfigComplete, TimeCrosshairTheme } from './TimeCrosshairConfig';
+declare const parseTimeCrosshairConfig: (partialConfig: (false | TimeCrosshairConfig) | undefined, timeCrosshairTheme: TimeCrosshairTheme) => null | TimeCrosshairConfigComplete;
+export default parseTimeCrosshairConfig;

package/dist/config/chart/crosshairs/timeCrosshair/timeCrosshairLabel/CrosshairTimeFormat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * react-candlesticks, trendingcandles.com
+ *
+ * Copyright (c) 2026 Jason Wilson
+ * Licensed under the MIT License (see LICENSE file in the project root).
+ */
+export type CrosshairTimeFormat = 'ddd DD MMM YY HH:mm' | 'ddd DD MMM YY';

package/dist/config/chart/crosshairs/timeCrosshair/timeCrosshairLabel/TimeCrosshairLabelConfig.d.ts

@@ -0,0 +1,10 @@
+import { BoxedTimeLabelConfig, BoxedTimeLabelConfigComplete, BoxedTimeLabelTheme } from '../../../../elements/boxedTimeLabel/BoxedTimeLabelConfig';
+import { TimeCrosshairLabelFormatter } from './TimeCrosshairLabelFormatter';
+export interface TimeCrosshairLabelConfigComplete extends Omit<BoxedTimeLabelConfigComplete, 'formatter'> {
+    formatter: TimeCrosshairLabelFormatter;
+}
+export interface TimeCrosshairLabelConfig extends Omit<BoxedTimeLabelConfig, 'formatter'> {
+    formatter?: TimeCrosshairLabelFormatter;
+}
+export type TimeCrosshairLabelTheme = BoxedTimeLabelTheme;
+export declare const timeCrosshairLabelDefaults: TimeCrosshairLabelConfigComplete;

package/dist/config/chart/crosshairs/timeCrosshair/timeCrosshairLabel/TimeCrosshairLabelFormatter.d.ts

@@ -0,0 +1,7 @@
+import { TimeUnit } from '../../../../../domain/types/TimeUnit';
+export interface TimeCrosshairLabelFormatterArgs {
+    utcTs: number;
+    timeUnit: TimeUnit;
+    timeZoneId?: string | null;
+}
+export type TimeCrosshairLabelFormatter = (args: TimeCrosshairLabelFormatterArgs) => string;