@fusioncharts/fusiontime/readme.md

FusionCharts JavaScript time-series charting framework

## ⚠️ Internal only: this package is not supported for external use

### Package Summary (fc-timeseries)
This package contains the FusionTime (time-series) runtime: chart factories, scales, dataset renderers, navigator, range selectors, and supporting utilities that are shared across FusionCharts products. It is published to npm but is intended for internal consumption only (bundled via `fusioncharts`), not as a standalone public API. Key areas:
- Chart scaffolding and panel/layout orchestration for focus/context canvases.
- Axis/scale plumbing (linear/log/time-bin) and data-domain utilities.
- Datasets (line/area/column/candlestick) and navigator/custom range selector components.
- Internal test and tooling configuration for ESM/Ramda usage.

### Running targeted unit tests
Run the domain helper unit test with explicit config to handle ESM and mappings:

```
npx jest --config packages/fc-timeseries/jest.config.js --runTestsByPath packages/fc-timeseries/src/viz/timeseries/domain-utils.unit.test.js
```

### Changelog

#### Dec 2025
- Extracted domain helpers (`getLinearMinMax`, `getLogMinMax`, etc.) into `src/viz/timeseries/domain-utils.js` to decouple math from UI/toolbox dependencies.
- Introduced explicit padding controls (`maxPadding`, `minPadding`) and a `strictPadding` switch to respect user bounds without implicit headroom when desired; legacy padding branch retained for backward compatibility.
- Expanded unit coverage for domain calculations (user vs data bounds, equal bounds padding, negative-only clamping, explicit padding, missing data fallback) and added package-scoped Jest config to transpile ESM, map `ramda/es` to CJS, and run in jsdom when needed.

### Notes for developers
- This package assumes hoisted installs (Lerna) and relies on root `node_modules`; ensure `ramda` is installed at the workspace root when running tests locally.
- Tests are intended to be run with the package-specific Jest config to avoid resolver/DOM issues from broader FusionCharts dependencies.
- The package is internal-only; breaking changes may occur without a public semantic guarantee. Use the top-level `fusioncharts` package for public consumption.

### Metadata
- Owner: FusionCharts - An Idera, Inc. Company
- Maintainers: Meher Howji (FusionCharts Architect)
- Contact: <support@fusioncharts.com>