hawktui 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 07fe25870ab381af56a2690f6b7befd22933dea333cb63f2d4d9e96b6801af5e
+  data.tar.gz: 8d7e1ce5dc90cfcc1d07e7adcb2b9f0c99949f612616c5ab64b7a3e34529f7c3
+SHA512:
+  metadata.gz: 25ead068f0039099acabceba170d120aaa8c674cae0b607df496a7de60fdc9a722c827376bf2bb6929522d5405861e515e4e8b3713d9b4bcce964bd855d51061
+  data.tar.gz: 5c6b1112d3519712730b7c84dccd153d0ae6062afd5c325beea6ad70cd13f6da8d6bed61f5f94ce9b0c20a0d03325117416326413b76301994cdf3698becb297

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.0

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jonathan Hoyt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,5 @@
+# Hawktui
+
+Hawktui is a simple and easy to use TUI (Terminal User Interface) library for Ruby. It is built on the [curses](https://github.com/ruby/curses) library.
+
+![hawktui](https://github.com/jonmagic/hawktui/blob/main/hawktui.jpeg)

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/hawktui.txt

@@ -0,0 +1,93 @@
+
+
+
+                                                               .-.                                                                                             .-.
+                                    .-%%#-.                   .+@@%-.                                                                                .*#-.    :##-    ...
+                                     .%@@@@*..                .+@@@@%..                                                                     ...     .#%%+.   :#%#=   .++.
+                                      :#@@@@@%=.              .:%@@@@@*                                                                    .+#=    .+%%%*.  .*%%#+   +#*:
+                                       .*@@@@@@@%=.             :%@@@@@@=                                                                 .*###.   :#%%%#.  =%%%#= .-##*:
+                .::...                  .:%@@@@@@@@#:.           :%@@@@@@@-.                                                             .=###%-. .+%%%%#: .#%%##- :###*.
+                :#%%%%#-.                 .-%@@@@@@@@@#:          .*@@@@@@@%:                                                            .#%%%%+. .#%%%%#:.+%%%##:.+###=.
+                 .+%%%%%@@#+:.               -#@@@@@@@@@@#=.       .-@@@@@@@@#-.                                                .*#+..   :#%%%%#- =%%%%##.-#####=.+###*:
+                   .=%%%%%%@@@@*-...           .#@@@@@@@@@@@%-..     .+@@@@@@@@%:.                                              =###*-.  -#%%%%##.*%%###+-####*+.*###*=
+                     .:*%%%%@%%%@@@%*-.          .-%@@@@@@@@@@@%*-.    .+@@@@@@@@%=.                                            =#####*: .######**#####***#***=-*##**=.
+                        .-#%%%@%@@@@@@@@%*=:.      ..=%@@@@@@@@@@@@%+:.   =%@@@@%%@@+..                                         .##%%%%#*=*%%##%*#####*****++=+***++:.
+                           .:#%@@@@%%%@@@@@@@@%+-...   .+%@@@@@@%%@@%@@@*:..:#@@@@@%%@*..         ..#%@:.               .-==-:....#%%%%%%#*#######**#++**-+++*+++=:.
+                              ..=%%%%%%%@@@%%%@@@@@@%#+:. ..=%@%%%%%%%###%%@%#*%%%##*%##%=.       -%@%@@+.             :########*+++#%%%%#%#**##+***+**====*+++:.
+     :*%%%#+=:..                  .:=*%%%%%%%%%%%%%@@@@@%%%%*=-*%%###%#*++#%*+#%**###**##*#*:.   =@@%%%@@#.           .-#%%%%%%%#%##**######+##**#*+*********+=:
+       :*%%%%%%@@%*=:....              .-*#%%@@@@%%%%@@#**@@*+#@#*%*+*#%%++#%*==#%*++**+*#**+*=..#@%%%%@@@%..     .......=%%%%%%%%%%%%#%*%##*##*********+++=-:.
+         .=%%%%%%%%%@@@@@%%%#*+-:..        ..:-#@@%#*+*%@#+++%%+=*@*=%%+##+=*#+==#*=**###*%%#%##%@@%%%%@@@@%:    -#%%%%%%%##%%%####%#*#%%#**+===---+*++=-:..                                                                                                                                 ....
+            .-+%%%%%%%%%%%%@@@@@@@@@@@%%%%###*****%%%%#*++#@#==*@+=+%*-+%*=**=**=+%####%*%###+*%#*##%%%%%%@@*.  .:*%%%%%%%%%%%#%%#*#%%%#**++++==--::.                                                                                                                          ...:-=++**########-.
+                ..=##%%%%%%%%%%%%%%@%#*#@@#**@%**@%++#@+=*@#+*@#==%#==#+-+#=+#--#%+%#**=+++=+**%*+*#@@%%%@@%#-#%%%%%%%%%%%%%%%%%%%%#**+++==+===-:..                                                                                                             ......:-+*%%%#**++++++++++++++++++:
+                     ..:=*#%%%%%%%#**#%@#**#@*+*@%==#@*=+@#==%#-=%+-*%+-*%+-*+=*##%#%*===+++*#**+#%###%%%%%%*-*####%%%%%%%%%%%##*+====***+++==-:.                                                                                                    ..:-=*##***+++++===+++++++++++++++++++++++++*-
+                             .:--=+#%####%@#++%@*+#%%+=#%+-+@*-+%=-##--%+-=#--%#####=-===++****+*#####%#%%%#=+%%%%%%%%%%%%%##*+++==+**++++++=-..                                                                                     ...:-=+++******+=================+++++++++++++++***####*++++*=
+                                    ...=****#%#=+#%%++#%*==#%==%#-+%=-##--%=-*+*%*##=====+*%#**########%#%#*-:=*#%@@%%%%%%%**++****#****+++==:   .......                                                              ......::=*###*+===============================++++++**#%%@@@@@@@@@@@@@*+++*#-
+      ..... ........::--==+++*###*##%%#*#%%**#@%==%%+=*@*=+%*=+%=-*#--*%-=#-=%=*%#%%%*=+++**+######%%#%%#%%#*--::=#%%%##%###*###%**##***+=-=-====+++====--:.                                                 ..:=+***+++++==============+@#===============+**#%%@@@@@@@@@@@@@@@@@@@@@@@@@@@%++++*%:
+     .=*%%%%%%%%%%%%%%%%%%%@%*#@@%+*@@*+#@#++%@+=+@#==#%==+%#-=@*-*#-=%--%*-=%=-#+*#+*#**+*+***#%###%%%%%%###*+--::::+#%%@%%%%%#%%#***+***###%%##%%%###+=----:.                                 .:-==++++*++===============================+**##%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@++++*#-.
+         ..-+###%%%%%%%%%%%%%*#%#+*@%#*#@%*+*@%=+%@*==@%--#%--#%-=%+-=%=-%+:+#+=#*+**#%*+#*%######@%%%%%%%%%%%##*=-::-:..-#%@@%*+**##**+++#@@%@@@@@@%%%%#*=-::-:.                             .:*-=========================++++*#%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#=+++#+.
+               ...::-==+***#%%*+#@@#++#@%++#@#=+#@*==%%+-=@#-=%*:=%+-*#--%*-+%==+#******%%%%%##*##%%*#%%#%%%%%%%%%**+--:----:.::-==+==+*+*%@@@@@@@@@@%#%@@%*-::--.                            :+-============++*#%%@@@@@@@@@@@@@@@@@@@@@@@@@#=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%++++##:
+                              ..:::-+*##**%###*+*@%--@@=-#%=-*%+-+%+=+#-=%=*#-##=++*##@@@@%*****%%%##*###%%%######%####*==--::::--=+#%++**##@@@@@@@@##*+*#@@@*-:--.                          .=-+*##%%@@@@@@@@@@@@@@@@@@@@@@=*@@@@:%@@@@@*@%+@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*++++%=.
+                          ....:=*###@@#*%@*=+@#=*@+-*@#++#%+-=#%*--#%*+=%--##=+++*++##%%@@%#%**####%#+#=#+%#%%%%#%######%#***#*++=++*@@*%%*#@@@@@@@@@@%#*+*#@@@@+=-.                        .-=%@@@@@@@@@**@@@@@@@@@@@@@@%**-@*-#:=#==@@++@:#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++#*.
+                    .-=*##%%%%%%%@**%@*+%%++%#*%%+=#%#==#%#*#==#%===%#-+%#=-*#**++%#**@@@@%%%#**#@@%*****+++%#%%#%%#########**#%#%%@@@@@%###@@@@@@@@@@@@@%#*%@%@@#+:                        :=*@@@@@@@@@@--:#@=**:@.#*:%#+@--+@@#-@%-@@#=@=*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%++++##:
+                .=#%%%%%%%%%%%%%%##%@%*+#@%++#%*+*%%*+*@%=-*%#==%#-=%#*-=%#=+*+*#+=*%#@@@@@%#***##%%@#%+=#++++*+%##%####****##%%%@@@@@%**++###%@@%%%@@@@@@@@###@@*:.                       .==@@#-=#@@@@-#@+%%++:#@.*#=++@-#+=@%:@@.#@+.@+-@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*+++*#+.
+                   .:-****#######%%%*=*%#*+%%%%@%**%@#==@#=*%+==%%#=-#%=***#*#=++#*+%@@@@@%%#%####*#*###%*#++**#***+*+*%+*###%@@@@@@%%#++=*%%***%#%%*#+**+#%###%#+=..                     .=-%@@@@%=+@@+*@%+=*@*=@*.#@.%@=+@@:@#-%@**@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%=+++##.
+                             .......   .-#%%@%%%%#**%*=*%*++%%#==%%+=#####*+=###-*%**@@@@@%##%####****+**#####%+#+***#*##%%@@@@@@@@@@#++==+=*#++*++++=-......-#@%#%+.                     -=#@@-+%@@@@@*@@#@%#%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@+=++*#-.
+                                    .+#%@@%%%%%%%%%#*#@%%%%**%%+-*%#+*#==*%%*-=#%=*%#+%@@@@@@%%%%###***#*%%%%####%#%%#%@@@@@@@@@@@@%#%%*===+-++=++=-.         .-@@@*.                    :==@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*++++#*.
+                                  :#%%%%%%%%%%%###%@@@%%%#%#+#%%%%#*#*%+*#=-##+-%#*+%%%%#%%%%%@%@%%%####%%#@%#@#@@#%@@@@@@@@@@@@%@%@*+===--+---=-=.             .*+.                    .+-@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%++++*%:
+                                 .-+##%%##*+-:.:#@@@%%%%%%%#%@%%#%%#==%%##+#*#*###%#%=#%%@@@%@%@%@###%%%%%%@%@@%@@@@@@@@@@@@@@@@@%#**%%+=--------..                                    .+=#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@+++++%-.
+                                             :#%%%%%%%%%%@@@%%%%%%%%@%#-=%#+=#%#++%*%%+#*#%%%%%%%%@%@@@@@@@@@@@@@@@@@@@@@@@@@@@@%%%%#+------:-::.                                      -=+@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++#*.
+                                          ..*%@%%%%#*+@@@%%%%%%%%%@@%%%%%%%%@*=#%#%#-*%%+##%#%%%%@%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%*+#==+=--::::.                                      .==@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@++++#%-.
+                                          .........-%%@%%%%%%%%@@@%%%@%%%%@@%%##+*+#@#+*%##*%##%%%@%@@@@@@@@@@@@@@@@@@@@@@@@@@@%%%@@+%*=%-::::.                                      .*-%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*++++%+.
+                                                 .*%%%%%%%*=+%@@%%%@%%%%@@@%%%%%%%%#*#@%++%%*%%%%@@@@@@@@@@@@@#+-@@@@@@@@@@@@@@@@%@@+=#+%=-++:                           ..::.      .--*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%++++#*.
+                                                 .+***=:  .*@@@%%%%%%%@@@%%%%%%%%@@%@@#%@@#%@@%@@@@@@@@@@@@%-  .*@@@@@@@@@@@@@@@@@#**%#=++**:...                       .*%=         .+=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@++++*#=
+                                                         :#%%%@%%%*-%@@@%%%%%%%@@%@@@@@@@@@@@@@@@@@@@%*#+:.    *@@@@@@@@@@@@@@@%###+==+-#**-::...                      =*=-*=.     .+=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++##.
+                                                        .=#%%%#=:.=%@@@@@@%%%@@@%@@@@@@@@@@@@@@@@@@@%:       .#@@@@@@@@@@@@@@@@@@#+++=+=+*=*++-:...                   .*%##=:.    .==*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@++++*%:.
+                                                          ..     -%@@@@@%%#@@@@@@@@@@@@@@@@@@@@@@@@*.      .+@@@@@@@@@@@@@@@@@@@%==::..+++####*=::..                  .#%#=       :==@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++%+.
+                                                                 -%%@%#-.:%@@@@@#@@@@@@@@@@@@@@@%%:.      -%@@@@@@@@@@@@@@@@@@@@@%*=-:..*#######*-:..                .#%@%-      .*=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%++++##.
+                                                                 .::.   .*%@@*-.#@@@%+%@@@++@@#...      :#@@@@@@@@@@@@@@@@@@@@@@@@%*+-::-*#######*=::....         ..=%@#-       .+=#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*+++*%=.
+                                                                         :-.   .#%#:.:#%=. .=.        .+%@@@@@@@@@@@@@@@@@@@@@@@@@@%*=::.+#*#######*+--:::....:=*%@@@%-         :++@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++#*.
+                                                                                ..    ..            .=#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#+-:.:****#########**+*#%%%*=::#@-.        .*=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@++++*#-
+                                                                                                   :#@@@@@@@@@@@%%%%%%%%%@%@@@@@@@@@%*=::..-+**###########+:.      :%-.       .+=%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++#+.
+                                                                                                 .-%%@@@@@@@%%%%%######%%%%%%@@@@@@@%*+--.. :=+**#######*+:.       :%*.       -+*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%*+++*#.
+                                                                                                .*%@@@@@@@#%%%%############*+%@@@@@@%#+=-:.  .:-+***#***+=:.       -@@=      :++@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*++++%-.
+                                                                                              .+%@@@@@@%##%%%####**#*****+-..*@@@@@@@%*=-:..   .:-=++++=--:.        :%-.:   :++%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#++++#*.
+                                                                                            .:*##@@@%%########****++++=-.   .*%@@@@@%%#*=-..      ..:.::...                .=+*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%*+++#%-.
+                                                                                           -#@%%@@%%######******++==-=+.    .+%@@@@@@%**+-:..                              =++@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#*++*%=.
+                                                                                        .+%%%%@@%%####******++======-=*-     :=#%@@@%%%#*+=:..                           .-++@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%*++*%*.
+                                                                                     .-#%%%%@%%%*##*****+++===++=-=++++-     .:*%@@@@%%%####+-...:+..       ..=##-       .++#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*****#-.
+                                                                                  .-#%%%@%@@%%*#******+++==+==+:===+*#*.     ..=*%%%%%%%%#+=*%@%%@%**%#.    :#*+%#=.    .+++@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%****##..
+                                                                               .-*%%%#%%%@%%**#*#*+++++++=+*===..-+##+:.       .:+*######+-.  .+@@@@@+...:+####+. .-.  .=++@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*****%:.
+                                                                            .:#%%#*#@%%@#%#****#*=**++++===+=+=   ..            ..::-+*=*=..   *@@@%@@@%@@@@%@@%+:     :++%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#****%=.
+                                                                         .+##%**+%@@%@%%%#+#***==**+==+=*=-=++-                    ...:.:..     .+-..*@@%@*-..:..     .*+*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%****##:
+                                                                    .:=##+***++%%#%%%###=+*+**-+++++*+=-=+++**.                                     .%#:. -=:        .++*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%#****#-.
+                                                               ..:*#*+::#+*-*@**%%#*#*+:##**=:*#++=+**+:=*##*.                                    .=@%:              -**%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%****#*.
+                                                             .++=-:.=*+*--#+#=#%%=***:+#***:-+*+++====.:*##-.                                    .%@#-.             .**#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%****##-
+                                                               .:=+++=-*#*+-*%#==%#-.+*+*+.=#++--+**#:  ...                                      :%:.              .*+*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#****#+.
+                                                          ...=*-=*=::#**=.*%#-:##+.:#*+*:.=**+-.*%%#.                                             :#+.             =**@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%****#%:.
+                                                           .=+=:..*#*+..###:.*##:.-****..=*++. +%#=.                                                              :*+#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#****%=.
+                                                              .-#*-:.:##*: -%#=..+#*#-..-*##.  ::.                                                               .*++##%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%****%*.
+                                                           ..=++.  .#%#. .***. .***%.  -@%=                                                                     .++++++++++*+**#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%#####%-.
+                                                           ...   .*%#:..=%%=. :%@%+.  -@+.                                                                      -**********************##%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%#####+..
+                                                               .=#=.  .*%*.  .%%*:    :.                                                 .......::::::---:::::::=++*##*************************##%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%######:.
+                                                                     .*=.   .*+.                           .............:::-----===--=+===---:::-+**#*-:--=-:::::----==+++**######***********************#%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#####%=.
+                                                                            ..           ...:::::----*=-------=#%*-------==+++=--=+++**==--==++++=-==+=--==**+=-=*+---------==+++++*#########*******************###%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%####%#..
+                                                              ....::::::------==============-----------+*%*=---====*****+=====-=+==-==--=========-=+==------=-=--=++*#+==+=--------====++****##############*******######*##%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%######:.
+                                                            .=++=================================------------*%#+==-====-=*##=-:::-=*#**+=----:+*=-====-==---====--------*%%%#+---=-------====++++**################################%@@@@@@@@@@@@@@@@@@@@@@@@#####%+.
+                                                              .-*+++===============================-----------=+*+=*%*=:---::---+#+-------=#+=-----=+*+-=----:::-====+=--=-----===+*+*#*+------=======++++**#################################%@@@@@@@@@@@@@@%######:
+                                                                .-*#*++==========++++*******+++++++++======--------=+++++##+-:::::::-+**+==---=+++=-----=+=++===-:--::---=+===========+***##*==-=+=========++++++*###%%%%%###################%%%%%#%%%%@@@@%%%%#%%=.
+                                                                    .*@%**++==++++======++++====================-------:-**--*%#=:::::::::+*+==-----=###*+===-----*#*++--::::--============++++*##*+*#*===+++++++++++++++*#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*.
+                                                                       .-@@%**++=++===+++++++=====++++++==========--------::--=*+-+#%+::::::::-=**-:::--=++*#+==-:::::-=***=------=**======++++*********###*++++*++++++++++++++***#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%#-.
+                                                                          .-*@%%#%@#+==++++++++++++++++++++++=======-----------:::=++==+##+=+++++++*+**=-==----=***++=======+***+=-----=+***++++++++*#****+***##%#*++*#*+++++++**+++++**##%%%%%%%%%%%%%%%%%%%%%%+.
+                                                                              .*@@@@@%%*=+++++++++++++++++++++++======------------:::::=-::=%%+::::::::-+%%#+-::::::--=#+---------+%#*+======-+##*++++++#******##**###%#***##*++++++++***+=====*%%%%%%%%%%%%%%%%:.
+                                                                                ..-%@@@@@#+++++++++++++++++++*****+++========-------::::::::::-=+@%=::::::::-+%%@%*-:::::--=*#=::------=##+-====--==+##+++*+*************#*##%%#***+****+++++**********#%%%%%%%-.
+                                                                                     -*@@@%##**++*****************++++++=======---------:::::::::::-+##*+++#*=:::-+#%%*+-::::::-+**+-::::::-+***+=------=***#*++++*###*#####%%%########****++++++++++===*@@@%*:.
+                                                                                        .+@@@@%#*********************+++++======-----------:::::::::::::=#%%*==+=-------+#@#=::::::::=%%+-::::----=#%**#%%@%#****++++++++++++====+++++++=*%%@@@%@*++++==:::..
+                                                                                           .-%@@@@%#*******************+++++=====-------------::::::::::::::-+%#+--*%=::::::-+#%%++**##%%=##**++====-------=====++++++%%%%%@@+=*%%%%%@*==+@@@@@@%======-.
+                                                                                              .:*@@@@%#########***********++++====--------------:::::::::::::::::-==-=*#####*++-:----------======++++++++++++========#@@@@%%#==+#########%@@@@@@@@@%#*=-:..
+                                                                                                  .+@@@@@%#######**********++++====-----------------::::::::::::::::::::-----==++***++++++++++++++++++++++++++++**#%%@@@@@@@@@@@@%%%%#*+=-:....
+                                                                                                    ..:%@@@@@%####*********++++=====------------------::::-==+++++++++++++++++++++++++++++**###%%@@@@@@@@@@@@@@@@%#*+=-:::.....
+                                                                                                         :*@@@@@@%###*******++++====----====++++++**+++++++++++++++++****####%%%@@@@@@@@@@@@@%%#**++=-::...
+                                                                                                            .+%@@@@@%%#************+*++++++++++++++++++**#%%@@@@@@@@@@@@@@@@@%%#*+=-:.
+                                                                                                               .-#@@@@@@%***++++++++**##%%%@@@@@@@@@@@@@@@@@%#*=--::.....
+                                                                                                                  .:*@@@@@@@@@@@@@@@@@@@@%%#*++=--::..
+                                                                                                                      .+%%%#*+=:..

data/lib/hawktui/streaming_table/cell.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Hawktui
+  class StreamingTable
+    # Public: Represents a single cell in a table. Holds the cell’s value and
+    # optional color, and can return both in a consistent format.
+    #
+    # Examples
+    #
+    #   cell = Tui::Cell.new("Hello")
+    #   cell.value  # => "Hello"
+    #   cell.color  # => nil
+    #
+    #   colored_cell = Tui::Cell.new(value: "Error", color: :red)
+    #   colored_cell.value  # => "Error"
+    #   colored_cell.color  # => :red
+    #
+    class Cell
+      attr_reader :value, :color
+
+      # Public: Create a new Cell object from either a raw value or a Hash with
+      # `:value` and `:color` keys.
+      #
+      # value_or_hash - A raw value (e.g., String, Integer) or a Hash of the form:
+      #                 { value: <String/Integer>, color: <Symbol/Integer> }.
+      #
+      # Examples
+      #
+      #   Cell.new("Hello")
+      #   Cell.new(value: "Hello", color: :blue)
+      #
+      # Returns a new Cell instance.
+      def initialize(value_or_hash)
+        @value, @color = extract_value_and_color(value_or_hash)
+      end
+
+      # Internal: Extract the cell's value and color from the given parameter.
+      #           If value_or_hash is a Hash, expects :value and :color keys.
+      #
+      # value_or_hash - A raw value or a Hash with :value and :color.
+      #
+      # Returns an Array [value, color].
+      def extract_value_and_color(value_or_hash)
+        case value_or_hash
+        when Hash
+          [value_or_hash[:value], value_or_hash[:color]]
+        else
+          [value_or_hash, nil]
+        end
+      end
+    end
+  end
+end

data/lib/hawktui/streaming_table/column.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Hawktui
+  class StreamingTable
+    # Public: Represents a single column in a table. Knows how to truncate or
+    # pad a cell’s text to fit within its width.
+    #
+    # Examples
+    #
+    #   column = Tui::Column.new(name: :message, width: 50)
+    #
+    class Column
+      attr_reader :name, :width
+
+      # Public: Create a new Column with a name and width.
+      #
+      # name  - A Symbol or String representing the column's name.
+      # width - An Integer specifying how wide the column is.
+      #
+      # Examples
+      #
+      #   column = Tui::Column.new(name: :message, width: 50)
+      #
+      # Returns a new Column instance.
+      def initialize(name:, width:)
+        @name = name
+        @width = width
+      end
+
+      # Public: Format the cell’s textual value to fit within the column width.
+      # If the text is longer than `width`, it will be truncated with an ellipsis ("…").
+      # Otherwise, it’s left-padded with spaces to fill the width.
+      #
+      # cell - A Tui::Cell containing the raw value and color.
+      #
+      # Examples
+      #
+      #   cell = Tui::Cell.new("Some message")
+      #   column.format_cell(cell)
+      #   # => ["Some message        ", nil] # => example if width is bigger
+      #
+      # Returns an Array [formatted_string, color].
+      def format_cell(cell)
+        str_value = cell.value.to_s
+        if str_value.size > width
+          [str_value[0...width - 1] + "…", cell.color]
+        else
+          [str_value.ljust(width), cell.color]
+        end
+      end
+    end
+  end
+end

data/lib/hawktui/streaming_table/layout.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Hawktui
+  class StreamingTable
+    # Public: A class to layout tables with columns and rows. Knows how to convert
+    # a hash of row data into an array of Cell objects in the correct column order,
+    # and can also build a header row for the table.
+    #
+    # Examples
+    #
+    #   columns = [
+    #     { name: :timestamp, width: 20 },
+    #     { name: :message,   width: 50 },
+    #   ]
+    #   layout = Tui::TableLayout.new(columns: columns, header_color: :white)
+    #
+    #   header_cells = layout.build_header_row   # => [Cell(...), Cell(...)]
+    #
+    class Layout
+      attr_reader :columns
+
+      # Public: Create a new TableLayout.
+      #
+      # columns      - An Array of Hashes or Tui::Column objects. Each element must
+      #                have a `:name` and `:width`.
+      # header_color - A Symbol representing the color used in the header (defaults to :white).
+      #
+      # Examples
+      #
+      #   layout = Tui::TableLayout.new(
+      #     columns: [
+      #       { name: :time, width: 10 },
+      #       { name: :level, width: 5 },
+      #     ],
+      #     header_color: :yellow,
+      #   )
+      #
+      # Returns a new TableLayout instance.
+      def initialize(columns:, header_color: :white)
+        @columns = columns.map do |col|
+          # Accept either raw Hashes or Column objects
+          col.is_a?(Column) ? col : Column.new(**col)
+        end
+        @header_color = header_color
+      end
+
+      # Public: Return an Array of Cell objects for the header row.
+      # Uses a header-specific color if desired.
+      #
+      # Examples
+      #
+      #   layout.build_header_row
+      #   # => [Cell(value="time", color=:white), Cell(value="level", color=:white)]
+      #
+      # Returns an Array of Tui::Cell objects.
+      def build_header_row
+        columns.map do |col|
+          # Use the stored @header_color for all headers
+          Cell.new(value: col.name, color: @header_color)
+        end
+      end
+
+      # Public: Convert a single row of data (a Hash) into an array of Cells, in column order.
+      #
+      # row_hash - A Hash whose keys are the column names and whose values may be raw
+      #            or a Hash with :value and :color.
+      #
+      # Examples
+      #
+      #   row_hash = { time: "12:00", level: { value: "INFO", color: :green } }
+      #   layout.build_cells_for_row(row_hash)
+      #   # => [Cell(value="12:00", color=nil), Cell(value="INFO", color=:green)]
+      #
+      # Returns an Array of Tui::Cell objects.
+      def build_cells_for_row(row_hash)
+        columns.map do |col|
+          value_or_hash = row_hash[col.name] || ""
+          Cell.new(value_or_hash)
+        end
+      end
+    end
+  end
+end

data/lib/hawktui/streaming_table.rb

@@ -0,0 +1,261 @@
+# frozen_string_literal: true
+
+require "curses"
+require "hawktui/utils/colors"
+require "hawktui/streaming_table/cell"
+require "hawktui/streaming_table/column"
+require "hawktui/streaming_table/layout"
+
+module Hawktui
+  # Public: Streams a dynamic table to the terminal, handling user input such as
+  # pausing/unpausing and quitting. Continually appends new rows at the top of the
+  # table and enforces a maximum row limit.
+  #
+  # Examples
+  #
+  #   columns = [
+  #     { name: :timestamp, width: 20 },
+  #     { name: :message,   width: 50 },
+  #   ]
+  #   table = Tui::StreamingTable.new(columns: columns, max_rows: 1000)
+  #   table.start
+  #
+  #   # In a separate thread or async process:
+  #   table.add_row(timestamp: Time.now.to_s, message: "Hello, world!")
+  #
+  # WARNING: The StreamingTable must run in the main thread and table.add_row should
+  # be called from a separate thread or async process. This is because the table
+  # uses curses, which is not thread-safe and does not respond to user input in
+  # a separate thread.
+
+  class StreamingTable
+    # Public: Create a new StreamingTable.
+    #
+    # columns - An Array of Hashes or Tui::Column objects that define the table’s
+    #           columns. Each element should at least contain `:name` and `:width`.
+    # max_rows - The maximum number of rows to keep in the table. Defaults to 100000.
+    #
+    # Examples
+    #
+    #   table = Tui::StreamingTable.new(columns: [{ name: :time, width: 10 }], max_rows: 500)
+    #
+    # Returns a new StreamingTable instance.
+    def initialize(columns:, max_rows: 100_000)
+      @layout = Layout.new(columns: columns)
+      @max_rows = max_rows
+      @rows = [] # Store rows newest-first
+      @paused = false
+      @input_thread = nil
+      @should_exit = false
+    end
+
+    # Public accessors
+    attr_reader :layout, :max_rows, :rows, :paused, :should_exit
+    attr_accessor :win
+
+    # Public: Start the table UI. Initializes curses, sets up input handling,
+    # and draws the initial screen.
+    #
+    # Examples
+    #
+    #   table.start
+    #
+    # Returns nothing.
+    def start
+      setup
+      start_input_handling
+      draw
+    end
+
+    # Public: Stop the table UI. Stops the input thread, closes the curses screen,
+    # and exits the process.
+    #
+    # Examples
+    #
+    #   table.stop
+    #
+    # Returns nothing. Exits the process.
+    def stop
+      @input_thread&.exit
+      Curses.close_screen if win
+      self.win = nil
+      Process.exit(0)
+    end
+
+    # Public: Add a new row of data to the top of the table. If the table has
+    # reached its maximum row limit, the oldest row is dropped.
+    #
+    # row_data - A Hash of row data where keys match column names. Values can be
+    #            raw (String, Integer, etc.) or a Hash with :value and :color.
+    #
+    # Examples
+    #
+    #   table.add_row(timestamp: "2025-01-01 12:00", message: { value: "New Year!", color: :red })
+    #
+    # Returns nothing.
+    def add_row(row_data)
+      return unless win
+
+      rows.unshift(row_data)
+      rows.pop if rows.size > max_rows
+      draw unless paused
+    end
+
+    # Internal: Set up curses, initialize colors, etc. Called by #start.
+    #
+    # Returns nothing.
+    def setup
+      Curses.init_screen
+      Utils::Colors.setup_colors
+      Curses.start_color
+      Curses.noecho
+      Curses.curs_set(0)
+      Curses.stdscr.keypad(true)
+      Curses.timeout = 0
+
+      self.win = Curses.stdscr
+      win.clear
+    end
+
+    # Internal: Start a separate thread to handle user input (non-blocking).
+    #
+    # Returns nothing.
+    def start_input_handling
+      @input_thread = Thread.new do
+        loop do
+          handle_input
+          sleep 0.1
+          break if should_exit
+        end
+      rescue => e
+        win.setpos(0, 0)
+        win.addstr("Error in input thread: #{e.message}")
+        win.refresh
+      end
+    end
+
+    # Internal: Handle a single character of user input, toggling pause or stopping
+    # the table as appropriate.
+    #
+    # Returns nothing.
+    def handle_input
+      case Curses.getch
+      when "p"
+        toggle_pause
+      when "q"
+        @should_exit = true
+        stop
+      end
+    end
+
+    # Internal: Toggle whether the table is paused. When paused, new rows
+    # are still collected but not rendered until unpaused.
+    #
+    # Returns nothing.
+    def toggle_pause
+      @paused = !paused
+      draw_footer
+    end
+
+    # Internal: Draw the entire table (header, rows, status line).
+    #
+    # Returns nothing.
+    def draw
+      return unless win
+
+      win.clear
+      draw_header
+      draw_body
+      draw_footer
+      win.refresh
+    end
+
+    # Internal: Draw the header row of the table.
+    #
+    # Returns nothing.
+    def draw_header
+      header_cells = layout.build_header_row
+      formatted_header_cells = header_cells.zip(layout.columns).map do |cell, column|
+        column.format_cell(cell)
+      end
+      draw_row(0, formatted_header_cells)
+    end
+
+    # Internal: Draw the body of the table (rows of data).
+    #
+    # Returns nothing.
+    def draw_body
+      max_display_rows = Curses.lines - 2
+      display_rows = rows.first(max_display_rows)
+
+      display_rows.each_with_index do |row_data, idx|
+        cells = layout.build_cells_for_row(row_data)
+        formatted_cells = cells.zip(layout.columns).map do |cell, column|
+          column.format_cell(cell)
+        end
+        draw_row(idx + 1, formatted_cells)
+      end
+    end
+
+    # Internal: Draw the status line at the bottom of the screen.
+    #
+    # Returns nothing.
+    def draw_footer
+      return unless win
+
+      win.setpos(Curses.lines - 1, 0)
+      status = paused ? "PAUSED" : "RUNNING"
+      help_text = " | Press 'p' to pause/unpause, 'q' to quit"
+      win.addstr("Status: #{status}#{help_text}".ljust(Curses.cols))
+      win.refresh
+    end
+
+    # Internal: Draw a single row of the table, given already-formatted cells.
+    #
+    # y_pos            - The Integer row position (0-based) on the screen to draw.
+    # formatted_cells  - An Array of [string_value, color], as returned by column formatting.
+    #
+    # Returns nothing.
+    def draw_row(y_pos, formatted_cells)
+      x_pos = 0
+      formatted_cells.each do |str_value, color|
+        win.setpos(y_pos, x_pos)
+
+        if y_pos == 0
+          # Bold the header row
+          win.attron(Curses::A_BOLD) { draw_with_color(str_value, color) }
+        else
+          draw_with_color(str_value, color)
+        end
+
+        x_pos += str_value.length + 1
+      end
+    end
+
+    # Internal: Add a string to the screen, optionally with a color attribute.
+    #
+    # str_value - The String text to draw.
+    # color     - An Integer color index or Symbol referencing a base color in Colors.
+    #
+    # Returns nothing.
+    def draw_with_color(str_value, color)
+      if color
+        color_index =
+          case color
+          when Integer
+            color
+          when Symbol, String
+            Utils::Colors::BASE_COLORS[color.to_sym]&.first
+          end
+
+        if color_index
+          win.attron(Curses.color_pair(color_index + 1)) { win.addstr(str_value) }
+        else
+          win.addstr(str_value)
+        end
+      else
+        win.addstr(str_value)
+      end
+    end
+  end
+end

data/lib/hawktui/utils/colors.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+module Hawktui
+  module Utils
+    module Colors
+      # Define base color ranges
+      STANDARD_COLORS = (0..15).to_a
+      COLOR_CUBE = (16..231).to_a
+      GRAYSCALE = (232..255).to_a
+      BASE_COLORS = {
+        black: [0, 8],   # Standard and bright black
+        red: [1, 9],   # Standard and bright red
+        green: [2, 10],  # Standard and bright green
+        yellow: [3, 11],  # Standard and bright yellow
+        blue: [4, 12],  # Standard and bright blue
+        magenta: [5, 13],  # Standard and bright magenta
+        cyan: [6, 14],  # Standard and bright cyan
+        white: [7, 15]  # Standard and bright white
+      }.freeze
+
+      # Human-readable mapping for colors
+      COLOR_MAP = BASE_COLORS.keys.map(&:to_s).sort
+
+      # Helper for composite colors (yellow, cyan, magenta)
+      COMPOSITE_COLORS = {
+        yellow: ->(r, g, b) { r == g && r > b },
+        cyan: ->(r, g, b) { g == b && g > r },
+        magenta: ->(r, g, b) { r == b && r > g }
+      }.freeze
+
+      # Public: Find all shades for a base or composite color in the color cube.
+      # Returns an array of color indexes that represent different intensities
+      # of the requested color within the 216-color cube (indexes 16-231).
+      #
+      # Examples
+      #
+      #   Colors.color_cube_shades(:red)
+      #   # => [196, 197, 198, 199, 200, 201]
+      #
+      #   Colors.color_cube_shades(:yellow)
+      #   # => [226, 227, 228, 229, 230]
+      #
+      # base_color - A Symbol or String representing the color to find shades for.
+      #             Must be one of: red, green, blue, yellow, cyan, or magenta.
+      #
+      # Returns an Array of Integers representing color indexes in the color cube.
+      def self.color_cube_shades(base_color)
+        base_color = base_color.to_sym
+        color_index = {red: 0, green: 1, blue: 2}[base_color]
+
+        if color_index
+          # Handle primary colors (red, green, blue)
+          COLOR_CUBE.select do |color|
+            r, g, b = color_cube_rgb(color)
+            [r, g, b].each_with_index.max[1] == color_index
+          end
+        elsif COMPOSITE_COLORS[base_color]
+          # Handle composite colors (yellow, cyan, magenta)
+          COLOR_CUBE.select do |color|
+            r, g, b = color_cube_rgb(color)
+            COMPOSITE_COLORS[base_color].call(r, g, b)
+          end
+        else
+          [] # Return empty array for unrecognized colors
+        end
+      end
+
+      # Public: Decompose a color cube index into its RGB components.
+      # Converts a color index (16-231) into RGB values on a scale of 0-5.
+      #
+      # Examples
+      #
+      #   Colors.color_cube_rgb(16)
+      #   # => [0, 0, 0]
+      #
+      #   Colors.color_cube_rgb(231)
+      #   # => [5, 5, 5]
+      #
+      # color - Integer representing the color index in the color cube (16-231)
+      #
+      # Returns an Array of three Integers representing RGB values (0-5)
+      def self.color_cube_rgb(color)
+        red_intensity = (color - 16) / 36
+        green_intensity = ((color - 16) % 36) / 6
+        blue_intensity = (color - 16) % 6
+        [red_intensity, green_intensity, blue_intensity]
+      end
+
+      # Public: Get all available shades for a given color.
+      # Combines both the base color values (standard + bright)
+      # and any matching shades from the color cube.
+      #
+      # Examples
+      #
+      #   Colors.shades_for(:red)
+      #   # => [1, 9, 196, 197, 198, 199, 200, 201]
+      #
+      #   Colors.shades_for(:white)
+      #   # => [7, 15]
+      #
+      # color_name - A Symbol or String representing the color
+      #
+      # Returns an Array of Integers representing color indexes
+      def self.shades_for(color_name)
+        (BASE_COLORS[color_name.to_sym] || []) + color_cube_shades(color_name)
+      end
+
+      # Public: Initialize all possible color pairs for use with Curses.
+      # Sets up 256 color pairs, each with a unique foreground color
+      # and black background.
+      #
+      # Examples
+      #
+      #   Colors.setup_colors
+      #   # => Sets up color pairs 1-256
+      #
+      # Returns nothing.
+      def self.setup_colors
+        Curses.start_color
+        (0..255).each do |color|
+          Curses.init_pair(color + 1, color, Curses::COLOR_BLACK)
+        end
+      end
+
+      # Public: Get a comma-separated list of all available base colors.
+      #
+      # Examples
+      #
+      #   Colors.available_colors
+      #   # => "black, blue, cyan, green, magenta, red, white, yellow"
+      #
+      # Returns a String of color names separated by commas
+      def self.available_colors
+        COLOR_MAP.join(", ")
+      end
+    end
+  end
+end

data/lib/hawktui/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Hawktui
+  VERSION = "0.1.0"
+end

data/lib/hawktui.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative "hawktui/version"
+
+module Hawktui
+  class Error < StandardError; end
+
+  # Your code goes here...
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: hawktui
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jonathan Hoyt
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: curses
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.7
+description: Use this gem to build TUIs in Ruby.
+email:
+- jonmagic@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".standard.yml"
+- LICENSE
+- README.md
+- Rakefile
+- hawktui.jpeg
+- hawktui.txt
+- lib/hawktui.rb
+- lib/hawktui/streaming_table.rb
+- lib/hawktui/streaming_table/cell.rb
+- lib/hawktui/streaming_table/column.rb
+- lib/hawktui/streaming_table/layout.rb
+- lib/hawktui/utils/colors.rb
+- lib/hawktui/version.rb
+homepage: https://github.com/jonmagic/hawktui
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/jonmagic/hawktui
+  changelog_uri: https://github.com/jonmagic/hawktui/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: HawkTui is a simple and easy to use TUI (Terminal User Interface) library
+  for Ruby.
+test_files: []