# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later

# SYNOPSIS
#   __fish_palette
#
# DESCRIPTION
#   Defines the shared terminal-output colour roles used by the
#   user-facing functions in this configuration. Declared
#   --no-scope-shadowing and using a bare `set`, so the variables are
#   created in the CALLER's scope -- a consumer just calls it and then
#   interpolates $c_head, $c_err and friends exactly as it did when the
#   declarations were inline.
#
#   Call it where the local declarations used to sit, once per contiguous
#   block that needs the palette. set_color runs at call time, so the
#   values track $TERM exactly as inline declarations did. (Measured:
#   set_color output is identical across every TERM tested except
#   TERM=dumb, which yields empty strings, and is unaffected by whether
#   stdout is a tty or a pipe.)
#
#   A role is a semantic slot, not a colour. c_flag and c_warn are both
#   yellow but stay separate, as do c_ok and c_accent (both green) --
#   merging either pair would foreclose ever restyling one without the
#   other. c_accent is the command name in logs and smart_exit, which
#   style it green where the rest of the config styles it bold.
#
# ARGUMENTS
#   none
#
# EXIT STATUS
#   0  always
#
# EXAMPLE
#   function mytool
#       __fish_palette
#       echo "$c_head""Usage:$c_reset $c_cmd""mytool$c_reset"
#   end
#
# NOTES
#   Calling this at top level (outside any function) creates GLOBAL
#   variables. Every consumer calls it from inside a function, where the
#   variables stay function-local and do not leak.
#
#   functions/fish_prompt.fish deliberately does NOT use this palette. Its
#   c_* values are Catppuccin hex strings passed as ARGUMENTS to set_color
#   (`set_color --bold $c_green`), not captured escape sequences -- colour
#   inputs rather than rendered output, a different concern.

function __fish_palette --no-scope-shadowing --description 'Define the shared output colour palette in the caller scope'
    set c_reset (set_color normal)
    set c_head (set_color --bold cyan)
    set c_cmd (set_color --bold)
    set c_arg (set_color cyan)
    set c_flag (set_color yellow)
    set c_warn (set_color yellow)
    set c_err (set_color red)
    set c_ok (set_color green)
    set c_accent (set_color green)
    set c_dim (set_color brblack)
    set c_sel (set_color --bold magenta)
    set c_hi (set_color --bold white)
end