Об этом проекте

Bubbles предоставляет набор переиспользуемых примитивов для построения терминальных пользовательских интерфейсов с использованием фреймворка Bubble Tea на языке Go. Компоненты применяются в продакшене в приложении Charm's Crush и многих других проектах, а сама библиотека распространяется под лицензией MIT как часть экосистемы Charm. Включенные компоненты: - Spinner: анимированные индикаторы для операций, находящихся в процессе выполнения, с несколькими вариантами по умолчанию и поддержкой пользовательских кадров. - Text Input: однострочное поле ввода, аналогичное текстовому полю HTML, с поддержкой Unicode, вставки, горизонтальной прокрутки на месте, когда значение превышает ширину элемента, и широкими возможностями настройки. - Text Area: многострочное поле ввода, аналогичное textarea в HTML, с поддержкой Unicode и вставки, а также вертикальной прокруткой, когда контент превышает размеры элемента. - Table: отображение и навигация по табличным данным в столбцах и строках с вертикальной прокруткой и параметрами настройки. - Progress: настраиваемый индикатор выполнения с опциональной анимацией через Harmonica, сплошным или градиентным заполнением, конфигурируемыми символами заполнения/пустоты и опциональным отображением процента. - Paginator: управляет логикой пагинации и может опционально отображать интерфейс навигации, поддерживая точечные (как в iOS) и числовые индикаторы страниц; логика также может быть сопряжена с пользовательскими визуализациями. - Viewport: область контента с вертикальной прокруткой, опциональными стандартными сочетаниями клавиш для постраничного просмотра и поддержкой колесика мыши, плюс высокопроизводительный режим для приложений, использующих альтернативный буфер экрана. Хорошо сочетается с Reflow для ANSI-ориентированного отступа и переноса строк. - List: комплексный компонент для просмотра наборов элементов, включающий пагинацию, нечеткую фильтрацию, автоматически генерируемую справку, спиннер активности и статусные сообщения, каждый из которых можно включить или отключить. Изначально выделен из Glow. - File Picker: навигация по каталогам и выбор файлов с опциональной фильтрацией по расширению. - Timer and Stopwatch: гибкие компоненты обратного отсчета и секундомера с настраиваемой частотой обновления и выводом. - Help: горизонтальный мини-представление справки, автоматически генерируемое из привязок клавиш, с однострочным и многострочным режимами и корректным усечением в узких терминалах. - Key: невидимый компонент для управления привязками клавиш, позволяющий пользователю переназначать клавиши и генерировать представления справки, связанные с этими привязками. Проект предлагает руководство по обновлению для миграции с версии v1, ссылки на примеры кода для каждого компонента в директории примеров Bubble Tea и указывает на поддерживаемое сообществом собрание дополнительных компонентов (Charm & Friends), принимающее вклад. Каналы обратной связи включают Twitter, Fediverse и Discord.