Multi-series, multiple datasets, amCharts, and so much more!

This is the first release of @esri/cedar! 🎉

BREAKING CHANGES

JSON API

• support multi-series charts
• support joining multiple datasets

Charts & chart types

• use amCharts as the charting library to facilitate the above
• new "area" chart type
• new "radar" chart type
• default chart theme is based on the calcite color scheme

Runtime (JavaScript) API

• expose a new cedar namespace instead of Cedar() constructor as the global
• chart constructor (instead of .show()) establishes relationship to DOM node (const chart = new cedar.Chart('#chartDiv', chartDefinition))
• async operations like .show() return promises instead of taking callbacks
• new fluent API for chaining definition property setters and function calls (chart.type('bar').datasets(datasets).series(series).show())
• remove .transform() in favor of using promises to modify query responses as needed:

chart.query()
.then(queryResponse => {
  let modifiedResponse;
   // TODO: modify response
  return chart.updateData(modifiedResponse).render();
});

See the v1.x README for details on how to install and use @esri/cedar.

See the issues related to this release for more details.

Why alpha?

The only v0.x feature that we haven't addressed in v1 yet is events (i.e. exposing the chart's mouse clicks, movement, etc). Once we address that and these other issues, v1 will move into beta.

Here are the remaining issues that make up the v1.x roadmap.