v2.0.0-alpha.1

Changelog

New Features

• d019ed3: feat(list): add SetFilterText and SetFilterState (#335) (@taigrr)
• 0fdf5f5: feat: use bubbletea/v2 (@aymanbagabas)

Bug fixes

• 9589cbc: fix: lint issues and disable predeclared linter (#614) (@aymanbagabas)
• f81fd52: fix: spacebar keybinding is now "space" instead of a literal space (@aymanbagabas)

Dependency updates

• 1797ac2: feat(deps): bump github.com/charmbracelet/bubbletea from 1.1.0 to 1.1.1 (#611) (@dependabot[bot])
• c1199d7: feat(deps): bump github.com/charmbracelet/x/ansi from 0.2.3 to 0.3.0 (#613) (@dependabot[bot])
• d3ac47d: feat(deps): bump github.com/charmbracelet/x/ansi from 0.3.0 to 0.3.1 (#615) (@dependabot[bot])
• ed14316: feat(deps): bump github.com/charmbracelet/x/ansi from 0.3.1 to 0.3.2 (#618) (@dependabot[bot])

Other work

• 8972b56: feat!: make Init return the model (@aymanbagabas)
• a93bfef: feat!: use bubbletea@v2-exp (@aymanbagabas)
• a2602f8: feat!: v2: move to v2 module (@aymanbagabas)

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.20.0

Focus. Breathe.

This features support for Bubble Tea's new focus-blur feature as well as a quality-of-life update to paginator. Enjoy!

Focus

You heard that right. Focus-blur window events are now enabled for textinput and textarea which were recently added to Bubble Tea v1.1.0. As long as WithReportFocus is enabled in your Program you'll automatically get nicer inputs.

To enable focus reporting:

p := tea.NewProgram(model{}, tea.WithReportFocus())

Remember to stay focused and hydrated!

Paginator opts

Speaking of functional arguments, paginator also received some some new quality-of-life startup options, courtesy @nervo.

p := paginator.New(
	paginator.WithPerPage(42),
	paginator.WithTotalPages(42),
)

Of course, you can still set the values on the model directly too:

p := paginator.New()
p.PerPage = 42
p.TotalPages = 24

Happy paging!

Changelog

New!

• d3bd075: feat(cursor): focus/blur support (#581) (@caarlos0)
• 5110925: feat: Introduce paginator options (@nervo)

Deps

• 3eaf8da: feat(deps): bump github.com/charmbracelet/bubbletea from 0.27.0 to 1.0.0 (#604) (@dependabot[bot])
• 6fc27e9: feat(deps): bump github.com/charmbracelet/bubbletea from 1.0.0 to 1.1.0 (#607) (@dependabot[bot])

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.19.0

Bugs? Squashed (along with a few nice lil’ features).

Community-Driven Development?! Yep, the majority of the changes in this release were done by the community. Thank you all for your contributions that made this release possible.

Progress: custom chars

You can now customize the filled and empty characters of the progress bar.

p := progress.New(progress.WithFillCharacters('>', '.'))

Table improvements

Help is on the way

Table now includes a short and full help view so it's easier than ever to tell your users how to interact with the table.

// Render a table with its help.
t := table.New()
view := t.View() + "\n" + t.HelpView()

Accessing columns

You can also now get the table's columns (this already existed for rows).

package table

// Columns returns the current columns.
func (m Model) Columns() []Column

List: page navigation is fixed!

Previously, list.NextPage() and list.PrevPage() didn't work because the methods did not have pointer receivers. We've fixed this…by making them pointer receivers!

⚠️ Note that this is a minor API change and you might need to update your app to pass a pointer receiver to your model rather than a copy. Details in #458.

package progress

// NextPage moves to the next page, if available.
func (m *Model) NextPage()

// PrevPage moves to the previous page, if available.
func (m *Model) PrevPage()

---

What’s Changed

Changed

• Textarea: Improve setting width by @mikelorant in #496
• Textinput: fix out of range panic if no matched suggestions by @rdnt in #473
• List: Fix no-op list pagination functions by @nekopy in #458
• Table: Clarify position constant in JoinHorizontal by @aditipatelpro in #577
• Progress: make full/empty fill characters configurable by @rwinkhart in #409
• Dependencies: switch to x/ansi for text manipulation by @aymanbagabas in #505

Added

• Textarea: add help to textarea key bindings by @TravisYeah in #418
• Textarea: Add multiline placeholder by @mikelorant in #302
• Table: Add column return function by @abeleinin in #369
• Table: Implement help.Keymap interface and add quit mapping by @prgres in #440
• Ctrl+Left/Right for WordForward/Backward by @maaslalani in #387
• Use goreleaser for releases by @aymanbagabas in #526

Fixed

• Table: Render Row Tests by @maaslalani in #487
• Table: Only render columns with a positive width by @fabio42 in #465
• Table: Fix inheritence of SelectedStyle in StyleFunc by @gabrielfu in #539
• Table: Don't include header height in the total table size by @prgres in #434
• Table: Fix premature viewport scroll by @dzeleniak in #429
• Textarea: Fix end of buffer character by @mikelorant in #491
• Textarea: Set textarea default EndOfBufferCharacter to ' ' by @blvrd in #510
• Textarea: End of Buffer alignment by @maaslalani in #486
• Textinput: don't block input on validation by @GabrielNagy in #185
• Viewport: Fix division by zero in scrollpercentage by @zMoooooritz in #494
• Help: Fix centering by @gabe565 in #516
• Progress: Stop spring defaults from overriding WithStringOptions by @nervo in #540
• Cursor: Make SetMode method in cursor library handle invalid mode values correctly by @anirudhaCodes in #477

Test coverage ✅

• Add tests for textarea view by @mikelorant in #485
• Add tests for paginator by @anirudhaCodes in #480
• Add tests for textInput Tests by @KevM in #500
• Improve textarea tests by @mikelorant in #490

New Contributors

• @rdnt made their first contribution in #473
• @rwinkhart made their first contribution in #409
• @mikelorant made their first contribution in #485
• @anirudhaCodes made their first contribution in #480
• @nekopy made their first contribution in #458
• @TravisYeah made their first contribution in #418
• @abeleinin made their first contribution in #369
• @fabio42 made their first contribution in #465
• @prgres made their first contribution in #440
• @zMoooooritz made their first contribution in #494
• @dzeleniak made their first contribution in #429
• @KevM made their first contribution in #500
• @gabe565 made their first contribution in #516
• @blvrd made their first contribution in #510
• @nervo made their first contribution in #540
• @gabrielfu made their first contribution in #539
• @aditipatelpro made their first contribution in #577

Full Changelog: v0.18.0...v0.19.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.18.0

Textarea, but faster

This release features several fixes and big performance improvements for the textarea bubble.

What's Changed

New

• Optional File Permissions and File Size by @maaslalani in #471
• Add Paginator OnFirstPage method by @maaslalani in #463

Improved

• Implement Memoization to Speed Up Textarea Rendering by @wesen in #427
• refactor(textinput): reduce allocations by @naglis in #413
• Use uniseg.StringWidth by @maaslalani in #462

Fixed

• fix(textarea): correctly trim incoming paste by @muesli in #469
• fix(textinput): Placeholder No Longer Changes Width + Paste Calculation by @hopefulTex in #451
• fix(viewport): pad width to contentWidth by @ivanvc in #388

New Contributors

• @seanbanko made their first contribution in #442
• @hopefulTex made their first contribution in #451
• @ivanvc made their first contribution in #388
• @wesen made their first contribution in #427

Full Changelog: v0.17.1...v0.18.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.17.1

Bumping Bubble Tea

This is just a little update to update to the latest version of Bubble Tea.

What's Changed

• feat: upgrade bubbletea and remove deprecated code by @aymanbagabas in #448

Full Changelog: v0.17.0...v0.17.1

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.17.0

Text input autocompletions and various improvements

Autocompletion in Text Input

So @toadle wanted textinputs to support autocompletion in a ghost-text kind of a way. Rather than wait for us to do it he did what any dedicated open source developer would: he sent a PR! And now we can all benefit from his hard work.

Autocompletion is super easy to use:

ti := textinput.New()
ti.SetSuggestions([]string{"meow", "purr"})

By default you can press ctrl+n and ctrl+p to cycle through suggestions, but those keybindings can be changed as you, the application developer, see fit. For details check out textinput.SetSuggestions and the corresponding KeyMap in the docs.

Is the progress bar done yet?

@yrashk acutely noticed that to nicely transition from one state to another after an animated progress bar fills up it's helpful to know when the animated has finished animating before transitioning. To solve for this he added an IsAnimating method to the progress model. Thanks, @yrashk!

Changelog

New!

• Support suggestions and autocompletion in textinput by @toadle in #407
• Add method for determining if progress bar is animating by @yrashk in #386

Improved

• Update fuzzy library by @caarlos0 in #379
• Reduce allocations in filterItems by @naglis in #396
• Improve message when list is empty by @maaslalani in #393

Fixed

• Fix unicode character encoding error by @lc-1010 in #421

Full Changelog: v0.16.1...v0.17.0

New Contributors

• @yrashk made their first contribution in #386
• @naglis made their first contribution in #391
• @lc-1010 made their first contribution in #421

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.16.1

File Picker Bubble 📁 🫧

This release introduces a brand new filepicker bubble, new features, and a tonne of bugfixes.
Let us know what you think, ask questions, or just say hello in our Discord.

For a quick start on how to use this bubble, take a look at the Example code.

Getting Started

Create a new file picker and add it to your Bubble Tea model.

picker := filepicker.New()
picker.CurrentDirectory, err = os.UserHomeDir()
if err != nil {
    // ...
}

m := model{
    picker: picker,
    // ...
}

Initialize the file picker in your Model's Init function.

func (m model) Init() tea.Cmd {
    return tea.Batch(
        m.picker.Init(),
        // ...
    )
}

Update the filepicker as any other bubble in the Update function.
After the picker.Update, use the DidSelectFile(msg tea.Msg) function to perform an action when the user selects a valid file.
You may allow only certain file types to be selected with the AllowedTypes property and allow directories to be selected with the DirAllowed property. To see the currently selected file/directory use the Path property.

var cmd tea.Cmd
m.picker, cmd = m.picker.Update(msg)

// Did the user select a file?
if didSelect, path := m.picker.DidSelectFile(msg); didSelect {
	// Get the path of the selected file.
	return m, tea.Println("You selected: " + selectedPath)
}

return m, cmd

For the full example on how to use this bubble, take a look at the Example code.

New

• Filepicker: new bubble by @maaslalani in #343
• Textarea: max width/height configurable by @knz in #370
• Spinner: periods of ellipsis by @meowgorithm in #375
• List: infinite scrolling by @jon4hz in #316

Fixed

• app would crash if deleteWordRight was called at the end of line by @infastin in #313
• support pastes that end with a newline character by @knz in #314
• data corruption after multi-line input by @knz in #318
• Remove unused BackgroundStyle in TextInput by @savannahostrowski in #341
• add bounds checking to the SelectedRow by @MikaelFangel in #351
• fix(progress): last gradient color off by one by @residualmind in #338
• deprecate CursorStyle in favour of Cursor.Style by @maaslalani in #365
• Reset blink only when CursorBlink by @remiposo in #378

New Contributors

• @infastin made their first contribution in #313
• @gzipChrist made their first contribution in #332
• @savannahostrowski made their first contribution in #341
• @MikaelFangel made their first contribution in #351
• @stefanbildl made their first contribution in #339
• @residualmind made their first contribution in #338
• @bashbunni made their first contribution in #359
• @squrki made their first contribution in #373
• @remiposo made their first contribution in #378

Full Changelog: v0.15.0...v0.16.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.15.0

Ceci, Cela

This is primarily a housekeeping release with lots and lots of bugfixes and improvements from the community. Thanks, everyone, for all your support! 🤗

Please do feel free to say hello, ask questions, and tell us what else you want to see in our Discord. 💬

New

• textinput + textarea: support for forthcoming bracketed paste (see also charmbracelet/bubbletea#397) and avoid ctrl chars in clipboard input by @knz in #214
• textinput: support key bindings textarea by @knz in #270
• paginator: make paginator keybindings customizable by @knz in #272
• viewport: Expose TotalLineCount() and VisibleLineCount() methods within viewport by @adaam2 in #283
• table: make UpdateViewport() have constant runtime by @pja237 in #284
• table: add SetColumns method to set columns by @maaslalani in #260
• table: expose rows by @marcantoineg in #287

Fixed

• textarea: fix paste by @hhe07 in #250
• viewport: fix performance scrolling by @meowgorithm in #312
• help: full help renders fully when width is unset by @craiggwilson in #218
• cursor: apply TextStyle inline by @knz in #230
• cursor: delegate cursor logic to cursor bubble by @maaslalani in #181
• cursor: fix SetValue cursor movement by @maaslalani in #267
• general: miscellaneous housekeeping by @twpayne in #243

New Contributors

• @twpayne made their first contribution in #243
• @dependabot made their first contribution in #252
• @hhe07 made their first contribution in #250
• @craiggwilson made their first contribution in #218
• @adaam2 made their first contribution in #283
• @pja237 made their first contribution in #284
• @marcantoineg made their first contribution in #287
• @yusufmalikul made their first contribution in #300

Full Changelog: v0.14.0...v0.15.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v0.14.0

Table Bubble

This feature release of Bubbles includes a brand new table bubble that you can use to show and select tabular data! Huge thanks to @wesleimp for contributing this change ❤️.

See the example code for an example of how to use the table in your Bubble Tea applications.

Getting Started

Create a new table:

t := table.New(
	table.WithColumns(columns),
	table.WithRows(rows),
	table.WithFocused(true),
	table.WithHeight(7),
)

Alternatively,

t := table.New(table.WithColumns(columns))
t.SetRows(rows)
t.Focus()
t.SetHeight(7)

Style the table how you want:

s := table.DefaultStyles()
s.Header = s.Header.
	BorderStyle(lipgloss.NormalBorder()).
	BorderForeground(lipgloss.Color("240")).
	BorderBottom(true).
	Bold(false)
s.Selected = s.Selected.
	Foreground(lipgloss.Color("229")).
	Background(lipgloss.Color("57")).
	Bold(false)
t.SetStyles(s)

And then Update and Render (View) the table:

type model struct {
	table table.Model
}

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
	var cmd tea.Cmd
	m.table, cmd = m.table.Update(msg)
	return m, cmd
}

func (m model) View() string {
	return m.table.View()
}

Other Changes

• Ctrl+H backspaces text by @maaslalani in #199
• LineCount() + Include New Line characters in Length() by @maaslalani in #204
• fix(viewport): honor width and height settings by @meowgorithm in #216
• feat(textarea): new bindings for "go to begin" / "go to end" by @knz in #226
• feat(textarea): PromptFunc, support dynamic prompts by @knz in #211
• fix(viewport): properly truncate to size by @knz in #228

New Contributors

• @knz made their first contribution in #208
• @buztard made their first contribution in #220
• @nikaro made their first contribution in #219

Full Changelog: v0.13.0...v0.14.0

Read more about it in our examples and docs:

• Example code, country populations
• Docs

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.

v0.13.0

Textarea Bubble

This feature release includes a brand new textarea bubble that you can use to input as many lines of text as your heart desires (or until your computer memory runs out, whichever comes first).

See the example code for a simple example of how to use the textarea in your Bubble Tea applications.

Customization

There are a few ways to customize the text area.

• SetHeight(height int): tells the component how many lines of text it should display at once.
• SetWidth(width int): tells the component how wide the it should be.
• ShowLineNumbers: whether or not to show line numbers on the left-hand side of a line of text.
• Prompt: the prompt to display on the left-hand side.
• EndOfBufferCharacter: the character to display as the line number after the last line to fill the rest of the height. Defaults to ~.
• CharLimit: Prevents users from typing more than a set number of characters.
• KeyMap: The set of keybindings to navigate and interact with the textarea.

Styling

The textarea can be customized heavily with Lip Gloss.

• FocusedStyles: the styles to be applied while the textarea is focused.
• BlurredStyles: the styles to be applied while the textarea is focused.

Each of the above properties has the below sub-properties that can be modified.

Base             lipgloss.Style
CursorLine       lipgloss.Style
CursorLineNumber lipgloss.Style
EndOfBuffer      lipgloss.Style
LineNumber       lipgloss.Style
Placeholder      lipgloss.Style
Prompt           lipgloss.Style
Text             lipgloss.Style

See the split editors example for how to style the textarea component.

Read more about it in our examples and docs:

• Example code, split editors
• Example code, chat application
• Example code, story time
• Docs

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Slack.