⚠️ 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: [email protected]