v2.4.0

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

• v2.3.0 by Spencer Childress (@samussiah) in #465
• v2.3.0 > dev by Spencer Childress (@samussiah) in #468
• Bump js-yaml from 3.14.1 to 3.14.2 by Dependabot (@dependabot)[bot] in #467
• Bump lodash from 4.17.21 to 4.17.23 by Dependabot (@dependabot)[bot] in #469
• Bump csvtojson from 2.0.10 to 2.0.13 by Dependabot (@dependabot)[bot] in #470
• Bump minimatch from 3.1.2 to 3.1.5 by Dependabot (@dependabot)[bot] in #472
• Bump picomatch from 2.3.1 to 2.3.2 by Dependabot (@dependabot)[bot] in #476
• Bump @tootallnate/once and jest-environment-jsdom by Dependabot (@dependabot)[bot] in #475
• fix: add scatterPlot predictBounds utility for issue #473 by Spencer Childress (@samussiah) in #474
• Bump lodash from 4.17.23 to 4.18.1 by Dependabot (@dependabot)[bot] in #477
• Bump @babel/plugin-transform-modules-systemjs from 7.20.11 to 7.29.4 by Dependabot (@dependabot)[bot] in #478
• feat: scaffold AI agent framework with TDD-first skills by Spencer Childress (@samussiah) in #504
• feat: add bars module with ggplot2-aligned spec API (#502, #482) by Spencer Childress (@samussiah) in #505
• Add support for bars as a percentage of the total for a given axis category. by Spencer Childress (@samussiah) in #506
• Add bars label annotations by Spencer Childress (@samussiah) in #507
• feat(bars): add scales.fill.colors named map and darkenHex guard (#496) by Spencer Childress (@samussiah) in #508
• feat(bars): tooltip format/formatter API + stable percentages on legend toggle (#489) by Spencer Childress (@samussiah) in #509
• feat(bars): add click and hover callback hooks (#488) by Spencer Childress (@samussiah) in #510
• feat(bars): add exportImage helper for PNG download by Spencer Childress (@samussiah) in #511
• feat(bars): add labels.captions and labels.captionsOptions for user-defined chart footnotes by Spencer Childress (@samussiah) in #512
• feat(bars): top-N category limiting (nCategories) by Spencer Childress (@samussiah) in #513
• feat(bars): add generic referenceLines annotation support by Spencer Childress (@samussiah) in #514
• feat(bars): enrich formatter details and add template string support by Spencer Childress (@samussiah) in #516
• feat(facetBars): faceted bar charts with linked interactions (#492) by Spencer Childress (@samussiah) in #518
• chore(deps-dev): bump esbuild from 0.25.12 to 0.28.1 by Dependabot (@dependabot)[bot] in #517
• Bump form-data from 4.0.5 to 4.0.6 by Dependabot (@dependabot)[bot] in #520
• feat(explorer): Data Explorer for bars/facetBars + facetBars bug fixes by Spencer Childress (@samussiah) in #521
• feat: add embedded position toggle to bars with fill mapping by Spencer Childress (@samussiah) in #523
• feat: add optional chartjs-plugin-zoom support to bars module by Spencer Childress (@samussiah) in #525
• feat(bars): add dense legend mode with tooltip on hover (#494) by Spencer Childress (@samussiah) in #526
• feat(bars): stacked, grouped, and layered bar position modes by Spencer Childress (@samussiah) in #528
• feat(bars): programmatic selection/highlight API by Spencer Childress (@samussiah) in #539
• feat(bars): add categorical tick label truncation and rotation (#531) by Spencer Childress (@samussiah) in #540
• fix: address v2.4.0 RC review findings by Spencer Childress (@samussiah) in #542
• Release Candidate: gsm.viz v2.4.0 by Spencer Childress (@samussiah) in #541

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

v2.3.0

v2.3.0 adds support to the group overview table module for the new site risk score calculation that applies weights to each metric and flag. View a full list of resolved issues here.

What's Changed

• Bump gh-pages from 4.0.0 to 5.0.0 by Dependabot (@dependabot)[bot] in #436
• add additional result-level attribute to tooltips by Spencer Childress (@samussiah) in #441
• Fix 440 by Spencer Childress (@samussiah) in #442
• Add site risk score column to group overview by Laura Maxwell (@lauramaxwell) in #454
• Bump on-headers and morgan by Dependabot (@dependabot)[bot] in #452
• Bump form-data from 4.0.0 to 4.0.4 by Dependabot (@dependabot)[bot] in #453
• Bump esbuild from 0.19.12 to 0.25.0 by Dependabot (@dependabot)[bot] in #456
• Resolve bug where x-axis ticks disappear when x-axis type is set to linear. by Spencer Childress (@samussiah) in #458
• remove mock data debug code from group overview module; add testing by Spencer Childress (@samussiah) in #460
• Add timestamp to GitHub Pages deployment. by Spencer Childress (@samussiah) in #462
• v2.3.0 by Spencer Childress (@samussiah) in #463

New Contributors

• Dependabot (@dependabot)[bot] made their first contribution in #436
• Laura Maxwell (@lauramaxwell) made their first contribution in #454

Full Changelog: v2.2.0...v2.3.0

v2.2.0

v2.2.0 is the first open-source release of this repo 🎉 The package has been renamed gsm.viz from rbm-viz to align with other packages in the OpenRBQM universe.

This release primarily enriches each module with additional group metadata that appears in the tooltips, which is visible on the website. Other updates include improved handling of missing data and support for asymmetrical and bidirectional threshold annotations. View a full list of resolved issues here.

What's Changed

• Create node.js.yml by Spencer Childress (@samussiah) in #408
• Use colored flags in groupOverview. by Jon Harmon (@jonthegeek) in #413
• v2.1.0 by Spencer Childress (@samussiah) in #406
• v2.1.0 by Spencer Childress (@samussiah) in #431
• Improved handling of missingness. by Spencer Childress (@samussiah) in #432
• Add edge case to threshold annotation heuristics. by Spencer Childress (@samussiah) in #434
• Update package namespace from rbmViz to gsmViz and add group attributes to all modules. by Spencer Childress (@samussiah) in #430
• v2.2.0 by Spencer Childress (@samussiah) in #435

New Contributors

• Jon Harmon (@jonthegeek) made their first contribution in #413

Full Changelog: v2.1.0...v2.2.0

v2.1.0

v2.1.0 extends the click event functionality with a new custom event named riskSignalSelected.

What's Changed

• v2.1.0 by Spencer Childress (@samussiah) in #414
• Add LICENSE. by Spencer Childress (@samussiah) in #427

Full Changelog: v2.0.0...v2.1.0

v2.0.0

What's Changed

• Add extensions. by Spencer Childress (@samussiah) in #358
• Added site overview functions. by MarianaZamarripa in #361
• Have Sparklines working from inherit function to flagStatusIcon() by MarianaZamarripa in #363
• Fix 374 by Taylor Rodgers (@taylorrodgers) in #382
• Site overview table by Spencer Childress (@samussiah) in #371
• Simplify thresholds specification and fix examples. by Spencer Childress (@samussiah) in #384
• fix metric sort by Spencer Childress (@samussiah) in #385
• Dev v1.2.0 by Spencer Childress (@samussiah) in #400
• v2.0.0 by Spencer Childress (@samussiah) in #395

New Contributors

• Taylor Rodgers (@taylorrodgers) made their first contribution in #382

Full Changelog: v1.1.0...v2.0.0

v1.1.0

v1.1.0 embeds site metadata in the scatter plot, bar chart, and time series modules.

What's Changed

• Add site metadata as a new parameter to each module. by Spencer Childress (@samussiah) in #370

Full Changelog: v1.0.6...v1.1.0

v1.0.6

Resolves #313

What's Changed

• Remove duplicate thresholds when mapping to flags. by Spencer Childress (@samussiah) in #314
• v1.0.6 by Spencer Childress (@samussiah) in #315

Full Changelog: v1.0.5...v1.0.6

v1.0.5

• Resolves #307
• Resolves #309
• Resolves #310

What's Changed

• Address overlapping points in discrete time series and improve algorithm that determines which group ID is returned on hover and click. by Spencer Childress (@samussiah) in #311
• v1.0.5 by Spencer Childress (@samussiah) in #312

Full Changelog: v1.0.4...v1.0.5

v1.0.4

• Resolves #293
• Resolves #303

What's Changed

• Resolve bug in overlapping tooltip in continuous time series. by Spencer Childress (@samussiah) in #305
• v1.0.4 by Spencer Childress (@samussiah) in #306

Full Changelog: v1.0.3...v1.0.4

v1.0.3

• Resolves #290
• Resolves #300

What's Changed

• Fix tooltip bug in discrete time series. by Spencer Childress (@samussiah) in #301
• v1.0.3 by Spencer Childress (@samussiah) in #302

Full Changelog: v1.0.2...v1.0.3