feat: Added auto, always, never modifiers to --hyperlink argument (V2)

[nikelborm]

This is an ideological continuation of @mrnossiom's work in #746 (as I've learned already after I started coding the current PR myself) with added shell completions that don't have merge conflicts with the main branch.

Description

Add a WHEN modifier to the --hyperlink argument. This matches the ls behavior and the --color argument behavior.

I think ls is doing it right because you might want to enable --hyperlink in a shell alias but still get plain text when piping into some other program without control chars in the way. Setting --hyperlink in a shell alias is useful for terminal integration (e.g. Kitty).

The public API is compatible since --hyperlink defaults to auto and doesn't break. However, it changes the behavior, with no value the option worked like always but now defaults to auto. Even though I consider auto the right default, maybe it could be changed to always to keep the old behavior.

[mrnossiom]

I can merge shell completions updates into my branch, but I don't see how this PR resolves what was blocking on mine.

[nikelborm]

I can merge shell completions updates into my branch, but I don't see how this PR resolves what was blocking on mine.

When I started doing it, I started doing it myself following already established patterns in the current project. But I started doing it on top of the latest main branch. Then I found your PR that looked similar and merged what i done with what you did and mentioned you in the commits where our changes looked similar. I didn't really tested what kind of conflicts exist on your branch, I just looked on github's banner

And since I built this PR on top of latest commit in main branch it doesn't yet have any conflicts.

[mrnossiom]

For conflicts, you have rebasing. But that's not blocking. The issue we had was that hyperlink OSCs were not taken into account when calculating width and that end up messing with the --grid/G flag.

I just rebased and force-pushed on my end. Works fine apparently.

[gierens]

Code and functionality on my system looks good ... Gotta check this failing BSD test and conflict with main, though.

[gierens]

Ok, I rebased main into this branch and resolved the conflicts.

[gierens]

I rebased main again which added a fix for the FreeBSD CI, should run through now ... also ran a short benchmark, doesn't appear to introduce any performance penalty, so again LGTM, thanks.

The merge-base changed after approval.