Комментирование, правки кода, исправление модальных окон

setup/final.go

@@ -10,21 +10,21 @@ import (
 	"github.com/charmbracelet/lipgloss/table"
 )
 
+// FinalModel структур описывающая модель отрисовки таблицы переменных
 type FinalModel struct {
-	variables []types.Variable
-	table     *table.Table
-	viewport  viewport.Model
-	ready     bool
-	width     int
-	height    int
+	variables []types.Variable //Список переменных
+	table     *table.Table     //Таблица для вывода
+	viewport  viewport.Model   //Объект куда помещена таблица для возможности прокручивать её
+	width     int              //Ширина окна
+	height    int              //Высота окна
 }
 
+// NewFinalModel создается новую модель таблицы переменных
 func NewFinalModel(variables []types.Variable, width, height int) *FinalModel {
 	m := &FinalModel{
 		variables: variables,
 		width:     width,
 		height:    height,
-		ready:     false,
 	}
 	if width > 0 && height > 0 {
 		m.initViewport(width, height)
@@ -36,60 +36,70 @@ func (m *FinalModel) Init() tea.Cmd {
 	return nil
 }
 
+// Update отслеживает действия со таблицей
 func (m *FinalModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 	var cmd tea.Cmd
 	switch msg := msg.(type) {
 	case tea.KeyMsg:
+		//Отслеживаем нажатие клавиш
 		switch msg.String() {
 		case "up":
+			//Обработчик up для прокручивания вверх на 1 позицию
 			m.viewport.ScrollUp(1)
 		case "down":
+			//Обработчик down для прокручивания вниз на 1 позицию
 			m.viewport.ScrollDown(1)
 		case "left":
+			//Обработчик left для прокручивания влево на 1 позицию
 			m.viewport.ScrollLeft(1)
 		case "right":
+			//Обработчик right для прокручивания вправо на 1 позицию
 			m.viewport.ScrollRight(1)
 		case "pageup":
+			//Обработчик pageup для прокручивания вверх на половину допустимой высоты viewport
 			m.viewport.HalfPageUp()
 		case "pagedown":
+			//Обработчик pagedown для прокручивания вниз на половину допустимой высоты viewport
 			m.viewport.HalfPageDown()
 		case "home":
+			//Обработчик home для перехода в самый вверх
 			m.viewport.GotoTop()
 		case "end":
+			//Обработчик end для перехода в самый низ
 			m.viewport.GotoBottom()
 		}
 	case tea.WindowSizeMsg:
+		//Отслеживаем и записываем новые размер окна, вносим изменения в размеры viewport
 		m.height = msg.Height
 		m.width = msg.Width
 		m.initViewport(msg.Width, msg.Height)
 	}
+	//Если сообщение было иным, передаем его напрямую в viewport
+	//todo проверить есть ли эти функции уже у viewport.Update, возможно мой код дублирует
 	m.viewport, cmd = m.viewport.Update(msg)
 	return m, cmd
 }
 
+// View формирует строку для вывода таблицы переменных
 func (m *FinalModel) View() string {
-	if !m.ready {
-		return "Загрузка таблицы"
-	}
+	//Получаем размеры контейнера и ширину контента
 	containerWidth, containerHeight, contentWidth, _ := ui.ContentSizes(m.width, m.height)
 
-	m.rebuildTable(contentWidth)
-
+	//Формируем шапку с заголовком
 	header := ui.FinalHeader.
 		Width(contentWidth).
 		Render("Итоговые значения переменных")
+	//Формируем "подвал"
 	footer := ui.FinalFooter.
 		Width(contentWidth).
-		Render(fmt.Sprintf("Строк: %d • q — выход • ↑↓ / jk — скролл", len(m.variables)))
+		Render(fmt.Sprintf("Количество переменных: %d", len(m.variables)))
 
-	renderedTable := m.table.Render()
-	content := lipgloss.NewStyle().
-		Align(lipgloss.Center).
-		Render(renderedTable)
-	m.viewport.SetContent(content)
-	body := m.viewport.View()
-	fullContent := lipgloss.JoinVertical(lipgloss.Top, header, body, footer)
+	//Обновляем отображение таблицы
+	m.rebuildTable(contentWidth)
+	//Формируем единый контент из шапки, видимой области и подвала
+	fullContent := lipgloss.JoinVertical(lipgloss.Top, header, m.viewport.View(), footer)
 
+	//Формируем главный контейнер
 	container := ui.AppContainer.
 		Width(containerWidth).
 		Height(containerHeight).
@@ -103,6 +113,7 @@ func (m *FinalModel) View() string {
 	)
 }
 
+// initViewport создание видимой области таблицы
 func (m *FinalModel) initViewport(width, height int) {
 
 	_, _, contentWidth, contentHeight := ui.ContentSizes(width, height)
@@ -110,15 +121,15 @@ func (m *FinalModel) initViewport(width, height int) {
 	tableWidth := contentWidth - 2*1
 	tableHeight := int(float64(contentHeight)*ui.TableWithRatio) - 2*1
 
+	//Создание видимой области, куда будет помещена таблица
 	m.viewport = viewport.New(contentWidth, tableHeight)
-	//размеры для viewport в нем будет находиться таблица и перемещаться в зависимости от команд
 
-	m.ready = true
+	//Обновление таблицы
 	m.rebuildTable(tableWidth)
-	m.viewport.SetContent(m.table.Render())
 }
 
 func (m *FinalModel) rebuildTable(width int) {
+	//Если переменных нет, то делаем спец таблицу
 	if len(m.variables) == 0 {
 		m.table = table.New().
 			Border(lipgloss.RoundedBorder()).
@@ -126,9 +137,11 @@ func (m *FinalModel) rebuildTable(width int) {
 			StyleFunc(func(row, col int) lipgloss.Style {
 				return ui.FinalTableHeader
 			}).Headers("Нет переменных")
+		m.viewport.SetContent(m.table.Render())
 		return
 	}
-	variableNameColWidth := 15
+	//Вычисляем размеры колонок
+	variableNameColWidth := 20
 	defaultValueColWidth := 25
 	usedValueColWidth := width - variableNameColWidth - defaultValueColWidth - 4*1
 	//ширина таблицы - ширина первой колонки - ширина второй колонки - 4 границы (2 крайние, 2 между колонками)
@@ -136,6 +149,7 @@ func (m *FinalModel) rebuildTable(width int) {
 		usedValueColWidth = 30
 	}
 
+	//Создаем модель таблицы
 	t := table.New().
 		Width(variableNameColWidth+defaultValueColWidth+usedValueColWidth+4).
 		Border(lipgloss.RoundedBorder()).
@@ -162,6 +176,7 @@ func (m *FinalModel) rebuildTable(width int) {
 		}).
 		Headers("Variable name", "Default value", "Used value")
 
+	//Заполняем таблицу данными
 	for _, v := range m.variables {
 		used := fmt.Sprintf("%v", v.Value)
 		if used == "" {
@@ -169,5 +184,9 @@ func (m *FinalModel) rebuildTable(width int) {
 		}
 		t.Row(v.Name, v.Default, used)
 	}
+	//записываем таблицу в модель
 	m.table = t
+
+	//Помещение в видимую область таблицы
+	m.viewport.SetContent(m.table.Render())
 }