Skip to content

v2.4.0

Latest
Latest

Choose a tag to compare

View all tags
@samussiah samussiah released this 14 Jul 15:56
v2.4.0
6e5a3e1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

New: bars Module

A brand-new ggplot2-aligned declarative bar chart module (bars) that reproduces disparate bar chart implementations across the gsm ecosystem, including most functionality in the existing, KRI-specific barChart module (#502, #482). Highlights include:

  • Spec-driven API — define charts with a declarative spec object (fill, position, scales, labels, theme, tooltip, etc.)
  • Position modes — stack (default), fill (within-category percentage normalization), dodge (side-by-side), and layered positioning
  • Stat modes — count (default) and percent
  • Dynamic category axis — legend-driven axis subsetting that hides categories with no visible data (#503)
  • Dynamic sizing — automatically adjusts chart height based on category count
  • Dense legend — compact legend with tooltip on hover (#494)
  • Zoom support — optional chartjs-plugin-zoom integration (#524)
  • Tick truncation & rotation — automatic categorical tick label truncation and rotation for long labels (#531)
  • Selection & highlight API — programmatic selection/highlight with selectCategories(), highlightCategories(), and clearSelection() methods
  • Click & hover callbacks — onClick and onHover hooks for interactive workflows (#488)
  • Reference lines — generic annotation-based reference lines with customizable styles (#498)
  • Label annotations — in-bar segment labels, total labels, and dynamic contrast coloring (#487)
  • Top-N limiting — spec.nCategories to show only the top N categories (#493)
  • Captions — user-defined chart footnotes via labels.captions and labels.captionsOptions
  • Export to PNG — exportImage() helper for one-click PNG download (#499)
  • Tooltip formatting — tooltip.format and tooltip.formatter convenience API with template string support (#489, #515)
  • Custom fill colors — scales.fill.colors named color map (#496)
  • updateData / updateSpec — update chart data or spec without full re-render

New: facetBars Module

A new faceting layer for bars that renders multiple linked sub-charts (#492):

  • Faceted layout — split data by a facet variable into separate sub-charts
  • Linked interactions — hover highlight syncs across all facets
  • Configurable scales — facet.scales.x.free toggles between constant and free category domains
  • Per-facet ordering — function-based x-axis order per facet panel
  • Chart height control — facet.chartHeight option for sub-chart sizing
  • Selection sync — selection state synchronized across faceted charts
  • Global category computation — consistent category ordering across facets

New: Bar Chart Builder

An interactive UI for constructing bars specifications:

  • Visual controls for position, fill, sort, scales, tooltip, and export
  • Live spec preview with JSON export
  • Zoom control integration

New: Documentation Site

  • Docsify-based documentation deployed to gh-pages
  • Collapsible navigation sidebar across all example pages
  • Module documentation differentiating between metric and generic chart modules

Enhancements

  • scatterPlot: Generate scatter bounds on demand with backwards compatibility (#473)
  • examples: KRI Facet, Retention, and Prevalence chart demonstrations
  • examples: Side-by-side hover table and click-to-scatter workflows

Bug Fixes

  • bars: Preserve legend colors during selection
  • bars: Harden truncateLabel against negative/NaN maxLength
  • bars: Filter unknown fill values when fill.order is provided
  • bars: Coerce labels to string in reorderDatasets for type-safe fill ordering
  • bars: Disable dynamic contrast color for segment.placement='end'
  • bars: Empty dataset data on hide to prevent CategoryScale re-adding labels
  • bars: Reset container dimensions on every render for dynamicSizing
  • facetBars: Guard setActiveElements against undefined chart elements
  • facetBars: Re-apply chartHeight after bars() clears container height
  • facetBars: Restore key variable in computeGlobalCategories function-order loop
  • facetBars: Pin category axis min/max for constant x domain
  • facetBars: Resolve function scales.x.order in computeGlobalScales
  • facetBars: Skip global category injection when dynamicCategoryAxis is true
  • scatterPlot: Generate scatter bounds on demand with backwards compatibility (#473)
  • Remove stray console.log calls

Infrastructure & Chores

  • Add Husky pre-commit hook to rebundle on every commit
  • OS/platform-agnostic npm scripts in package.json
  • AI agent framework with TDD-first skills (.agent/)
  • Issue templates for GitHub
  • Remove unused React dependencies
  • Dependency updates: lodash 4.18.1, esbuild 0.28.1, form-data 4.0.6, picomatch 2.3.2, minimatch 3.1.5, js-yaml 3.14.2, csvtojson 2.0.13, @babel/plugin-transform-modules-systemjs 7.29.4

What's Changed

Full Changelog: v2.3.0...v2.4.0

Contributors

samussiah and dependabot
Assets 2
Loading