Download HistropediaJS

Highlights

• Timeline charts – add line and area chart layers aligned to the timeline date scale.
• Date bounds – constrain the visible viewport with optional minimum and maximum dates.
• String option selectors – use descriptive values such as 'month', 'all', and 'screen' for precision, density, and stacking range.
• Improved start-date navigation – use timeline.setStartDate(date, { padding, animation }) for padded or animated jumps.
• Settled state-change events – timeline-state-change now fires after meaningful interactions settle, reducing save-handler noise.
• Date normalization fixes – plain date objects now default missing month/day values without mutating caller input.

v1.4.0 release blog post

Highlights

• Multi-lane timelines – organize events into separate horizontal lanes while sharing one bottom timeline axis.
• Lane layout and reordering APIs – add, style, hide, show, and reorder lanes at runtime.
• Date range fitting – use timeline.fitDateRange(start, end, options) to fit a supplied period into the viewport.
• Pan momentum and smoother wheel zooming – drag and notched wheel interactions feel more responsive by default.
• Responsive baseline distance and card layout breakpoints – adapt article spacing and card layout to the available height.
• Simplified download bundle – UMD, minified UMD, ESM, and one TypeScript definitions file.

Fixes

• Time Band opacity bleed – resets the canvas globalAlpha at the start of each Time Band draw so the overlay does not inherit the last rendered article's fade opacity when it has no image.

Fixes

• Legacy event handler this context – preserves the timeline instance as this inside legacy event handlers to maintain backward compatibility.

Fixes

• HiDPI shadows – aligns shadow dimensions with the canvas DPR for consistent size on high-density displays.
• Card border toggles – prevents landscape cards from drawing borders when border width is set to 0.
• Card height refresh – recalculates card height when border width changes to fix bottom alignment.

v1.3.0 release blog post

Highlights

• Zero dependencies – now only a single HistropediaJS file required.
• Card layouts – landscape layout and the ability to register custom layouts.
• Time Bands – highlight and label different time periods on the timeline.
• Event system – new EventManager API with 18 events.
• HiDPI support – configurable high-resolution canvas rendering.
• Image loading – redesigned loader and cache for a massive performance boost.
• Zoom options – smooth trackpad scrolling with automatic detection.
• TypeScript – full type definitions for IDE autocompletion and type safety.