This adds support for no-TTY, such as a CI environment, or via `ssh -T ...` to `choose`.

However, this rewrites `read-key` to support such, and there needs further work as it still sends multiple characters in a single line under certain circumstances.

However, `read-key` now does support no-TTY situations, such as pipes, or bash v3 character mashing.

The complexity with this, is that there is no way native to just read one key at a time, and escape sequences can take multiple characters, as such the approach taken is to trim known escape sequences and then split the remaining. This is fine, however it means read-key now only supports known characters, and as such is more adequate to be considered a read-keyboard-key or so, as special escape sequences will require a lot of complexity to support, as they will need say our regex handling in `echo-wrap.awk` to be trimmed.

This all means that `read-key` should be changed instead of reading one key at a time, now in an aggregate, it should just read everything and then shift the keys off.

- `read-key` and `confirm` have been rewritten

- `bash.bash`: add `__command_(missing|exists)`, `__try_sudo`, `__is_brew`, `__mkdirp`, `__sudo_mkdirp`, and `__can_read_decimal_timeout`
- `(command-(exists|missing)|is-brew)`: use the `bash.bash` functions
- `(command-(exists|missing|working)|is-brew)`: add tests
- `debug-network:` fix bad maintenance over the years
- `dorothy`:
    - move common helpers into `bash.bash`, and improve them
    - source the `bash.bash` that is appropriately local or remote
- `(echo-(html|url)-coder|fs-dequarantine|get-desktop-theme|setup-util-(1password-cli|apple-(cli-tools|rosetta)|yt-dlp))`: fix functional incorrect function names
- `expand-path-zsh` renamed to `expand-path.zsh` to follow modern conventions
- `get-font`: improve performance
- `is-tty`: remove unneeded `echo`s for modern conventions in tests
- `setup-util`: conjoined a few redundant calls
- `echo-mkdirp`: moved to beta commands as it is no longer used internally

…remote-name

also remove update technique for legacy dorothy installations

/ref c7f31b1 - `option_commands` leftover in `bash.bash` helpers
/ref b60ef24 - use new `is_remote` var that is accurate

/ref c7f31b1

/ref b60ef24

rewrite `is-needle` to use this new `has_needles` helper and add tests

git-helper:
- add verify step
- improve the way remotes are gathered
- fix path not sent to review
- support update on repos that don't have origin, and restore remote prompt on repos with multiple remotes

/ref b60ef24
/ref https://github.com/bevry/dorothy/actions/runs/11267661909/job/31333162360#step:3:1812
/ref https://github.com/bevry/dorothy/actions/runs/11115550380/job/30884206594#step:3:1873
/ref https://github.com/bevry/dorothy/actions/runs/11277567607/job/31364020536#step:3:1873
/ref https://github.com/bevry/dorothy/actions/runs/11286493561/job/31390927875#step:3:2128
/ref https://github.com/bevry/dorothy/actions/runs/11286573839/job/31391154425#step:3:1896
/ref https://github.com/bevry/dorothy/actions/runs/11286652092/job/31391365190#step:3:2141
/ref https://github.com/bevry/dorothy/actions/runs/11287510416/job/31393567790#step:3:1797
/ref https://github.com/bevry/dorothy/actions/runs/11287614318/job/31393844817#step:3:1798
/ref https://github.com/bevry/dorothy/actions/runs/11287762099/job/31394250547#step:3:1861

/ref 64c9cf6

todos:
- `ask` no-tty support
- documentation of fixes, new features, changes, deprecations

https://github.com/bevry/dorothy/actions/runs/11323459946/job/31486170602#step:4:11

/ref https://github.com/bevry/dorothy/actions/runs/11337745165/job/31529845513#step:4:36

…d react accordingly

/ref https://github.com/bevry/dorothy/actions/runs/11337845512/job/31530095505#step:4:56

/ref https://github.com/bevry/dorothy/actions/runs/11338434503/job/31531633175#step:4:58

styles.bash: add some escaped styles, such as `newline`

echo-style: support '--=...', '--=', '--' arguments

change `echo` to `__print_lines`

compress multiple `echo-style` calls into one

fix broken `code_notice` style and replace to `code-notice1`

implement new styles where appropriate, however this is not comprehensive at all

use `echo-style --tty` instead of `echo-style >/dev/tty` as the former can support when `/dev/tty` doesn't exist

/ref https://github.com/bevry/dorothy/actions/runs/11340094950/job/31535923344#step:4:71

choose:
- don't crash on unknown keys, instead flash bell
- improve performance of legend rendering
- don't hide/show cursor on environments that don't support it

read-key:
- don't output unknown keys by default
- support `shift+(left|right)` on macos
- fix tests for `is-tty` deprecation

get-terminal-color-support:
- if ci that isn't github, continue to fail, however if dumb terminal and not ci, continue to fallback
    - this enables fallback on `ssh -T ...`, which does support colors

get-terminal-quiet-support:
- adapt for the `get-terminal-color-support` convention, however keep same functionality, this could be a mistake - will need to evaluate

get-terminal-title-support:
- vscode doesn't support titles, so fail on vscode

video-merge:
- use `is-headful` which is appropriate, instead of the deprecated `is-tty`

styles.bash:
- use support vars at the begining for clarity and performance

oz:
- cleanup a little bit, now that docs are elsewhere

todos:
- check if `--quiet=''` causes crashes

/ref https://github.com/bevry/dorothy/actions/runs/11345441621/job/31552330617#step:3:2984

/ref https://github.com/bevry/dorothy/actions/runs/11357972748/job/31591723554#step:3:785

/ref 5405c39
/ref 5def66e

/ref https://github.com/bevry/dorothy/actions/runs/11358242517/job/31592464176#step:2:3754

/ref https://github.com/bevry/dorothy/actions/runs/11358441972/job/31592966478#step:2:2805

re-add some WIP deleted commands to `commands.deprecated` and move some longstanding deprecated commands into it, also remove duplicate `is-match` from 7ee7f6c

deprecate `echo-clear-line`

until-success: things that should be output to the terminal device file are now outputted there

move ansi escape code documentation from various commands into a new `ansi-escape-codes.md` documentation file

update the outdated `prompts.md` documentation file

second part of 4ee1fa4 to maintain renames

also revert broken WIP echo-clear-lines argument usage, with correct `< <(...)` usage

- brew-installed: support --quiet argument, return exit status 46 if brew is not installed
- echo-quote: support --double and --single arguments
- echo-revolving-door: remove some outdated implementation comments
- fs-rm: note when trash is not available
- setup-util:
    - output to /dev/tty if supported and appropriate
    - if uninstalling/upgrading the currently executing bash, output a warning
    - redo the clearing functionality to implement modern conventions and support a wide range of edge cases, such as when installer outputs more than LINES, or when clear is not available, or when the installer needs interaction
    - don't remove non-xdg-bins when upgrading as that causes issues with homebrew if the homebrew-intalled bin was removed but homebrew still thinks it is installed
- setup-util-bash: detections and workarounds if trying to uninstall/upgrade the currently executing bash
- add an `echo-revolving-screen` command that unfortunately doesn't work properly and I don't know why
- styles.bash: change clear screen to use `\e[J` instead of `\e[2J` for reasoning documented inside the file

/close #253

- shellcheckrc: add `SC2059`, and add docs on all the disabled rules
- ask: rewrote for modern conventions, support no-TTY, fix read failures not being output
- ask/choose/confirm: consistent commentary styling
- choose: fix blockquote line being a different color or breaking colors
- confirm: fix and improve the WIP no-TTY support, now complete
- dorothy: prompt for lint upgrade before dev deps, to speed up UX
- echo-clear-lines: rewrote to support all known edge cases
- echo-count-lines: add note that it doesn't wrap
- echo-escape-command: use new `__quote` helped in `bash.bash` to support ANSI Escape Codes
- echo-quote: add tests, add support for `--single` and `--double` arguments
- echo-regexp(.ts)?: better support for character classes, supporting `[[:XXX:]]` and `[:XXX:]` forms
- echo-revolving-door: rewrote to support all known edge cases
- added `echo-substr`: as command alias for `__substr` helper in `bash.bash`
- echo-wrap: fix help errors not showing, support --column=* alias for --width=*
- eval-helper: updated for TTY changes, aand fix all known edge cases
- expand-path.zsh: same functionality, but rewrote for clarity
- setup-util: linting, and only output the output if there is output
- setup-util-bash: compact `echo-style` calls for performance, include `setup-util --check` for performance
- until-success: rewrote for new TTY conventions
- echo-escape-special: fix everything being dumped together
- is-shapeshifter: rewrote and add tests, to fix all known edge cases, and now uses `bash.bash` helpers
- bash.bash:
    - remove deprecated usage of `__print_line ...` use `__print_lines ...` instead
    - support initial `--` argument in appropriate functions
    - rewrite to use [[ ... ]] instead of test/[ to better handle edge cases
- stdinargs.bash:
    - rewrite to use [[ ... ]] instead of test/[ to better handle edge cases, such as a trailing line containing only `>`
- zsh.zsh:
    - consistency with `bash.bash` changes
    - rewrote and fixed `__substr` helper for edge cases
    - added `is_shapeshifter` and `__escape_shapeshifting` helpers, used in `is-shapeshifter`
- ansi-escape-codes.md: removed excess docs

todos:

- decide if ask/choose/confirm linger should be outputted to stderr if there is commentary and a sucess code but no linger, check if consistent with choose
- setup-util: consider new wrapper for the font selection too

…ing issue when testing

get-terminal-position-support: fix crash when stdin not accessible

get-terminal-tty-support: expand debug information to look for ways to ensure ask is only clearing input if it needed to

is-interactive: simplify conditional logic

read-key, is-shapeshifter: add (ctrl|alt)+(left|right) macos keys

dorothy, dorothy-warnings: only output warnings by default if there are new warnings

- add `debug-terminal-(stdin|tty)`
- simplify `get-terminal-*-support` checks
- `IFS=''` to `IFS=` as they are equivalent
- get-terminal-theme: add `--ignore-cache` option
- echo-file: correctly handle bat theme in cases where theme could not be detected, such as inside `ssh -T`

ask:
- if non-reactive, use alternative screen buffer
- add `--no-inline` option to force usage of alternative screen buffer if supported/reactive
- this solves the impossibility of clearing the accurate amount of lines in no-TTY mode, as `ssh -T` and pipe/redirect/CI result in different line counts due to `ssh -T` outputting the enter key as a visual new line

dorothy, setup-util-bash, setup-util-gh: use new `get-terminal-reactivity-support` command, and deprecate `is-interactive`

add a `terminals-and-tty.md` document with the learnings and reasoning

dorothy-warnings: prevent clearing of warnings causing warnings to be shown

/ref https://github.com/bevry/dorothy/actions/runs/11512899768

also fix `echo-regexp` including `stdinargs.bash` when it didn't need to

…revent edge case failures when the needle looks like an option