Merge remote-tracking branch 'origin/master' into v2-exp

.golangci.yml

@@ -1,17 +1,6 @@
+version: "2"
 run:
   tests: false
-
-issues:
-  include:
-    - EXC0001
-    - EXC0005
-    - EXC0011
-    - EXC0012
-    - EXC0013
-
-  max-issues-per-linter: 0
-  max-same-issues: 0
-
 linters:
   enable:
     - bodyclose
@@ -19,8 +8,6 @@ linters:
     - goconst
     - godot
     - godox
-    - gofumpt
-    - goimports
     - gomoddirectives
     - goprintffuncname
     - gosec
@@ -39,3 +26,24 @@ linters:
     - unparam
     - whitespace
     - wrapcheck
+  exclusions:
+    generated: lax
+    presets:
+      - common-false-positives
+    paths:
+      - third_party$
+      - builtin$
+      - examples$
+issues:
+  max-issues-per-linter: 0
+  max-same-issues: 0
+formatters:
+  enable:
+    - gofumpt
+    - goimports
+  exclusions:
+    generated: lax
+    paths:
+      - third_party$
+      - builtin$
+      - examples$

bubbles.go

@@ -1 +1,4 @@
+// Package bubbles provides some components for Bubble Tea applications. These
+// components are used in production in Glow, Charm and many other
+// applications.
 package bubbles

filepicker/filepicker.go

@@ -1,3 +1,5 @@
+// Package filepicker provides a file picker component for Bubble Tea
+// applications.
 package filepicker
 
 import (

help/help.go

@@ -1,3 +1,4 @@
+// Package help provides a simple help view for Bubble Tea applications.
 package help
 
 import (

list/list.go

@@ -284,7 +284,7 @@ func (m *Model) SetFilterText(filter string) {
 	m.updateKeybindings()
 }
 
-// Helper method for setting the filtering state manually.
+// SetFilterState allows setting the filtering state manually.
 func (m *Model) SetFilterState(state FilterState) {
 	m.Paginator.Page = 0
 	m.cursor = 0

progress/progress.go

@@ -1,3 +1,4 @@
+// Package progress provides a simple progress bar for Bubble Tea applications.
 package progress
 
 import (

spinner/spinner.go

@@ -1,3 +1,4 @@
+// Package spinner provides a spinner component for Bubble Tea applications.
 package spinner
 
 import (

table/table.go

@@ -1,3 +1,4 @@
+// Package table provides a simple table component for Bubble Tea applications.
 package table
 
 import (

textarea/textarea.go

@@ -1,3 +1,5 @@
+// Package textarea provides a multi-line text input component for Bubble Tea
+// applications.
 package textarea
 
 import (

textinput/textinput.go

@@ -1,3 +1,5 @@
+// Package textinput provides a text input component for Bubble Tea
+// applications.
 package textinput
 
 import (
@@ -165,7 +167,7 @@ func New() Model {
 	}
 }
 
-// SetWidth sets the width of the text input.
+// Width returns the width of the text input.
 func (m Model) Width() int {
 	return m.width
 }
@@ -797,7 +799,7 @@ func (m *Model) MatchedSuggestions() []string {
 	return m.getSuggestions(m.matchedSuggestions)
 }
 
-// CurrentSuggestion returns the currently selected suggestion index.
+// CurrentSuggestionIndex returns the currently selected suggestion index.
 func (m *Model) CurrentSuggestionIndex() int {
 	return m.currentSuggestionIndex
 }

viewport/keymap.go

@@ -1,3 +1,5 @@
+// Package viewport provides a component for rendering a viewport in a Bubble
+// Tea.
 package viewport
 
 import "github.com/charmbracelet/bubbles/v2/key"