Skip to content

Releases: shandley/ggterm

v0.3.11

08 Mar 03:38

Choose a tag to compare

What's New

Data Inventory on Init/Setup

  • npx ggterm-plot init and npx ggterm-plot setup now scan your directory (up to 5 levels deep) for CSV, TSV, JSON, and JSONL files
  • Analyzes column types, value ranges, and unique counts for each file
  • Generates plot suggestions based on column types
  • Writes .ggterm/data-inventory.md so Claude Code knows your data before you ask
  • TSV support for tab-separated bioinformatics data

Bug Fixes

  • fill aesthetic: Bar charts now correctly color by fill column (was only checking color)
  • coord_flip: Horizontal bar charts work in the Vega-Lite viewer (swaps x/y encodings)
  • REPL: coordFlip / coord_flip now available in the interactive REPL
  • Legend: Fill-only aesthetics now correctly show legends

Documentation

  • New Scientific Visualizations vignette covering volcano, Manhattan, Kaplan-Meier, forest, ROC, and Bland-Altman plots
  • Audited and fixed GEOM-REFERENCE.md (17 CLI names corrected)
  • Audited and fixed ARCHITECTURE.md (code examples, line counts)
  • Fixed geom count consistency (66) across all docs
  • Added Terminal-Native category to README

npm

npm install @ggterm/core@0.3.11

v0.3.10

08 Mar 02:10

Choose a tag to compare

What's New in v0.3.10

One-Command Setup

npx ggterm-plot setup

Installs everything, generates a welcome plot, opens the live viewer in your browser, and starts the server. Ready to go in seconds.

Live Plot Viewer

SSE-powered browser companion panel that auto-displays every plot as an interactive Vega-Lite visualization. Style and customize changes update in place — no page refresh.

  • Keyboard shortcuts: h (history), arrows (browse), s/p (export SVG/PNG), f (fullscreen)
  • Plot history with provenance tracking
  • Dark theme support
  • ResizeObserver for responsive reflow

8 Claude Code Skills

Skill Purpose
data-load Load CSV, JSON, JSONL data
ggterm-plot Create visualizations
ggterm-style Apply publication presets (Wilke, Tufte, Nature, Economist, APA, Minimal)
ggterm-customize Natural language customization
ggterm-publish Export to PNG, SVG, HTML
ggterm-history Browse and retrieve plots
ggterm-markdown Generate reports with plots
ggterm-help Get help with features

Grammar Primitives

  • 65 geometry types across essentials, scientific, diagnostics, and advanced categories
  • 73 scale functions (continuous, discrete, color, size, shape)
  • Statistical transforms, coordinate systems, faceting, themes
  • Backend-agnostic PlotSpec — consumed by terminal renderer and Vega-Lite exporter

Other Improvements Since v0.2.5

  • Built-in datasets: iris (150 rows), mtcars (16 rows)
  • Vega-Lite export fixes (zero-free axes, boxplot rendering)
  • Style/customize workflow for live viewer
  • Realistic iris dataset ranges
  • Comprehensive documentation rewrite
  • 2,158 tests

Full Changelog: v0.2.5...v0.3.10

v0.2.5

28 Jan 19:54

Choose a tag to compare

Fix npm publishing for private repo

v0.2.4

28 Jan 19:52

Choose a tag to compare

Test automated npm publishing with NPM_TOKEN

v0.2.3

28 Jan 19:44

Choose a tag to compare

Changes

  • Add JSON/JSONL file support to CLI
  • Add reference line geoms (+hline@y, +vline@x, +abline@slope,intercept)
  • Simplify to single @ggterm/core package
  • Fix repository URLs
  • Configure OIDC Trusted Publishing

Installation

npm install @ggterm/core

CLI Examples

# JSON/JSONL support
bun cli-plot.ts data.json x y
bun cli-plot.ts data.jsonl x y color

# Reference lines
bun cli-plot.ts data.csv x y - - point+hline@50+vline@2

v0.2.2

28 Jan 13:37

Choose a tag to compare

Fixes

  • Fix CI build order: core builds first, then render packages, then framework packages
  • Add explicit type annotations to lambda parameters in solid/vue packages
  • Fix Trusted Publishing workflow

Packages

  • @ggterm/core@0.2.2
  • @ggterm/render-braille@0.2.2
  • @ggterm/render-block@0.2.2
  • @ggterm/render-sixel@0.2.2
  • @ggterm/opentui@0.2.2
  • @ggterm/solid@0.2.2
  • @ggterm/svelte@0.2.2
  • @ggterm/vue@0.2.2

v0.2.1

28 Jan 13:34

Choose a tag to compare

What's New

  • Fix vue package build, update vue-tsc to v2
  • Add all 8 packages to Trusted Publishing workflow
  • Test Trusted Publishing via GitHub Actions

Packages

  • @ggterm/core@0.2.1
  • @ggterm/render-braille@0.2.1
  • @ggterm/render-block@0.2.1
  • @ggterm/render-sixel@0.2.1
  • @ggterm/opentui@0.2.1
  • @ggterm/solid@0.2.1
  • @ggterm/svelte@0.2.1
  • @ggterm/vue@0.2.1