Releases: charmbracelet/bubbletea
v0.22.1
Mutli-Byte Character Support on Windows
This is a small release with a big impact for Chinese, Japanese, and Korean users on Windows. The long as short of it is that if youโre using a multi-byte character set thatโs not UTF-8, Bubble Tea will covert stuff for you so things work as expected. For details see #343.
๐ค Enormous thanks to @mattn for the contribution as well as his Go libraries that make CJK support in the Charm ecosystem possible.
๐พ Also, thanks to @aklyachkin, if Bubble Tea on AIX is something you want your dream is a now a reality.
Changelog
- support multi-byte strings on Windows by @mattn in #343
- enable compilation on AIX by @aklyachkin in #381
Full Changelog: v0.22.0...v0.22.1
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Slack.
v0.22.0
Unmanaged Output
Now you can print unmanaged output above your inline applications. This means you can print stuff above your app that won't be cleared on the next render. Itโs super useful for cases where you want to build an apt
-like package manager.
Letโs Print
This release introduces two new Cmd
s that print output above your inline Bubble Tea program:
tea.Println("Hello, Bubble Tea")
tea.Printf("%s, %s", "Hello", "Bubble Tea")
Use it anytime you want to add log-type info to the terminalโs scrollback buffer, such as building your own package manager ๐ฆ. And keep in mind that these methods are no-opโs in altscreen mode.
For details see the full example and the docs.
๐ค Thanks
@fiws has been bugging us to implement this forever and then @Adjective-Object swooped in and did it with style and grace! Itโs been a great collaboration all around.
Changelog
New
- Credit card input form example by @maaslalani in #338
- Allow unmanaged output above the app in standard renderer by @Adjective-Object in #249
Fixed!
New Contributors
- @georgijd made their first contribution in #330
- @joaom00 made their first contribution in #313
- @maaslalani made their first contribution in #338
- @Adjective-Object made their first contribution in #249
Full Changelog: v0.21.0...v0.22.0
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Slack.
v0.21.0
Spawn Interactive Processes + More Keybindings
Finally! This update allows you to run blocking, interactive processes from Bubble Tea like vim
, htop
, curl
, and even entire shells like fish
. It also adds a bunch of new keybindings. Read on for more!
Letโs Exec
As we were saying, you can now spawn interactive processes in the terminal from Bubble Tea and resume Bubble Tea when they exit. For example, you could have your Bubble Tea program spawn vim
to edit a file, or temporarily open a shell, like fish
. Hereโs what it looks like:
type editorFinishedMsg struct{ err error }
func openInVim(path string) tea.Cmd {
c := exec.Command("vim", path)
return tea.ExecProcess(c, func(err error) tea.Msg {
return editorFinishedMsg{err}
})
}
See the full example for details.
Keys Galore
Prior to this update, you couldn't bind to the functions keys. Isn't that crazy? @mrusme certainly thought so. With this update you can can now respond to F1 through F20, modifiers included.
And thanks to @Bwahharharrr you can also now bind to arrow keys with the ctrl, shift and alt modifiers.
High-Level Changelog
New
- move cancelreader into a separate package by @muesli in #222
- Exec, program.ReleaseTerminal and RestoreTerminal to re-use input and terminal by @muesli in #237
- add support for shift/ctrl + arrow keys by @meowgorithm in #292
- add function key support by @meowgorithm in #263
Changed
- spacebar now sends a
KeySpace
by @bashbunni in #289 and #315 - Program#Send, Program#Quit, and Program#Kill no longer provisional by @meowgorithm in #271
New Contributors
- @r-darwish made their first contribution in #225
- @wolves made their first contribution in #250
- @imranZERO made their first contribution in #254
- @iamjaredwalters made their first contribution in #279
- @bashbunni made their first contribution in #289
Full Changelog: v0.20.0...v0.21.0
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Slack.
v0.20.0
Force Kill, Bugfixes, and Small Improvements
This is mostly a bugfix release, but thereโs also a new feature where you can quit a Bubble Tea program immediately, skipping the final render, but still restoring the terminal state:
p := tea.NewProgram(model{})
go func() {
if err := p.Start(); err != nil {
fmt.Println("Oh no:", err)
os.Exit(1)
}
}()
// Later
p.Kill()
This can be useful in when to you need fine-grained management over a Bubble Tea program when using something like Wish. Special thanks to @aymanbagabas for implementing this swiftly and acutely.
New
- Added
Kill()
method to force quit the program and restore terminal state #219 - Support batched mouse events #215 (see #212 for details)
Fixed
- Allocate msgs channel in constructor to fix a data race (thanks @paralin!) #180
- Handle
nil
cmds intea.Sequentially
(thanks @ajeetdsouza!) #214 tea.Batch
now returnsnil
if all cmds are nil #217- Don't check terminal size if output is not a terminal #228
New Contributors
- @mamachanko made their first contribution in #178
- @paralin made their first contribution in #180
- @dependabot made their first contribution in #203
- @ajeetdsouza made their first contribution in #214
Full Changelog: v0.19.3...v0.20.0
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Slack.
v0.19.3
Altscreen Repaints
This release fixes a small bug where views would render blank if the viewโs return value didnโt change after toggling the altscreen.
๐ค Special thanks to @chris-miner for flagging this one.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or Slack.
v0.19.2
Itโs all about BSD
This release restores support for Dragonfly BSD and fixes a bug where general BSD builds would fail with Go 1.17. BSD users, let us know if you notice anything else is awry.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
v0.19.1
Welcome back, BSD
This update fixes a regression introduced in v0.16.0 that prevented Bubble Tea from building on BSD systems (excluding Darwin).
Hereโs the changelog.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
v0.19.0
Final Model Access
This release features Program.StartReturningModel
, a handy alternative start method for returning the final Model
after a Program
exits. This makes it easy to access data collected in a Bubble Tea program while still working in an immutable fashion.
Hereโs an example illustrating how it works:
type MyModel struct {
Name string
FaveCatColor string
}
p := tea.NewProgram(MyModel{})
// Return the final model when we're done
finalModel, err := p.StartReturningModel()
if err != nil {
fmt.Println("Uh oh", err)
os.Exit(1)
}
// The final model is a generalized tea.Model, so be sure to assert it into
// your actual model type.
if m, ok := finalModel.(MyModel); ok {
fmt.Printf("Hello, %s. I have a %s kitty for you.\n", m.Name, m.FaveCatColor)
}
๐ค A big thanks to @Raphexion for both conceptualizing and executing this feature.
ANSI Compression, Now Opt-In
Weโve also made the ANSI compressor opt-in by default as we noticed that it was incurring a larger performance hit than weโd like in some cases. To enable the ANSI compressor just use the WithANSICompressor
program option:
tea.NewProgram(model, tea.WithANSICompressor())
Changelog
Hereโs the full changelog for this release.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
v0.18.0
Hello, ANSI compressor!
The big news in this release is the integration of @muesliโs ANSI compressor from his new ANSI package. The compressor, which has been integrated into the renderer, automatically removes redundant ANSI sequences and, as such, it can be considered lossless. This should improve rendering speeds both locally and over the wire.
Other stuff
- @caarlos0 also added a few much-needed tests
- We've added a
Program.Quit()
helper function as acutely suggested by @aymanbagabas
When quitting a Bubble Tea program from the outside you previously had toโฆ
p.Send(tea.Quit())
โฆwhich works, but also feels a little silly. So now you can justโฆ
p.Quit()
Hereโs the full changelog.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.
v0.17.0
Windows Stuff
This release adds mouse support in Windows! It also fixes a regression introduced in v0.16.0
where the arrow keys didn't work on Windows.
As a side effect to the above, cancelable reads have been disabled in Windows for now. This means applications running in Windows can not run multiple Program
s in succession in the context of a single application, nor can user input be reliably read after a Program
has exited until the Go application exits. This is temporary and a solution is in development.
Changelog
New
- Mouse support in Windows
Fixed
- Arrow keys work properly in Windows again
Changed
- Input will no longer reliably close on Windows after exiting a Bubble Tea program as it did in
v0.16.0
. This will be addressed in a subsequent release.
Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter or The Fediverse.