@kvickchart/core

Framework-independent chart definitions, normalized data, state, commands, and events for KvickChart.

Most React applications should install @kvickchart/react, which re-exports the definition helpers and connects this core to the worker renderer. Use this package directly when building another framework adapter or integrating the state model without React.

npm install @kvickchart/core@alpha

import { defineChart, normalizeChartData } from "@kvickchart/core"

const definition = defineChart<{ time: number; value: number }>()({
  axes: [
    { id: "time", dimension: "x", type: "time" },
    { id: "value", dimension: "y" },
  ],
  panes: [{ id: "main", xAxes: ["time"], yAxes: ["value"] }],
  series: [
    {
      id: "value",
      type: "line",
      x: "time",
      y: "value",
      xAxis: "time",
      yAxis: "value",
      pane: "main",
    },
  ],
})

const data = normalizeChartData(
  [
    { time: Date.UTC(2026, 0, 1), value: 42 },
    { time: Date.UTC(2026, 0, 2), value: 47 },
  ],
  definition,
)

The project is in alpha. Public APIs may change between prereleases.

See the repository documentation for architecture, examples, contributing, and security information.