Changelog

Unreleased

Packaging / repo

• Split into the standalone canvas-timeline repository: a self-contained package entry (index.js) re-exports CanvasTimeline plus DataSet/DataView (with a ./renderer subpath for the renderer alone). Declares vis-timeline and vis-data as dependencies for ecosystem interop without importing vis-timeline's source. Simplified single-repo GitLab Pages CI (+ a test job).

Bug fixes (round-3 review pass)

• Circular nestedGroups no longer hang the page; zero-width containers no longer poison the viewport on zoom; setItems preserves the window (initial start/end and later updates); DataSet remove recomputes bounds/heights; setWindow restacks; a queued render can't fire after destroy().

Features

• timeResolution option (default 60000 ms) — a timeline-wide resolution unit that quantizes all manual edits; committed values snap to the nearest unit on mouseup. Keyboard Shift+Arrow nudges by exactly one unit.
• Fullscreen button in the zoom-control overlay (+ toggleFullscreen() / isFullscreen()); the body grows to fill the screen in fullscreen.
• hour24 option (default on) — axis and probe time-of-day labels use a 24-hour clock (13:00) instead of 12-hour with AM/PM.
• Time-probe chip now overlaps the minimap (aligned above the body probe line), falling back to the bottom axis when there's no minimap.
• topAxis option renders the time gutter above the body as well as below.
• Keyboard ←/→ stay within the focused item's group (minimal vertical jumping); ↑/↓ move to the nearest-in-time item in the adjacent group.

Changes

• Edits snap to a fixed one-minute grid at every zoom level (reverted the earlier adaptive snap) — the smallest meaningful step for a one-day timeline.
• Stress-test demo is now bounded to a single day (24h) with hard min/max.

Internal

• Split the ~3.3k-line renderer into mixin modules: timeline/layout.js, timeline/rendering.js, timeline/interaction.js (+ mixin.js). Core file is now ~1.3k lines. No behavior change.

0.2.0

Round-2 feature work, bug fixes, and a quality pass toward production baseline.

Features

• Vertical scrollbar on the left of the body for fast vertical navigation (auto-hides when content fits; also clamps over-scroll).
• Front-layer block items (layer:'front' / onTop) that cover the items beneath, with a per-block opacity override.
• Linear-gradient block fills (gradient: true | ['#a','#b'], gradientDirection).
• Snap-to-item / magnetic edges when dragging or resizing (snapToItems, snapDistance), on a stable absolute-from-origin drag model.
• Desktop keyboard navigation & focus ring (keyboard): arrow-key item navigation, Shift+Arrow nudge, +/− zoom, Home/End, F fit, Esc, Enter.
• Configurable fonts (fontFamily, fontSize) and an icon system: leading item icons via glyph registry, standalone images, or a sprite atlas (icons, iconAtlas, iconSize).
• TypeScript declarations (src/canvas-timeline.d.ts) and a documented public API (wired via types/exports).
• Event parity: rangechange / rangechanged, itemover / itemout, contextmenu.

Fixes

• Tiny/single-item datasets now open at a 24h minimum span (was ~2h).
• Adaptive grid snap so resizing registers when zoomed in (was fixed 1-minute).
• Stable stacking during drag — items no longer jump rows mid-gesture; one restack on drop.
• Selected items draw on top of stacked neighbours (text stays readable).
• Time-axis labels align with body grid lines (label-panel offset fixed).
• Minimap aligned with the body region.
• Time-probe label moved to the axis strip so it no longer covers top-row items.
• Follow-now pauses while the tab is hidden.

Internal

• Extracted stateless helpers into modules (theme.js, colors.js, canvas-draw.js, time-format.js); deduped item-by-group partitioning.
• Docs: README (full option/API reference), EXAMPLES (recipes), optimizations.html (deferred perf work), expanded bugs-and-issues.txt.
• Tests grew from 33+14 to 51+19 assertions; all green.

0.1.0

Initial canvas renderer with features F1–F16 (uniform color + accent, error stripes, dark mode, group highlight, row hover/selected highlight, textless items, compact styling, blocks across subgroups, minimap, follow-now, time probe, multi-timeline, live appends) plus migration/risks/future docs.

← Back to demos & docs