feat: trees and lists

[caarlos0]

Worked on top of @maaslalani trees and lists implementations, fixed some bugs, refactor some stuff, added a couple of possibilities (namely, sublists (as trees)), etc.

Its a big PR, but it if it makes it better, it closes this 4 other PRs:

closes #242
closes #240
closes #243
closes #263

Some examples:

[bashbunni]

Hey @testinfected we're still doing some usability tests on the API to decide if the developer experience is where we want it to be before release. No ETA yet, but the functionality is there, just want to make sure it's easy to use before publishing. We don't want to have to break the API in the future, so now's the time to get it all sorted :)

[nervo]

@bashbunni i just wonder something 🤔

There are today two ways to use a list as a user input in the charmbracelet ecosystem:

• the list bubble https://github.com/charmbracelet/bubbles/tree/master/list
• the select/multiselect huh https://github.com/charmbracelet/huh#select
  None of them seems to have a compatible interface with this new list lipgloss component :(

Do you plan something on this subject ? It could be amazing to use the same list either in a user input or output way ❤️

[caarlos0]

hey @nervo !

Ideally, we'll use this new component on both of these once this is merged :)

[bashbunni]

Docs:

• We should probably populate the "Overview" section of the Godoc with a basic example
• It's still unclear to me when to use a tree vs a list - maybe something we can include in the godoc?

Unexpected Behaviour:

• If I add sublists in Items instead of as an Item, I get multiple bullet points.
  

Styling Qs:

• how do I style a Root elem? Can I style by depth?
• how do I create a sublist with titles/categories?
  • Use a tree with Root
• when do I use stylefunc vs style?

[bashbunni]

We should also improve godoc on StyleFunc usage for lists/trees. I'm searching examples to figure out how to use it

[caarlos0]

If I add sublists in Items instead of as an Item, I get multiple bullet points.

can you share an example?

[bashbunni]

@caarlos0 🤦‍♀️ totally didn't include the code to repro did I? LOL

The broken one (using Items to set list elements):

	l := list.New().Items(
		"S",
		list.New().Items([]string{"vim", "doom emacs"}),
		list.New().Item("I like fuzzy socks"),
	)

	fmt.Println(l)

gives me

The one used in examples:

	l2 := list.New().
		Item("S").
		Item(list.New().Items([]string{"vim", "doom emacs"})).
		Item(list.New().Item("I like fuzzy socks"))
	fmt.Println(l2)

which doesn't include the extra bullets, even though technically these two solutions should have the same output

[caarlos0]

fixed @bashbunni