comments

support default colors in non-`TB_OUTPUT_NORMAL` modes (#41)

`TB_DEFAULT` is now defined as a bitwise attribute similar to
`TB_BOLD`. previously it was defined as 0 which made it impossible to
use default colors in non-`TB_OUTPUT_NORMAL` modes.

for convenience and limited back-compat, 0 is still interpreted as
`TB_DEFAULT` in `TB_OUTPUT_NORMAL`, `TB_OUTPUT_216`, and
`TB_OUTPUT_GRAYSCALE`, though `TB_DEFAULT` may be used as well.

in `TB_OUTPUT_256` and `TB_OUTPUT_TRUECOLOR`, 0 is black, so
`TB_DEFAULT` and `TB_TRUECOLOR_DEFAULT` respectively must be used if
a default color is desired.

add tb_version

prevent compile-time option mismatch when used as library

add soname and install rules

add examples in other languages

add .gitignore

factor out ffi creation

add TODO about resize errors

document optimistic nature of tb_set_output_mode (#37)

make resize immediate

add demo image

switch back to select() as poll() is broken on implementations like mac OS

convert test_mod from xvkdb- to memfd-based test (was flaky)

Run tests for non-truecolor and non-egc builds.

This patch introduces a few new things:

* Build artifact termbox.ffi.h for easier FFI header file parsing. As a result, no more `__ffi_strip` bs, but probably more complex overall. The other idea I had would have been uglier. I think the test coverage is worth it.

* Functions `tb_has_truecolor` and `tb_has_egc` for determining support for those features at runtime.

* Test container uses `debian:11-slim` image instead of `debian:10-slim`.

* Test container uses PHP 8 instead of PHP 7.

* Test container now accepts `cflags` build argument.

* Tests can now be skipped via `$test->skip()`.

* Test suite covers 3 different builds: normal, non-truecolor, non-egc.

add a few missing if_err_return and fmt

fix non-truecolor (#26)

add `TB_BLINK` and `TB_TRUECOLOR_*` attributes (#16)

update docs concerning style attributes (#24)

in particular, document the hidden feature of applying `TB_BOLD` as a
background attribute, which emits `TB_CAP_BLINK`.

Clarify what 0x08-0x0f in TB_OUTPUT_256 means, a bit

update docs for TB_INPUT_MOUSE (#20)

[0..216] -> [0..215]

update readme with examples (#19)

add build rule for static lib

define required feature test macros

Actually fix non-truecolor build

fix build without truecolor

save errno in resize handler, deinit signal handler in tb_shutdown()

prevent emitting attrs in true-color mode

fix some warnings

fmt termbox.h

add mouse support

add test for f715214

fix `#define` regex in tests

include tb_init_rwfd in api

fix bug in `extract_esc_cap`.

previously we were able to read past the actual end of the
input buffer (`global.in.buf`). we would not segfault due
to how bytebufs are implemented, but we could erroneously
re-process segments of input. in practice i think this
could only occur with an instantaneous burst of tty input
greater than the read buffer in `wait_event` (64 bytes). i
noticed this by accidentally mouse-wheeling very fast in
xfce4-terminal which, in my setup, sends a bunch of
up-arrow events (`\x1bOA`) all at once, in which case
termbox was pseduo-randomly emitting "O" and "A" events.

add test for tb_strerror

recompile in container before running tests

add tb_strerror (#11)

use github actions for ci

add and apply `.clang-format`

expose internal fds for external polling

update inline docs (#4).

specifically document return code TB_ERR_SELECT on
tb_peek/poll_event.

add regression test for #3

prevent segfault in `tb_deinit` when TERM is invalid

add test case for `tb_printf_ex`

add `tb_print_ex` and `tb_printf_ex`.

these functions have an optional `out_w` param that
receives the printed width of the string if specified.

add readme

replace linear cap search with trie.

for every input, termbox used to iterate over termcaps one
at a time, `strncmp`ing it to the input buffer. the benefit
of this approach was that it had a very simple
implementation. the downside was that it was inefficient,
increasingly so as we added more caps such as modified
arrow keys.

the trie makes it easy to detect when there are overlaps in
termcaps. the obvious one is `TB_KEY_ESC` versus all other
escape codes. in the future we can modify function
`extract_esc_cap` to, e.g., potentially return `TB_KEY_ESC`
in `TB_INPUT_ALT` mode if no further input is available
after a certain amount of time.

add license header

add cap kcbt (TB_KEY_BACK_TAB)

termbox rewrite (wip)