Timeline: allow to group multiple entries of same kind into a single node that can expand

[bpasero]

This is to explore whether the timeline view could aggregate multiple entries of the same source under a single node to reduce the spam from local history.

Examples from other products:

Notes

• entries should still be sorted from newest to oldest even when under a parent node
• relative time should be visible as with top level entries
• parent node should show most recent entries time

//cc @JacksonKearl @daviddossett @misolori

[bpasero]

This turned out to be a surprisingly small change so I pushed for it:

@daviddossett @misolori fyi, happy for feedback:

• I ended up using the same icon because in most cases the user will see the aggregated version and not a single entry and I quite like that icon already
• number of aggregated entries is shown as part of the label
• there is no tooltip and no command other than expand/collapse on such an entry, but we could enrich this

//cc @JacksonKearl this works by making Timeline allow to return children:

vscode/src/vs/workbench/contrib/timeline/common/timeline.ts

Lines 56 to 61 in b53e523

	/**
	* Optional support for grouping multiple timeline items
	* under a parent timeline, e.g. to flatten entries of
	* the same kind.
	*/
	children?: TimelineItem[];

[bpasero]

Oh, I had to revert that change, I forgot that the aggregation should not happen at the level of the provider but needs to happen inside the timeline view because we want to aggregate over all items from all sources and not within source. Otherwise the timeline would no longer show a real timeline with entries one after the other...

[daviddossett]

Looking good! Is it possible to use an explicit tree parent with open/close? If I didn't know what the behavior was, I wouldn't know it was clickable to show the actual entries. E.g.

number of aggregated entries is shown as part of the label

I wonder if a badge a la SCM could also work for here. The plain text in brackets is clear, but feels somewhat bespoke here since we have similar patterns for counting children elsewhere:

It could look like:

[bpasero]

👍 for both suggestions

[bpasero]

While this is very cool, I will let this sink for a little longer and wait for user feedback. Interestingly so far I did not hear the need from users, but it is also quite early.

If someone wants to jump ahead and take an attempt at this, here are some pointers:

• the original naive attempt I did where timelinePane sees the necessary changes to show a tree node
• however my attempt had the flaw that this grouping was controlled from the provider, but it needs to be implemented from the timeline itself
• I think *getItems() needs to be changed to enable grouping in a way that for as long as entries of the same kind would be yielded, they should group under 1 node
• this needs some kind of new API on the level of timeline item to signal opt-in to this

The challenge is probably within *getItems() to implement this while still supporting yield, so it would require some kind of peeking as well, -> fun.