Feature: Tables

[maaslalani]

Adds NewTable + features to Lip Gloss.

API:

t := lipgloss.NewTable().
    Border(lipgloss.NormalBorder()).
    BorderStyle(lipgloss.NewStyle().Foreground(lipgloss.Color("99"))).
    StyleFunc(func(row, col int) lipgloss.Style {
        switch {
        case row == 0:
            return HeaderStyle
        case row%2 == 0:
            return EvenRowStyle
        default:
            return OddRowStyle
        }
    }).
    Headers("LANGUAGE", "FORMAL", "INFORMAL").
    Row("Chinese", "Nǐn hǎo", "Nǐ hǎo").
    Row("French", "Bonjour", "Salut").
    Row("Russian", "Zdravstvuyte", "Privet").
    Row("Spanish", "Hola", "¿Qué tal?")

Results:

┌──────────┬──────────────┬───────────┐
│ LANGUAGE │    FORMAL    │ INFORMAL  │
├──────────┼──────────────┼───────────┤
│ Chinese  │ Nǐn hǎo      │ Nǐ hǎo    │
│ French   │ Bonjour      │ Salut     │
│ Russian  │ Zdravstvuyte │ Privet    │
│ Spanish  │ Hola         │ ¿Qué tal? │
└──────────┴──────────────┴───────────┘

[maaslalani]

[bashbunni]

I think we should have a "DefaultStyle" function that returns some basic styling for a table

Also, I think when setting headers and rows we should accept []string as the argument 🤔

[bashbunni]

I think we also need to add some kind of restrictions or a check to make sure that we don't try to index out of range when iterating over the cells in the rows since there is the possibility right now that there are more cells in a row than headings in the header.
Here is where the issue surfaces if that's the case. Happy to add a test for this case :)
https://github.com/charmbracelet/lipgloss/pull/218/files#diff-134c48f173480a9772719053c1b3e967756a71c75f84ed4f94f12c71cd91ed30R169

[bashbunni]

Note to self:

• uses the struct's String function when rendering outputs to the table
• use the spread operator to use array values as the any type

[bashbunni]

This has been great to work with btw Maas!

[maaslalani]

Thanks so much @bashbunni!

[bashbunni]

@maaslalani I think StyleFunc should be named something else to indicate that it's for cell styling. It's a bit vague imo

[meowgorithm]

Side note that this may become a more general RenderFunc in order to allow more flexibility in text transormation (see image).

[bashbunni]

Ah gotcha, good to know! Thank you :)

[muesli]

I think Append should remain optional. Not all data models can/will support that.

[muesli]

I think Rows(data Data) is even weirder then Data(data Data). Also comparing Row with Rows , I would expect them to accept the same type, just singular vs plural?

[muesli]

What I'm trying to say: this function sets an entire data model, and hence the names should probably match. In addition to Row we can then have Rows, which lets you set multiple string rows at once.

[maaslalani]

Yep you're right! I will change this.

I'll keep the Rows method and then also add a Data method.

[maaslalani]

@muesli does this seem reasonable to you? This is how we would avoid Append being a required message, but not sure if this is the correct way to do it.