Download HistropediaJS

Fixes

• Time-aware date parts. Date-part objects containing hours, minutes, seconds, or milliseconds now infer the appropriate precision when you do not specify one; date-only values still default to day precision, and an explicit setting always wins.
• Automatic height fitting after option changes. With auto-fit enabled, changing reserved vertical space through timeline.setOption(...)—including parent date-label visibility or height—now refits stacked articles before redraw, with no manual fitToHeight() call needed.

Highlights

• Timelines down to the millisecond. Add hours, minutes, seconds, and milliseconds to your data, then jump straight to an exact moment. Existing timelines keep their familiar day-level zoom unless you choose to enable the closer scales.
• Clearer dates at every scale. Optional sticky and parent labels help people keep track of the wider date context.
• More visual control. Style the main timeline with a solid colour or gradient, customise article date indicators, choose your chart palette, and control chart grid lines.
• Easier custom card layouts. Custom layouts, available since v1.3.0, now have more predictable styling and simpler tools for drawing cards and handling their interactive areas.
• More reliable rendering. Charts remain visible with extremely distant data, and card connectors stay crisp and correctly aligned across display and pixel-snapping modes.
• More dependable date calculations. Dmy objects retain their chosen precision during calculations and correctly update the day of year after their date fields are edited.

Highlights

• Elastic date-bound dragging. Prevents viewport jumps when a pinch gesture returns to a single-pointer drag.

v1.5.0 release blog post

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.