fix(deps): update module github.com/charmbracelet/bubbles to v2

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
github.com/charmbracelet/bubbles	v1.0.0 → v2.0.0

---

Release Notes

charmbracelet/bubbles (github.com/charmbracelet/bubbles)

v2.0.0

Compare Source

Bubbles v2 is here! 🫧

We're thrilled to share Bubbles v2 with you! This release accompanies Bubble Tea v2 and Lip Gloss v2 and brings a ton of consistency, new features, and quality-of-life improvements across every component. Catch 'em all:

go get charm.land/bubbletea/v2
go get charm.land/bubbles/v2
go get charm.land/lipgloss/v2

You can also check the Upgrade Guide for more info.

There are a lot of changes in here, but we've found upgrading pretty easy, especially with a linter. Read on for the full breakdown!

[!NOTE]
When in doubt, check the examples for reference — they've all been updated for v2.

🏠 New Home

Bubbles v2 now lives at charm.land:

import "charm.land/bubbles/v2"

All sub-packages follow the same pattern: charm.land/bubbles/v2/viewport, charm.land/bubbles/v2/list, etc.

🎨 Light and Dark Styles

Some Bubbles, like help, offer default styles for both light and dark backgrounds. Since Lip Gloss v2 removes AdaptiveColor, choosing light or dark is now a manual process. You've got a couple of options.

🎩 The Best Way

Have Bubble Tea query the background color for you. This properly queries the correct inputs and outputs, and happens in lockstep with your application:

func (m model) Init() tea.Cmd {
    return tea.RequestBackgroundColor
}

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.BackgroundColorMsg:
        m.help.Styles = help.DefaultStyles(msg.IsDark())
        return m, nil
    }
    // ...
}

If you're using Wish you must do it this way to get the background color of the client.

🤠 The Quick Way

Use the compat package in Lip Gloss. It's less recommended because it contains blocking I/O that operates independently of Bubble Tea, and when used with Wish it won't detect the client's background:

import "charm.land/lipgloss/v2/compat"

var hasDarkBG = compat.HasDarkBackground()

h := help.New()
h.Styles = help.DefaultStyles(hasDarkBG)

👀 Or Just Pick One

h.Styles = help.DefaultLightStyles() // light mode!
h.Styles = help.DefaultDarkStyles()  // jk dark mode

This pattern applies to help, list, textarea, and textinput.

🔑 The Init You Know and Love is Back

After experimenting with a few different forms of Init during the alphas, we decided the v1 signature was the right call after all. Init was a bit too redundant for our tastes given that initialization already happens in New:

func (m Model) Init() tea.Cmd

✨ The Big Highlights

Getters and Setters Everywhere

All components now use getter/setter methods instead of exported Width and Height fields. This lets us do internal bookkeeping when things change, and it makes the API consistent across every Bubble:

// Before
vp.Width = 40
fmt.Println(vp.Width)

// After
vp.SetWidth(40)
fmt.Println(vp.Width())

Affected: filepicker, help, progress, table, textinput, viewport.

Functional Options

Constructors now use the functional options pattern instead of positional args or separate constructor functions:

vp := viewport.New(viewport.WithWidth(80), viewport.WithHeight(24))
sw := stopwatch.New(stopwatch.WithInterval(500 * time.Millisecond))
t := timer.New(30*time.Second, timer.WithInterval(100*time.Millisecond))

DefaultKeyMap is a Function Now

All DefaultKeyMap package-level variables are now functions, so you get fresh values every time:

km := textinput.DefaultKeyMap()   // was textinput.DefaultKeyMap
km := textarea.DefaultKeyMap()    // was textarea.DefaultKeyMap
km := paginator.DefaultKeyMap()   // was paginator.DefaultKeyMap

Real Cursor Support 🖱️

Both textarea and textinput now support real terminal cursors! The feature is opt-in, so by default your programs will continue to use the easy-breezy virtual cursor. Set VirtualCursor to false and use Model.Cursor() for the real deal. Check out the textarea and textinput examples to see it in action.

Cleaned House 🧹

All previously deprecated symbols have been removed:

• NewModel variants — just use New
• spinner.Tick() — use Model.Tick() instead
• paginator.UsePgUpPgDownKeys and friends — customize KeyMap directly
• filepicker.DefaultStylesWithRenderer() — Lip Gloss is pure now, use DefaultStyles()
• viewport.HighPerformanceRendering — no longer needed
• runeutil and memoization packages moved to internal/ (they were never meant for public use anyway)

---

What's Changed: the Laundry List

🔮 Cursor

• Model.Blink renamed to Model.IsBlinked for clarity
• Model.BlinkCmd() renamed to Model.Blink()
• Each cursor now gets a unique ID

📂 Filepicker

• DefaultStylesWithRenderer() removed — Lip Gloss is pure now, so just use DefaultStyles()
• Model.Height broken into SetHeight(int) / Height() int

❓ Help

• Model.Width broken into SetWidth(int) / Width() int
• New DefaultStyles(isDark bool), DefaultDarkStyles(), and DefaultLightStyles()
• Defaults to dark background styles out of the box

🥕 List

• DefaultStyles() and NewDefaultItemStyles() now take an isDark bool parameter
• Styles.FilterPrompt and Styles.FilterCursor have been consolidated into Styles.Filter (a textinput.Styles)
• GlobalIndex helper added

📄 Paginator

• DefaultKeyMap variable → DefaultKeyMap() function
• Deprecated fields (UsePgUpPgDownKeys, UseLeftRightKeys, etc.) removed — customize KeyMap directly

🌈 Progress

This one got the biggest makeover!

• Complete color API overhaul:
  • WithGradient / WithScaledGradient → WithColors(...color.Color) — pass 2+ colors for blending
  • WithSolidFill(string) → WithColors(color) — pass a single color for a solid fill
  • WithDefaultGradient() → WithDefaultBlend()
  • New WithScaled(bool) to scale the blend to fit only the filled portion
  • New WithColorFunc(func(total, current float64) color.Color) for fully dynamic coloring
  • WithColorProfile removed — Bubble Tea handles this automatically now
• Model.FullColor and Model.EmptyColor changed from string to image/color.Color
• Model.Width broken into SetWidth(int) / Width() int
• Model.Update now returns Model instead of tea.Model
• Improved blend algorithm with support for multiple color stops — special thanks to the legendary @​lrstanley!

🌀 Spinner

• Tick() package-level function removed — use Model.Tick() instead

⏱️ Stopwatch

• NewWithInterval(d) removed — use New(WithInterval(d)) instead
• Debounced tick messages

🔢 Table

• Model.Width / Model.Height replaced with getter/setter methods
• Uses ansi.Truncate instead of runewidth.Truncate
• Fixed a critical out-of-bounds cursor bug — thanks @​s0ders!

✏️ Textarea

The big change here is real cursor support — but that's opt-in, so by default your programs will keep using the virtual cursor.

• DefaultKeyMap variable → DefaultKeyMap() function
• New PageUp / PageDown key bindings
• Model.FocusedStyle / Model.BlurredStyle → Model.Styles.Focused / Model.Styles.Blurred
• Style type renamed to StyleState; new Styles struct groups Focused, Blurred, and Cursor
• Model.SetCursor renamed to Model.SetCursorColumn
• Model.Cursor is now func() *tea.Cursor for real cursor support
• Model.VirtualCursor bool added — set to false when using a real cursor
• New DefaultStyles(isDark bool), DefaultDarkStyles(), DefaultLightStyles()
• New methods: Column(), ScrollYOffset(), ScrollPosition(), MoveToBeginning(), MoveToEnd()
• Focus status now passed to SetPromptFunc

📜 Textinput

Most of the changes here bring textinput to parity with textarea, including real cursor support. Styling has been consolidated into a Styles struct with Focused and Blurred states:

• DefaultKeyMap variable → DefaultKeyMap() function
• Model.Width broken into SetWidth(int) / Width() int
• Model.PromptStyle → StyleState.Prompt
• Model.TextStyle → StyleState.Text
• Model.PlaceholderStyle → StyleState.Placeholder
• Model.CompletionStyle → StyleState.Suggestion
• Model.Cursor is now func() *tea.Cursor for real cursor support
• Model.VirtualCursor() / SetVirtualCursor(bool) added
• Model.Styles() / SetStyles(Styles) added
• New DefaultStyles(isDark bool), DefaultDarkStyles(), DefaultLightStyles()
• Exposed matched suggestions and suggestion index

⏲️ Timer

• NewWithInterval(timeout, interval) removed — use New(timeout, WithInterval(interval))
• Debounced tick messages

📦 Viewport

viewport got a ton of love in v2. Let's dive in!

Breaking changes:

• New(width, height int) → New(...Option) with WithWidth / WithHeight
• Model.Width, Model.Height, Model.YOffset replaced with getter/setter methods
• HighPerformanceRendering removed

Shiny new features:

You can now scroll horizontally with the left and right arrow keys, and set up a custom gutter column for things like line numbers:

vp := viewport.New()
vp.SetContent("hello world")

// Show line numbers:
vp.LeftGutterFunc = func(info viewport.GutterContext) string {
    if info.Soft {
        return "     │ "
    }
    if info.Index >= info.TotalLines {
        return "   ~ │ "
    }
    return fmt.Sprintf("%4d │ ", info.Index+1)
}

Highlight parts of what's being viewed with regex:

vp.SetHighlights(regexp.MustCompile("hello").FindAllStringIndex(vp.GetContent(), -1))
vp.HighlightNext()      // highlight and navigate to next match
vp.HighlightPrevious()  // highlight and navigate to previous match
vp.ClearHighlights()    // clear all highlights

Let viewport handle soft wrapping for you:

vp.SoftWrap = true
vp.SetContent("hello world from a very long line")

Or, if you need fine control, use SetContentLines with "virtual lines" containing \n — they're treated as soft wraps automatically.

Also new:

• Horizontal mouse wheel scrolling (thanks @​UnseenBook!)
• GetContent() to retrieve content
• FillHeight to pad the viewport with empty lines
• StyleLineFunc for per-line styling
• HighlightStyle and SelectedHighlightStyle for highlight appearance

Changelog

Fixed

• f744b929dddecc7863cf78605c5bfc396d90abc3: fix(ci): use local golangci-lint config (@​aymanbagabas)
• 251e612949595b006e0e4739029d45e32c6b34b6: fix(filepicker): fix a panic due to an unchecked assertion (#​891) (@​meowgorithm)
• f3f0ca0fe2f05b56e5a0c69b226b4d752c5e8f4a: fix(lint): exclude var-naming rule for revive (@​aymanbagabas)
• d004225e8c3b8c8ddb14a76a5101728d666396f3: fix(table): use ansi.Truncate instead of runewidth.Truncate (#​884) (@​jedevc)
• 93a004ab70c8ea979940b2720b3993c8f68bf8dc: fix(viewport): optimize subline splitting by skipping lines without line endings (@​aymanbagabas)
• d0166363eb8176b331de98dba1d6e997560f216f: fix: changed 'recieve' to 'receive' for 100% quality of Go Report Card (#​881) (@​Atennop1)
• af98365cc63af118d838e05522f8dddf16ad827e: fix: lint issues (@​aymanbagabas)

Docs

• c81d525337e1a059c4343cf65a02eea020470a48: docs(readme): update for v2 (#​888) (@​aymanbagabas)
• 6a799f4d58cc0eaeab0874f4ce9c98b5a922bd01: docs(readme): update header image, minor corrections (@​meowgorithm)
• 24081b3590e746db4efa2ec09e31a85e2c078427: docs: add v2 upgrade and changes guide (#​885) (@​aymanbagabas)
• 3a5ea3e2eb42aa064bb4a0ffe3262cb2b8a1f19b: docs: update mascot image (@​aymanbagabas)

Other stuff

• ae99f46cec66f45862c2d953bb1af31efdc4f073: feat(v2/textarea): expose Column(), clarify 0-indexing (#​875) (@​caarlos0)

---

💝 That's a wrap!

Feel free to reach out, ask questions, give feedback, and let us know how it's going. We'd love to know what you think.

• Discord
• Matrix
• Email

---

Part of Charm.

Charm热爱开源 • Charm loves open source • نحنُ نحب المصادر المفتوحة

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[renovate]

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

• any of the package files in this branch needs updating, or
• the branch becomes conflicted, or
• you click the rebase/retry checkbox if found above, or
• you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: go.sum

Command failed: go get -t ./...
go: github.com/charmbracelet/bubbles/v2@v2.0.0: parsing go.mod:
	module declares its path as: charm.land/bubbles/v2
	        but was required as: github.com/charmbracelet/bubbles/v2