@robinpath/chart

Generate chart images (PNG/JPEG) using Chart.js. Supports bar, line, pie, doughnut, scatter, radar, polarArea, and bubble charts with auto-coloring and customizable titles, legends, and dimensions.

Why use this module?

The chart module lets you:

• Create a new chart (bar, line, pie, doughnut, scatter, radar, polarArea, bubble)
• Add a dataset to an existing chart
• Update chart options (title, size, legend, type, labels)
• Render chart and save to PNG or JPEG file
• Render chart and return as base64 data URL string

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/chart

Quick Start

No credentials needed — start using it right away:

chart.addDataset "c1" {"label": "Costs", "data": [50, 80]}

Available Functions

Function	Description
chart.create	Create a new chart (bar, line, pie, doughnut, scatter, radar, polarArea, bubble)
chart.addDataset	Add a dataset to an existing chart
chart.update	Update chart options (title, size, legend, type, labels)
chart.save	Render chart and save to PNG or JPEG file
chart.toBase64	Render chart and return as base64 data URL string
chart.toBuffer	Render chart and return as raw Buffer
chart.destroy	Remove chart from memory

Examples

Add a dataset to an existing chart

chart.addDataset "c1" {"label": "Costs", "data": [50, 80]}

Update chart options (title, size, legend, type, labels)

chart.update "c1" {"title": "Updated Title", "width": 1200}

Render chart and save to PNG or JPEG file

chart.save "c1" "./output/chart.png"

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/chart";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  chart.addDataset "c1" {"label": "Costs", "data": [50, 80]}
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT