@surprisal/hyperchart

Host-neutral Hyperchart authoring, machine, replay, runtime, and inspector models.

Install

npm install @surprisal/hyperchart

Requires Node.js 22.19 or newer.

Create a chart

import { chart, final, script } from "@surprisal/hyperchart";

export default chart({
  kind: "chart",
  id: "hello",
  initial: "run",
  states: {
    run: {
      kind: "state",
      action: script("node", ["-e", "console.log('done')"]),
      transitions: { DONE: "done" },
    },
    done: final(),
  },
});

A script with one successful transition may select it implicitly on exit code 0.

Entry points

| Import | Purpose | |---|---| | @surprisal/hyperchart | DSL, types, parsing, inspection, machine, projection, replay | | @surprisal/hyperchart/runtime | generic runtime, log stores, scripts, guards, artifacts | | @surprisal/hyperchart/host | canonical chart/run models and adapters | | @surprisal/hyperchart/package.json | package metadata |

This package has no Pi or React dependency.

Documentation

• Run your first chart
• Author charts
• Runtime and durability
• Complete API reference
• DSL reference and examples

MIT · experimental 0.1.1