fix terminfo header memory check

fix alignment warnings

some architectures don't support reading an `int16_t` on an odd
memory. so several `int16_t` explicit casts while parsing terminfo
caps emit warnings. change these to `memcpy` to fix.

replace `header[n]` with variable names in `parse_terminfo_caps`.

update copyright year

comments and fmt

fix bug in `TB_OPT_LIBC_WCHAR`

found by running tests with that option flagged on:

```
$ CFLAGS='-UTB_LIB_OPTS -DTB_OPT_LIBC_WCHAR -DTB_OPT_ATTR_W=64 -DTB_OPT_EGC' make test
```

add built-in replacements for `iswprint(3)` and `wcwidth(3)`

in b075ddd, we added an `iswprint` check to prevent untrusted input
from garbling the terminal. `iswprint` is locale-dependent, so if the
caller did not `setlocale` to a UTF-8 `LC_CTYPE`, the check would
fail. this affected several library users.

termbox has always had built-in support for converting between UTF-8
and 32-bit codepoints (i.e., replacements for `wcrtomb(3)` and
`mbrtowc(3)`). this patch adds built-in support for `iswprint` and
`wcwidth` as well, which makes the entire library Unicode compatible
independent of locale.

a compile-time option to use the libc versions is supported.

c++ compilation error with TB_OPT_EGC defined

bump version

bump test env from debian 12 to debian 13

debian 13 comes with a newer version of xterm which has some changes
in `print-immediate`. this requires us to update test fixtures. the
changes are:

          test_64bit: invisible was previously emitted as spaces.
                      now emitted with escape codes.

     test_color_true: 0x808080 was previously emitted as
                      128:128:120. now emitted as 128:128:128.

            test_egc: fullwidth char with combining characters was
                      previously emitted with U+FFFF (invalid) in the
                      2nd cell, now emitted without.

   test_invalid_utf8: U+FFFD (replacement char) is now emitted as
                      a hash char ("#").

  test_non_printable: ditto

          test_print: ditto

also bump php from 8.3 to 8.4.

fix egc memory error

this was copying too many bytes to the dest cell (8-bytes for a
pointer vs 4-bytes for a uint32_t).

fix egc memory error

ensure space allocated for null-terminator

fix bug with adding combining chars to a full-width char

the logic was incorrectly sending the combinin char to x-1, but that
assumed a wcwidth==1 char. save last printed x coord and use that
instead.

xterm's ansi output for this is a little strange. unlike other
`expected.ansi` files, cat-ing this one to stdout doesn't seem to
render the correct output, and if you peek at its contents you'll see
some "\xef\xbf\xbf" (U+FFFF) which is an invalid codepoint. in any
case, it still picks up the regression so i'm adding it.

Added odin language bindings repo

Fix errors and warnings when compiling with c++.

`setlocale` in demo

since around cd42ba3, we rely on `iswprint`, which itself is
locale-dependent. callers using unicode (like the demo) must be sure
to set a unicode locale prior to initializing.

Add `xtxf` example

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