/ 
Term-Fabulous-0.01

Changes for version 0.01 - 2026-10-11

  • First release. Full-screen terminal user interfaces from a tree of widgets, built in Perl or in a KDL layout file, laid out by Clay (through Clay::UI) and drawn with 24-bit colors through termbox2. Key presses, mouse clicks, wheel scrolling and resizes arrive as events; keyboard focus moves with Tab and the mouse.
  • Widgets: boxes, text and rich text with styled spans, scroll boxes and virtual lists, text fields and areas, buttons, check boxes, radio groups, dropdowns, sliders, star ratings, segmented controls, tables, tabs, accordions, dividers, dialogs, toasts, progress bars, spinners, canvases, pixel canvases, images and sixel pictures.
  • Charts drawn from data: line, area, bar and scatter charts, histograms, sparklines, pie, donut, polar area and radar charts.
  • Application widgets: menus, a menu bar, a status bar, prompts, a command table with key bindings, a key reference, file dialogs, color pickers and document tabs.
  • Themes in KDL files, with a theme editor.
  • An inline mode that uses a few rows below the shell's output instead of the whole screen.
  • Term::Fabulous::Static prints a widget tree once as text, with or without colors, and Term::Fabulous::Terminal::Memory runs whole programs in tests without a terminal.

Documentation

README.md
fabulous-theme-editor
Edit Term::Fabulous themes with a live preview
Term::Fabulous::Cookbook
Recipes for common Term::Fabulous tasks
Term::Fabulous::Cookbook::Canvases
Recipes: draw on a canvas
Term::Fabulous::Cookbook::ChartStyles
Recipes: curves, markers, colors, line styles and hover of charts
Term::Fabulous::Cookbook::ChartTechniques
Recipes: time axes, live data, transforms, KDL and reports with charts
Term::Fabulous::Cookbook::Charts
Recipes: one for each chart type
Term::Fabulous::Cookbook::Extending
Recipes: your own widgets and events
Term::Fabulous::Cookbook::Forms
Recipes: forms, dialogs and input widgets
Term::Fabulous::Cookbook::GettingStarted
Recipes: a first program, quitting and text
Term::Fabulous::Cookbook::KeyboardAndMouse
Recipes: key bindings and buttons
Term::Fabulous::Cookbook::Layout
Recipes: layout, borders, colors and themes
Term::Fabulous::Cookbook::LiveData
Recipes: timers, logs and the output of commands
Term::Fabulous::Cookbook::Menus
Recipes: menu bars, context menus, status bars, help screens and document tabs
Term::Fabulous::Cookbook::Output
Recipes: reports and tests without a terminal
Term::Fabulous::Cookbook::TableRows
Recipes: sort, filter, group, nest and page table rows
Term::Fabulous::Cookbook::TableStyles
Recipes: column sizes, lines and colors of tables
Term::Fabulous::Cookbook::Tables
Recipes: show, format, edit and print tables
Term::Fabulous::Examples
The example programs of the distribution, with pictures
Term::Fabulous::Manual
The Term::Fabulous user guide
Term::Fabulous::Manual::Charts
Canvases and charts
Term::Fabulous::Manual::CustomWidgets
Writing your own widgets
Term::Fabulous::Manual::Events
Events, keyboard, focus, mouse and scrolling
Term::Fabulous::Manual::Feedback
Progress bars, spinners, toasts, status bars, prompts and file dialogs
Term::Fabulous::Manual::Forms
Forms and input widgets
Term::Fabulous::Manual::Glossary
The terms used in the Term::Fabulous documentation
Term::Fabulous::Manual::KDL
KDL layout files
Term::Fabulous::Manual::Layout
Widgets, the widget tree and layout
Term::Fabulous::Manual::Looks
Text, colors and borders
Term::Fabulous::Manual::Menus
Commands, menu bars, context menus and key references
Term::Fabulous::Manual::Programs
The event loop, output without a terminal and testing
Term::Fabulous::Manual::TableRows
Tables: sorting, filtering, grouping, trees, pages and selection
Term::Fabulous::Manual::TableStyles
Tables: colors, lines, size and printing
Term::Fabulous::Manual::Tables
Tables: how they work, rows, columns, display text and cell widgets
Term::Fabulous::Manual::Troubleshooting
Solutions to common problems

Modules

Term::Fabulous
Full-screen terminal user interfaces with layouts, widgets, keyboard and mouse
Term::Fabulous::Chart::Curve
How lines connect the points of a series
Term::Fabulous::Chart::Easing
Easing functions for the curves of charts
Term::Fabulous::Chart::Format
Number and date labels of charts
Term::Fabulous::Chart::Marker
The character sets charts draw with
Term::Fabulous::Chart::Palette
Color palettes and color arithmetic for the chart widgets
Term::Fabulous::Chart::Radial
Geometry of round charts in terminal cells
Term::Fabulous::Chart::Raster
A drawing surface with several subpixels per terminal cell
Term::Fabulous::Chart::Scale
What the scales of chart axes have in common
Term::Fabulous::Chart::Scale::Category
An axis of named categories
Term::Fabulous::Chart::Scale::Linear
A numeric axis with evenly spaced ticks
Term::Fabulous::Chart::Scale::Log
A logarithmic numeric axis
Term::Fabulous::Chart::Scale::Time
A date and time axis
Term::Fabulous::Chart::Series
One data series of an XY chart
Term::Fabulous::Chart::Surface
The cells of a chart while it is drawn
Term::Fabulous::Chart::Transform
Prepare the data of a chart series: normalize, smooth, accumulate, resample
Term::Fabulous::Check
Validate the values of widget properties
Term::Fabulous::Color
An immutable RGBA color, parsed from many notations
Term::Fabulous::Command
Something the user can do, with a name and keys
Term::Fabulous::Commands
The commands of a program, and the keys that run them
Term::Fabulous::Editor
Text, cursor, selection, undo and clipboard of a text input
Term::Fabulous::Enum::BorderStyle
The border styles a widget can be drawn with
Term::Fabulous::Enum::WebColor
The CSS named colors as Term::Fabulous::Color objects
Term::Fabulous::Event::Activate
The user activated a button
Term::Fabulous::Event::Answer
The user answered a prompt or a file dialog
Term::Fabulous::Event::CanvasResize
A canvas got a new size
Term::Fabulous::Event::Change
The user changed the value of an input widget
Term::Fabulous::Event::Choose
The user chose an item of a menu
Term::Fabulous::Event::Close
A dialog, a toast or a popup menu went away
Term::Fabulous::Event::Collapse
The user closed a row or a group of a table
Term::Fabulous::Event::ColumnsChange
The user chose which columns of a table are shown
Term::Fabulous::Event::CursorMove
The cursor of a table moved to another line
Term::Fabulous::Event::Expand
The user opened a row or a group of a table
Term::Fabulous::Event::FilterChange
The user typed into a filter field of a table
Term::Fabulous::Event::KeyPress
A key press from the terminal
Term::Fabulous::Event::LinkActivate
The user followed a link of a RichText
Term::Fabulous::Event::Mouse
A mouse click, release, drag or wheel turn from the terminal
Term::Fabulous::Event::MouseMove
The mouse pointer moved with no button held
Term::Fabulous::Event::PageChange
The user turned the page of a table or changed its page size
Term::Fabulous::Event::Resize
The terminal changed size
Term::Fabulous::Event::RowActivate
The user activated a row of a table
Term::Fabulous::Event::Select
The user opened or closed an item of an accordion, or chose a tab
Term::Fabulous::Event::SelectionChange
The user changed which rows of a table are selected
Term::Fabulous::Event::SeriesHover
The mouse moved onto another series, point or slice of a chart
Term::Fabulous::Event::SortChange
The user changed how a table is sorted
Term::Fabulous::Event::Start
The terminal is open and its size is known
Term::Fabulous::Event::Submit
The user pressed Enter in a text field
Term::Fabulous::Event::TabAdd
The user asked for a new document tab
Term::Fabulous::Event::TabClose
The user asked to close a document tab
Term::Fabulous::Event::TextClick
A mouse button pressed on a character of a text
Term::Fabulous::Event::ValidityChange
The value of an input widget became valid or invalid
Term::Fabulous::Layout
Build a widget tree from a KDL layout description
Term::Fabulous::OptionList
The options of a choice and the one selected
Term::Fabulous::Range
A value in a range, on a grid of steps
Term::Fabulous::Render
Role that paints Clay render commands into terminal cells
Term::Fabulous::Render::Attr
Turn colors into termbox2 truecolor attributes
Term::Fabulous::Render::Border
Paint widget borders in their border styles
Term::Fabulous::Render::Canvas
Paint canvas widgets, only their changed cells when possible
Term::Fabulous::Render::Frame
What one frame paints, command by command
Term::Fabulous::Render::Geometry
Snap Clay's layout boxes to terminal cells, and step lines through a raster
Term::Fabulous::Render::Rectangle
Paint widget backgrounds
Term::Fabulous::Render::Target::Grid
Cell target that keeps the painted cells in memory
Term::Fabulous::Render::Target::Mask
Base role of the cell targets: protect kept cells during a frame
Term::Fabulous::Render::Target::Sixel
Role of the cell targets that show sixel pictures
Term::Fabulous::Render::Text
Paint lines of text
Term::Fabulous::Role::CanParseLayout
Let a widget class be built from a KDL layout
Term::Fabulous::Role::HasBorderStyle
Border glyphs per side, and borders that take space
Term::Fabulous::Role::HasOptions
A widget whose options come from a layout
Term::Fabulous::Role::HasRange
A widget whose range comes from a layout in one piece
Term::Fabulous::Role::HasSeries
Named data series of a chart
Term::Fabulous::Role::Terminal
What Term::Fabulous needs from a terminal
Term::Fabulous::Role::Themed
How a widget reads its colors and borders from the theme
Term::Fabulous::Role::Validatable
An input widget whose value can be checked
Term::Fabulous::Roving
Which entry an arrow key moves to
Term::Fabulous::Static
Render a widget tree to text once, without a terminal
Term::Fabulous::Termbox
termbox2 compiled into Term::Fabulous
Term::Fabulous::Termbox::Event
One termbox2 input event
Term::Fabulous::Terminal::Memory
A terminal in memory, for tests
Term::Fabulous::Terminal::Termbox
The real terminal, through termbox2
Term::Fabulous::Terminal::Termbox::Cells
Cell target that paints into the terminal through termbox2
Term::Fabulous::Text::Markup
Parse "[bold red]text[/]" markup into text, styled spans and links
Term::Fabulous::Text::Style
Parse style strings such as "bold red on #202020"
Term::Fabulous::TextView
Lay out the text of an editor in a view of rows and columns
Term::Fabulous::Theme
Colors and borders for every widget, with variants per class
Term::Fabulous::Theme::Document
A theme file you can read, check and change, keeping its comments and layout
Term::Fabulous::ThemeEditor
Edit Term::Fabulous themes with a live preview of every widget
Term::Fabulous::ThemeEditor::Form
The form mode of the theme editor
Term::Fabulous::ThemeEditor::KdlArea
The text area of the theme editor's text mode
Term::Fabulous::ThemeEditor::Preview
The gallery of widgets in the theme editor's preview
Term::Fabulous::ThemeEditor::SettingsList
The table of settings in the theme editor's form
Term::Fabulous::ThemeEditor::Tab
A theme open in the theme editor
Term::Fabulous::ThemeEditor::UI
The UI of the theme editor, with a preview in another theme
Term::Fabulous::ThemeEditor::ValueDialog
The dialog that edits one setting in the theme editor
Term::Fabulous::Unicode
Measure text in terminal cells, exactly as termbox2 draws it
Term::Fabulous::Validator
Checks the value of an input widget
Term::Fabulous::Viewport
The arithmetic of a scrolled view
Term::Fabulous::Widget
Abstract base class of the Term::Fabulous container widgets
Term::Fabulous::Widget::Accordion
Sections that open and close under their headers
Term::Fabulous::Widget::Accordion::Item
One section of an accordion
Term::Fabulous::Widget::AreaChart
Lines with the area below them filled
Term::Fabulous::Widget::BarChart
Values as bars, grouped, stacked or horizontal
Term::Fabulous::Widget::Box
The general-purpose container widget
Term::Fabulous::Widget::Button
A box that can be clicked, focused and activated
Term::Fabulous::Widget::Canvas
A widget you draw on cell by cell
Term::Fabulous::Widget::Chart
What all chart widgets have in common: title, legend, colors and hover
Term::Fabulous::Widget::Checkbox
A box the user can check and uncheck
Term::Fabulous::Widget::ColorPicker
A field, sliders and swatches for choosing a color
Term::Fabulous::Widget::Dialog
A box that opens over the whole screen and keeps the focus
Term::Fabulous::Widget::Dialog::Backdrop
The screen-filling layer behind an open dialog
Term::Fabulous::Widget::Display
Common base class of the widgets that paint themselves from their own state
Term::Fabulous::Widget::Divider
A line between widgets, with an optional text
Term::Fabulous::Widget::DocumentTabs
A row of tabs for the open documents of a program
Term::Fabulous::Widget::DonutChart
A pie chart with a hole
Term::Fabulous::Widget::Dropdown
Choose one of several options from a list that opens
Term::Fabulous::Widget::Dropdown::List
The option list of an open dropdown
Term::Fabulous::Widget::Element
The Clay::UI roles behind Term::Fabulous::Widget
Term::Fabulous::Widget::FileDialog
A dialog that asks for a file to open or save, or for a folder
Term::Fabulous::Widget::FileDialog::FolderLine
The line that names the folder a file dialog shows, and its message line
Term::Fabulous::Widget::FocusableText
The focus role behind Term::Fabulous::Widget::RichText
Term::Fabulous::Widget::Histogram
How values are distributed: counts in bins
Term::Fabulous::Widget::Image
Show a picture in half-block pixels
Term::Fabulous::Widget::Input
Common base class of the input widgets
Term::Fabulous::Widget::KeyReference
A dialog that lists the keys of a program and what they do
Term::Fabulous::Widget::LineChart
A chart of lines through data points
Term::Fabulous::Widget::Menu
A list of commands, as a context menu, in a menu bar or on its own
Term::Fabulous::Widget::MenuBar
A row of menus at the top of the screen
Term::Fabulous::Widget::PieChart
A pie chart: parts of a whole as slices
Term::Fabulous::Widget::PixelCanvas
A canvas of square-ish pixels, two per cell
Term::Fabulous::Widget::PolarAreaChart
Slices of equal angle whose length shows their value
Term::Fabulous::Widget::ProgressBar
How much of a task is done
Term::Fabulous::Widget::Prompt
A dialog that asks a question and waits for the answer
Term::Fabulous::Widget::RadarChart
Several values per series on axes around a center
Term::Fabulous::Widget::RadioButton
One choice of a radio group
Term::Fabulous::Widget::RadioGroup
A group of radio buttons of which one is selected
Term::Fabulous::Widget::RichText
Text with styled spans and links: bold words, colored phrases, highlighted ranges, links to follow
Term::Fabulous::Widget::ScatterPlot
Points by two numbers, with trend lines
Term::Fabulous::Widget::ScrollBox
A box whose content scrolls
Term::Fabulous::Widget::Scrollbar
A scrollbar for a scroll container
Term::Fabulous::Widget::SegmentedControl
Choose one of a few options shown side by side
Term::Fabulous::Widget::Sixel
Show a picture in sixel graphics
Term::Fabulous::Widget::Slider
Choose a number from a range by moving a thumb
Term::Fabulous::Widget::Sparkline
A small chart without axes, one row high
Term::Fabulous::Widget::Spinner
Show that something is going on
Term::Fabulous::Widget::StarRating
Rate something with a row of stars
Term::Fabulous::Widget::StatusBar
A row at the bottom of the screen for messages and the program's state
Term::Fabulous::Widget::Table
Rows and columns with sorting, filtering, grouping, trees, pages and selection
Term::Fabulous::Widget::Table::Borders
Work out the grid lines of a table
Term::Fabulous::Widget::Table::Cell
A cell of a table
Term::Fabulous::Widget::Table::Column
What a table column shows and how
Term::Fabulous::Widget::Table::ColumnChooser
The list where the user picks the columns of a table
Term::Fabulous::Widget::Table::Filter
Conditions that decide which rows a table shows
Term::Fabulous::Widget::Table::Frame
A frame around a table that shows its focus
Term::Fabulous::Widget::Table::Grid
The grids of a table
Term::Fabulous::Widget::Table::HeaderView
The header of a table, scrolled sideways with its body
Term::Fabulous::Widget::Table::Model
The rows of a table and how it shows them
Term::Fabulous::Widget::Table::Mutator
Ready-made mutators for table columns
Term::Fabulous::Widget::Table::Pager
The page controls below a table
Term::Fabulous::Widget::Table::Style
Check the style hashes of a table
Term::Fabulous::Widget::Table::Toggle
The marker that opens and closes a row or group of a table
Term::Fabulous::Widget::Table::Value
Read numbers and dates from table values
Term::Fabulous::Widget::Tabs
Pages behind a row of tabs
Term::Fabulous::Widget::Tabs::Bar
A row of tabs, one of them active
Term::Fabulous::Widget::Tabs::Button
The button of one tab in a tab bar
Term::Fabulous::Widget::Tabs::Line
The line that joins the tabs of a bar with the page
Term::Fabulous::Widget::Tabs::Page
One page of a Tabs widget
Term::Fabulous::Widget::Text
A piece of text inside a box
Term::Fabulous::Widget::TextArea
Multi-line text input
Term::Fabulous::Widget::TextField
Single-line text input
Term::Fabulous::Widget::TextInput
Common base class of the text input widgets
Term::Fabulous::Widget::TextNode
The Clay::UI text role behind Term::Fabulous::Widget::Text
Term::Fabulous::Widget::Toast
A notification that appears in a corner and goes away by itself
Term::Fabulous::Widget::Toast::Stack
The column of toasts in one corner of the screen
Term::Fabulous::Widget::VirtualList
A ScrollBox that attaches only the items near the viewport
Term::Fabulous::Widget::XYChart
The common base of charts with an x and a y axis

Examples

Other files