#MoonChart

#Installation

moon add JunJunTnT/moonchart

import {
  "JunJunTnT/moonchart",
}

#Simple Demo

#Performance

#Quick Start

fn main {
  let data = [
    @moonchart.DataPoint::withErrY(0.0, 45.0, 3.0),
    @moonchart.DataPoint::withAsymErrY(1.0, 62.0, 2.5,7.5),
  ]

  let result = @moonchart.Chart::new()
    .title("Cell Viability")
    .xTicks([0.0, 1.0], ["Control", "Treated"])
    .xLabel("Condition")
    .yLabel("Viability (%)")
    .yRange(0.0, 100.0)
    .barWidthRatio(0.4)
    .series(@moonchart.Series::bar("24h", data))
    .toSvg()


  match result {
    Ok(svg) => println(svg)
    Err(e) => println("Error: \{e}")
  }

}

moon run cmd/main/main.mbt

#Chart Types

#Bar Chart

let data = [
  @moonchart.DataPoint::withErrY(0.0, 45.0, 3.0),
  @moonchart.DataPoint::withErrY(1.0, 62.0, 2.5),
]

@moonchart.Series::bar("Group A", data)
  .withColor(@moonchart.Color::rgb(0, 122, 184))
  .withBarStroke(@moonchart.Color::rgb(0, 80, 140), 1.0)

#Line Chart

let data = [
  @moonchart.DataPoint::new(0.0, 100.0),
  @moonchart.DataPoint::new(1.0, 85.0),
  @moonchart.DataPoint::new(2.0, 72.0),
]

@moonchart.Series::line("Trend", data)
  .withColor(@moonchart.Color::rgb(212, 57, 57))
  .withPointSize(5.0)
  .withPointShape(@moonchart.Diamond)
  .withLineStyle(@moonchart.Dashed)

#Scatter Plot

let data = [
  @moonchart.DataPoint::new(1.2, 2.1),
  @moonchart.DataPoint::new(2.3, 3.8),
  @moonchart.DataPoint::new(3.1, 5.2),
]

@moonchart.Series::scatter("Group X", data)
  .withColor(@moonchart.Color::rgb(0, 122, 184))
  .withPointSize(5.0)
  .withPointShape(@moonchart.Circle)
  .withPointFill(@moonchart.Color::rgb(255, 0, 0))

#Box Plot

let groups = [
  @moonchart.BoxGroup::new(0.0, "Control", [1.2, 2.1, 3.4, 2.8, 1.9, 2.5, 3.0, 2.3]),
  @moonchart.BoxGroup::new(1.0, "Treated", [0.8, 1.5, 2.9, 2.1, 1.3, 1.9, 2.4, 1.7]),
]

@moonchart.Series::boxplot("Expression", groups)
  .withColor(@moonchart.Color::rgb(0, 122, 184))
  .withShowOutliers(true)

#Mixed Charts

@moonchart.Chart::new()
  .series(@moonchart.Series::bar("Experiment", barData))
  .series(@moonchart.Series::line("Trend", trendData).withLineStyle(@moonchart.Dashed))

#Feature Matrix

#Builder API Reference

#Chart Builder

#Series Constructors

#Series Modifiers

#Data Types

DataPoint::new(x, y)                         // Simple (x, y) point
DataPoint::withErrY(x, y, err)               // Symmetric error bar: y ± err
DataPoint::withAsymErrY(x, y, lo, hi)        // Asymmetric error bar: +hi, -lo

BoxGroup::new(x, label, values)              // Raw data for box plot

#Enums

#Color

Color::rgb(r, g, b)       // Opaque color (alpha = 255)
Color::rgba(r, g, b, a)   // Color with alpha (0-255)

#Axis Configuration

AxisOption::defaultX()     // Default X axis (auto-infer ticks from data)
AxisOption::linearY()      // Default linear Y axis [0, 100]

#Static API

render(opt : ChartOption) -> Result[String, String]     // Render a ChartOption to SVG
saveSvg(filename : String, svg : String) -> Result[Unit, String]  // Write SVG string to file

#Running Examples

# Run individual examples
moon run examples/bar_chart        # Grouped bar chart with error bars → bar_chart.svg
moon run examples/line_chart       # Multi-series line chart → line_chart.svg
moon run examples/scatter_chart    # Scatter plot → scatter_chart.svg
moon run examples/boxplot_chart    # Box plot → boxplot_chart.svg
moon run examples/mixed_chart      # Bar + line mixed chart → mixed_chart.svg

Tip: All examples use Chart::new()...save("output.svg") to write directly to disk. For programmatic use, replace .save(...) with .toSvg() to get the SVG string.

#Visualization

# Start a local HTTP server in the demo directory
cd demo
python -m http.server 8080

#WASM Usage

pub fn render_chart(config_json : String) -> String

moon build --target wasm-gc

#License