Lip Gloss: стили, цвета и рамки

Точка входа — lipgloss.NewStyle(): пустой стиль, к которому методы цепляются один за другим. Foreground задаёт цвет текста, Background — фона; цвет — просто строка: число от нуля до 255 означает код палитры ANSI, а строка с решёткой — hex-цвет вроде #FF00FF. Начертания — булевы методы: Bold для жирного, Faint для приглушённого, Italic для курсива, Underline для подчёркивания. Готовый стиль вызывается методом Render: ему отдаёте строку, получаете обратно ту же строку с вкраплёнными управляющими кодами. Важное свойство, на котором держится всё остальное: стиль — неизменяемое значение, каждый метод возвращает новую копию, не трогая исходник. Поэтому в View пишут так: обернули строку — и всё; а в инициализации, если нужно два шага, присваивают результат обратно переменной. Это отличает Lip Gloss от мутабельных конструкторов, к которым приучает обычный Go.

Ваш красивый hex-цвет существует только в терминале, который умеет truecolor. Профиль — число цветов, которые поддерживает текущий терминал — Lip Gloss определяет при старте, и рендер сам деградирует до ближайшего допустимого: в 256-цветном терминале ваш точный оттенок превратится в похожий из палитры, в 16-цветном — ещё грубее. Это не баг, а выживание: та же программа в SSH-сессии на древнем сервере останется читаемой. Вторая реальность — светлая и тёмная темы терминала: серый текст, идеальный на тёмном фоне, на белом исчезает. Для этого есть lipgloss.AdaptiveColor с двумя значениями — Light и Dark: библиотека определяет светлость фона через HasDarkBackground и берёт нужное. Именно так устроен краситель курсорной строки в textarea из прошлого урока. Полный контроль на все профили разом даёт CompleteColor — отдельные цвета для truecolor, 256 и 16, без автоматической деградации, но он нужен редко.

Рамка — это не строка дефисов, а готовый набор глифов: у липглосса есть функции NormalBorder с прямыми углами, RoundedBorder со скруглёнными, DoubleBorder с двойными линиями, ThickBorder жирными и ASCIIBorder из плюсов и дефисов — на случай самых простых терминалов. Метод Border принимает такой набор и по умолчанию рисует все четыре стороны; частичный выбор задаётся булевыми аргументами после рамки — по верху, правому краю, низу и левому краю, или отдельными методами вроде BorderTop. Цвет рамки — BorderForeground, и это отдельный цвет от текста: панель с серой рамкой и ярким заголовком выглядит дороже, чем одна сплошная краска. Рамка ложится после отрисовки текста и паддингов, поэтому геометрия считается честно: ширина панели складывается из текста, отступов и двух боковых линий. В таблице ниже — самые ходовые наборы, чтобы выбрать на глаз.

Два способа отодвинуть текст — и они не взаимозаменяемы. Padding — внутренние отступы: воздух между текстом и рамкой, и фон блока заливает и их тоже, поэтому цветная плашка с Padding выглядит цельной, а не как текст с прилипшей рамкой. Margin — внешние: пустое место вокруг уже готового блока, которым панели отодвигаются друг от друга; фон сюда по умолчанию не красится, но есть MarginBackground, если нужна сплошная заливка. Порядок аргументов у обоих методов CSS-образный: один аргумент — все стороны, два — вертикаль и горизонталь, четыре — по часовой от верха. Для одной стороны есть отдельные PaddingLeft, MarginTop и соседи. Держите в голове последовательность рендера: текст, затем паддинги, затем рамка, затем маргины — отсюда следует, что Width задаёт ширину содержимого, а рамка и маргины дорисуются сверху. Геттеры вроде GetHorizontalFrameSize вернут, сколько места рамка и отступы уже съели.

Стиль-база и производные от него — классический паттерн библиотеки: вы описываете общий вид один раз, а вариации получают точечные отличия. Исторически для этого существовал метод Copy: errStyle := base.Copy().Foreground(red) — база оставалась нетронутой, копия красилась. Здесь стоит быть честным до конца: в версиях Lip Gloss 1.1 и новее Copy помечен устаревшим, потому что методы и так возвращают новые значения, и то же самое записывается как base.Foreground(red) — присваиванием в новую переменную. В старых примерах, документации и чужом коде Copy встречается сплошь и рядом: читать его надо спокойно, а в новом коде я всё же оставляю вызов ради намерения — строка с Copy мгновенно читается как «делаем вариацию», хотя линтер вправе предложить иначе. Второй инструмент — Inherit: он переносит на стиль только те свойства базового, что явно установлены, и не трогает паддинги с маргинами. Это удобно для тем: одна база задаёт цвета, наследники добавляют свои отступы.

Методы Width и Height на стиле — это уже не краска, а геометрия: Width задаёт ширину блока в символах, и если текст длиннее, он переносится по словам, а короткие строки добираются пробелами до одной длины. Height добивает блок пустыми строками сверху или снизу — вертикальное выравнивание регулируется AlignVertical. Это уже половина раскладки, и вторая её половина — соединение блоков — тема следующего урока. Здесь зафиксируйте факт: блок с Width — прямоугольник со строками одной длины, и именно поэтому его можно предсказуемо склеивать, печатать и обкладывать рамками. Для отладки и расчётов у стиля есть геттеры — GetWidth, GetForeground, GetBold: они возвращают то, что реально установлено, и спасают, когда стили собираются из нескольких баз по условиям.

Красить блоки вы умеете — пора их соединять: экран собирается из панелей, и урок про раскладку научит склеивать блоки бок о бок, выравнивать и центрировать, а заодно считать ширину по сообщению WindowSizeMsg. Там же пригодится и эта база: все примеры раскладки — это стили из сегодняшнего урока. Тему целиком — наборы цветов, переключение светлое/тёмное, — интересно сравнить с десктопом: у нас есть урок про темы в Fyne, где решается та же задача, но с пикселями и шрифтами. Стили из урока лягут в отдельный файл проекта — об организации кода есть урок про структуру большого TUI-проекта. Практика: соберите три стиля — заголовок, успех и ошибку — от одной базы, оберните в рамку строку статуса с адаптивным цветом и посмотрите на неё в светлой и тёмной теме терминала.