elkjs is a JavaScript library that exposes ELK’s automatic layout algorithms for diagrams. It computes positions for the elements of a node-link graph, especially layer-based layouts with directions and ports, and can be used in Node.js or the browser (optionally via Web Workers).
Project status
- The source appears actively maintained, with an upstream GitHub push on 2026-09-17 and the most recent published update (0.12.0) on 2026-07-17.
- Update cadence looks moderately steady, with updates roughly every 4 to 6 months in the recent period (0.11.1 on 2026-03-03, 0.12.0 on 2026-07-17).
AI summary generated
Recent updates
0.12.0
Release 0.12.0 primarily introduces a secondary GPL-3.0-or-later license for elkjs, enabling reuse in GPL-3.0-or-later projects. The code diff, however, also shows substantial additions to the shipped JavaScript and TypeScript declaration files, plus smaller build and CI packaging changes.
BreakingFeatures0.11.1
Release 0.11.1 is described only as a security patch, but the diff shows a much broader set of packaging, CI, and type-definition changes. The codebase adds new compiled entry points and worker bundles, introduces TypeScript declaration files, and changes the npm release dist-tag behavior.
BreakingSecurity0.11.0
Release 0.11.0 is positioned as an ELK 0.11.0-based update, but the provided release notes do not enumerate specific user-facing changes. The code diff shows substantial packaging and API surface additions, plus a new supported layout algorithm (vertiflex) and updated worker handling logic.
Features0.10.2
Release 0.10.2 is described only as being based on several linked pull requests. In the provided code diff, the only explicit changes shown are the package version bump, plus substantial regeneration of the worker and bundled/minified artifacts (large net line churn).
0.10.1
Release 0.10.1 is presented as a small update on top of ELK 0.10.0, primarily changing the underlying Xtext version and bumping pbkdf2. However, the shipped artifacts in this diff also include a large set of new compiled/bundled files and new TypeScript declaration files for the public API.
0.10.0
Release 0.10.0 focuses on updating elkjs TypeScript typings, adding small JSON adapter and edge model enhancements, and introducing worker termination capabilities. The code diff also shows that the DisCo algorithm is excluded from the build, and a number of build tool and CI-related changes were made.
Features0.9.3
elkjs 0.9.3 is primarily a build and packaging update that brings in ELK 0.9.1 related changes, with documented updates to the test runner (mocha) and worker termination behavior. The release notes also reference an ELK improvement around considering node sizes in port placement space calculations.
Features0.9.2
Release 0.9.2 is documented as a fix for microlayout when combined with rectpacking. However, the provided code diff shows only CI workflow and README changes, with no library source changes visible for the microlayout fix.
0.9.1
Release 0.9.1 is described in the notes as a technical release with no feature differences compared to 0.9.0. The code diff, however, shows substantial addition of new build artifacts, including a new TypeScript API surface, worker bundles, and a Node wrapper entry point.
0.9.0
Release 0.9.0 is described only as “Based on ELK 0.9.0”, with no further documented changes included in the provided release notes. The release notes defer to an external ELK link for details, but that content is not present here.