Mention Node.js wrapper on README

I recently created termbox2 (termbox1 already exists but is
unmaintained) wrapper library for Node.js JavaScript engine
and thought it would be nice to mention about it in README.md in case
anyone else than me needs one.

normalize comments and `make terminfo format`

make `tb_print*` functions a little kinder

* handle newlines. previously they would mess up rendering.
* replace other non-printable codepoints with U+FFFD.
* skip over cells that would go out of bounds instead of erroring.

send non-printable codepoints as U+FFFD

add note about required feature test macros

for cells skipped due to double-width chars, set them to invalid
codepoints instead of null (0) which is a valid codepoint.

add deprecation notices

bump test env versions

Debian 11 -> Debian 12
PHP 8.0 -> 8.3

remove usage of __ prefix

Add const

in keyboard demo, retry poll on `EINTR`

SIGWINCH may interrupt the `select` call leading to `TB_ERR_POLL`
with `errno` of EINTR. retry in this case instead of exiting.

fix compiler warning

bump version

update docs

null-terminate output of `tb_utf8_unicode_to_char`

update copyright year

permit overriding docker in makefile (like with podman)

stop reading at null-terminator in `tb_utf8_char_to_unicode` (#63)

if this occurs in `tb_print_ex`, replace the invalid character with a U+FFFD.

fix compile warning in demo

```
In file included from demo/keyboard.c:5:
demo/keyboard.c: In function ‘draw_keyboard’:
demo/../termbox2.h:252:33: warning: unsigned conversion from ‘int’ to ‘uint16_t’ {aka ‘short unsigned int’} changes value from ‘16777222’ to ‘6’ [-Woverflow]
  252 | #define TB_MAGENTA              0x0006
      |                                 ^
demo/keyboard.c:512:22: note: in expansion of macro ‘TB_MAGENTA’
  512 |     printf_tb(33, 1, TB_MAGENTA | TB_BOLD, TB_DEFAULT, "Keyboard demo!");
```

README: add Chez Scheme's letloop to bindings list.

delete unnecessary if_not_init_return() check in tb_set_cell()

update readme

fix egc bug, clarify docs, add test

add nim example

update readme

update readme

parse test macros from `gcc -E -dM` output instead of the raw header

previously we had no way intelligently parsing out conditional
defines such as:

```c
```

we would parse out TB_XYZ twice and overwrite the first value. this
was breaking tests as we now, for example, have TB_BOLD defined
conditionally.

we are now parsing the output of `gcc -E -dM` instead which give us a
simple list of macro key-vals after the preprocessor has executed.

add support for more style attrs and 64-bit attrs (#56)

probably should have broken this into multiple commits but it was all
inter-related:

* deprecate TB_OPT_TRUECOLOR in favor of TB_OPT_ATTR_W which defaults
  to 16, but can be 32 (truecolor) or 64 (truecolor + additional
  styles). for back compat, TB_OPT_TRUECOLOR sets TB_OPT_ATTR_W to 32
  if not already set.

* add TB_BRIGHT, available in TB_OUTPUT_NORMAL only.

* add TB_DIM and TB_INVISIBLE. TB_INVISIBLE is available only when
  TB_OPT_ATTR_W=64.

* add TB_STRIKEOUT, TB_UNDERLINE_2, TB_OVERLINE, available only when
  TB_OPT_ATTR_W=64. these are hard-coded caps because they don't
  appear to be in terminfo.

* deprecate TB_256_BLACK and TB_TRUECOLOR_BLACK in favor of
  TB_HI_BLACK which can be used in any of the hi-color modes.

* deprecate all TB_TRUECOLOR_* style attributes. users can use
  TB_BOLD, TB_UNDERLINE, etc in truecolor mode now.

* add tests for new features.

* document compile-time options.

ignore cap collisions

many terms have duplicate escape codes even for our modest subset of
caps. see inline comment for an example as well as a todo.

interpret oob terminfo strings as absent caps

if either the string offset or string value is beyond the entry
bounds, interpret this as an absent cap. several terms seem to do
this.

this behavior is still slightly stricter than ncurses which ignores
corrupt or truncated terminfo entries. we still error in that case.

skip empty caps (#57)

this slipped under the radar because none of the built-in terms have
more than one empty key cap, or an empty string for one of the caps
we use in init/shutdown.

some terms do of course have multiple empty caps. for example,
`xterm-color` is missing `khome`, `kend`, and `kcbt` (back-tab),
which leads to adding `""` more than once, which leads to a
`TB_ERR_CAP_COLLISION` error on init. other terms don't have caps for
hiding and showing the cursor, for example.

to avoid these errors, we avoid adding empty caps to the trie, and
similarly avoid emitting empty caps.

it's kind of hard to add a functional test for this as it gets into
testing multiple term envs and terminal emulators which is a bit of a
pandora's box. as an alternative, i'm going to do some more manual
testing on various terms on my system.

update readme

update readme

permit single-line-if in clang-format

avoid setting `PATH_MAX` (use `TB_PATH_MAX`) h/t @rofl0r

define `PATH_MAX` if undefined

some architectures apparently don't define it. e.g.:

https://buildd.debian.org/status/fetch.php?pkg=mle&arch=hurd-i386&ver=1.5.0-1&stamp=1654066958&raw=0

add: a demo in rust

add clang-format makefile rule

add example in dlang

invalidate last_(fg|bg) after mode switch

last_(fg|bg) are no longer valid after a mode switch. see the test
for an example of the bug in action.

make test_basic version agnostic

add `tb_invalidate`

restore `TB_DEFAULT==0` in all modes (#51)

this removes `TB_TRUECOLOR_DEFAULT` added in 846bba4b and goes back to
`TB_DEFAULT==0` in all modes. instead, hi-bit macros `TB_256_BLACK`
and `TB_TRUECOLOR_BLACK` are added which provide a way to emit black
in those modes.

turns out there were some subtle bugs associated with `TB_DEFAULT!=0`
(in addition to the bug identified in #51). the bugs were fixable but
required uglying up some code. zero as default in all modes is more
intuitive and easier to reason about (e.g., `memset(..., 0, ...)`).

update copyright date

termbox -> termbox2 (#53)

add example `lavat` (#47)

fix the no-cap case of `get_terminfo_string`

a negative string offset indicates the corresponding cap is
not supported on that terminal. return an empty string in
this case. previously we'd return garbage.

for a test case, observe what happens when fetching `smcup`
on `TERM=linux`.

Fixed narrowing conversions, cast some values where deemed safe

Added (void) to functions taking no args

strerror -> strerror_r (#43)

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