4.0 released

.gitignore

@@ -0,0 +1,15 @@
+# User-specific configuration — never commit personal settings.
+# Copy doc/profile.conf.example to profile.conf and customise it.
+profile.conf
+
+# Compiled / generated artefacts
+*.pyc
+__pycache__/
+
+# macOS noise
+.DS_Store
+
+# Editor swap / backup files
+*~
+*.swp
+*.swo

LICENSE

@@ -1,4 +1,4 @@
-Copyright 2013-2022 Geoffray Levasseur <fatalerrors@geoffray-levasseur.org>
+Copyright 2013-2026 Geoffray Levasseur <fatalerrors@geoffray-levasseur.org>
 
 This is distributed with BSD-3-Clause license with the following terms and
 condition:

README.md

@@ -68,7 +68,8 @@ A bar-style prompt showing current time, execution time of the last command
 | `mcd` | filefct | Create a directory and immediately move into it |
 | `meteo` | info | Display weather forecast for the configured or given city |
 | `myextip` | net | Get information about your public IP address |
-| `pkgs` | packages | Search for a pattern in installed package names (dpkg/rpm, supports `-i`) |
+| `get_pkgmgr` | packages | Detect the active package manager of the running distribution (`apt`, `dnf`, `yum`, `zypper`, `pacman`, `apk`, `portage`, `xbps`, `nix`) |
+| `pkgs` | packages | Search for a pattern in installed package names (distro-aware via `get_pkgmgr`, supports `-i`) |
 | `ppg` | processes | Look for the given pattern in running processes |
 | `ppn` | processes | List processes matching an exact command name |
 | `ppu` | processes | List processes owned by a specific user |
@@ -204,7 +205,7 @@ change the default without having to pass flags every time.
 
 ### 4.3. Locale shortcuts
 
-The `[general]` key `SET_LOCALE` accepts a comma-separated list of
+The `[lang]` key `SET_LOCALE` accepts a comma-separated list of
 `alias:locale` pairs. Each pair generates a function of that name at startup:
 
 ```ini
@@ -214,6 +215,16 @@ SET_LOCALE = fr:fr_FR.UTF-8, us:en_US.UTF-8
 This creates `setfr` and `setus`. Use `setlocale <locale>` to switch to any
 installed locale directly.
 
+Set `DEFAULT_LANG` to one of the defined aliases to activate that locale
+automatically at login:
+
+```ini
+DEFAULT_LANG = fr
+```
+
+If `DEFAULT_LANG` is set but does not match any alias in `SET_LOCALE`, a
+warning is displayed and no locale change is applied.
+
 ### 4.4. Prompt theming
 
 The prompt appearance is controlled by two mechanisms that are applied in order

doc/CHANGELOG.md

@@ -1,71 +1,97 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-Versions follow `MAJOR.MINOR.PATCH-REVISION_STAGE_N` (e.g. `3.99.1-4_rc_1`).
-
----
-
-## [3.99.1-4_rc_1] — 2026
-
-### Added
-- **Theming system** — `load_theme` in `profile.d/prompt.sh` loads `.theme`
-  files from `profile.d/themes/` (or a custom directory set via
-  `PROMPT_THEME_DIR`). Theme files are **parsed, not executed** — no shell code
-  ever runs from a theme.
-- **Built-in themes** — `default`, `dark`, `light`, `solarized` (24-bit
-  true-colour), `solarized-light` (24-bit), `monokai`, `monochrome`, `abyss`,
-  `plasma`, `adwaita`.
-- **`[prompt]` section** — `PROMPT_THEME` and `PROMPT_THEME_DIR` keys to select
-  a theme; eleven `PROMPT_COLOR_*` keys for per-key overrides in `profile.conf`.
-- **Standard colour variables as theme keys** — theme files may also override
-  the `disp.sh` colour variables (`Black`, `Blue`, `On_IBlack`, …) to remap the
-  terminal palette used by `ls`, `grep`, and colour-aware tools.
-- **Module configuration defaults** — all modules now expose their hardcoded
-  defaults as `profile.conf` keys: `TAZ_*`, `UTAZ_*`, `EXPANDLIST_*`,
-  `CLEAN_*`, `RMSPC_*`, `FINDBIG_*`, `RAIN_*`, `MATRIX_*`, `SSH_DEFAULT_OPT`,
-  `GENPWD_*`, `PWDSCORE_*`, `BUSY_*`, `METEO_DEFAULT_CITY`, `DWL_*`,
-  `MYEXTIP_*`, `PKGS_*`, `PPU_*`, `KU_*`, `UPDT_DEFAULT_BRANCH`.
-- **`UPDT_DEFAULT_BRANCH`** — configures the git branch used by `check_updates`
-  and `profile_upgrade`. Changing the key causes `profile_upgrade` to
-  automatically switch the local checkout to the new branch and display a
-  warning.
-- **`doc/` directory** — `CONTRIBUTING.md`, `FAQ.md`, `profile.conf.example`
-  (annotated template), `todo.md`.
-- **`.gitignore`** — `profile.conf` is now git-ignored so personal settings are
-  never accidentally staged.
-
-### Changed
-- README §2 now explains how to create `profile.conf` from
-  `doc/profile.conf.example` (new section 2.1 "Initial configuration").
-- README §4 updated with full module-defaults tables, theming reference, and a
-  note about `profile.conf` being git-ignored.
-- Theme values no longer carry the `export` keyword (they are not shell
-  variables, only data).
-
-### Security
-- `load_theme` uses a strict allowlist (no `eval`, no sourcing). Only
-  `PROMPT_COLOR_*` keys and known `disp.sh` colour variable names are accepted.
-  Values must match `\$[A-Za-z_][A-Za-z0-9_]*` or `\\e\[[0-9;]*m`; any other
-  value is discarded with a warning.
-
----
-
----
-
-> **Note:** Versions prior to `3.95.x-4_beta` did not maintain a formal
-> changelog. The full history of earlier changes is available through the git
-> log (`git log --oneline`).
-
-## [3.95.3-4_beta_3] — 2024
-
-### Added
-- Initial public release candidate series.
-- Core modules: `compress`, `disp`, `filefct`, `fun`, `help`, `info`, `lang`,
-  `net`, `packages`, `processes`, `prompt`, `pwd`, `rain`, `ssh`, `updates`.
-- Bar-style prompt with time, command duration, and exit code.
-- `taz` / `utaz` archive helpers.
-- `genpwd` / `pwdscore` password tools.
-- `matrix` / `rain` screensavers.
-- `profile_upgrade` with git and archive download support.
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versions follow `MAJOR.MINOR.PATCH-REVISION_STAGE_N` (e.g. `3.99.1-4_rc_1`).
+
+---
+
+## [3.99.2-4_rc_2] — 2026-04-21
+
+### Fixed
+- **`prompt.sh`** — `\$Last_Command` in PS1 was escaped, preventing the exit
+  code from ever appearing in the prompt (the local variable no longer exists
+  when PS1 is rendered by bash). Removed the backslash so the value is embedded
+  at `set_prompt` build time.
+- **`filefct.sh` — `file_stats()`** — a stray unconditional `shift` after
+  `esac` doubled-shifted arguments already shifted by each `case` branch;
+  successive options such as `-H -d` were silently skipped.
+- **`packages.sh` — `pkgs()`** — replaced the unreliable binary-presence test
+  (`command -v dpkg / rpm`) with the new `get_pkgmgr` function. Also corrected
+  a typo in the "no package manager" error message (`avialable` → `available`).
+- **`processes.sh` — `kt()`** — copy-paste error: usage error message read
+  `"Usage: ppg <string>"` instead of `"Usage: kt <pid>"`.
+
+### Added
+- **`packages.sh` — `get_pkgmgr()`** — new exported helper that detects the
+  active package manager of the running distribution. Detection first reads
+  `/etc/os-release` (`ID` then `ID_LIKE`), then falls back to a
+  fixed-priority binary scan. Supported families: `apt`, `dnf`, `yum`,
+  `zypper`, `pacman`, `apk`, `portage`, `xbps`, `nix`. Returns 1 when
+  nothing is identified. Available to all future commands in `packages.sh`.
+
+---
+
+## [3.99.1-4_rc_1] — 2026
+
+### Added
+- **Theming system** — `load_theme` in `profile.d/prompt.sh` loads `.theme`
+  files from `profile.d/themes/` (or a custom directory set via
+  `PROMPT_THEME_DIR`). Theme files are **parsed, not executed** — no shell code
+  ever runs from a theme.
+- **Built-in themes** — `default`, `dark`, `light`, `solarized` (24-bit
+  true-colour), `solarized-light` (24-bit), `monokai`, `monochrome`, `abyss`,
+  `plasma`, `adwaita`.
+- **`[prompt]` section** — `PROMPT_THEME` and `PROMPT_THEME_DIR` keys to select
+  a theme; eleven `PROMPT_COLOR_*` keys for per-key overrides in `profile.conf`.
+- **Standard colour variables as theme keys** — theme files may also override
+  the `disp.sh` colour variables (`Black`, `Blue`, `On_IBlack`, …) to remap the
+  terminal palette used by `ls`, `grep`, and colour-aware tools.
+- **Module configuration defaults** — all modules now expose their hardcoded
+  defaults as `profile.conf` keys: `TAZ_*`, `UTAZ_*`, `EXPANDLIST_*`,
+  `CLEAN_*`, `RMSPC_*`, `FINDBIG_*`, `RAIN_*`, `MATRIX_*`, `SSH_DEFAULT_OPT`,
+  `GENPWD_*`, `PWDSCORE_*`, `BUSY_*`, `METEO_DEFAULT_CITY`, `DWL_*`,
+  `MYEXTIP_*`, `PKGS_*`, `PPU_*`, `KU_*`, `UPDT_DEFAULT_BRANCH`.
+- **`UPDT_DEFAULT_BRANCH`** — configures the git branch used by `check_updates`
+  and `profile_upgrade`. Changing the key causes `profile_upgrade` to
+  automatically switch the local checkout to the new branch and display a
+  warning.
+- **`doc/` directory** — `CONTRIBUTING.md`, `FAQ.md`, `profile.conf.example`
+  (annotated template), `todo.md`.
+- **`.gitignore`** — `profile.conf` is now git-ignored so personal settings are
+  never accidentally staged.
+
+### Changed
+- README §2 now explains how to create `profile.conf` from
+  `doc/profile.conf.example` (new section 2.1 "Initial configuration").
+- README §4 updated with full module-defaults tables, theming reference, and a
+  note about `profile.conf` being git-ignored.
+- Theme values no longer carry the `export` keyword (they are not shell
+  variables, only data).
+
+### Security
+- `load_theme` uses a strict allowlist (no `eval`, no sourcing). Only
+  `PROMPT_COLOR_*` keys and known `disp.sh` colour variable names are accepted.
+  Values must match `\$[A-Za-z_][A-Za-z0-9_]*` or `\\e\[[0-9;]*m`; any other
+  value is discarded with a warning.
+
+---
+
+---
+
+> **Note:** Versions prior to `3.95.x-4_beta` did not maintain a formal
+> changelog. The full history of earlier changes is available through the git
+> log (`git log --oneline`).
+
+## [3.95.3-4_beta_3] — 2024
+
+### Added
+- Initial public release candidate series.
+- Core modules: `compress`, `disp`, `filefct`, `fun`, `help`, `info`, `lang`,
+  `net`, `packages`, `processes`, `prompt`, `pwd`, `rain`, `ssh`, `updates`.
+- Bar-style prompt with time, command duration, and exit code.
+- `taz` / `utaz` archive helpers.
+- `genpwd` / `pwdscore` password tools.
+- `matrix` / `rain` screensavers.
+- `profile_upgrade` with git and archive download support.

doc/CONTRIBUTING.md

@@ -1,171 +1,210 @@
-# Contributing to profile
-
-Thank you for your interest in contributing. This document explains how to get
-set up, what the conventions are, and how to submit work.
-
----
-
-## 1. Before you start
-
-- Check the [to-do list](./todo.md) to see if your idea is already planned.
-- Check the [issue tracker](https://git.geoffray-levasseur.org/fatalerrors/profile/issues)
-  to avoid duplicate work.
-- For significant changes, open an issue or contact the maintainer before
-  writing code — alignment on design saves everyone time.
-
----
-
-## 2. Getting the source
-
-A Git clone is mandatory for contributions:
-
-```bash
-git clone https://git.geoffray-levasseur.org/fatalerrors/profile.git
-cd profile
-```
-
-Always work from the **latest commit on `master`** (or the branch you intend
-to target). Stale forks cause avoidable merge conflicts.
-
----
-
-## 3. Development environment
-
-| Requirement | Minimum version | Notes |
-|---|---|---|
-| Bash | 4.3 | Namerefs (`local -n`) required |
-| shellcheck | any recent | Run before every commit |
-| git | any | For contributing patches |
-| bats-core | 1.x | Optional — for running the test suite |
-
-Install shellcheck:
-```bash
-# Debian / Ubuntu
-apt-get install shellcheck
-
-# Fedora / RHEL
-dnf install ShellCheck
-
-# macOS
-brew install shellcheck
-```
-
----
-
-## 4. Code style
-
-### General rules
-- **Bash only** — no external interpreters in core modules. Python or Perl is
-  acceptable for completely self-contained, optional utilities that have no
-  dependencies beyond a minimal Debian or CentOS installation.
-- **4-space indentation** — no tabs.
-- **`[[ … ]]`** for all conditionals — not `[ … ]`.
-- **`(( … ))`** for arithmetic — not `$(( … ))` in conditionals.
-- **`local`** for all function-internal variables — avoid polluting the
-  environment.
-- **`printf`** instead of `echo` wherever the format matters.
-- **Never `eval`** — use namerefs (`local -n`), `${!varname}` indirection, or
-  `declare -g` instead.
-- **No hardcoded defaults** — wire every configurable value through
-  `${VAR:-default}` and document the key in `profile.conf` and `README.md §4`.
-
-### Function conventions
-- Public functions **must** be exported: `export -f funcname`.
-- Every public function **must** support `-h` / `--help` and print usage to
-  stdout, returning 0.
-- Use `getopt` (not `getopts`) for option parsing — it handles long options and
-  `--` correctly.
-- Follow existing error-return conventions: 0 = success, 1 = usage error,
-  2 = bad options, 3 = missing dependency, 4+ = runtime failure.
-- Prefix all local helper variables with a short unique prefix (e.g. `_taz_`)
-  to prevent collisions with caller-scope variables.
-
-### Module structure
-Every new module should follow this pattern:
-
-```bash
-#!/usr/bin/env bash
-# <copyright block identical to existing modules>
-
-load_conf "<module_name>"
-
-# --- functions ---
-
-export -f my_function
-
-# EOF
-```
-
-Add the `load_conf` call near the top after any variable declarations.
-
----
-
-## 5. Configuration keys
-
-When adding a configurable default:
-
-1. Use `${MY_VAR:-hardcoded_default}` in the function body.
-2. Add a commented-out entry with a description to `profile.conf`.
-3. Document the key in the matching table in `README.md §4.2`.
-
----
-
-## 6. Theming
-
-New theme files go in `profile.d/themes/` with a `.theme` extension.
-They are **parsed, not executed** — do not add shell logic.  
-See the existing themes and `README.md §4.4` for the allowed syntax.
-
----
-
-## 7. Running shellcheck
-
-```bash
-shellcheck -x profile.sh profile.d/*.sh
-```
-
-All warnings must be resolved before a patch will be accepted. Accepted
-suppression directives (`# shellcheck disable=SCxxxx`) require an inline
-comment explaining why the suppression is necessary.
-
----
-
-## 8. Submitting a contribution
-
-### Via Git (preferred)
-1. Contact the maintainer to obtain push access, or fork on the Gitea instance.
-2. Create a branch: `git checkout -b feature/my-feature`.
-3. Commit with a clear subject line: `module: short description (≤ 72 chars)`.
-4. Push and open a pull request against `master`.
-
-### Via patch
-If you do not have push access:
-```bash
-git format-patch origin/master
-```
-Send the resulting `.patch` file(s) to
-`fatalerrors <at> geoffray-levasseur <dot> org`.
-
-### Commit message format
-```
-module: imperative short description
-
-Optional longer explanation of what changed and why. Wrap at 72 characters.
-Reference issue numbers if applicable: closes #42.
-```
-
----
-
-## 9. What will be rejected
-
-- Code requiring packages not in a minimal Debian or CentOS install.
-- Use of `eval`, `source`-based config loading, or other code-injection vectors.
-- Changes that break Bash 4.3 compatibility.
-- Patches without a passing `shellcheck` run.
-- New functions without `--help` support.
-
----
-
-## 10. Financial contributions
-
-Contact the maintainer by mail if you wish to make a financial contribution.
+# Contributing to profile
+
+Thank you for your interest in contributing. This document explains how to get
+set up, what the conventions are, and how to submit work.
+
+---
+
+## 1. Before you start
+
+- Check the [to-do list](./todo.md) to see if your idea is already planned.
+- Check the [issue tracker](https://git.geoffray-levasseur.org/fatalerrors/profile/issues)
+  to avoid duplicate work.
+- For significant changes, open an issue or contact the maintainer before
+  writing code — alignment on design saves everyone time.
+
+---
+
+## 2. Getting the source
+
+A Git clone is mandatory for contributions:
+
+```bash
+git clone https://git.geoffray-levasseur.org/fatalerrors/profile.git
+cd profile
+```
+
+Always work from the **latest commit on `master`** (or the branch you intend
+to target). Stale forks cause avoidable merge conflicts.
+
+---
+
+## 3. Branch policy
+
+| Branch | Purpose |
+|---|---|
+| `master` | Main development branch — new features and enhancements go here |
+| `<version>` (e.g. `3.x`) | Maintenance branch for a released version — bugfixes backported from `master` |
+
+**New functionality** must always target `master`.
+
+**Bugfixes** must target the branch where the bug was introduced:
+- If the bug exists in a released version, open the fix against that version's
+  maintenance branch first, then cherry-pick onto `master`.
+- If the bug is only in `master` (unreleased), fix it directly on `master`.
+- During a release-candidate cycle, bugfixes go on the `x.*` branch and are
+  merged back into `master` before the final release.
+
+Do **not** add new features to a maintenance branch.
+
+---
+
+## 4. Versioning scheme
+
+Versions follow the format **`MAJOR.MINOR.PATCH`** where the `MINOR` number
+conveys the development stage of the next major release:
+
+| Minor range | Stage | Rules |
+|---|---|---|
+| `x.90.y` | **Alpha** toward `x+1` | Stays on `master`. Development is open: new features are welcome, regressions are acceptable. |
+| `x.95.y` | **Beta** toward `x+1` | The `x+1.*` maintenance branch is created at this point. No regression unless absolutely necessary; new features still allowed. |
+| `x.99.y` | **RC** toward `x+1` | Bugfixes only. No new features. No regression allowed. Becomes `x+1.0.0` when stable. |
+
+Examples: `3.90.1` is the first alpha toward `4.0`, `3.99.2` is the second
+release candidate for `4.0`.
+
+The `PATCH` number increments freely within a stage. A bump in `MINOR`
+(e.g. `90` → `95`) always indicates a stage promotion in development phase.
+
+Any experimental version must have it's dedicated branch.
+
+---
+
+## 5. Development environment
+|---|---|---|
+| Bash | 4.3 | Namerefs (`local -n`) required |
+| shellcheck | any recent | Run before every commit |
+| git | any | For contributing patches |
+| bats-core | 1.x | Optional — for running the test suite |
+
+Install shellcheck:
+```bash
+# Debian / Ubuntu
+apt-get install shellcheck
+
+# Fedora / RHEL
+dnf install ShellCheck
+
+# macOS
+brew install shellcheck
+```
+
+---
+
+## 6. Code style
+
+### General rules
+- **Bash only** — no external interpreters in core modules. Python or Perl is
+  acceptable for completely self-contained, optional utilities that have no
+  dependencies beyond a minimal Debian or CentOS installation.
+- **4-space indentation** — no tabs.
+- **`[[ … ]]`** for all conditionals — not `[ … ]`.
+- **`(( … ))`** for arithmetic — not `$(( … ))` in conditionals.
+- **`local`** for all function-internal variables — avoid polluting the
+  environment. Prefer upper case for global and lowercase for local.
+- **`printf`** instead of `echo` all the time.
+- **Never `eval`** — use namerefs (`local -n`), `${!varname}` indirection, or
+  `declare -g` instead.
+- **No hardcoded defaults** — wire every configurable value through
+  `${VAR:-default}` and document the key in `profile.conf` and `README.md §4`.
+
+### Function conventions
+- Public functions **must** be exported: `export -f funcname`.
+- Every public function **must** support `-h` / `--help` and print usage to
+  stdout, returning 0.
+- Use `getopt` (not `getopts`) for option parsing — it handles long options and
+  `--` correctly.
+- Follow existing error-return conventions: 0 = success, 1 = usage error,
+  2 = bad options, 3 = missing dependency, 4+ = runtime failure.
+- Prefix all local helper variables with a short unique prefix (e.g. `_taz_`)
+  to prevent collisions with caller-scope variables.
+
+### Module structure
+Every new module should follow this pattern:
+
+```bash
+#!/usr/bin/env bash
+# <copyright block identical to existing modules>
+
+load_conf "<module_name>"
+
+# --- functions ---
+
+export -f my_function
+
+# EOF
+```
+
+Add the `load_conf` call near the top after any variable declarations.
+
+---
+
+## 7. Configuration keys
+
+When adding a configurable default:
+
+1. Use `${MY_VAR:-hardcoded_default}` in the function body.
+2. Add a commented-out entry with a description to `profile.conf`.
+3. Document the key in the matching table in `README.md §4.2`.
+
+---
+
+## 8. Theming
+
+New theme files go in `profile.d/themes/` with a `.theme` extension.
+They are **parsed, not executed** — do not add shell logic.  
+See the existing themes and `README.md §4.4` for the allowed syntax.
+
+---
+
+## 9. Running shellcheck
+
+```bash
+shellcheck -x profile.sh profile.d/*.sh
+```
+
+All warnings must be resolved before a patch will be accepted. Accepted
+suppression directives (`# shellcheck disable=SCxxxx`) require an inline
+comment explaining why the suppression is necessary.
+
+---
+
+## 10. Submitting a contribution
+
+### Via Git (preferred)
+1. Contact the maintainer to obtain push access, or fork on the Gitea instance.
+2. Create a branch: `git checkout -b feature/my-feature`.
+3. Commit with a clear subject line: `module: short description (≤ 72 chars)`.
+4. Push and open a pull request against `master`.
+
+### Via patch
+If you do not have push access:
+```bash
+git format-patch origin/master
+```
+Send the resulting `.patch` file(s) to
+`fatalerrors <at> geoffray-levasseur <dot> org`.
+
+### Commit message format
+```
+module: imperative short description
+
+Optional longer explanation of what changed and why. Wrap at 72 characters.
+Reference issue numbers if applicable: closes #42.
+```
+
+---
+
+## 11. What will be rejected
+
+- Code requiring packages not in a minimal Debian or CentOS install.
+- Use of `eval`, `source`-based config loading, or other code-injection vectors.
+- Changes that break Bash 4.3 compatibility.
+- Patches without a passing `shellcheck` run.
+- New functions without `--help` support.
+
+---
+
+## 12. Financial contributions
+
+Contact the maintainer by mail if you wish to make a financial contribution.

doc/FAQ.md

@@ -1,208 +1,208 @@
-# Frequently Asked Questions
-
----
-
-## Installation & loading
-
-**Q: profile refuses to load and prints "This profile requires Bash 4.3 or higher."**
-
-Your system's default shell is an older Bash (common on macOS, which ships
-Bash 3.x for licensing reasons). Install a newer Bash:
-```bash
-# macOS
-brew install bash
-# then add /opt/homebrew/bin/bash to /etc/shells and chsh
-```
-Or point your terminal emulator at the newer binary explicitly.
-
----
-
-**Q: I sourced `profile.sh` but functions are not available in sub-shells or scripts.**
-
-All public functions are exported with `export -f`. They are available in
-child Bash processes, but **not** in POSIX `sh` sub-shells. Make sure your
-scripts start with `#!/usr/bin/env bash`.
-
----
-
-**Q: I set `PROFILE_PATH` but profile still can't find its modules.**
-
-`PROFILE_PATH` must be exported *before* you source `profile.sh`:
-```bash
-export PROFILE_PATH=/opt/profile
-source /opt/profile/profile.sh
-```
-If set after sourcing, `MYPATH` is already locked in and the variable has
-no effect.
-
----
-
-**Q: Can I load profile system-wide via `/etc/profile`?**
-
-It is not recommended. User `.bashrc` files frequently set variables that
-conflict with the aliases and locale functions defined here, leading to
-surprising behaviour. Per-user sourcing from `~/.bashrc` is the supported
-method.
-
----
-
-## Configuration
-
-**Q: I edited `profile.conf` but my changes have no effect.**
-
-`profile.conf` is parsed once per shell session at load time. Open a new
-terminal (or `exec bash`) to pick up the changes. There is no live-reload.
-
----
-
-**Q: How do I find out which configuration keys a module supports?**
-
-Every supported key is documented with a comment in `profile.conf`.
-See also `README.md §4.2` for a consolidated table.
-
----
-
-**Q: A key I set in `profile.conf` is being ignored.**
-
-Check that:
-1. The key is inside the correct `[section]` header.
-2. There is no leading space before the section name (`[section]` not
-   `[ section ]`).
-3. The key is not commented out (no leading `#`).
-4. The value contains no backticks or `$(…)` — these are stripped by the
-   parser as a security measure.
-
----
-
-## Prompt & theming
-
-**Q: How do I change the prompt theme?**
-
-Add to `profile.conf`:
-```ini
-[prompt]
-PROMPT_THEME = dark
-```
-Built-in names: `default`, `dark`, `light`, `solarized`, `solarized-light`,
-`monokai`, `monochrome`, `abyss`, `plasma`, `adwaita`.
-
----
-
-**Q: The solarized or solarized-light theme shows wrong colours.**
-
-Those themes use 24-bit / true-colour ANSI sequences (`\e[38;2;R;G;Bm`).
-Test your terminal:
-```bash
-printf '\e[38;2;38;139;210mTrue colour test\e[0m\n'
-```
-If you see a solid blue word your terminal supports true colour.  
-If you see garbage or plain text, switch to a 16-colour theme
-(`dark`, `default`, etc.) or upgrade your terminal emulator.
-
----
-
-**Q: I created a custom theme but `load_theme` emits "key not allowed" warnings.**
-
-Theme files are parsed, not executed. Only `PROMPT_COLOR_*` keys and the
-standard colour variable names from `disp.sh` (`Black`, `Blue`, `On_IBlack`,
-…) are accepted. Any other key — including custom variables — is rejected.
-See `README.md §4.4` for the full list of accepted keys and value forms.
-
----
-
-**Q: Can a theme file contain shell logic or `$(…)` command substitutions?**
-
-No, and intentionally so. Theme files are parsed line-by-line; shell
-constructs are never evaluated. This is a security boundary — a malicious
-theme file cannot execute code. Values must be a colour variable reference
-(`$Blue`) or a raw ANSI escape literal (`\e[0;34m`).
-
----
-
-## Functions
-
-**Q: `meteo` prints "No city specified" even though I set a default.**
-
-The key is `METEO_DEFAULT_CITY` (not `DEFAULT_CITY`), and it must be in the
-`[info]` section:
-```ini
-[info]
-METEO_DEFAULT_CITY = Paris
-```
-
----
-
-**Q: `dwl` fails with "no download tool found".**
-
-`dwl` requires one of `curl`, `wget`, or `fetch` to be installed.
-Install curl:
-```bash
-# Debian / Ubuntu
-apt-get install curl
-
-# Fedora / RHEL
-dnf install curl
-```
-Or set `DWL_PREFERRED_TOOL` in `[net]` to whichever tool you have.
-
----
-
-**Q: `pkgs` does not find packages I know are installed.**
-
-`pkgs` delegates to `dpkg -l` (Debian/Ubuntu) or `rpm -qa` (RHEL/Fedora).
-If your distribution uses a different package manager (pacman, apk, brew …)
-it is not yet supported. See `doc/todo.md` for the tracking issue.
-
----
-
-**Q: `profile_upgrade` says "no update available" but I know there is one.**
-
-`check_updates` compares the content of the remote `version` file against
-`$PROFVERSION`. If `UPDT_DEFAULT_BRANCH` in `[updates]` points to a different
-branch than your installation, the version files may not match. Check:
-```bash
-cat "$MYPATH/version"
-```
-and make sure `UPDT_DEFAULT_BRANCH` matches the branch you track.
-
----
-
-## Compatibility
-
-**Q: Some functions misbehave on macOS / Cygwin.**
-
-Both environments ship non-GNU userland utilities with different flags and
-behaviour. profile is primarily developed and tested on Linux (Debian and
-RHEL families). macOS and Cygwin bugs are low priority; patches that add
-compatibility without breaking Linux support are welcome.
-
----
-
-**Q: Can I use profile with ZSH?**
-
-Not officially. Blockers include `local -A` (ZSH requires `typeset -A`) and
-`local -n` namerefs. A compatibility layer is listed in `doc/todo.md` but
-has not been implemented yet.
-
----
-
-## Miscellaneous
-
-**Q: How do I completely disable profile for one session?**
-
-```bash
-PROFILE_DISABLED=1 bash --norc
-```
-Or simply open a shell without sourcing `~/.bashrc` (`bash --norc`).
-
----
-
-**Q: How do I report a bug?**
-
-Open an issue on the
-[Gitea tracker](https://git.geoffray-levasseur.org/fatalerrors/profile/issues)
-or send a mail to `fatalerrors <at> geoffray-levasseur <dot> org` with:
-- The exact command that triggered the bug
-- Your OS and Bash version (`bash --version`)
-- The module involved
-- Any relevant error output
+# Frequently Asked Questions
+
+---
+
+## Installation & loading
+
+**Q: profile refuses to load and prints "This profile requires Bash 4.3 or higher."**
+
+Your system's default shell is an older Bash (common on macOS, which ships
+Bash 3.x for licensing reasons). Install a newer Bash:
+```bash
+# macOS
+brew install bash
+# then add /opt/homebrew/bin/bash to /etc/shells and chsh
+```
+Or point your terminal emulator at the newer binary explicitly.
+
+---
+
+**Q: I sourced `profile.sh` but functions are not available in sub-shells or scripts.**
+
+All public functions are exported with `export -f`. They are available in
+child Bash processes, but **not** in POSIX `sh` sub-shells. Make sure your
+scripts start with `#!/usr/bin/env bash`.
+
+---
+
+**Q: I set `PROFILE_PATH` but profile still can't find its modules.**
+
+`PROFILE_PATH` must be exported *before* you source `profile.sh`:
+```bash
+export PROFILE_PATH=/opt/profile
+source /opt/profile/profile.sh
+```
+If set after sourcing, `MYPATH` is already locked in and the variable has
+no effect.
+
+---
+
+**Q: Can I load profile system-wide via `/etc/profile`?**
+
+It is not recommended. User `.bashrc` files frequently set variables that
+conflict with the aliases and locale functions defined here, leading to
+surprising behaviour. Per-user sourcing from `~/.bashrc` is the supported
+method.
+
+---
+
+## Configuration
+
+**Q: I edited `profile.conf` but my changes have no effect.**
+
+`profile.conf` is parsed once per shell session at load time. Open a new
+terminal (or `exec bash`) to pick up the changes. There is no live-reload.
+
+---
+
+**Q: How do I find out which configuration keys a module supports?**
+
+Every supported key is documented with a comment in `profile.conf`.
+See also `README.md §4.2` for a consolidated table.
+
+---
+
+**Q: A key I set in `profile.conf` is being ignored.**
+
+Check that:
+1. The key is inside the correct `[section]` header.
+2. There is no leading space before the section name (`[section]` not
+   `[ section ]`).
+3. The key is not commented out (no leading `#`).
+4. The value contains no backticks or `$(…)` — these are stripped by the
+   parser as a security measure.
+
+---
+
+## Prompt & theming
+
+**Q: How do I change the prompt theme?**
+
+Add to `profile.conf`:
+```ini
+[prompt]
+PROMPT_THEME = dark
+```
+Built-in names: `default`, `dark`, `light`, `solarized`, `solarized-light`,
+`monokai`, `monochrome`, `abyss`, `plasma`, `adwaita`.
+
+---
+
+**Q: The solarized or solarized-light theme shows wrong colours.**
+
+Those themes use 24-bit / true-colour ANSI sequences (`\e[38;2;R;G;Bm`).
+Test your terminal:
+```bash
+printf '\e[38;2;38;139;210mTrue colour test\e[0m\n'
+```
+If you see a solid blue word your terminal supports true colour.  
+If you see garbage or plain text, switch to a 16-colour theme
+(`dark`, `default`, etc.) or upgrade your terminal emulator.
+
+---
+
+**Q: I created a custom theme but `load_theme` emits "key not allowed" warnings.**
+
+Theme files are parsed, not executed. Only `PROMPT_COLOR_*` keys and the
+standard colour variable names from `disp.sh` (`Black`, `Blue`, `On_IBlack`,
+…) are accepted. Any other key — including custom variables — is rejected.
+See `README.md §4.4` for the full list of accepted keys and value forms.
+
+---
+
+**Q: Can a theme file contain shell logic or `$(…)` command substitutions?**
+
+No, and intentionally so. Theme files are parsed line-by-line; shell
+constructs are never evaluated. This is a security boundary — a malicious
+theme file cannot execute code. Values must be a colour variable reference
+(`$Blue`) or a raw ANSI escape literal (`\e[0;34m`).
+
+---
+
+## Functions
+
+**Q: `meteo` prints "No city specified" even though I set a default.**
+
+The key is `METEO_DEFAULT_CITY` (not `DEFAULT_CITY`), and it must be in the
+`[info]` section:
+```ini
+[info]
+METEO_DEFAULT_CITY = Paris
+```
+
+---
+
+**Q: `dwl` fails with "no download tool found".**
+
+`dwl` requires one of `curl`, `wget`, or `fetch` to be installed.
+Install curl:
+```bash
+# Debian / Ubuntu
+apt-get install curl
+
+# Fedora / RHEL
+dnf install curl
+```
+Or set `DWL_PREFERRED_TOOL` in `[net]` to whichever tool you have.
+
+---
+
+**Q: `pkgs` does not find packages I know are installed.**
+
+`pkgs` delegates to `dpkg -l` (Debian/Ubuntu) or `rpm -qa` (RHEL/Fedora).
+If your distribution uses a different package manager (pacman, apk, brew …)
+it is not yet supported. See `doc/todo.md` for the tracking issue.
+
+---
+
+**Q: `profile_upgrade` says "no update available" but I know there is one.**
+
+`check_updates` compares the content of the remote `version` file against
+`$PROFVERSION`. If `UPDT_DEFAULT_BRANCH` in `[updates]` points to a different
+branch than your installation, the version files may not match. Check:
+```bash
+cat "$MYPATH/version"
+```
+and make sure `UPDT_DEFAULT_BRANCH` matches the branch you track.
+
+---
+
+## Compatibility
+
+**Q: Some functions misbehave on macOS / Cygwin.**
+
+Both environments ship non-GNU userland utilities with different flags and
+behaviour. profile is primarily developed and tested on Linux (Debian and
+RHEL families). macOS and Cygwin bugs are low priority; patches that add
+compatibility without breaking Linux support are welcome.
+
+---
+
+**Q: Can I use profile with ZSH?**
+
+Not officially. Blockers include `local -A` (ZSH requires `typeset -A`) and
+`local -n` namerefs. A compatibility layer is listed in `doc/todo.md` but
+has not been implemented yet.
+
+---
+
+## Miscellaneous
+
+**Q: How do I completely disable profile for one session?**
+
+```bash
+PROFILE_DISABLED=1 bash --norc
+```
+Or simply open a shell without sourcing `~/.bashrc` (`bash --norc`).
+
+---
+
+**Q: How do I report a bug?**
+
+Open an issue on the
+[Gitea tracker](https://git.geoffray-levasseur.org/fatalerrors/profile/issues)
+or send a mail to `fatalerrors <at> geoffray-levasseur <dot> org` with:
+- The exact command that triggered the bug
+- Your OS and Bash version (`bash --version`)
+- The module involved
+- Any relevant error output

doc/LICENSE

@@ -0,0 +1,29 @@
+Copyright 2021-2026 Geoffray Levasseur <fatalerrors@geoffray-levasseur.org>
+
+This software is distributed under the BSD-3-Clause license with the
+following terms and conditions:
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

doc/profile.conf.example

@@ -1,247 +1,252 @@
-# profile.conf — example / reference configuration
-# Copy this file to the profile installation directory as "profile.conf"
-# and uncomment / edit the keys you want to change.
-#
-# Format:
-#   [section_name]      — starts a section
-#   key = value         — sets a key (whitespace around = is optional)
-#   # comment           — line comment
-#
-# All keys are optional. Sensible defaults apply when unset.
-# Values must not contain backticks or $(…) — those are stripped for security.
-# ------------------------------------------------------------------------------
-
-# ==============================================================================
-[system]
-# Bash history settings
-HISTSIZE=50000
-HISTFILESIZE=100000
-HISTIGNORE="&:[bf]g:exit"
-
-# Default pager
-PAGER=less
-
-# Terminal colour capability
-TERM=xterm-256color
-
-# ==============================================================================
-[compress]
-# taz: Default archive format (-f/--format).
-# Supported: lz (default), xz, bz2, gz, lzo, tar, zip, zst
-#TAZ_DEFAULT_FORMAT=lz
-
-# taz: Number of compression threads (0 = auto-detect CPU count).
-#TAZ_DEFAULT_THREADS=0
-
-# taz: Compression level 1 (fast/large) … 9 (slow/small).
-#TAZ_DEFAULT_LEVEL=6
-
-# utaz: Delete source archive after successful extraction (0=no, 1=yes).
-#UTAZ_DEFAULT_DELETE=0
-
-# utaz: Subdirectory creation policy.
-#   auto   — create one only when the archive has multiple top-level entries
-#   always — always extract into a new subdirectory
-#   never  — always flatten into the current directory
-#UTAZ_DEFAULT_DIR_MODE=auto
-
-# ==============================================================================
-[debug]
-# (no configurable keys yet)
-
-# ==============================================================================
-[disp]
-# Uncomment to disable ANSI colours in profile's own output messages.
-#NO_COLOR=1
-
-# ==============================================================================
-[filefct]
-# expandlist: Separator between items (default: space). Use \n for newline.
-#EXPANDLIST_DEFAULT_SEPARATOR=" "
-
-# clean: Recurse into subdirectories by default (0=no, 1=yes).
-#CLEAN_DEFAULT_RECURSIVE=0
-
-# rmspc: Replacement character for spaces in filenames (default: underscore).
-#RMSPC_DEFAULT_CHAR=_
-
-# findbig: Number of results to display (default: 10).
-#FINDBIG_DEFAULT_LIMIT=10
-
-# ==============================================================================
-[fun]
-# busy: Hex pattern searched in /dev/urandom hexdump.
-#BUSY_DEFAULT_PATTERN=ca fe
-
-# busy: Delay between matched lines in milliseconds (0 = no delay).
-#BUSY_DEFAULT_DELAY=0
-
-# ==============================================================================
-[info]
-# meteo: Default city when no argument is given. Leave unset to require an
-# explicit city argument every time.
-#METEO_DEFAULT_CITY=Paris
-
-# ==============================================================================
-[lang]
-# Comma-separated alias:locale pairs. One function is generated per entry.
-# Example: SET_LOCALE="fr:fr_FR.UTF-8,us:en_US.UTF-8,es:es_ES.UTF-8"
-# creates setfr, setus, setes.
-#SET_LOCALE=fr:fr_FR.UTF-8,us:en_US.UTF-8
-
-# ==============================================================================
-[net]
-# dwl: Force a specific download tool (curl, wget, fetch).
-# Unset = auto-detect (curl preferred, then wget, then fetch).
-#DWL_PREFERRED_TOOL=curl
-
-# myextip: API endpoint for external IP lookup.
-# Alternatives: https://ipinfo.io/json, https://ip-api.com/json/
-#MYEXTIP_DEFAULT_URL=https://ip-api.com/json/
-
-# ==============================================================================
-[packages]
-# pkgs: Case-insensitive search by default (0=no, 1=yes).
-#PKGS_DEFAULT_IGNORE_CASE=0
-
-# ==============================================================================
-[processes]
-# ppu: ps output columns (comma-separated ps field names).
-#PPU_DEFAULT_FORMAT=pid,user,%cpu,%mem,start,time,command
-
-# ku: Signal sent when killing a user's processes (without SIG prefix).
-#KU_DEFAULT_SIGNAL=TERM
-
-# ==============================================================================
-[prompt]
-# Name of the prompt theme to load, or an explicit path to a .theme file.
-# Built-in themes: default, dark, light, solarized, solarized-light,
-#                  monokai, monochrome, abyss, plasma, adwaita
-# Solarized variants require a terminal with 24-bit true-colour support.
-#PROMPT_THEME=default
-
-# Directory searched for bare theme names. Defaults to profile.d/themes/.
-#PROMPT_THEME_DIR=/path/to/my/themes
-
-# Individual colour overrides — these always win over the loaded theme.
-# Values must be colour variable names from disp.sh (e.g. $Blue, $On_IBlack)
-# or raw ANSI escape sequences (e.g. \e[0;34m).
-#
-# Clock segment
-#PROMPT_COLOR_TIME_FG=$Blue
-#PROMPT_COLOR_TIME_BG=$On_IBlack
-#
-# Main bar background
-#PROMPT_COLOR_BAR_BG=$On_Blue
-#
-# Exit-code segment — success
-#PROMPT_COLOR_OK_FG=$White
-#PROMPT_COLOR_OK_MARK=$Green
-#
-# Exit-code segment — failure
-#PROMPT_COLOR_ERR_BG=$On_Red
-#PROMPT_COLOR_ERR_FG=$White
-#PROMPT_COLOR_ERR_MARK=$BYellow
-#
-# User / host
-#PROMPT_COLOR_ROOT_FG=$Red
-#PROMPT_COLOR_USER_FG=$Green
-#
-# Working directory
-#PROMPT_COLOR_DIR_FG=$ICyan
-
-# ==============================================================================
-[pwd]
-# genpwd: Default password length.
-#GENPWD_DEFAULT_LENGTH=16
-
-# genpwd: Maximum occurrences of any single character.
-#GENPWD_DEFAULT_OCCURS=2
-
-# genpwd: Number of passwords generated per invocation.
-#GENPWD_DEFAULT_COUNT=1
-
-# genpwd: Include symbols (1=yes, 0=no).
-#GENPWD_DEFAULT_SYMBOLS=1
-
-# genpwd: Include uppercase letters (1=yes, 0=no).
-#GENPWD_DEFAULT_UPPERCASE=1
-
-# genpwd: Include lowercase letters (1=yes, 0=no).
-#GENPWD_DEFAULT_LOWERCASE=1
-
-# genpwd: Include digits (1=yes, 0=no).
-#GENPWD_DEFAULT_NUMBERS=1
-
-# pwdscore: Show verbose breakdown by default (1=yes, 0=no).
-#PWDSCORE_DEFAULT_VERBOSE=0
-
-# ==============================================================================
-[rain]
-# rain: Falling speed — integer/100 gives seconds (5 → 0.05 s).
-# Values < 1 are used as raw seconds.
-#RAIN_DEFAULT_SPEED=5
-
-# rain: Colour theme. Supported: white (default), green, blue, red, yellow, cyan
-#RAIN_DEFAULT_COLOR=white
-
-# matrix: Falling speed.
-#MATRIX_DEFAULT_SPEED=3.5
-
-# matrix: Colour theme. Supported: green (default), blue, red, yellow, cyan, white
-#MATRIX_DEFAULT_COLOR=green
-
-# matrix: Character set. Supported: binary (default), kana, ascii
-#MATRIX_DEFAULT_CHARSET=binary
-
-# ==============================================================================
-[ssh]
-# ssr: Default SSH options prepended to every ssr call.
-# Examples:
-#   SSH_DEFAULT_OPT=-Y                                # X11 forwarding
-#   SSH_DEFAULT_OPT=-Y -o StrictHostKeyChecking=accept-new
-#   SSH_DEFAULT_OPT=                                  # no default options
-#SSH_DEFAULT_OPT=-Y
-
-# ==============================================================================
-[updates]
-# Git branch used for update checks and profile_upgrade.
-# Changing this causes profile_upgrade to automatically switch the local
-# checkout to the new branch on the next run and display a warning.
-#UPDT_DEFAULT_BRANCH=master
-
-# ==============================================================================
-[general]
-# General-purpose section — set any environment variable you need globally.
-# Good place for compilation flags, personal PATH additions, etc.
-#CFLAGS=-O2 -pipe -march=native
-#CXXFLAGS=$CFLAGS
-#MAKEFLAGS=-j4
-#PKGSOURCES=/usr/local/src
-
-# ==============================================================================
-[aliases]
-# Command aliases loaded for interactive shells only.
-# The value is the full command string; the key becomes the alias name.
-# The base command must be executable; if not, the alias is silently skipped.
-#
-# ls
-ll=ls -laFh --color=auto
-la=ls -Ah --color=auto
-l=ls -CF --color=auto
-ls=ls --color=auto
-#
-# grep
-grep=grep --color=auto
-egrep=egrep --color=auto
-fgrep=fgrep --color=auto
-#
-# disk usage
-df=df -H
-du=du -ch
-#
-# make shortcuts
-#mk=make
-#mkin=make install
-
-# End of profile.conf.example
+# profile.conf — example / reference configuration
+# Copy this file to the profile installation directory as "profile.conf"
+# and uncomment / edit the keys you want to change.
+#
+# Format:
+#   [section_name]      — starts a section
+#   key = value         — sets a key (whitespace around = is optional)
+#   # comment           — line comment
+#
+# All keys are optional. Sensible defaults apply when unset.
+# Values must not contain backticks or $(…) — those are stripped for security.
+# ------------------------------------------------------------------------------
+
+# ==============================================================================
+[system]
+# Bash history settings
+HISTSIZE=50000
+HISTFILESIZE=100000
+HISTIGNORE="&:[bf]g:exit"
+
+# Default pager
+PAGER=less
+
+# Terminal colour capability
+TERM=xterm-256color
+
+# ==============================================================================
+[compress]
+# taz: Default archive format (-f/--format).
+# Supported: lz (default), xz, bz2, gz, lzo, tar, zip, zst
+#TAZ_DEFAULT_FORMAT=lz
+
+# taz: Number of compression threads (0 = auto-detect CPU count).
+#TAZ_DEFAULT_THREADS=0
+
+# taz: Compression level 1 (fast/large) … 9 (slow/small).
+#TAZ_DEFAULT_LEVEL=6
+
+# utaz: Delete source archive after successful extraction (0=no, 1=yes).
+#UTAZ_DEFAULT_DELETE=0
+
+# utaz: Subdirectory creation policy.
+#   auto   — create one only when the archive has multiple top-level entries
+#   always — always extract into a new subdirectory
+#   never  — always flatten into the current directory
+#UTAZ_DEFAULT_DIR_MODE=auto
+
+# ==============================================================================
+[debug]
+# (no configurable keys yet)
+
+# ==============================================================================
+[disp]
+# Uncomment to disable ANSI colours in profile's own output messages.
+#NO_COLOR=1
+
+# ==============================================================================
+[filefct]
+# expandlist: Separator between items (default: space). Use \n for newline.
+#EXPANDLIST_DEFAULT_SEPARATOR=" "
+
+# clean: Recurse into subdirectories by default (0=no, 1=yes).
+#CLEAN_DEFAULT_RECURSIVE=0
+
+# rmspc: Replacement character for spaces in filenames (default: underscore).
+#RMSPC_DEFAULT_CHAR=_
+
+# findbig: Number of results to display (default: 10).
+#FINDBIG_DEFAULT_LIMIT=10
+
+# ==============================================================================
+[fun]
+# busy: Hex pattern searched in /dev/urandom hexdump.
+#BUSY_DEFAULT_PATTERN=ca fe
+
+# busy: Delay between matched lines in milliseconds (0 = no delay).
+#BUSY_DEFAULT_DELAY=0
+
+# ==============================================================================
+[info]
+# meteo: Default city when no argument is given. Leave unset to require an
+# explicit city argument every time.
+#METEO_DEFAULT_CITY=Paris
+
+# ==============================================================================
+[lang]
+# Comma-separated alias:locale pairs. One function is generated per entry.
+# Example: SET_LOCALE="fr:fr_FR.UTF-8,us:en_US.UTF-8,es:es_ES.UTF-8"
+# creates setfr, setus, setes.
+#SET_LOCALE=fr:fr_FR.UTF-8,us:en_US.UTF-8
+
+# Alias to activate at login. Must match one of the aliases defined in SET_LOCALE above.
+# Example: DEFAULT_LANG=fr  → calls setfr at startup.
+# Leave unset to keep the system default locale.
+#DEFAULT_LANG=fr
+
+# ==============================================================================
+[net]
+# dwl: Force a specific download tool (curl, wget, fetch).
+# Unset = auto-detect (curl preferred, then wget, then fetch).
+#DWL_PREFERRED_TOOL=curl
+
+# myextip: API endpoint for external IP lookup.
+# Alternatives: https://ipinfo.io/json, https://ip-api.com/json/
+#MYEXTIP_DEFAULT_URL=https://ip-api.com/json/
+
+# ==============================================================================
+[packages]
+# pkgs: Case-insensitive search by default (0=no, 1=yes).
+#PKGS_DEFAULT_IGNORE_CASE=0
+
+# ==============================================================================
+[processes]
+# ppu: ps output columns (comma-separated ps field names).
+#PPU_DEFAULT_FORMAT=pid,user,%cpu,%mem,start,time,command
+
+# ku: Signal sent when killing a user's processes (without SIG prefix).
+#KU_DEFAULT_SIGNAL=TERM
+
+# ==============================================================================
+[prompt]
+# Name of the prompt theme to load, or an explicit path to a .theme file.
+# Built-in themes: default, dark, light, solarized, solarized-light,
+#                  monokai, monochrome, abyss, plasma, adwaita
+# Solarized variants require a terminal with 24-bit true-colour support.
+#PROMPT_THEME=default
+
+# Directory searched for bare theme names. Defaults to profile.d/themes/.
+#PROMPT_THEME_DIR=/path/to/my/themes
+
+# Individual colour overrides — these always win over the loaded theme.
+# Values must be colour variable names from disp.sh (e.g. $Blue, $On_IBlack)
+# or raw ANSI escape sequences (e.g. \e[0;34m).
+#
+# Clock segment
+#PROMPT_COLOR_TIME_FG=$Blue
+#PROMPT_COLOR_TIME_BG=$On_IBlack
+#
+# Main bar background
+#PROMPT_COLOR_BAR_BG=$On_Blue
+#
+# Exit-code segment — success
+#PROMPT_COLOR_OK_FG=$White
+#PROMPT_COLOR_OK_MARK=$Green
+#
+# Exit-code segment — failure
+#PROMPT_COLOR_ERR_BG=$On_Red
+#PROMPT_COLOR_ERR_FG=$White
+#PROMPT_COLOR_ERR_MARK=$BYellow
+#
+# User / host
+#PROMPT_COLOR_ROOT_FG=$Red
+#PROMPT_COLOR_USER_FG=$Green
+#
+# Working directory
+#PROMPT_COLOR_DIR_FG=$ICyan
+
+# ==============================================================================
+[pwd]
+# genpwd: Default password length.
+#GENPWD_DEFAULT_LENGTH=16
+
+# genpwd: Maximum occurrences of any single character.
+#GENPWD_DEFAULT_OCCURS=2
+
+# genpwd: Number of passwords generated per invocation.
+#GENPWD_DEFAULT_COUNT=1
+
+# genpwd: Include symbols (1=yes, 0=no).
+#GENPWD_DEFAULT_SYMBOLS=1
+
+# genpwd: Include uppercase letters (1=yes, 0=no).
+#GENPWD_DEFAULT_UPPERCASE=1
+
+# genpwd: Include lowercase letters (1=yes, 0=no).
+#GENPWD_DEFAULT_LOWERCASE=1
+
+# genpwd: Include digits (1=yes, 0=no).
+#GENPWD_DEFAULT_NUMBERS=1
+
+# pwdscore: Show verbose breakdown by default (1=yes, 0=no).
+#PWDSCORE_DEFAULT_VERBOSE=0
+
+# ==============================================================================
+[rain]
+# rain: Falling speed — integer/100 gives seconds (5 → 0.05 s).
+# Values < 1 are used as raw seconds.
+#RAIN_DEFAULT_SPEED=5
+
+# rain: Colour theme. Supported: white (default), green, blue, red, yellow, cyan
+#RAIN_DEFAULT_COLOR=white
+
+# matrix: Falling speed.
+#MATRIX_DEFAULT_SPEED=3.5
+
+# matrix: Colour theme. Supported: green (default), blue, red, yellow, cyan, white
+#MATRIX_DEFAULT_COLOR=green
+
+# matrix: Character set. Supported: binary (default), kana, ascii
+#MATRIX_DEFAULT_CHARSET=binary
+
+# ==============================================================================
+[ssh]
+# ssr: Default SSH options prepended to every ssr call.
+# Examples:
+#   SSH_DEFAULT_OPT=-Y                                # X11 forwarding
+#   SSH_DEFAULT_OPT=-Y -o StrictHostKeyChecking=accept-new
+#   SSH_DEFAULT_OPT=                                  # no default options
+#SSH_DEFAULT_OPT=-Y
+
+# ==============================================================================
+[updates]
+# Git branch used for update checks and profile_upgrade.
+# Changing this causes profile_upgrade to automatically switch the local
+# checkout to the new branch on the next run and display a warning.
+#UPDT_DEFAULT_BRANCH=master
+
+# ==============================================================================
+[general]
+# General-purpose section — set any environment variable you need globally.
+# Good place for compilation flags, personal PATH additions, etc.
+#CFLAGS=-O2 -pipe -march=native
+#CXXFLAGS=$CFLAGS
+#MAKEFLAGS=-j4
+#PKGSOURCES=/usr/local/src
+
+# ==============================================================================
+[aliases]
+# Command aliases loaded for interactive shells only.
+# The value is the full command string; the key becomes the alias name.
+# The base command must be executable; if not, the alias is silently skipped.
+#
+# ls
+ll=ls -laFh --color=auto
+la=ls -Ah --color=auto
+l=ls -CF --color=auto
+ls=ls --color=auto
+#
+# grep
+grep=grep --color=auto
+egrep=egrep --color=auto
+fgrep=fgrep --color=auto
+#
+# disk usage
+df=df -H
+du=du -ch
+#
+# make shortcuts
+#mk=make
+#mkin=make install
+
+# End of profile.conf.example

doc/todo.md

@@ -1,121 +1,114 @@
-# profile — to-do list
-
-Items marked **[easy]**, **[medium]**, or **[hard]** give a rough effort hint.
-Items marked **[breaking]** would change existing behaviour and require a
-version-bump.
-
----
-
-## Shell / compatibility
-
-- [ ] **ZSH compatibility layer** — most functions work already; the remaining
-  blockers are `local -A` (no associative arrays in ZSH without `typeset -A`)
-  and `local -n` namerefs. A thin compatibility shim would open the project to
-  ZSH users. **[hard]**
-- [ ] **Bash completion** — add a `profile.d/completion/` directory and write
-  `_profile_upgrade`, `_taz`, `_utaz`, `_meteo`, etc. completions so that
-  `<Tab>` works on all public functions. **[medium]**
-- [ ] **`shellcheck` clean pass** — run `shellcheck -x profile.sh profile.d/*.sh`
-  and address every remaining warning (currently a handful of SC2034 and SC2086
-  items). Integrate as a pre-commit hook. **[easy]**
-
----
-
-## Prompt & theming
-
-- [ ] **Git branch in prompt** — show the current branch name (and dirty
-  indicator) in the PS1 bar when inside a Git repository. Should be
-  gated behind a `[prompt]` config key so it can be disabled. **[medium]**
-- [ ] **Virtual-env / conda indicator** — detect `$VIRTUAL_ENV` / `$CONDA_DEFAULT_ENV`
-  and display the name in the prompt bar. **[easy]**
-- [ ] **True-colour terminal auto-detection** — query `$COLORTERM` and
-  `$TERM` at load time; automatically fall back from a 24-bit theme to its
-  16-colour equivalent when the terminal does not support true colour. **[medium]**
-- [ ] **True-colour variants of other themes** — create `monokai-tc.theme`,
-  `abyss-tc.theme`, etc. using the same `\e[38;2;R;G;Bm` approach as the
-  Solarized themes. **[easy]** _(per theme)_
-- [ ] **Theme preview command** — add a `theme_preview` (or `profile_theme`)
-  function that renders a colour swatch and a sample prompt line for the
-  currently loaded theme, so users can evaluate themes without reloading
-  the session. **[medium]**
-- [ ] **`load_theme` — DEFAULTCOL rebuild** — after overriding `DEFAULTFG` and
-  `DEFAULTBG`, automatically recompute `DEFAULTCOL` from the new values instead
-  of requiring the theme file to set it explicitly. **[easy]**
-
----
-
-## Module improvements
-
-### compress
-- [ ] **`taz` progress bar** — show a `pv` / `dd`-based progress indicator when
-  compressing large trees, gated behind a `-p` flag. **[medium]**
-- [ ] **`utaz` integrity check** — run `tar -tOf` / `unzip -t` / `7z t` before
-  extracting and abort if the archive is corrupt. **[easy]**
-
-### filefct
-- [ ] **`findbig` / `findzero` / `finddead` — `fd` integration** — optionally
-  use `fd` instead of `find` when available for faster traversal. **[easy]**
-- [ ] **`file_stats` — human-readable totals** — add `--human` flag to emit
-  sizes in K/M/G instead of bytes. **[easy]**
-
-### info
-- [ ] **`showinfo` fallback** — when neither `neofetch` nor `fastfetch` is
-  installed, print a minimal sysinfo block (hostname, OS, kernel, uptime,
-  CPU, RAM) using pure Bash + `/proc`. **[medium]**
-
-### net
-- [ ] **`dwl` resume support** — pass `-C -` to curl / `--continue-at -` to
-  wget for interrupted downloads; gate behind a `-r` flag. **[easy]**
-- [ ] **`myextip` multiple providers** — fall back to a secondary URL
-  (configurable via `MYEXTIP_FALLBACK_URL`) when the primary times out.
-  **[easy]**
-
-### packages
-- [ ] **Additional backends** — add support for `pacman` (Arch), `apk` (Alpine),
-  `xbps-query` (Void), and `brew` (macOS). **[medium]**
-
-### processes
-- [ ] **`ku` dry-run flag** — add `-n` / `--dry-run` to print what would be
-  killed without acting. **[easy]**
-
-### pwd
-- [ ] **`genpwd` passphrase mode** — add `-w` / `--words N` to generate
-  word-based passphrases (diceware-style) from `/usr/share/dict/words`.
-  **[medium]**
-
-### ssh
-- [ ] **SSH agent management** — add `ssh_agent_start` / `ssh_agent_stop` helpers
-  that start a persistent `ssh-agent`, add configured keys, and survive
-  re-login via a socket stored in `~/.ssh/agent.env`. **[medium]**
-- [ ] **`rmhost` glob support** — allow `rmhost '*.example.com'` to remove all
-  matching entries in one call. **[easy]**
-
-### updates
-- [ ] **Automatic update check age** — store a timestamp in `~/.cache/profile_last_check`;
-  skip the network request in `check_updates -q` if the last check was less
-  than `UPDT_CHECK_INTERVAL` hours ago (configurable, default 24). **[medium]**
-- [ ] **Changelog display** — after a successful `profile_upgrade`, fetch and
-  display `CHANGELOG.md` entries newer than the previously installed version.
-  **[medium]**
-
----
-
-## Infrastructure
-
-- [ ] **Test suite** — add a `test/` directory with `bats` (Bash Automated
-  Testing System) unit tests for pure functions (`expandlist`, `genpwd`,
-  `pwdscore`, `isipv4`, `isipv6`, `parse_conf`, `load_theme`, …). Target for
-  CI. **[hard]**
-- [ ] **CI pipeline** — Gitea Actions (or similar) job that runs `shellcheck`
-  and the `bats` suite on every push. **[medium]**
-- [ ] **`profile_status` function** — print a diagnostic summary: installed
-  version, active theme, loaded modules, detected Bash version, interactive /
-  login shell flags, and `profile.conf` path. **[easy]**
-- [ ] **`profile_uninstall` function** — remove the `source` line from
-  `~/.bashrc` / `~/.profile` and optionally delete the install directory,
-  with a dry-run mode. **[medium]**
-- [ ] **`disp` syslog integration** — add a `DISP_SYSLOG=1` config key that
-  additionally pipes E/W messages to `logger`. **[easy]**
-- [ ] **XDG base-dir support** — honour `$XDG_CONFIG_HOME` as an alternative
-  location for `profile.conf` so users can keep `~` tidy. **[medium]**
-  **[breaking]**
+# profile — to-do list
+
+Items marked **[easy]**, **[medium]**, or **[hard]** give a rough effort hint.
+Items marked **[breaking]** would change existing behaviour and require a
+version-bump.
+
+---
+
+## Shell / compatibility
+
+- [ ] **ZSH compatibility layer** — most functions work already; the remaining
+  blockers are `local -A` (no associative arrays in ZSH without `typeset -A`)
+  and `local -n` namerefs. A thin compatibility shim would open the project to
+  ZSH users. **[hard]**
+- [ ] **Bash completion** — add a `profile.d/completion/` directory and write
+  `_profile_upgrade`, `_taz`, `_utaz`, `_meteo`, etc. completions so that
+  `<Tab>` works on all public functions. **[medium]**
+
+---
+
+## Prompt & theming
+
+- [ ] **Git branch in prompt** — show the current branch name (and dirty
+  indicator) in the PS1 bar when inside a Git repository. Should be
+  gated behind a `[prompt]` config key so it can be disabled. **[medium]**
+- [ ] **Virtual-env / conda indicator** — detect `$VIRTUAL_ENV` / `$CONDA_DEFAULT_ENV`
+  and display the name in the prompt bar. **[easy]**
+- [ ] **True-colour terminal auto-detection** — query `$COLORTERM` and
+  `$TERM` at load time; automatically fall back from a 24-bit theme to its
+  16-colour equivalent when the terminal does not support true colour. **[medium]**
+- [ ] **True-colour variants of other themes** — create `monokai-tc.theme`,
+  `abyss-tc.theme`, etc. using the same `\e[38;2;R;G;Bm` approach as the
+  Solarized themes. **[easy]** _(per theme)_
+- [ ] **Theme preview command** — add a `theme_preview` (or `profile_theme`)
+  function that renders a colour swatch and a sample prompt line for the
+  currently loaded theme, so users can evaluate themes without reloading
+  the session. **[medium]**
+- [ ] **`load_theme` — DEFAULTCOL rebuild** — after overriding `DEFAULTFG` and
+  `DEFAULTBG`, automatically recompute `DEFAULTCOL` from the new values instead
+  of requiring the theme file to set it explicitly. **[easy]**
+
+---
+
+## Module improvements
+
+### compress
+- [ ] **`taz` progress bar** — show a `pv` / `dd`-based progress indicator when
+  compressing large trees, gated behind a `-p` flag. **[medium]**
+- [ ] **`utaz` integrity check** — run `tar -tOf` / `unzip -t` / `7z t` before
+  extracting and abort if the archive is corrupt. **[easy]**
+
+### filefct
+- [ ] **`findbig` / `findzero` / `finddead` — `fd` integration** — optionally
+  use `fd` instead of `find` when available for faster traversal. **[easy]**
+- [ ] **`file_stats` — human-readable totals** — add `--human` flag to emit
+  sizes in K/M/G instead of bytes. **[easy]**
+
+### info
+- [ ] **`showinfo` fallback** — when neither `neofetch` nor `fastfetch` is
+  installed, print a minimal sysinfo block (hostname, OS, kernel, uptime,
+  CPU, RAM) using pure Bash + `/proc`. **[medium]**
+
+### net
+- [ ] **`dwl` resume support** — pass `-C -` to curl / `--continue-at -` to
+  wget for interrupted downloads; gate behind a `-r` flag. **[easy]**
+- [ ] **`myextip` multiple providers** — fall back to a secondary URL
+  (configurable via `MYEXTIP_FALLBACK_URL`) when the primary times out.
+  **[easy]**
+
+### processes
+- [ ] **`ku` dry-run flag** — add `-n` / `--dry-run` to print what would be
+  killed without acting. **[easy]**
+
+### pwd
+- [ ] **`genpwd` passphrase mode** — add `-w` / `--words N` to generate
+  word-based passphrases (diceware-style) from `/usr/share/dict/words`.
+  **[medium]**
+
+### ssh
+- [ ] **SSH agent management** — add `ssh_agent_start` / `ssh_agent_stop` helpers
+  that start a persistent `ssh-agent`, add configured keys, and survive
+  re-login via a socket stored in `~/.ssh/agent.env`. **[medium]**
+- [ ] **`rmhost` glob support** — allow `rmhost '*.example.com'` to remove all
+  matching entries in one call. **[easy]**
+
+### updates
+- [ ] **Automatic update check age** — store a timestamp in `~/.cache/profile_last_check`;
+  skip the network request in `check_updates -q` if the last check was less
+  than `UPDT_CHECK_INTERVAL` hours ago (configurable, default 24). **[medium]**
+- [ ] **Changelog display** — after a successful `profile_upgrade`, fetch and
+  display `CHANGELOG.md` entries newer than the previously installed version.
+  **[medium]**
+
+---
+
+## Infrastructure
+
+- [ ] **Test suite** — add a `test/` directory with `bats` (Bash Automated
+  Testing System) unit tests for pure functions (`expandlist`, `genpwd`,
+  `pwdscore`, `isipv4`, `isipv6`, `parse_conf`, `load_theme`, …). Target for
+  CI. **[hard]**
+- [ ] **CI pipeline** — Gitea Actions (or similar) job that runs `shellcheck`
+  and the `bats` suite on every push. **[medium]**
+- [ ] **`profile_status` function** — print a diagnostic summary: installed
+  version, active theme, loaded modules, detected Bash version, interactive /
+  login shell flags, and `profile.conf` path. **[easy]**
+- [ ] **`profile_uninstall` function** — remove the `source` line from
+  `~/.bashrc` / `~/.profile` and optionally delete the install directory,
+  with a dry-run mode. **[medium]**
+- [ ] **`disp` syslog integration** — add a `DISP_SYSLOG=1` config key that
+  additionally pipes E/W messages to `logger`. **[easy]**
+- [ ] **XDG base-dir support** — honour `$XDG_CONFIG_HOME` as an alternative
+  location for `profile.conf` so users can keep `~` tidy. **[medium]**
+  **[breaking]**

profile.d/compress.sh

@@ -44,36 +44,42 @@
 # 	-n, --no-dir		Never create a host directory
 utaz()
 {
+    # shellcheck disable=SC2329
     _ununzip()
     {
         unzip -o "$1" -d "$2" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _untar()
     {
         tar -xf "$1" -C "$2"
     }
 
+    # shellcheck disable=SC2329
     _ungzip()
     {
         tar -xzf "$1" -C "$2"
     }
-
+    # shellcheck disable=SC2329
     _unbzip2()
     {
         tar -xjf "$1" -C "$2"
     }
 
+    # shellcheck disable=SC2329
     _unxz()
     {
         tar -xJf "$1" -C "$2"
     }
 
+    # shellcheck disable=SC2329
     _unlzop()
     {
         lzop -d "$1" -o "$2/$(basename "${1%.*}")"
     }
 
+    # shellcheck disable=SC2329
     _unlzip()
     {
         if command -v plzip >/dev/null 2>&1; then
@@ -83,16 +89,19 @@ utaz()
         fi
     }
 
+    # shellcheck disable=SC2329
     _ununrar()
     {
         unrar x -o+ "$1" "$2/" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _ununarj()
     {
         unarj e "$1" "$2/" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _unlha()
     {
         # lha typically extracts into the current directory
@@ -100,40 +109,47 @@ utaz()
         (cd "$2" && lha -x "../$1") >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _ununace()
     {
         unace x "$1" "$2/" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _un7z()
     {
         7z x "$1" -o"$2/" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _unzstd()
     {
         # Zstd decompresses files directly, often requiring tar for archives
         tar --zstd -xf "$1" -C "$2"
     }
 
+    # shellcheck disable=SC2329
     _uncpio()
     {
         # CPIO requires careful directory handling
         (cd "$2" && cpio -id < "../$1") >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _uncabextract()
     {
         # Requires 'cabextract' package
         cabextract "$1" -d "$2/" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _undeb()
     {
         # Extracts data content from a Debian package
         dpkg-deb -x "$1" "$2/" >/dev/null 2>&1
     }
 
+    # shellcheck disable=SC2329
     _unrpm()
     {
         # Extracts CPIO-based payload from an RPM package
@@ -141,8 +157,9 @@ utaz()
         rpm2cpio "$1" | (cd "$2/" && cpio -idmv) >/dev/null 2>&1
     }
 
-    local PARSED=$(getopt -o hdcn --long help,delete,create-dir,no-dir -n 'utaz' -- "$@")
-
+    local PARSED
+    PARSED=$(getopt -o hdcn --long help,delete,create-dir,no-dir -n 'utaz' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [ $? -ne 0 ]; then
         disp E "Invalid options, use \"utaz --help\" to display usage."
         return 1
@@ -314,10 +331,10 @@ utaz()
             fi
 
             disp I "Processing archive ${f} with ${extractor}..."
-            mkdir -p "${dir}"
-            [[ $? -gt 0 ]] &&
+            if ! mkdir -p "${dir}"; then
                 disp E "The filesystem can't create directories, exit!" &&
                 return 1
+            fi
 
             ${extractor} "${f}" "${dir}"
             case $? in
@@ -390,6 +407,7 @@ export -f utaz
 # 	-1, .., -9	Compression level to use [1=fast/biggest, 9=slow/smallest]
 taz()
 {
+    # shellcheck disable=SC2329
     _doxz()
     {
         command -v xz >/dev/null 2>&1 || {
@@ -397,17 +415,19 @@ taz()
             return 127
         }
 
-        [[ $4 ]] && local verb='-v'
+        local verb=()
+        [[ $4 ]] && verb=('-v')
 
         # Display a warning for this format
         disp W "xz format is not suited for long term archiving."
         disp I "See https://www.nongnu.org/lzip/xz_inadequate.html for details."
 
-        # Compresse to xz (lzma2) - Deprecated
-        xz $verb --compress --keep -$3 -T $2 $1
+        # Compress with xz (lzma2) - Deprecated
+        xz "${verb[@]}" --compress --keep "-$3" -T "$2" "$1"
         return $?
     }
 
+    # shellcheck disable=SC2329
     _dolz()
     {
         local procopt="--threads $2"
@@ -425,13 +445,16 @@ taz()
                 disp W "Consider installing plzip to obtain multithreading abilities."
         }
 
-        [[ $4 ]] && local verb="-vv"
+        local opt=()
+        [[ $4 ]] && opt=('-vv')
+        opt+=("$procopt")
 
-        # Compresse au format lzip (lzma)
-        $command $verb $procopt --keep -$3 $1
+        # Compress with lzip (lzma)
+        $command "${opt[@]}" --keep "-$3" "$1"
         return $?
     }
 
+    # shellcheck disable=SC2329
     _dogz()
     {
         local procopt="--processes $2"
@@ -449,13 +472,16 @@ taz()
                 disp W "Consider installing pigz to obtain multithreading abilities."
         }
 
-        [[ $4 ]] && local verb="--verbose"
+        local opt=()
+        [[ $4 ]] && opt=('--verbose')
+        opt+=("$procopt")
 
         # Compresse au format bz2
-        $command $verb $procopt --keep -$3 $1
+        $command "${opt[@]}" --keep "-$3" "$1"
         return $?
     }
 
+    # shellcheck disable=SC2329
     _dobz2()
     {
         local procopt="-p$2"
@@ -473,13 +499,16 @@ taz()
                 disp W "Consider installing pbzip2 to obtain multithreading abilities."
         }
 
-        [[ $4 ]] && local verb="-v"
+        local opt=()
+        [[ $4 ]] && opt=('-v')
+        opt+=("$procopt")
 
-        # Compresse au format bz2
-        $command $verb --compress $procopt --keep -$3 $1
+        # Compress with bz2
+        $command "${opt[@]}" --compress --keep "-$3" "$1"
         return $?
     }
 
+    # shellcheck disable=SC2329
     _dolzo()
     {
         command -v lzop >/dev/null 2>&1 || {
@@ -487,16 +516,18 @@ taz()
             return 127
         }
 
-        [[ $4 ]] && local verb='-v'
+        local verb=()
+        [[ $4 ]] && verb=('-v')
         [[ $2 -gt 1 ]] && disp W "lzop doesn't support multithreading, falling back to 1 thread."
 
         # Compresse au format lzo
-        lzop --keep -$3 $1
+        lzop "${verb[@]}" --keep "-$3" "$1"
         return $?
     }
 
     local PARSED
     PARSED=$(getopt -o hdf:p:vq123456789 --long help,delete,format:,parallel:,verbose,quiet --name "taz" -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [ $? -ne 0 ]; then
         disp E "Invalid options, use \"taz --help\" to display usage."
         return 1
@@ -587,8 +618,7 @@ taz()
         if [[ -d "$item" ]]; then
             disp I "\t Creating $item.tar... "
 
-            tar -cf "$item.tar" "$item"
-            if [[ ! $? -eq 0 ]]; then
+            if ! tar -cf "$item.tar" "$item"; then
                 disp E "tar file creation failed, skipping to next item."
                 continue
             fi
@@ -602,8 +632,9 @@ taz()
         # Skip compression part if tar is asked
         if [[ $compform != "tar" ]]; then
             disp I "\t Compressing archive..."
-            _do$compform "$fname" "$nproc" "$complevel" "$verbose"
-            [[ ! $? -eq 0 ]] && case $? in
+            local exec_code=0
+            "_do$compform" "$fname" "$nproc" "$complevel" "$verbose" || exec_code=$?
+            [[ ! $exec_code -eq 0 ]] && case $exec_code in
             127)
                 disp E "Compression program unavailable, aborting."
                 return 127

profile.d/debug.sh

@@ -70,6 +70,7 @@ settrace()
 
     local PARSED
     PARSED=$(getopt -oh --long help,on,off,status,force -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"settrace --help\" to display usage."
         return 1

profile.d/disp.sh

@@ -36,81 +36,85 @@
 
 # ------------------------------------------------------------------------------
 # Color definitions
-# Standard 16 colors display declaration
-export DEFAULTFG='\e[0;39m'
-export DEFAULTBG='\e[0;49m'
-export DEFAULTCOL="${DEFAULTBG}${DEFAULTFG}"
-export RESETCOL=$'\e[0m'
+set_colors()
+{
+    # Standard 16 colors display declaration
+    export DEFAULTFG='\e[0;39m'
+    export DEFAULTBG='\e[0;49m'
+    export DEFAULTCOL="${DEFAULTBG}${DEFAULTFG}"
+    export RESETCOL=$'\e[0m'
 
-# Regular Colors
-export Black='\e[0;30m'
-export Red='\e[0;31m'
-export Green='\e[0;32m'
-export Yellow='\e[0;33m'
-export Blue='\e[0;34m'
-export Purple='\e[0;35m'
-export Cyan='\e[0;36m'
-export White='\e[0;37m'
+    # Regular Colors
+    export Black='\e[0;30m'
+    export Red='\e[0;31m'
+    export Green='\e[0;32m'
+    export Yellow='\e[0;33m'
+    export Blue='\e[0;34m'
+    export Purple='\e[0;35m'
+    export Cyan='\e[0;36m'
+    export White='\e[0;37m'
 
-# Bold
-export BBlack='\e[1;30m'
-export BRed='\e[1;31m'
-export BGreen='\e[1;32m'
-export BYellow='\e[1;33m'
-export BBlue='\e[1;34m'
-export BPurple='\e[1;35m'
-export BCyan='\e[1;36m'
-export BWhite='\e[1;37m'
+    # Bold
+    export BBlack='\e[1;30m'
+    export BRed='\e[1;31m'
+    export BGreen='\e[1;32m'
+    export BYellow='\e[1;33m'
+    export BBlue='\e[1;34m'
+    export BPurple='\e[1;35m'
+    export BCyan='\e[1;36m'
+    export BWhite='\e[1;37m'
 
-# Underline
-export UBlack='\e[4;30m'
-export URed='\e[4;31m'
-export UGreen='\e[4;32m'
-export UYellow='\e[4;33m'
-export UBlue='\e[4;34m'
-export UPurple='\e[4;35m'
-export UCyan='\e[4;36m'
-export UWhite='\e[4;37m'
+    # Underline
+    export UBlack='\e[4;30m'
+    export URed='\e[4;31m'
+    export UGreen='\e[4;32m'
+    export UYellow='\e[4;33m'
+    export UBlue='\e[4;34m'
+    export UPurple='\e[4;35m'
+    export UCyan='\e[4;36m'
+    export UWhite='\e[4;37m'
 
-# Background
-export On_Black='\e[40m'
-export On_Red='\e[41m'
-export On_Green='\e[42m'
-export On_Yellow='\e[43m'
-export On_Blue='\e[44m'
-export On_Purple='\e[45m'
-export On_Cyan='\e[46m'
-export On_White='\e[47m'
+    # Background
+    export On_Black='\e[40m'
+    export On_Red='\e[41m'
+    export On_Green='\e[42m'
+    export On_Yellow='\e[43m'
+    export On_Blue='\e[44m'
+    export On_Purple='\e[45m'
+    export On_Cyan='\e[46m'
+    export On_White='\e[47m'
 
-# High Intensity
-export IBlack='\e[0;90m'
-export IRed='\e[0;91m'
-export IGreen='\e[0;92m'
-export IYellow='\e[0;93m'
-export IBlue='\e[0;94m'
-export IPurple='\e[0;95m'
-export ICyan='\e[0;96m'
-export IWhite='\e[0;97m'
+    # High Intensity
+    export IBlack='\e[0;90m'
+    export IRed='\e[0;91m'
+    export IGreen='\e[0;92m'
+    export IYellow='\e[0;93m'
+    export IBlue='\e[0;94m'
+    export IPurple='\e[0;95m'
+    export ICyan='\e[0;96m'
+    export IWhite='\e[0;97m'
 
-# Bold High Intensity
-export BIBlack='\e[1;90m'
-export BIRed='\e[1;91m'
-export BIGreen='\e[1;92m'
-export BIYellow='\e[1;93m'
-export BIBlue='\e[1;94m'
-export BIPurple='\e[1;95m'
-export BICyan='\e[1;96m'
-export BIWhite='\e[1;97m'
+    # Bold High Intensity
+    export BIBlack='\e[1;90m'
+    export BIRed='\e[1;91m'
+    export BIGreen='\e[1;92m'
+    export BIYellow='\e[1;93m'
+    export BIBlue='\e[1;94m'
+    export BIPurple='\e[1;95m'
+    export BICyan='\e[1;96m'
+    export BIWhite='\e[1;97m'
 
-# High Intensity backgrounds
-export On_IBlack='\e[0;100m'
-export On_IRed='\e[0;101m'
-export On_IGreen='\e[0;102m'
-export On_IYellow='\e[0;103m'
-export On_IBlue='\e[0;104m'
-export On_IPurple='\e[0;105m'
-export On_ICyan='\e[0;106m'
-export On_IWhite='\e[0;107m'
+    # High Intensity backgrounds
+    export On_IBlack='\e[0;100m'
+    export On_IRed='\e[0;101m'
+    export On_IGreen='\e[0;102m'
+    export On_IYellow='\e[0;103m'
+    export On_IBlue='\e[0;104m'
+    export On_IPurple='\e[0;105m'
+    export On_ICyan='\e[0;106m'
+    export On_IWhite='\e[0;107m'
+}
+export -f set_colors
 # ------------------------------------------------------------------------------
 
 
@@ -179,5 +183,6 @@ export -f disp
 
 # Load disp section variables
 load_conf disp
+set_colors
 
 # EOF

profile.d/filefct.sh

@@ -41,8 +41,8 @@ expandlist()
 {
     local separator="${EXPANDLIST_DEFAULT_SEPARATOR:- }"
     local PARSED
-
     PARSED=$(getopt -o hs:n --long help,separator:,newline -n 'expandlist' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"expandlist --help\" to display usage."
         return 1
@@ -87,6 +87,7 @@ expandlist()
 
         # True glob expansion when wildcards are present.
         if [[ "$item" == *'*'* || "$item" == *'?'* || "$item" == *'['* ]]; then
+            # shellcheck disable=SC2206 # We actually want the word splitting
             expanded=( $item )
         else
             expanded=( "$item" )
@@ -127,7 +128,7 @@ clean()
     # Define short and long options
     local PARSED
     PARSED=$(getopt -o hrsf --long help,recurs,shell,force -n 'clean' -- "$@")
-
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"clean --help\" to display usage."
         return 1
@@ -215,10 +216,14 @@ mcd()
         disp E "Missing parameter. Use \"mcd --help\" to display usage."
         return 1
     fi
-    mkdir -pv "$1" && cd "$1" || {
-        printf "Failed create and/or change directory.\n"
+    if ! mkdir -pv "$1"; then
+        disp E "Failed to create directory \"$1\"."
         return 1
-    }
+    fi
+    if ! cd "$1"; then
+        disp E "Failed to change to directory \"$1\"."
+        return 1
+    fi
 }
 export -f mcd
 # ------------------------------------------------------------------------------
@@ -241,6 +246,7 @@ rmspc()
     local PARSED
 
     PARSED=$(getopt -o hr:c::vs --long help,recursive,subst-char::,verbose,shell -n 'rmspc' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"rmspc --help\" to display usage."
         return 1
@@ -359,7 +365,7 @@ file_stats()
     # Short: H, d, m, M, c, t, a, x:, X:
     # Long: human, details, average, median, count, total, all, ext:, ext-list:, min:, max:, help
     PARSED=$(getopt -o HdmMctax:X:h --long human,details,average,median,count,total,all,ext:,ext-list:,min:,max:,help -n 'file_stats' -- "$@")
-
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"file_stats --help\" to display usage."
         return 1
@@ -441,7 +447,6 @@ file_stats()
                 return 1
                 ;;
         esac
-        shift
     done
 
     [[ -n "$1" ]] && path="$1"
@@ -578,6 +583,7 @@ findbig()
 
     local PARSED
     PARSED=$(getopt -o hdl:x --long help,details,limit:,one-fs -n 'findbig' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"findbig --help\" to display usage."
         return 1
@@ -660,6 +666,7 @@ findzero()
     local PARSED
     # o: options, long: long equivalents
     PARSED=$(getopt -o hdx --long help,details,one-fs,delete -n 'findzero' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"findzero --help\" to display usage."
         return 1
@@ -733,6 +740,7 @@ finddead()
 
     local PARSED
     PARSED=$(getopt -o hdx --long help,details,one-fs,delete -n 'finddead' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"finddead --help\" to display usage."
         return 1

profile.d/fun.sh

@@ -48,6 +48,7 @@ busy()
     # Short: h, p:, d:
     # Long: help, pattern:, delay:
     PARSED=$(getopt -o hp:d: --long help,pattern:,delay: -n 'busy' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"busy --help\" to display usage."
         return 1
@@ -89,7 +90,8 @@ busy()
     done
 
     # Convert milliseconds to seconds for 'sleep'
-    local delay_s=$(awk "BEGIN{
+    local delay_s
+    delay_s=$(awk "BEGIN{
         printf \"%.3f\", $delay_ms / 1000 }")
 
     # Monitor /dev/urandom

profile.d/help.sh

@@ -39,45 +39,48 @@
 # Usage: help
 help()
 {
+    # shellcheck disable=SC2154 # color code in disp.sh
+    # shellcheck disable=SC2059 # printf format is a color variable
     printf "${BIWhite}Welcome to your profile! Here is a list of available commands:${DEFAULTCOL}\n\n"
+    printf "busy\t\tMonitor /dev/urandom for a hex pattern — look busy\n"
     printf "check_updates\tCheck for new versions of profile\n"
-    printf "clean\t\tErase backup files\n"
+    printf "clean\t\tErase backup files in given directories, optionally recursive\n"
     printf "disp\t\tDisplay formatted info/warning/error/debug messages\n"
-    printf "dwl\t\tDownload a URL to a local file\n"
-    printf "expandlist\tExpand and quote item lists\n"
+    printf "dwl\t\tDownload a URL using curl, wget, or fetch transparently\n"
+    printf "expandlist\tExpand glob expressions into a quoted, separated list\n"
     printf "file_stats\tDisplay file size statistics for a path\n"
-    printf "findbig\t\tFind biggest files in the given (or current) directory\n"
-    printf "finddead\tFind dead symbolic links in the given (or current) directory\n"
-    printf "findzero\tFind empty files in the given (or current) directory\n"
-    printf "genpwd\t\tGenerate secure passwords\n"
-    printf "gpid\t\tGive the list of PIDs for the given process name\n"
-    printf "isipv4\t\tTell if the given IPv4 is valid\n"
-    printf "isipv6\t\tTell if the given IPv6 is valid\n"
-    printf "ku\t\tKill process owned by users in parameter\n"
-    printf "matrix\t\tDisplay matrix-style digital rain\n"
-    printf "mcd\t\tCreate a directory and go inside\n"
-    printf "meteo\t\tDisplay current weather forecast for the configured city\n"
-    printf "myextip\tDisplay current external/public IP\n"
-    printf "pkgs\t\tSearch for the given package in installed ones\n"
-    printf "ppg\t\tDisplay process matching the given parameter\n"
-    printf "ppn\t\tDisplay process matching the exact process name given in parameter\n"
-    printf "ppu\t\tDisplay processes owned by the given user\n"
-    printf "profile_upgrade\tUpgrade profile to the latest version\n"
-    printf "pwdscore\tCalculate password strength score\n"
-    printf "rain\t\tLet the rain fall\n"
-    printf "rmhost\t\tRemove host (IP and/or DNS name) from current known_hosts\n"
-    printf "rmspc\t\tRemove spaces from file and directory names\n"
-    printf "setlocale\tSet console language to the current locale\n"
-    printf "   * setc\tSet console language to C\n"
-    printf "   * setfr\tSet console language to French\n"
-    printf "   * setus\tSet console language to US English\n"
-    printf "settrace\tActivate/deactivate call trace for script debugging\n"
-    printf "showinfo\tShow welcome banner with basic system information\n"
-    printf "ssr\t\tDo a root login to the given address\n"
-    printf "taz\t\tCompress smartly the given files or directory\n"
-    printf "urlencode\tURL-encode the given text\n"
-    printf "utaz\t\tUncompress archives in the given (or current) directory\n"
-    printf "ver\t\tDisplay version of your copy of profile\n\n"
+    printf "findbig\t\tFind the biggest files in the given or current directory\n"
+    printf "finddead\tFind dead symbolic links in the given or current directory\n"
+    printf "findzero\tFind empty files in the given or current directory\n"
+    printf "genpwd\t\tGenerate one or more random secure passwords with configurable constraints\n"
+    printf "gpid\t\tGive the list of PIDs matching the given process name(s)\n"
+    printf "isipv4\t\tTell if the given parameter is a valid IPv4 address\n"
+    printf "isipv6\t\tTell if the given parameter is a valid IPv6 address\n"
+    printf "ku\t\tKill all processes owned by the given user name or ID\n"
+    printf "matrix\t\tConsole screensaver with Matrix-style digital rain (binary, kana, ascii charset)\n"
+    printf "mcd\t\tCreate a directory and immediately move into it\n"
+    printf "meteo\t\tDisplay weather forecast for the configured or given city\n"
+    printf "myextip\t\tGet information about your public IP address\n"
+    printf "pkgs\t\tSearch for a pattern in installed package names (dpkg/rpm, supports -i)\n"
+    printf "ppg\t\tLook for the given pattern in running processes\n"
+    printf "ppn\t\tList processes matching an exact command name\n"
+    printf "ppu\t\tList processes owned by a specific user\n"
+    printf "profile_upgrade\tUpgrade profile to the latest version (git pull or archive)\n"
+    printf "pwdscore\tCalculate the strength score of a given password\n"
+    printf "rain\t\tConsole screensaver with falling-rain effect (multiple color themes)\n"
+    printf "rmhost\t\tRemove host (name and IP) from SSH known_hosts; supports --all-users as root\n"
+    printf "rmspc\t\tReplace spaces in filenames with underscores (or a custom character)\n"
+    printf "setlocale\tSet console locale to any installed locale\n"
+    printf "   * setc\tSet locale to standard C (POSIX)\n"
+    printf "   * set*\tLocale shortcuts generated from SET_LOCALE in profile.conf\n"
+    printf "settrace\tActivate or deactivate ERR trap to display backtrace on script errors\n"
+    printf "set_theme\tSwitch the prompt colour theme; no argument lists available themes\n"
+    printf "showinfo\tDisplay welcome banner and system information (figlet + neofetch/fastfetch)\n"
+    printf "ssr\t\tSSH into a server as root, forwarding extra ssh options\n"
+    printf "taz\t\tCompress files and directories into a chosen archive format\n"
+    printf "urlencode\tURL-encode a string\n"
+    printf "utaz\t\tSmartly uncompress archives (zip, tar.gz/bz2/xz/lz, rar, arj, lha, ace, 7z, zst, cpio, cab, deb, rpm)\n"
+    printf "ver\t\tDisplay the installed profile version\n\n"
 
     printf "\nPlease use <command> --help to obtain usage details.\n"
 }

profile.d/info.sh

@@ -42,6 +42,7 @@ ver()
     local PARSED
 
     PARSED=$(getopt -o h --long help -n 'ver' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"ver --help\" to display usage."
         return 1
@@ -82,6 +83,7 @@ meteo()
     local PARSED
 
     PARSED=$(getopt -o h --long help -n 'meteo' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"meteo --help\" to display usage."
         return 1
@@ -133,6 +135,7 @@ showinfo()
     local PARSED
 
     PARSED=$(getopt -o h --long help -n 'showinfo' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"showinfo --help\" to display usage."
         return 1

profile.d/lang.sh

@@ -51,6 +51,7 @@ setlocale()
 {
     local PARSED
     PARSED=$(getopt -o h --long help -n 'setlocale' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"setlocale --help\" to display usage."
         return 1

profile.d/net.sh

@@ -70,9 +70,32 @@ dwl()
     # Honour preferred tool from configuration; fall back to auto-detection.
     local preferred="${DWL_PREFERRED_TOOL:-}"
 
-    _try_curl()  { [ -z "$output" ] && curl -sL "$url" || curl -sL -o "$output" "$url"; }
-    _try_wget()  { [ -z "$output" ] && wget -qO- "$url" || wget -q -O "$output" "$url"; }
-    _try_fetch() { [ -z "$output" ] && fetch -o - "$url" || fetch -o "$output" "$url"; }
+    _try_curl()
+    {
+        if [[ -z "$output" ]]; then
+            curl -sL "$url"
+        else
+            curl -sL -o "$output" "$url"
+        fi
+    }
+
+    _try_wget()
+    {
+        if [[ -z "$output" ]]; then
+            wget -qO- "$url"
+        else
+            wget -q -O "$output" "$url"
+        fi
+    }
+
+    _try_fetch()
+    {
+        if [[ -z "$output" ]]; then
+            fetch -o - "$url"
+        else
+            fetch -o "$output" "$url"
+        fi
+    }
 
     if [[ -n "$preferred" ]]; then
         command -v "$preferred" >/dev/null 2>&1 || {

profile.d/packages.sh

@@ -34,15 +34,80 @@
 # * OF SUCH DAMAGE.
 # ------------------------------------------------------------------------------
 
+# ------------------------------------------------------------------------------
+# Detect the active package manager of the current distribution.
+# Detection is based on /etc/os-release (ID / ID_LIKE), then falls back to
+# checking available binaries in a fixed priority order.
+# Echoes one of: apt dnf yum zypper pacman apk portage xbps nix
+# Returns 1 if no known package manager could be identified.
+_get_pkgmgr()
+{
+    local distro_id="" distro_like=""
+    if [[ -r /etc/os-release ]]; then
+        # shellcheck disable=SC1091 
+        distro_id=$( . /etc/os-release 2>/dev/null; printf '%s' "${ID:-}" )
+        # shellcheck disable=SC1091
+        distro_like=$( . /etc/os-release 2>/dev/null; printf '%s' "${ID_LIKE:-}" )
+    fi
+
+    # Map distro IDs/families to a package manager.
+    # ID_LIKE is space-separated and may list multiple families.
+    local id
+    for id in $distro_id $distro_like; do
+        case "${id,,}" in
+            debian|ubuntu|linuxmint|raspbian|pop|kali|elementary|zorin|neon|parrot)
+                echo "apt"; return 0 ;;
+            fedora)
+                echo "dnf"; return 0 ;;
+            rhel|centos|rocky|almalinux|ol|scientific|amzn)
+                command -v dnf >/dev/null 2>&1 && { echo "dnf"; return 0; }
+                echo "yum"; return 0 ;;
+            opensuse*|sles|sled)
+                echo "zypper"; return 0 ;;
+            arch|manjaro|endeavouros|garuda|artix|cachyos)
+                echo "pacman"; return 0 ;;
+            alpine)
+                echo "apk"; return 0 ;;
+            gentoo)
+                echo "portage"; return 0 ;;
+            void)
+                echo "xbps"; return 0 ;;
+            nixos)
+                echo "nix"; return 0 ;;
+        esac
+    done
+
+    # Fallback: check for binaries in priority order.
+    local bin
+    for bin in apt-get dnf yum zypper pacman apk emerge xbps-install nix-env; do
+        command -v "$bin" >/dev/null 2>&1 && {
+            case "$bin" in
+                apt-get)      echo "apt"     ;;
+                emerge)       echo "portage" ;;
+                xbps-install) echo "xbps"    ;;
+                nix-env)      echo "nix"     ;;
+                *)            echo "$bin"    ;;
+            esac
+            return 0
+        }
+    done
+
+    return 1
+}
+export -f _get_pkgmgr
+# ------------------------------------------------------------------------------
+
+
 # ------------------------------------------------------------------------------
 # Look for a package within installed one
-# Usage: dpkgs <string>
+# Usage: pkgs <string>
 pkgs()
 {
     local ignore_case=${PKGS_DEFAULT_IGNORE_CASE:-0}
 
     local PARSED
     PARSED=$(getopt -o hi --long help,ignore-case -n 'pkgs' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"pkgs --help\" to display usage."
         return 1
@@ -84,13 +149,28 @@ pkgs()
     local grep_opt=""
     (( ignore_case )) && grep_opt="-i"
 
-    command -v dpkg >/dev/null 2>&1 && local cmd="dpkg -l"
-    command -v rpm >/dev/null 2>&1 && local cmd="rpm -qa"
-    if [[ -z $cmd ]]; then
-        disp E "No usable package manager seems unavialable."
+    local pkgmgr
+    pkgmgr=$(_get_pkgmgr) || {
+        disp E "No usable package manager could be detected on this system."
         return 2
-    fi
-    $cmd | grep $grep_opt $pkg
+    }
+
+    local -a list_cmd
+    case "$pkgmgr" in
+        apt) list_cmd=(dpkg-query -l) ;;
+        dnf|yum|zypper) list_cmd=(rpm -qa) ;;
+        pacman) list_cmd=(pacman -Q) ;;
+        apk) list_cmd=(apk list --installed) ;;
+        portage) list_cmd=(qlist -I) ;;
+        xbps) list_cmd=(xbps-query -l) ;;
+        nix) list_cmd=(nix-env -q) ;;
+        *)
+            disp E "Package manager '$pkgmgr' is not supported by pkgs."
+            return 2
+            ;;
+    esac
+
+    "${list_cmd[@]}" | grep ${grep_opt:+"$grep_opt"} "$pkg"
 }
 export -f pkgs
 # ------------------------------------------------------------------------------

profile.d/processes.sh

@@ -121,6 +121,7 @@ ppn()
     # -e: select all processes
     # -o: specify custom output columns (PID and Command name)
     # grep -w: ensures exact word matching so 'bash' doesn't match 'dbash'
+    # shellcheck disable=SC2009 # pgrep do not offer the -w switch
     ps -eo pid,comm | grep -w "$1"
 }
 export -f ppn
@@ -200,8 +201,7 @@ ku()
         disp E "Usage: ku <username1 [username2 ...]>"
         return 1
     fi
-    local users="$@"
-    for u in $users; do
+    for u in "$@"; do
         if ! id "$u" >/dev/null 2>&1; then
             disp E "User '$u' does not exist."
             return 1
@@ -227,7 +227,7 @@ kt()
         return 0
     fi
     if [[ -z "$1" ]]; then
-        disp E "Usage: ppg <string>"
+        disp E "Usage: kt <pid>"
         return 1
     fi
 
@@ -238,7 +238,8 @@ kt()
         return 1
     fi
 
-    local children_pids=$(pgrep -P "$parent_pid")
+    local children_pids
+    children_pids=$(pgrep -P "$parent_pid")
 
     for pid in $children_pids; do
         kt "$pid" "$@" || break

profile.d/prompt.sh

@@ -140,9 +140,14 @@ load_theme()
             continue
         fi
 
-        # Strip surrounding quotes
-        _lth_value="${_lth_value#\"}" ; _lth_value="${_lth_value%\"}"
-        _lth_value="${_lth_value#\'}" ; _lth_value="${_lth_value%\'}"
+        # Strip surrounding quotes (handles inline trailing comments like KEY="val" # note)
+        if [[ "$_lth_value" == '"'* ]]; then
+            _lth_value="${_lth_value#\"}"
+            _lth_value="${_lth_value%%\"*}"
+        elif [[ "$_lth_value" == "'"* ]]; then
+            _lth_value="${_lth_value#\'}"
+            _lth_value="${_lth_value%%\'*}"
+        fi
 
         if [[ "$_lth_value" =~ $_lth_ref_re ]]; then
             # Safe colour variable reference — resolve via indirection
@@ -159,6 +164,67 @@ load_theme()
         fi
     done < "$theme_file"
 }
+# Not exported, it remains private
+# ------------------------------------------------------------------------------
+
+
+# ------------------------------------------------------------------------------
+# Dynamically switch the prompt theme for the current shell session.
+# Calls load_theme to apply the new colour values immediately, then updates
+# PROMPT_THEME so subshells and the set_prompt fallback chain reflect the
+# change.  PROMPT_THEME_DIR is honoured when set.
+# Usage: set_theme [theme_name_or_path]
+#   With no argument (or -l / --list), lists available .theme files.
+set_theme()
+{
+    local theme_dir="${PROMPT_THEME_DIR:-${MYPATH}/profile.d/themes}"
+
+    # -- help mode -----------------------------------------------------------
+    if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+        printf "set_theme: Switch the prompt colour theme for the current shell session.\n\n"
+        printf "Usage: set_theme [options] [theme]\n\n"
+        printf "Options:\n"
+        printf "  -h, --help    Display this help screen\n"
+        printf "  -l, --list    List available themes (default when no argument is given)\n\n"
+        printf "Arguments:\n"
+        printf "  theme         Bare theme name (e.g. 'dark') or an explicit path to a .theme file.\n"
+        printf "                Themes are searched in: %s\n" "$theme_dir"
+        printf "                Override with PROMPT_THEME_DIR in profile.conf [prompt].\n\n"
+        printf "Examples:\n"
+        printf "  set_theme              — list available themes\n"
+        printf "  set_theme dark         — apply the dark theme\n"
+        printf "  set_theme ~/my.theme   — apply a theme by path\n"
+        return 0
+    fi
+
+    # -- list mode -----------------------------------------------------------
+    if [[ $# -eq 0 || "$1" == "-l" || "$1" == "--list" ]]; then
+        printf "Available themes in %s:\n" "$theme_dir"
+        local f name
+        for f in "$theme_dir"/*.theme; do
+            [[ -f "$f" ]] || continue
+            name="${f##*/}"
+            name="${name%.theme}"
+            if [[ "$name" == "${PROMPT_THEME:-}" ]]; then
+                printf "  * %s (active)\n" "$name"
+            else
+                printf "    %s\n" "$name"
+            fi
+        done
+        return 0
+    fi
+
+    # -- apply mode ----------------------------------------------------------
+    local theme_name="$1"
+
+    # Reset colours to defaults before loading the new theme
+    set_colors
+    load_theme "$theme_name" || return 1
+
+    export PROMPT_THEME="$theme_name"
+    disp I "Prompt theme set to $theme_name."
+}
+export -f set_theme
 # ------------------------------------------------------------------------------
 
 
@@ -186,7 +252,7 @@ function timer_start
 # into a human-readable string with appropriate units (us, ms, s, m, h
 function timer_stop
 {
-    local delta_us=$((($(timer_now) - $timer_start) / 1000))
+    local delta_us=$((($(timer_now) - timer_start) / 1000))
     local us=$((delta_us % 1000))
     local ms=$(((delta_us / 1000) % 1000))
     local s=$(((delta_us / 1000000) % 60))
@@ -225,43 +291,48 @@ set_prompt()
 
     # Resolve theme/config colours with hardcoded fallbacks
     local _time_fg="${PROMPT_COLOR_TIME_FG:-$Blue}"
-    local _time_bg="${PROMPT_COLOR_TIME_BG:-$On_IBlack}"
+    local _time_bg="${PROMPT_COLOR_TIME_BG:-$On_White}"
     local _bar_bg="${PROMPT_COLOR_BAR_BG:-$On_Blue}"
-    local _ok_fg="${PROMPT_COLOR_OK_FG:-$White}"
-    local _ok_mark="${PROMPT_COLOR_OK_MARK:-$Green}"
+    local _ok_fg="${PROMPT_COLOR_OK_FG:-$BWhite}"
+    local _ok_mark="${PROMPT_COLOR_OK_MARK:-$BGreen}"
     local _err_bg="${PROMPT_COLOR_ERR_BG:-$On_Red}"
     local _err_fg="${PROMPT_COLOR_ERR_FG:-$White}"
     local _err_mark="${PROMPT_COLOR_ERR_MARK:-$BYellow}"
     local _root_fg="${PROMPT_COLOR_ROOT_FG:-$Red}"
-    local _user_fg="${PROMPT_COLOR_USER_FG:-$Green}"
+    local _user_fg="${PROMPT_COLOR_USER_FG:-$BGreen}"
     local _dir_fg="${PROMPT_COLOR_DIR_FG:-$ICyan}"
 
-    # Begin with time
-    PS1="\[\e[s${_time_fg}${_time_bg} [ \t ] ${_bar_bg}"
+    # Begin with time (cursor-save is non-printing; all ANSI sequences wrapped
+    # in \[...\] so bash does not count them toward the visible line width).
+    # Every fg colour is combined with its section bg in the same \[...\] block
+    # so that even "reset" colours (0;Xm) cannot strip the background.
+    PS1="\[\e[s\]\[${_time_fg}${_time_bg}\] [ \t ] \[${_bar_bg}\]"
 
     # Add exit status of the last command.
     # If it was successful, print a green check mark. Otherwise, print a red X.
     if [[ $Last_Command == 0 ]]; then
-        PS1+="${_ok_fg}${_bar_bg} [ \$Last_Command "
-        PS1+="${_ok_mark}${Checkmark} "
+        PS1+="\[${_ok_fg}${_bar_bg}\] [ $Last_Command "
+        PS1+="\[${_ok_mark}${_bar_bg}\]${Checkmark} "
+        # Add the elapsed time, then close the status section and return to bar bg.
+        timer_stop
+        PS1+="($timer_show)\[${_ok_fg}${_bar_bg}\] ] "
     else
-        PS1+="${_err_fg}${_err_bg} [ \$Last_Command "
-        PS1+="${_err_mark}${FancyX} "
+        PS1+="\[${_err_fg}${_err_bg}\] [ $Last_Command "
+        PS1+="\[${_err_mark}${_err_bg}\]${FancyX} "
+        timer_stop
+        PS1+="($timer_show)\[${_err_fg}${_err_bg}\] ] "
     fi
 
-    # Add the elapsed time
-    timer_stop
-    PS1+="($timer_show)${_ok_fg} ] ${_bar_bg} "
 
     # If root, print the host in root colour. Otherwise use user colour.
     if [[ $EUID -eq 0 ]]; then
-        PS1+="${_root_fg}\\u${_user_fg}@\\h"
+        PS1+="\[${_root_fg}${_bar_bg}\] \\u\[${_user_fg}${_bar_bg}\]@\\h"
     else
-        PS1+="${_user_fg}\\u@\\h"
+        PS1+="\[${_user_fg}${_bar_bg}\] \\u@\\h"
     fi
-    PS1+="\e[K\e[u$DEFAULTCOL\n"
+    PS1+="\[\e[K\e[u\]\[$RESETCOL\]\n"
     # Print the working directory and prompt marker, then reset colour.
-    PS1+="${_dir_fg}\\w \\\$$DEFAULTCOL "
+    PS1+="\[${_dir_fg}\]\\w \\\$\[$RESETCOL\] "
 }
 # ------------------------------------------------------------------------------
 

profile.d/pwd.sh

@@ -65,6 +65,7 @@ genpwd()
     PARSED=$(getopt -o hsnule:L:o: --long \
         help,nosymbols,nonumbers,noup,nolow,extracars:,length:,occurences:,occurrences: \
         -n 'genpwd' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then return 1; fi
     eval set -- "$PARSED"
 

profile.d/ssh.sh

@@ -44,6 +44,7 @@ rmhost()
     local -a known_hosts_files=()
 
     PARSED=$(getopt -o ha --long help,all-users -n 'rmhost' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then return 1; fi
     eval set -- "$PARSED"
 
@@ -194,6 +195,7 @@ ssr()
         ssh_default_opts=(-Y)
     fi
 
+    # shellcheck disable=SC2029
     ssh "${ssh_default_opts[@]}" root@"$srv" "$@"
 }
 export -f ssr

profile.d/themes/abyss.theme

@@ -1,42 +1,42 @@
-# Abyss prompt theme — deep ocean navy, electric teal, golden accents
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Inspired by the VS Code "Abyss" theme: deep navy/black backdrop, electric
-# teal highlights, golden-yellow accents, cool electric blue for identifiers.
-# Palette overrides shift the cooler hues to their high-intensity (electric)
-# equivalents — blue becomes IBlue, green shifts toward teal (ICyan).
-# ------------------------------------------------------------------------------
-
-# Palette overrides — shift colours toward cool electric hues
-Blue="\e[0;94m"         # electric blue  (IBlue — abyss identifier colour)
-Green="\e[0;96m"        # teal           (ICyan — abyss string colour)
-Yellow="\e[0;93m"       # bright gold    (IYellow — abyss constant colour)
-
-PROMPT_COLOR_TIME_FG="$ICyan"        # electric teal clock
-PROMPT_COLOR_TIME_BG="$On_Black"     # deep black background
-PROMPT_COLOR_BAR_BG="$On_Blue"       # deep blue bar
-
-PROMPT_COLOR_OK_FG="$ICyan"          # teal on success
-PROMPT_COLOR_OK_MARK="$IGreen"       # bright teal-green checkmark
-
-PROMPT_COLOR_ERR_BG="$On_Red"        # red background on failure
-PROMPT_COLOR_ERR_FG="$IWhite"        # bright white text
-PROMPT_COLOR_ERR_MARK="$IYellow"     # golden X
-
-PROMPT_COLOR_ROOT_FG="$IRed"         # red for root
-PROMPT_COLOR_USER_FG="$IBlue"        # electric blue for user
-PROMPT_COLOR_DIR_FG="$ICyan"         # teal path
+# Abyss prompt theme — deep ocean navy, electric teal, golden accents
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Inspired by the VS Code "Abyss" theme: deep navy/black backdrop, electric
+# teal highlights, golden-yellow accents, cool electric blue for identifiers.
+# Palette overrides shift the cooler hues to their high-intensity (electric)
+# equivalents — blue becomes IBlue, green shifts toward teal (ICyan).
+# ------------------------------------------------------------------------------
+
+# Palette overrides — shift colours toward cool electric hues
+Blue="\e[0;94m"         # electric blue  (IBlue — abyss identifier colour)
+Green="\e[0;96m"        # teal           (ICyan — abyss string colour)
+Yellow="\e[0;93m"       # bright gold    (IYellow — abyss constant colour)
+
+PROMPT_COLOR_TIME_FG="$ICyan"            # electric teal clock
+PROMPT_COLOR_TIME_BG="\e[48;2;0;60;70m"  # very dark cyan bg for time
+PROMPT_COLOR_BAR_BG="\e[48;2;0;30;70m"   # deep navy bar (24-bit)
+
+PROMPT_COLOR_OK_FG="$ICyan"          # teal on success
+PROMPT_COLOR_OK_MARK="$IGreen"       # bright teal-green checkmark
+
+PROMPT_COLOR_ERR_BG="\e[48;2;180;20;20m"  # vivid crimson background (24-bit)
+PROMPT_COLOR_ERR_FG="\e[1;97m"            # bold bright white — maximum contrast
+PROMPT_COLOR_ERR_MARK="$IYellow"          # golden X
+
+PROMPT_COLOR_ROOT_FG="$IRed"         # red for root
+PROMPT_COLOR_USER_FG="$IBlue"        # electric blue for user
+PROMPT_COLOR_DIR_FG="$ICyan"         # teal path

profile.d/themes/adwaita.theme

@@ -1,42 +1,42 @@
-# Adwaita prompt theme — clean GNOME defaults, blue accent, green/red status
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Follows the GNOME HIG colour intent: a single calm blue accent (#3584e4),
-# pleasant green for success (#33d17a), clear red for errors (#e01b24).
-# No intense saturation, no heavy remapping — legibility over spectacle.
-# Palette overrides gently shift Blue and Green to their IBlue/IGreen
-# variants to better match Adwaita's brighter, flatter tones.
-# ------------------------------------------------------------------------------
-
-# Palette overrides — align to Adwaita's brighter accent tones
-Blue="\e[0;94m"         # IBlue  → closer to Adwaita blue  (#3584e4)
-Green="\e[0;92m"        # IGreen → closer to Adwaita green (#33d17a)
-
-PROMPT_COLOR_TIME_FG="$Cyan"         # calm cyan clock text
-PROMPT_COLOR_TIME_BG="$On_IBlack"    # dark grey clock background
-PROMPT_COLOR_BAR_BG="$On_Blue"       # blue main bar (Adwaita accent)
-
-PROMPT_COLOR_OK_FG="$White"          # clean white on success
-PROMPT_COLOR_OK_MARK="$Green"        # Adwaita green checkmark
-
-PROMPT_COLOR_ERR_BG="$On_Red"        # Adwaita red on failure
-PROMPT_COLOR_ERR_FG="$White"         # white text
-PROMPT_COLOR_ERR_MARK="$Yellow"      # yellow X (warning intent)
-
-PROMPT_COLOR_ROOT_FG="$Red"          # Adwaita red for root
-PROMPT_COLOR_USER_FG="$IBlue"        # Adwaita blue for user
-PROMPT_COLOR_DIR_FG="$IGreen"        # Adwaita green for path
+# Adwaita prompt theme — clean GNOME defaults, blue accent, green/red status
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Follows the GNOME HIG colour intent: a single calm blue accent (#3584e4),
+# pleasant green for success (#33d17a), clear red for errors (#e01b24).
+# No intense saturation, no heavy remapping — legibility over spectacle.
+# Palette overrides gently shift Blue and Green to their IBlue/IGreen
+# variants to better match Adwaita's brighter, flatter tones.
+# ------------------------------------------------------------------------------
+
+# Palette overrides — align to Adwaita's brighter accent tones
+Blue="\e[0;94m"         # IBlue  → closer to Adwaita blue  (#3584e4)
+Green="\e[0;92m"        # IGreen → closer to Adwaita green (#33d17a)
+
+PROMPT_COLOR_TIME_FG="$Cyan"         # calm cyan clock text
+PROMPT_COLOR_TIME_BG="$On_IBlack"    # dark grey clock background
+PROMPT_COLOR_BAR_BG="$On_Blue"       # blue main bar (Adwaita accent)
+
+PROMPT_COLOR_OK_FG="$White"          # clean white on success
+PROMPT_COLOR_OK_MARK="$Green"        # Adwaita green checkmark
+
+PROMPT_COLOR_ERR_BG="$On_Red"        # Adwaita red on failure
+PROMPT_COLOR_ERR_FG="$BIWhite"       # bold bright white for maximum legibility
+PROMPT_COLOR_ERR_MARK="$Yellow"      # yellow X (warning intent)
+
+PROMPT_COLOR_ROOT_FG="$Red"          # Adwaita red for root
+PROMPT_COLOR_USER_FG="$BBlue"        # darker bold blue — readable on blue bar
+PROMPT_COLOR_DIR_FG="$IGreen"        # Adwaita green for path

profile.d/themes/dark.theme

@@ -1,32 +1,32 @@
-# Dark prompt theme — dark grey bar, cyan user, magenta path
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-
-PROMPT_COLOR_TIME_FG="$ICyan"       # Clock text
-PROMPT_COLOR_TIME_BG="$On_Black"    # Clock background (black)
-PROMPT_COLOR_BAR_BG="$On_IBlack"   # Main bar background (dark grey)
-
-PROMPT_COLOR_OK_FG="$IGreen"        # Exit-code text on success
-PROMPT_COLOR_OK_MARK="$BGreen"      # Checkmark colour on success
-
-PROMPT_COLOR_ERR_BG="$On_Red"       # Exit-code background on failure
-PROMPT_COLOR_ERR_FG="$BIWhite"      # Exit-code text on failure
-PROMPT_COLOR_ERR_MARK="$BIYellow"   # X mark colour on failure
-
-PROMPT_COLOR_ROOT_FG="$BIRed"       # Username colour when root
-PROMPT_COLOR_USER_FG="$ICyan"       # Username@host colour for normal users
-PROMPT_COLOR_DIR_FG="$IPurple"      # Working directory colour
+# Dark prompt theme — dark grey bar, cyan user, magenta path
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+
+PROMPT_COLOR_TIME_FG="$ICyan"       # Clock text
+PROMPT_COLOR_TIME_BG="$On_IBlack"   # Clock background (black)
+PROMPT_COLOR_BAR_BG="$On_Black"     # Main bar background (dark grey)
+
+PROMPT_COLOR_OK_FG="$IGreen"        # Exit-code text on success
+PROMPT_COLOR_OK_MARK="$BGreen"      # Checkmark colour on success
+
+PROMPT_COLOR_ERR_BG="$On_Red"       # Exit-code background on failure
+PROMPT_COLOR_ERR_FG="$BIWhite"      # Exit-code text on failure
+PROMPT_COLOR_ERR_MARK="$BIYellow"   # X mark colour on failure
+
+PROMPT_COLOR_ROOT_FG="$BIRed"       # Username colour when root
+PROMPT_COLOR_USER_FG="$ICyan"       # Username@host colour for normal users
+PROMPT_COLOR_DIR_FG="$IPurple"      # Working directory colour

profile.d/themes/default.theme

@@ -1,32 +1,32 @@
-# Default prompt theme — blue bar, green user, cyan path
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-
-PROMPT_COLOR_TIME_FG="$Blue"        # Clock text
-PROMPT_COLOR_TIME_BG="$On_IBlack"   # Clock background (dark grey)
-PROMPT_COLOR_BAR_BG="$On_Blue"      # Main bar background
-
-PROMPT_COLOR_OK_FG="$White"         # Exit-code text on success
-PROMPT_COLOR_OK_MARK="$Green"       # Checkmark colour on success
-
-PROMPT_COLOR_ERR_BG="$On_Red"       # Exit-code background on failure
-PROMPT_COLOR_ERR_FG="$White"        # Exit-code text on failure
-PROMPT_COLOR_ERR_MARK="$BYellow"    # X mark colour on failure
-
-PROMPT_COLOR_ROOT_FG="$Red"         # Username colour when root
-PROMPT_COLOR_USER_FG="$Green"       # Username@host colour for normal users
-PROMPT_COLOR_DIR_FG="$ICyan"        # Working directory colour
+# Default prompt theme — blue bar, green user, cyan path
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+
+PROMPT_COLOR_TIME_FG="$Blue"        # Clock text
+PROMPT_COLOR_TIME_BG="$On_White"    # Clock background (dark grey)
+PROMPT_COLOR_BAR_BG="$On_Blue"      # Main bar background
+
+PROMPT_COLOR_OK_FG="$White"         # Exit-code text on success
+PROMPT_COLOR_OK_MARK="$Green"       # Checkmark colour on success
+
+PROMPT_COLOR_ERR_BG="$On_Red"       # Exit-code background on failure
+PROMPT_COLOR_ERR_FG="$White"        # Exit-code text on failure
+PROMPT_COLOR_ERR_MARK="$BYellow"    # X mark colour on failure
+
+PROMPT_COLOR_ROOT_FG="$Red"         # Username colour when root
+PROMPT_COLOR_USER_FG="$Green"       # Username@host colour for normal users
+PROMPT_COLOR_DIR_FG="$ICyan"        # Working directory colour

profile.d/themes/light.theme

@@ -1,35 +1,35 @@
-# Light prompt theme — white bar, blue user, purple path
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Opposite of dark.theme: backgrounds flip to bright whites, foregrounds
-# shift to their dark/regular equivalents for contrast on a light terminal.
-# ------------------------------------------------------------------------------
-
-PROMPT_COLOR_TIME_FG="$Blue"        # Clock text      (ICyan  → Blue,   darker for light bg)
-PROMPT_COLOR_TIME_BG="$On_IWhite"   # Clock background (On_Black → On_IWhite)
-PROMPT_COLOR_BAR_BG="$On_White"     # Main bar background (On_IBlack → On_White)
-
-PROMPT_COLOR_OK_FG="$Green"         # Exit-code text on success  (IGreen → Green)
-PROMPT_COLOR_OK_MARK="$BGreen"      # Checkmark colour on success (unchanged — bold green reads on both)
-
-PROMPT_COLOR_ERR_BG="$On_Red"       # Exit-code background on failure (unchanged)
-PROMPT_COLOR_ERR_FG="$BIWhite"      # Exit-code text on failure (unchanged — white on red works on both)
-PROMPT_COLOR_ERR_MARK="$BYellow"    # X mark on failure (BIYellow → BYellow, less glaring on light)
-
-PROMPT_COLOR_ROOT_FG="$Red"         # Username when root         (BIRed → Red)
-PROMPT_COLOR_USER_FG="$Blue"        # Username@host normal user  (ICyan → Blue)
-PROMPT_COLOR_DIR_FG="$Purple"       # Working directory          (IPurple → Purple)
+# Light prompt theme — white bar, blue user, purple path
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Opposite of dark.theme: backgrounds flip to bright whites, foregrounds
+# shift to their dark/regular equivalents for contrast on a light terminal.
+# ------------------------------------------------------------------------------
+
+PROMPT_COLOR_TIME_FG="$BBlack"      # Clock text      (bold black — forces true black on terminals that render Black as dark grey)
+PROMPT_COLOR_TIME_BG="$On_IWhite"   # Clock background (On_Black → On_IWhite)
+PROMPT_COLOR_BAR_BG="$On_White"     # Main bar background (On_IBlack → On_White)
+
+PROMPT_COLOR_OK_FG="$Green"         # Exit-code text on success  (IGreen → Green)
+PROMPT_COLOR_OK_MARK="$BGreen"      # Checkmark colour on success (unchanged — bold green reads on both)
+
+PROMPT_COLOR_ERR_BG="$On_Red"       # Exit-code background on failure (unchanged)
+PROMPT_COLOR_ERR_FG="$BIWhite"      # Exit-code text on failure (unchanged — white on red works on both)
+PROMPT_COLOR_ERR_MARK="$BYellow"    # X mark on failure (BIYellow → BYellow, less glaring on light)
+
+PROMPT_COLOR_ROOT_FG="$Red"         # Username when root         (BIRed → Red)
+PROMPT_COLOR_USER_FG="$Blue"        # Username@host normal user  (ICyan → Blue)
+PROMPT_COLOR_DIR_FG="$Purple"       # Working directory          (IPurple → Purple)

profile.d/themes/monochrome.theme

@@ -1,64 +1,64 @@
-# Monochrome prompt theme — strict greyscale, no hue at all
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# All hues are silenced — colour variables are remapped to greyscale ANSI
-# codes so that ls, man, grep, etc. also lose their colour cues. Contrast
-# is achieved entirely through brightness: dark grey / light grey / white.
-# Error state uses an inverted (white background, black text) bar so it
-# remains visually distinct without relying on red.
-# ------------------------------------------------------------------------------
-
-# Palette overrides — replace every hue with a grey equivalent
-Red="\e[0;37m"          # light grey
-Green="\e[0;97m"        # bright white (success intent kept as brightest)
-Yellow="\e[0;90m"       # dark grey
-Blue="\e[0;90m"         # dark grey
-Purple="\e[0;37m"       # light grey
-Cyan="\e[0;37m"         # light grey
-BRed="\e[1;37m"         # bold light grey
-BGreen="\e[1;97m"       # bold bright white
-BYellow="\e[1;90m"      # bold dark grey
-BBlue="\e[1;90m"        # bold dark grey
-BPurple="\e[1;37m"      # bold light grey
-BCyan="\e[1;37m"        # bold light grey
-IRed="\e[0;97m"         # bright white
-IGreen="\e[0;97m"       # bright white
-IYellow="\e[0;90m"      # dark grey
-IBlue="\e[0;90m"        # dark grey
-IPurple="\e[0;37m"      # light grey
-ICyan="\e[0;37m"        # light grey
-BIRed="\e[1;97m"        # bold bright white
-BIGreen="\e[1;97m"      # bold bright white
-BIYellow="\e[1;90m"     # bold dark grey
-BIBlue="\e[1;90m"       # bold dark grey
-BIPurple="\e[1;37m"     # bold light grey
-BICyan="\e[1;37m"       # bold light grey
-
-PROMPT_COLOR_TIME_FG="$IBlack"       # dark grey clock text (subtle)
-PROMPT_COLOR_TIME_BG="$On_IBlack"    # dark grey clock background
-PROMPT_COLOR_BAR_BG="$On_IBlack"     # dark grey main bar
-
-PROMPT_COLOR_OK_FG="$IWhite"         # bright white on success
-PROMPT_COLOR_OK_MARK="$BIWhite"      # bold bright white checkmark
-
-PROMPT_COLOR_ERR_BG="$On_White"      # inverted: bright white bar on error
-PROMPT_COLOR_ERR_FG="$Black"         # black text on white background
-PROMPT_COLOR_ERR_MARK="$BBlack"      # bold black X
-
-PROMPT_COLOR_ROOT_FG="$BIWhite"      # bold bright white for root warning
-PROMPT_COLOR_USER_FG="$IWhite"       # bright white for normal user
-PROMPT_COLOR_DIR_FG="$White"         # standard white for path
+# Monochrome prompt theme — strict greyscale, no hue at all
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# All hues are silenced — colour variables are remapped to greyscale ANSI
+# codes so that ls, man, grep, etc. also lose their colour cues. Contrast
+# is achieved entirely through brightness: dark grey / light grey / white.
+# Error state uses an inverted (white background, black text) bar so it
+# remains visually distinct without relying on red.
+# ------------------------------------------------------------------------------
+
+# Palette overrides — replace every hue with a grey equivalent
+Red="\e[0;37m"          # light grey
+Green="\e[0;97m"        # bright white (success intent kept as brightest)
+Yellow="\e[0;90m"       # dark grey
+Blue="\e[0;90m"         # dark grey
+Purple="\e[0;37m"       # light grey
+Cyan="\e[0;37m"         # light grey
+BRed="\e[1;37m"         # bold light grey
+BGreen="\e[1;97m"       # bold bright white
+BYellow="\e[1;90m"      # bold dark grey
+BBlue="\e[1;90m"        # bold dark grey
+BPurple="\e[1;37m"      # bold light grey
+BCyan="\e[1;37m"        # bold light grey
+IRed="\e[0;97m"         # bright white
+IGreen="\e[0;97m"       # bright white
+IYellow="\e[0;90m"      # dark grey
+IBlue="\e[0;90m"        # dark grey
+IPurple="\e[0;37m"      # light grey
+ICyan="\e[0;37m"        # light grey
+BIRed="\e[1;97m"        # bold bright white
+BIGreen="\e[1;97m"      # bold bright white
+BIYellow="\e[1;90m"     # bold dark grey
+BIBlue="\e[1;90m"       # bold dark grey
+BIPurple="\e[1;37m"     # bold light grey
+BICyan="\e[1;37m"       # bold light grey
+
+PROMPT_COLOR_TIME_FG="$IBlack"       # dark grey clock text (subtle)
+PROMPT_COLOR_TIME_BG="$On_IBlack"    # dark grey clock background
+PROMPT_COLOR_BAR_BG="$On_IBlack"     # dark grey main bar
+
+PROMPT_COLOR_OK_FG="$IWhite"         # bright white on success
+PROMPT_COLOR_OK_MARK="$BIWhite"      # bold bright white checkmark
+
+PROMPT_COLOR_ERR_BG="$On_White"      # inverted: bright white bar on error
+PROMPT_COLOR_ERR_FG="$Black"         # black text on white background
+PROMPT_COLOR_ERR_MARK="$BBlack"      # bold black X
+
+PROMPT_COLOR_ROOT_FG="$BIWhite"      # bold bright white for root warning
+PROMPT_COLOR_USER_FG="$IWhite"       # bright white for normal user
+PROMPT_COLOR_DIR_FG="$White"         # standard white for path

profile.d/themes/monokai.theme

@@ -1,45 +1,45 @@
-# Monokai prompt theme — high-saturation, vivid hues on near-black
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Monokai's signature: lime green, orange-yellow, hot pink/red, bright violet,
-# electric cyan — all on a near-black (#272822) background.
-# Palette overrides remap the dim ANSI regulars to their vivid high-intensity
-# equivalents so that ls, grep colour output, etc. also look more "Monokai".
-# ------------------------------------------------------------------------------
-
-# Palette overrides — boost regular colours to Monokai-vivid equivalents
-Red="\e[0;91m"          # hot pink/red   (#F92672)
-Green="\e[0;92m"        # lime green     (#A6E22E)
-Yellow="\e[0;93m"       # orange-yellow  (#E6DB74 / #FD971F)
-Blue="\e[0;94m"         # electric blue  (#66D9E8 → shift blue)
-Purple="\e[0;95m"       # bright violet  (#AE81FF)
-Cyan="\e[0;96m"         # electric cyan  (#66D9E8)
-
-PROMPT_COLOR_TIME_FG="$IYellow"      # orange clock text
-PROMPT_COLOR_TIME_BG="$On_IBlack"    # near-black Monokai background
-PROMPT_COLOR_BAR_BG="$On_IBlack"     # flat dark bar
-
-PROMPT_COLOR_OK_FG="$IGreen"         # lime green on success
-PROMPT_COLOR_OK_MARK="$IGreen"       # lime green checkmark
-
-PROMPT_COLOR_ERR_BG="$On_IBlack"     # keep dark — use colour for contrast
-PROMPT_COLOR_ERR_FG="$IRed"          # hot pink on failure
-PROMPT_COLOR_ERR_MARK="$IRed"        # hot pink X
-
-PROMPT_COLOR_ROOT_FG="$IRed"         # hot pink for root
-PROMPT_COLOR_USER_FG="$IYellow"      # orange-yellow for user
-PROMPT_COLOR_DIR_FG="$ICyan"         # electric cyan for path
+# Monokai prompt theme — high-saturation, vivid hues on near-black
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Monokai's signature: lime green, orange-yellow, hot pink/red, bright violet,
+# electric cyan — all on a near-black (#272822) background.
+# Palette overrides remap the dim ANSI regulars to their vivid high-intensity
+# equivalents so that ls, grep colour output, etc. also look more "Monokai".
+# ------------------------------------------------------------------------------
+
+# Palette overrides — boost regular colours to Monokai-vivid equivalents
+Red="\e[0;91m"          # hot pink/red   (#F92672)
+Green="\e[0;92m"        # lime green     (#A6E22E)
+Yellow="\e[0;93m"       # orange-yellow  (#E6DB74 / #FD971F)
+Blue="\e[0;94m"         # electric blue  (#66D9E8 → shift blue)
+Purple="\e[0;95m"       # bright violet  (#AE81FF)
+Cyan="\e[0;96m"         # electric cyan  (#66D9E8)
+
+PROMPT_COLOR_TIME_FG="$IYellow"      # orange clock text
+PROMPT_COLOR_TIME_BG="$On_IBlack"    # near-black Monokai background
+PROMPT_COLOR_BAR_BG="$On_IBlack"     # flat dark bar
+
+PROMPT_COLOR_OK_FG="$IGreen"         # lime green on success
+PROMPT_COLOR_OK_MARK="$IGreen"       # lime green checkmark
+
+PROMPT_COLOR_ERR_BG="$On_IBlack"     # keep dark — use colour for contrast
+PROMPT_COLOR_ERR_FG="$IRed"          # hot pink on failure
+PROMPT_COLOR_ERR_MARK="$IRed"        # hot pink X
+
+PROMPT_COLOR_ROOT_FG="$IRed"         # hot pink for root
+PROMPT_COLOR_USER_FG="$IYellow"      # orange-yellow for user
+PROMPT_COLOR_DIR_FG="$ICyan"         # electric cyan for path

profile.d/themes/plasma.theme

@@ -1,42 +1,42 @@
-# Plasma prompt theme — vivid KDE Plasma purples and electric cyan
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Captures the charged, vivid energy of KDE Plasma: dominant bright magenta/
-# purple, electric cyan highlights, all on a dark background. Palette overrides
-# boost Blue, Purple, and Cyan to their high-intensity equivalents so that
-# shell colour output reflects the same vivid palette.
-# ------------------------------------------------------------------------------
-
-# Palette overrides — vivid charged hues
-Blue="\e[0;94m"         # electric blue  (IBlue)
-Purple="\e[0;95m"       # vivid magenta  (IPurple — Plasma's signature colour)
-Cyan="\e[0;96m"         # electric cyan  (ICyan)
-
-PROMPT_COLOR_TIME_FG="$IPurple"      # vivid purple clock text
-PROMPT_COLOR_TIME_BG="$On_IBlack"    # dark grey background
-PROMPT_COLOR_BAR_BG="$On_Purple"     # bright magenta bar
-
-PROMPT_COLOR_OK_FG="$ICyan"          # electric cyan on success
-PROMPT_COLOR_OK_MARK="$IGreen"       # green checkmark
-
-PROMPT_COLOR_ERR_BG="$On_Red"        # red bar on failure
-PROMPT_COLOR_ERR_FG="$IWhite"        # bright white text
-PROMPT_COLOR_ERR_MARK="$IYellow"     # yellow X
-
-PROMPT_COLOR_ROOT_FG="$IRed"         # red for root
-PROMPT_COLOR_USER_FG="$BIPurple"     # bold vivid purple for user
-PROMPT_COLOR_DIR_FG="$ICyan"         # electric cyan path
+# Plasma prompt theme — vivid KDE Plasma purples and electric cyan
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Captures the charged, vivid energy of KDE Plasma: dominant bright magenta/
+# purple, electric cyan highlights, all on a dark background. Palette overrides
+# boost Blue, Purple, and Cyan to their high-intensity equivalents so that
+# shell colour output reflects the same vivid palette.
+# ------------------------------------------------------------------------------
+
+# Palette overrides — vivid charged hues
+Blue="\e[0;94m"         # electric blue  (IBlue)
+Purple="\e[0;95m"       # vivid magenta  (IPurple — Plasma's signature colour)
+Cyan="\e[0;96m"         # electric cyan  (ICyan)
+
+PROMPT_COLOR_TIME_FG="$BIPurple"             # vivid purple clock text
+PROMPT_COLOR_TIME_BG="\e[48;2;50;50;55m"    # deep charcoal (darker than On_IBlack)
+PROMPT_COLOR_BAR_BG="\e[48;2;75;0;130m"     # deep indigo-purple (24-bit) — darker than On_Purple
+
+PROMPT_COLOR_OK_FG="$ICyan"          # electric cyan on success
+PROMPT_COLOR_OK_MARK="$IGreen"       # green checkmark
+
+PROMPT_COLOR_ERR_BG="$On_Red"        # red bar on failure
+PROMPT_COLOR_ERR_FG="$IWhite"        # bright white text
+PROMPT_COLOR_ERR_MARK="$IYellow"     # yellow X
+
+PROMPT_COLOR_ROOT_FG="$IRed"         # red for root
+PROMPT_COLOR_USER_FG="$BIPurple"     # bold vivid purple for user
+PROMPT_COLOR_DIR_FG="$ICyan"         # electric cyan path

profile.d/themes/solarized-light.theme

@@ -1,127 +1,127 @@
-# Solarized Light prompt theme — exact 24-bit / true-colour palette
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Requires a terminal with true-colour / 24-bit support.
-# Check with:  printf '\e[38;2;220;50;47mred\e[0m\n'
-# If you see solid red text, your terminal supports this theme.
-# (konsole, iTerm2, kitty, alacritty, Windows Terminal all do)
-#
-# Solarized Light base tones (inverted vs Dark):
-#   Base3   #fdf6e3  →253 246 227   (main background — lightest)
-#   Base2   #eee8d5  →238 232 213   (background highlights)
-#   Base1   #93a1a1  →147 161 161   (comments / secondary content)
-#   Base0   #839496  →131 148 150   (body text — secondary)
-#   Base00  #657b83  →101 123 131   (body text — main on light bg)
-#   Base01  #586e75  → 88 110 117   (emphasis)
-#   Base02  #073642  →  7  54  66   (darkest — used for strong contrast)
-#
-# Accent colours are identical to Solarized Dark:
-#   Yellow  #b58900  →181 137   0
-#   Orange  #cb4b16  →203  75  22
-#   Red     #dc322f  →220  50  47
-#   Magenta #d33682  →211  54 130
-#   Violet  #6c71c4  →108 113 196
-#   Blue    #268bd2  → 38 139 210
-#   Cyan    #2aa198  → 42 161 152
-#   Green   #859900  →133 153   0
-# ------------------------------------------------------------------------------
-
-# ---- Foreground palette overrides -------------------------------------------
-# The accent fg colours are identical to Dark — only the base/neutral roles flip.
-# Regular
-Black="\e[38;2;253;246;227m"        # Base3   — lightest (fg on light bg = invisible; used as bg fg pair complement)
-Red="\e[38;2;220;50;47m"            # Red
-Green="\e[38;2;133;153;0m"          # Green
-Yellow="\e[38;2;181;137;0m"         # Yellow  — primary accent
-Blue="\e[38;2;38;139;210m"          # Blue
-Purple="\e[38;2;211;54;130m"        # Magenta
-Cyan="\e[38;2;42;161;152m"          # Cyan
-White="\e[38;2;101;123;131m"        # Base00  — main body text on light bg
-
-# Bold
-BBlack="\e[1;38;2;238;232;213m"     # Base2   bold
-BRed="\e[1;38;2;220;50;47m"         # Red     bold
-BGreen="\e[1;38;2;133;153;0m"       # Green   bold
-BYellow="\e[1;38;2;181;137;0m"      # Yellow  bold
-BBlue="\e[1;38;2;38;139;210m"       # Blue    bold
-BPurple="\e[1;38;2;211;54;130m"     # Magenta bold
-BCyan="\e[1;38;2;42;161;152m"       # Cyan    bold
-BWhite="\e[1;38;2;88;110;117m"      # Base01  bold — emphasis text
-
-# High intensity (emphasis / I* family)
-IBlack="\e[38;2;147;161;161m"       # Base1   — secondary/comments
-IRed="\e[38;2;203;75;22m"           # Orange  — Solarized's "bright red"
-IGreen="\e[38;2;133;153;0m"         # Green   (no brighter variant)
-IYellow="\e[38;2;181;137;0m"        # Yellow  (no brighter variant)
-IBlue="\e[38;2;108;113;196m"        # Violet  — Solarized's "bright blue"
-IPurple="\e[38;2;211;54;130m"       # Magenta (no brighter variant)
-ICyan="\e[38;2;42;161;152m"         # Cyan    (no brighter variant)
-IWhite="\e[38;2;88;110;117m"        # Base01  — emphasis
-
-# Bold high intensity
-BIBlack="\e[1;38;2;147;161;161m"    # Base1   bold
-BIRed="\e[1;38;2;203;75;22m"        # Orange  bold
-BIGreen="\e[1;38;2;133;153;0m"      # Green   bold
-BIYellow="\e[1;38;2;181;137;0m"     # Yellow  bold
-BIBlue="\e[1;38;2;108;113;196m"     # Violet  bold
-BIPurple="\e[1;38;2;211;54;130m"    # Magenta bold
-BICyan="\e[1;38;2;42;161;152m"      # Cyan    bold
-BIWhite="\e[1;38;2;88;110;117m"     # Base01  bold
-
-# ---- Background palette overrides -------------------------------------------
-# Light bases flip: On_Black → Base3 (lightest), On_IBlack → Base2 (highlights)
-On_Black="\e[48;2;253;246;227m"     # Base3   — main light background
-On_Red="\e[48;2;220;50;47m"         # Red
-On_Green="\e[48;2;133;153;0m"       # Green
-On_Yellow="\e[48;2;181;137;0m"      # Yellow
-On_Blue="\e[48;2;38;139;210m"       # Blue
-On_Purple="\e[48;2;211;54;130m"     # Magenta
-On_Cyan="\e[48;2;42;161;152m"       # Cyan
-On_White="\e[48;2;101;123;131m"     # Base00
-
-On_IBlack="\e[48;2;238;232;213m"    # Base2   — background highlights (slightly darker than Base3)
-On_IRed="\e[48;2;203;75;22m"        # Orange
-On_IGreen="\e[48;2;133;153;0m"      # Green
-On_IYellow="\e[48;2;181;137;0m"     # Yellow
-On_IBlue="\e[48;2;108;113;196m"     # Violet
-On_IPurple="\e[48;2;211;54;130m"    # Magenta
-On_ICyan="\e[48;2;42;161;152m"      # Cyan
-On_IWhite="\e[48;2;88;110;117m"     # Base01
-
-# ---- Special codes ----------------------------------------------------------
-DEFAULTFG="\e[38;2;101;123;131m"    # Base00 — default foreground on light bg
-DEFAULTBG="\e[48;2;253;246;227m"    # Base3  — default background
-RESETCOL="\e[0m"
-
-# ---- Prompt colour slots ----------------------------------------------------
-# All specified as direct ANSI sequences to avoid ordering dependencies
-# with the palette overrides above.
-
-PROMPT_COLOR_TIME_FG="\e[38;2;181;137;0m"    # Yellow  — primary accent
-PROMPT_COLOR_TIME_BG="\e[48;2;238;232;213m"  # Base2   — slightly darker than bg
-PROMPT_COLOR_BAR_BG="\e[48;2;238;232;213m"   # Base2   — warm light bar
-
-PROMPT_COLOR_OK_FG="\e[38;2;7;54;66m"        # Base02  — dark text for contrast on light
-PROMPT_COLOR_OK_MARK="\e[38;2;133;153;0m"    # Green   — checkmark
-
-PROMPT_COLOR_ERR_BG="\e[48;2;220;50;47m"     # Red     — error background
-PROMPT_COLOR_ERR_FG="\e[38;2;253;246;227m"   # Base3   — light text on red
-PROMPT_COLOR_ERR_MARK="\e[38;2;253;246;227m" # Base3   — X mark (bright on red)
-
-PROMPT_COLOR_ROOT_FG="\e[38;2;220;50;47m"    # Red     — root warning
-PROMPT_COLOR_USER_FG="\e[38;2;42;161;152m"   # Cyan    — normal user
-PROMPT_COLOR_DIR_FG="\e[38;2;38;139;210m"    # Blue    — working directory
+# Solarized Light prompt theme — exact 24-bit / true-colour palette
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Requires a terminal with true-colour / 24-bit support.
+# Check with:  printf '\e[38;2;220;50;47mred\e[0m\n'
+# If you see solid red text, your terminal supports this theme.
+# (konsole, iTerm2, kitty, alacritty, Windows Terminal all do)
+#
+# Solarized Light base tones (inverted vs Dark):
+#   Base3   #fdf6e3  →253 246 227   (main background — lightest)
+#   Base2   #eee8d5  →238 232 213   (background highlights)
+#   Base1   #93a1a1  →147 161 161   (comments / secondary content)
+#   Base0   #839496  →131 148 150   (body text — secondary)
+#   Base00  #657b83  →101 123 131   (body text — main on light bg)
+#   Base01  #586e75  → 88 110 117   (emphasis)
+#   Base02  #073642  →  7  54  66   (darkest — used for strong contrast)
+#
+# Accent colours are identical to Solarized Dark:
+#   Yellow  #b58900  →181 137   0
+#   Orange  #cb4b16  →203  75  22
+#   Red     #dc322f  →220  50  47
+#   Magenta #d33682  →211  54 130
+#   Violet  #6c71c4  →108 113 196
+#   Blue    #268bd2  → 38 139 210
+#   Cyan    #2aa198  → 42 161 152
+#   Green   #859900  →133 153   0
+# ------------------------------------------------------------------------------
+
+# ---- Foreground palette overrides -------------------------------------------
+# The accent fg colours are identical to Dark — only the base/neutral roles flip.
+# Regular
+Black="\e[38;2;253;246;227m"        # Base3   — lightest (fg on light bg = invisible; used as bg fg pair complement)
+Red="\e[38;2;220;50;47m"            # Red
+Green="\e[38;2;133;153;0m"          # Green
+Yellow="\e[38;2;181;137;0m"         # Yellow  — primary accent
+Blue="\e[38;2;38;139;210m"          # Blue
+Purple="\e[38;2;211;54;130m"        # Magenta
+Cyan="\e[38;2;42;161;152m"          # Cyan
+White="\e[38;2;101;123;131m"        # Base00  — main body text on light bg
+
+# Bold
+BBlack="\e[1;38;2;238;232;213m"     # Base2   bold
+BRed="\e[1;38;2;220;50;47m"         # Red     bold
+BGreen="\e[1;38;2;133;153;0m"       # Green   bold
+BYellow="\e[1;38;2;181;137;0m"      # Yellow  bold
+BBlue="\e[1;38;2;38;139;210m"       # Blue    bold
+BPurple="\e[1;38;2;211;54;130m"     # Magenta bold
+BCyan="\e[1;38;2;42;161;152m"       # Cyan    bold
+BWhite="\e[1;38;2;88;110;117m"      # Base01  bold — emphasis text
+
+# High intensity (emphasis / I* family)
+IBlack="\e[38;2;147;161;161m"       # Base1   — secondary/comments
+IRed="\e[38;2;203;75;22m"           # Orange  — Solarized's "bright red"
+IGreen="\e[38;2;133;153;0m"         # Green   (no brighter variant)
+IYellow="\e[38;2;181;137;0m"        # Yellow  (no brighter variant)
+IBlue="\e[38;2;108;113;196m"        # Violet  — Solarized's "bright blue"
+IPurple="\e[38;2;211;54;130m"       # Magenta (no brighter variant)
+ICyan="\e[38;2;42;161;152m"         # Cyan    (no brighter variant)
+IWhite="\e[38;2;88;110;117m"        # Base01  — emphasis
+
+# Bold high intensity
+BIBlack="\e[1;38;2;147;161;161m"    # Base1   bold
+BIRed="\e[1;38;2;203;75;22m"        # Orange  bold
+BIGreen="\e[1;38;2;133;153;0m"      # Green   bold
+BIYellow="\e[1;38;2;181;137;0m"     # Yellow  bold
+BIBlue="\e[1;38;2;108;113;196m"     # Violet  bold
+BIPurple="\e[1;38;2;211;54;130m"    # Magenta bold
+BICyan="\e[1;38;2;42;161;152m"      # Cyan    bold
+BIWhite="\e[1;38;2;88;110;117m"     # Base01  bold
+
+# ---- Background palette overrides -------------------------------------------
+# Light bases flip: On_Black → Base3 (lightest), On_IBlack → Base2 (highlights)
+On_Black="\e[48;2;253;246;227m"     # Base3   — main light background
+On_Red="\e[48;2;220;50;47m"         # Red
+On_Green="\e[48;2;133;153;0m"       # Green
+On_Yellow="\e[48;2;181;137;0m"      # Yellow
+On_Blue="\e[48;2;38;139;210m"       # Blue
+On_Purple="\e[48;2;211;54;130m"     # Magenta
+On_Cyan="\e[48;2;42;161;152m"       # Cyan
+On_White="\e[48;2;101;123;131m"     # Base00
+
+On_IBlack="\e[48;2;238;232;213m"    # Base2   — background highlights (slightly darker than Base3)
+On_IRed="\e[48;2;203;75;22m"        # Orange
+On_IGreen="\e[48;2;133;153;0m"      # Green
+On_IYellow="\e[48;2;181;137;0m"     # Yellow
+On_IBlue="\e[48;2;108;113;196m"     # Violet
+On_IPurple="\e[48;2;211;54;130m"    # Magenta
+On_ICyan="\e[48;2;42;161;152m"      # Cyan
+On_IWhite="\e[48;2;88;110;117m"     # Base01
+
+# ---- Special codes ----------------------------------------------------------
+DEFAULTFG="\e[38;2;101;123;131m"    # Base00 — default foreground on light bg
+DEFAULTBG="\e[48;2;253;246;227m"    # Base3  — default background
+RESETCOL="\e[0m"
+
+# ---- Prompt colour slots ----------------------------------------------------
+# All specified as direct ANSI sequences to avoid ordering dependencies
+# with the palette overrides above.
+
+PROMPT_COLOR_TIME_FG="\e[38;2;181;137;0m"    # Yellow  — primary accent
+PROMPT_COLOR_TIME_BG="\e[48;2;238;232;213m"  # Base2   — slightly darker than bg
+PROMPT_COLOR_BAR_BG="\e[48;2;238;232;213m"   # Base2   — warm light bar
+
+PROMPT_COLOR_OK_FG="\e[38;2;7;54;66m"        # Base02  — dark text for contrast on light
+PROMPT_COLOR_OK_MARK="\e[38;2;133;153;0m"    # Green   — checkmark
+
+PROMPT_COLOR_ERR_BG="\e[48;2;220;50;47m"     # Red     — error background
+PROMPT_COLOR_ERR_FG="\e[38;2;253;246;227m"   # Base3   — light text on red
+PROMPT_COLOR_ERR_MARK="\e[38;2;253;246;227m" # Base3   — X mark (bright on red)
+
+PROMPT_COLOR_ROOT_FG="\e[38;2;220;50;47m"    # Red     — root warning
+PROMPT_COLOR_USER_FG="\e[38;2;42;161;152m"   # Cyan    — normal user
+PROMPT_COLOR_DIR_FG="\e[38;2;38;139;210m"    # Blue    — working directory

profile.d/themes/solarized.theme

@@ -1,122 +1,122 @@
-# Solarized Dark prompt theme — exact 24-bit / true-colour palette
-# ------------------------------------------------------------------------------
-# Theme files are NOT executed as shell scripts. load_theme() parses them
-# line by line. Only the following value forms are accepted:
-#
-#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
-#   KEY="${ColorVarName}"  — same with braces
-#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
-#
-# Accepted keys:
-#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
-#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
-#                            from disp.sh for the whole shell session)
-#
-# Any unknown key, unsafe value, or shell construct will be ignored with a
-# warning — theme files cannot execute code.
-# ------------------------------------------------------------------------------
-# Requires a terminal with true-colour / 24-bit support.
-# Check with:  printf '\e[38;2;220;50;47mred\e[0m\n'
-# If you see solid red text, your terminal supports this theme.
-# (konsole, iTerm2, kitty, alacritty, Windows Terminal all do)
-#
-# Solarized Dark exact hex → RGB mapping used below:
-#   Base03  #002b36  →  0  43  54   (darkest background)
-#   Base02  #073642  →  7  54  66   (background highlights)
-#   Base01  #586e75  → 88 110 117   (comments / secondary content)
-#   Base00  #657b83  →101 123 131   (body text — dark background)
-#   Base0   #839496  →131 148 150   (body text — main)
-#   Base1   #93a1a1  →147 161 161   (optional emphasis)
-#   Yellow  #b58900  →181 137   0
-#   Orange  #cb4b16  →203  75  22
-#   Red     #dc322f  →220  50  47
-#   Magenta #d33682  →211  54 130
-#   Violet  #6c71c4  →108 113 196
-#   Blue    #268bd2  → 38 139 210
-#   Cyan    #2aa198  → 42 161 152
-#   Green   #859900  →133 153   0
-# ------------------------------------------------------------------------------
-
-# ---- Foreground palette overrides -------------------------------------------
-# Regular
-Black="\e[38;2;0;43;54m"            # Base03  — darkest content fg
-Red="\e[38;2;220;50;47m"            # Red
-Green="\e[38;2;133;153;0m"          # Green
-Yellow="\e[38;2;181;137;0m"         # Yellow  — primary accent
-Blue="\e[38;2;38;139;210m"          # Blue
-Purple="\e[38;2;211;54;130m"        # Magenta
-Cyan="\e[38;2;42;161;152m"          # Cyan
-White="\e[38;2;131;148;150m"        # Base0   — body text
-
-# Bold
-BBlack="\e[1;38;2;7;54;66m"         # Base02  bold
-BRed="\e[1;38;2;220;50;47m"         # Red     bold
-BGreen="\e[1;38;2;133;153;0m"       # Green   bold
-BYellow="\e[1;38;2;181;137;0m"      # Yellow  bold
-BBlue="\e[1;38;2;38;139;210m"       # Blue    bold
-BPurple="\e[1;38;2;211;54;130m"     # Magenta bold
-BCyan="\e[1;38;2;42;161;152m"       # Cyan    bold
-BWhite="\e[1;38;2;147;161;161m"     # Base1   bold
-
-# High intensity (brighter / emphasis roles in Solarized)
-IBlack="\e[38;2;88;110;117m"        # Base01  — secondary/comments
-IRed="\e[38;2;203;75;22m"           # Orange  — Solarized's "bright red"
-IGreen="\e[38;2;133;153;0m"         # Green   (no brighter variant)
-IYellow="\e[38;2;181;137;0m"        # Yellow  (no brighter variant)
-IBlue="\e[38;2;108;113;196m"        # Violet  — Solarized's "bright blue"
-IPurple="\e[38;2;211;54;130m"       # Magenta (no brighter variant)
-ICyan="\e[38;2;42;161;152m"         # Cyan    (no brighter variant)
-IWhite="\e[38;2;147;161;161m"       # Base1   — optional emphasis
-
-# Bold high intensity
-BIBlack="\e[1;38;2;88;110;117m"     # Base01  bold
-BIRed="\e[1;38;2;203;75;22m"        # Orange  bold
-BIGreen="\e[1;38;2;133;153;0m"      # Green   bold
-BIYellow="\e[1;38;2;181;137;0m"     # Yellow  bold
-BIBlue="\e[1;38;2;108;113;196m"     # Violet  bold
-BIPurple="\e[1;38;2;211;54;130m"    # Magenta bold
-BICyan="\e[1;38;2;42;161;152m"      # Cyan    bold
-BIWhite="\e[1;38;2;147;161;161m"    # Base1   bold
-
-# ---- Background palette overrides -------------------------------------------
-On_Black="\e[48;2;0;43;54m"         # Base03
-On_Red="\e[48;2;220;50;47m"         # Red
-On_Green="\e[48;2;133;153;0m"       # Green
-On_Yellow="\e[48;2;181;137;0m"      # Yellow
-On_Blue="\e[48;2;38;139;210m"       # Blue
-On_Purple="\e[48;2;211;54;130m"     # Magenta
-On_Cyan="\e[48;2;42;161;152m"       # Cyan
-On_White="\e[48;2;131;148;150m"     # Base0
-
-On_IBlack="\e[48;2;7;54;66m"        # Base02  — background highlights
-On_IRed="\e[48;2;203;75;22m"        # Orange
-On_IGreen="\e[48;2;133;153;0m"      # Green
-On_IYellow="\e[48;2;181;137;0m"     # Yellow
-On_IBlue="\e[48;2;108;113;196m"     # Violet
-On_IPurple="\e[48;2;211;54;130m"    # Magenta
-On_ICyan="\e[48;2;42;161;152m"      # Cyan
-On_IWhite="\e[48;2;147;161;161m"    # Base1
-
-# ---- Special codes ----------------------------------------------------------
-DEFAULTFG="\e[38;2;131;148;150m"    # Base0  — default foreground
-DEFAULTBG="\e[48;2;0;43;54m"        # Base03 — default background
-RESETCOL="\e[0m"
-
-# ---- Prompt colour slots ----------------------------------------------------
-# All specified as direct ANSI sequences to avoid ordering dependencies
-# with the palette overrides above.
-
-PROMPT_COLOR_TIME_FG="\e[38;2;181;137;0m"    # Yellow  — primary accent
-PROMPT_COLOR_TIME_BG="\e[48;2;0;43;54m"      # Base03  — darkest background
-PROMPT_COLOR_BAR_BG="\e[48;2;7;54;66m"       # Base02  — bar background
-
-PROMPT_COLOR_OK_FG="\e[38;2;131;148;150m"    # Base0   — body text on success
-PROMPT_COLOR_OK_MARK="\e[38;2;133;153;0m"    # Green   — checkmark
-
-PROMPT_COLOR_ERR_BG="\e[48;2;220;50;47m"     # Red     — error background
-PROMPT_COLOR_ERR_FG="\e[38;2;253;246;227m"   # Base3   — bright fg on red
-PROMPT_COLOR_ERR_MARK="\e[38;2;181;137;0m"   # Yellow  — X mark on red bg
-
-PROMPT_COLOR_ROOT_FG="\e[38;2;220;50;47m"    # Red     — root warning
-PROMPT_COLOR_USER_FG="\e[38;2;42;161;152m"   # Cyan    — normal user
-PROMPT_COLOR_DIR_FG="\e[38;2;38;139;210m"    # Blue    — working directory
+# Solarized Dark prompt theme — exact 24-bit / true-colour palette
+# ------------------------------------------------------------------------------
+# Theme files are NOT executed as shell scripts. load_theme() parses them
+# line by line. Only the following value forms are accepted:
+#
+#   KEY="$ColorVarName"    — reference to a colour variable from disp.sh
+#   KEY="${ColorVarName}"  — same with braces
+#   KEY="\e[...m"          — raw ANSI escape sequence (single block)
+#
+# Accepted keys:
+#   PROMPT_COLOR_*         — prompt slot colours (see profile.conf [prompt])
+#   Standard colour vars   — Black, Blue, On_IBlack, … (overrides the palette
+#                            from disp.sh for the whole shell session)
+#
+# Any unknown key, unsafe value, or shell construct will be ignored with a
+# warning — theme files cannot execute code.
+# ------------------------------------------------------------------------------
+# Requires a terminal with true-colour / 24-bit support.
+# Check with:  printf '\e[38;2;220;50;47mred\e[0m\n'
+# If you see solid red text, your terminal supports this theme.
+# (konsole, iTerm2, kitty, alacritty, Windows Terminal all do)
+#
+# Solarized Dark exact hex → RGB mapping used below:
+#   Base03  #002b36  →  0  43  54   (darkest background)
+#   Base02  #073642  →  7  54  66   (background highlights)
+#   Base01  #586e75  → 88 110 117   (comments / secondary content)
+#   Base00  #657b83  →101 123 131   (body text — dark background)
+#   Base0   #839496  →131 148 150   (body text — main)
+#   Base1   #93a1a1  →147 161 161   (optional emphasis)
+#   Yellow  #b58900  →181 137   0
+#   Orange  #cb4b16  →203  75  22
+#   Red     #dc322f  →220  50  47
+#   Magenta #d33682  →211  54 130
+#   Violet  #6c71c4  →108 113 196
+#   Blue    #268bd2  → 38 139 210
+#   Cyan    #2aa198  → 42 161 152
+#   Green   #859900  →133 153   0
+# ------------------------------------------------------------------------------
+
+# ---- Foreground palette overrides -------------------------------------------
+# Regular
+Black="\e[38;2;0;43;54m"            # Base03  — darkest content fg
+Red="\e[38;2;220;50;47m"            # Red
+Green="\e[38;2;133;153;0m"          # Green
+Yellow="\e[38;2;181;137;0m"         # Yellow  — primary accent
+Blue="\e[38;2;38;139;210m"          # Blue
+Purple="\e[38;2;211;54;130m"        # Magenta
+Cyan="\e[38;2;42;161;152m"          # Cyan
+White="\e[38;2;131;148;150m"        # Base0   — body text
+
+# Bold
+BBlack="\e[1;38;2;7;54;66m"         # Base02  bold
+BRed="\e[1;38;2;220;50;47m"         # Red     bold
+BGreen="\e[1;38;2;133;153;0m"       # Green   bold
+BYellow="\e[1;38;2;181;137;0m"      # Yellow  bold
+BBlue="\e[1;38;2;38;139;210m"       # Blue    bold
+BPurple="\e[1;38;2;211;54;130m"     # Magenta bold
+BCyan="\e[1;38;2;42;161;152m"       # Cyan    bold
+BWhite="\e[1;38;2;147;161;161m"     # Base1   bold
+
+# High intensity (brighter / emphasis roles in Solarized)
+IBlack="\e[38;2;88;110;117m"        # Base01  — secondary/comments
+IRed="\e[38;2;203;75;22m"           # Orange  — Solarized's "bright red"
+IGreen="\e[38;2;133;153;0m"         # Green   (no brighter variant)
+IYellow="\e[38;2;181;137;0m"        # Yellow  (no brighter variant)
+IBlue="\e[38;2;108;113;196m"        # Violet  — Solarized's "bright blue"
+IPurple="\e[38;2;211;54;130m"       # Magenta (no brighter variant)
+ICyan="\e[38;2;42;161;152m"         # Cyan    (no brighter variant)
+IWhite="\e[38;2;147;161;161m"       # Base1   — optional emphasis
+
+# Bold high intensity
+BIBlack="\e[1;38;2;88;110;117m"     # Base01  bold
+BIRed="\e[1;38;2;203;75;22m"        # Orange  bold
+BIGreen="\e[1;38;2;133;153;0m"      # Green   bold
+BIYellow="\e[1;38;2;181;137;0m"     # Yellow  bold
+BIBlue="\e[1;38;2;108;113;196m"     # Violet  bold
+BIPurple="\e[1;38;2;211;54;130m"    # Magenta bold
+BICyan="\e[1;38;2;42;161;152m"      # Cyan    bold
+BIWhite="\e[1;38;2;147;161;161m"    # Base1   bold
+
+# ---- Background palette overrides -------------------------------------------
+On_Black="\e[48;2;0;43;54m"         # Base03
+On_Red="\e[48;2;220;50;47m"         # Red
+On_Green="\e[48;2;133;153;0m"       # Green
+On_Yellow="\e[48;2;181;137;0m"      # Yellow
+On_Blue="\e[48;2;38;139;210m"       # Blue
+On_Purple="\e[48;2;211;54;130m"     # Magenta
+On_Cyan="\e[48;2;42;161;152m"       # Cyan
+On_White="\e[48;2;131;148;150m"     # Base0
+
+On_IBlack="\e[48;2;7;54;66m"        # Base02  — background highlights
+On_IRed="\e[48;2;203;75;22m"        # Orange
+On_IGreen="\e[48;2;133;153;0m"      # Green
+On_IYellow="\e[48;2;181;137;0m"     # Yellow
+On_IBlue="\e[48;2;108;113;196m"     # Violet
+On_IPurple="\e[48;2;211;54;130m"    # Magenta
+On_ICyan="\e[48;2;42;161;152m"      # Cyan
+On_IWhite="\e[48;2;147;161;161m"    # Base1
+
+# ---- Special codes ----------------------------------------------------------
+DEFAULTFG="\e[38;2;131;148;150m"    # Base0  — default foreground
+DEFAULTBG="\e[48;2;0;43;54m"        # Base03 — default background
+RESETCOL="\e[0m"
+
+# ---- Prompt colour slots ----------------------------------------------------
+# All specified as direct ANSI sequences to avoid ordering dependencies
+# with the palette overrides above.
+
+PROMPT_COLOR_TIME_FG="\e[38;2;181;137;0m"    # Yellow  — primary accent
+PROMPT_COLOR_TIME_BG="\e[48;2;0;43;54m"      # Base03  — darkest background
+PROMPT_COLOR_BAR_BG="\e[48;2;88;110;117m"    # Base01  — slightly brighter bar (was Base02)
+
+PROMPT_COLOR_OK_FG="\e[38;2;131;148;150m"    # Base0   — body text on success
+PROMPT_COLOR_OK_MARK="\e[38;2;133;153;0m"    # Green   — checkmark
+
+PROMPT_COLOR_ERR_BG="\e[48;2;180;20;15m"     # deeper crimson — more contrast than Solarized Red
+PROMPT_COLOR_ERR_FG="\e[1;38;2;255;255;255m" # bold pure white — maximum contrast on dark red
+PROMPT_COLOR_ERR_MARK="\e[1;38;2;253;246;227m" # Base3 bold — bright warm mark stands out on crimson
+
+PROMPT_COLOR_ROOT_FG="\e[38;2;220;50;47m"    # Red     — root warning
+PROMPT_COLOR_USER_FG="\e[38;2;42;161;152m"   # Cyan    — normal user
+PROMPT_COLOR_DIR_FG="\e[38;2;38;139;210m"    # Blue    — working directory

profile.d/updates.sh

@@ -54,6 +54,7 @@ check_updates()
     local vfile="" lastver=""
 
     PARSED=$(getopt -o hq --long help,quiet -n 'check_updates' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"check_updates --help\" to display usage."
         return 2
@@ -128,6 +129,7 @@ profile_upgrade()
     local tmpdir="" archive="" extracted_root=""
 
     PARSED=$(getopt -o hf:t:nFb:g --long help,file:,tmpdir:,dry-run,force,branch:,switch-to-git -n 'profile_upgrade' -- "$@")
+    # shellcheck disable=SC2181 # getopt return code is checked immediately after
     if [[ $? -ne 0 ]]; then
         disp E "Invalid options, use \"profile_upgrade --help\" to display usage."
         return 2
@@ -215,8 +217,8 @@ profile_upgrade()
         }
         if (( dry_run )); then
             disp I "[dry-run] rm -rf \"$MYPATH\"/.git"
-            disp I "[dry-run] git clone "$BASE_URL" \"$MYPATH\""
-            [[ -n "$branch" ]] && disp I "[dry-run] git -C \"$MYPATH\" checkout "$branch""
+            disp I "[dry-run] git clone $BASE_URL \"$MYPATH\""
+            [[ -n "$branch" ]] && disp I "[dry-run] git -C \"$MYPATH\" checkout $branch"
             return 0
         fi
 

profile.sh

@@ -45,7 +45,7 @@ fi
 if ((BASH_VERSINFO[0] < 4)) || [[ ${BASH_VERSINFO[0]} -eq 4 && ${BASH_VERSINFO[1]} -lt 3 ]]; then
     echo "[ Error ] This profile requires Bash 4.3 or higher."
     echo "Current version: $BASH_VERSION"
-    return 1 2>/dev/null || exit 1
+    (return 0 2>/dev/null) && return 1 || exit 1
 fi
 
 # ------------------------------------------------------------------------------
@@ -66,17 +66,17 @@ pathremove()
     export "$pathvar=$newpath"
 }
 
-pathprepend()
-{
-    [[ -z "$1" ]] && return 0
-    local pathvar="${2:-PATH}"
-    [[ "$pathvar" =~ ^[a-zA-Z_][a-zA-Z0-9_]*$ ]] || {
-        printf "pathprepend: unsafe variable name '%s'\n" "$pathvar" >&2
-        return 1
-    }
-    pathremove "$1" "$pathvar"
-    export "$pathvar=$1${!pathvar:+:${!pathvar}}"
-}
+#pathprepend() # Unused for now, but might be useful in the future
+#{
+#    [[ -z "$1" ]] && return 0
+#    local pathvar="${2:-PATH}"
+#    [[ "$pathvar" =~ ^[a-zA-Z_][a-zA-Z0-9_]*$ ]] || {
+#        printf "pathprepend: unsafe variable name '%s'\n" "$pathvar" >&2
+#        return 1
+#    }
+#    pathremove "$1" "$pathvar"
+#    export "$pathvar=$1${!pathvar:+:${!pathvar}}"
+#}
 
 pathappend()
 {
@@ -98,7 +98,7 @@ parse_conf()
 {
     local config_file="$1"
     local current_section=""
-    local line key value
+    local key value
 
     [[ ! -f "$config_file" ]] && return 1
 
@@ -140,6 +140,7 @@ parse_conf()
 
             # Use a nameref for safe, eval-free assignment
             local -n current_array="CONF_$current_section"
+            # shellcheck disable=SC2034 # Dynamic var creation
             current_array["$key"]="$value"
         fi
     done < "$config_file"
@@ -168,6 +169,7 @@ load_alias()
 
         # Only alias if the base command is executable
         if command -v "$base_cmd" >/dev/null 2>&1; then
+            # shellcheck disable=SC2139 # Dynamic alias creation
             alias "$key"="$cmd"
         fi
     done
@@ -181,7 +183,8 @@ load_conf()
 {
     local section_name="CONF_$1"
 
-    [[ "$(declare -p "$section_name" 2>/dev/null)" != "declare -A"* ]] && return 1
+    # Missing section is not an error: modules can rely on built-in defaults.
+    [[ "$(declare -p "$section_name" 2>/dev/null)" != "declare -A"* ]] && return 0
 
     local -n current_vars="$section_name"
 
@@ -204,22 +207,24 @@ load_conf()
 # Because we're more likely to be sourced, we use BASH_SOURCE to get the path
 # of the sourced file instead of $0
 if [[ -z "$PROFILE_PATH" ]]; then
-    export MYPATH=$(dirname "$(realpath -s "${BASH_SOURCE[0]}")")
+    MYPATH=$(dirname "$(realpath -s "${BASH_SOURCE[0]}")")
 else
-    export MYPATH="$PROFILE_PATH"
+    MYPATH="$PROFILE_PATH"
 fi
+export MYPATH
 if [[ ! -e "$MYPATH/profile.sh" ]]; then
     echo "[ Warning ] Path detection failed, trying to use pwd..."
     MYPATH=$(pwd)
     if [[ ! -e "$MYPATH/profile.sh" ]]; then
-        echo "[ Error ] Impossible to determine installation path, pretty much nothing will work."
+        echo "[ Error ] Unable to determine installation path, pretty much nothing will work."
     fi
 fi
 
 if [[ ! -s "$MYPATH/version" ]]; then
-    echo "[ Warning ] Impossible to determine running version of profile, your installation might be broken."
+    echo "[ Warning ] Unable to determine running profile version; your installation might be broken."
 fi
-export PROFVERSION=$(cat "$MYPATH"/version)
+PROFVERSION=$(cat "$MYPATH"/version)
+export PROFVERSION
 
 # Build PATH environment variable
 if [[ $EUID -eq 0 ]]; then
@@ -258,11 +263,21 @@ if [[ $INTERACTIVE ]]; then
     trap 'timer_start' DEBUG
     PROMPT_COMMAND='set_prompt'
 
-    # Set default language
-    setfr
+    # Set default language from DEFAULT_LANG config key (set in [general]).
+    # The value must match one of the alias names defined in SET_LOCALE so that
+    # the corresponding set<alias> function exists after build_locale_shortcuts.
+    if [[ -n "${DEFAULT_LANG:-}" ]]; then
+        _lang_fn="set${DEFAULT_LANG}"
+        if declare -F "$_lang_fn" >/dev/null 2>&1; then
+            "$_lang_fn"
+        else
+            disp W "DEFAULT_LANG '$DEFAULT_LANG' has no matching locale shortcut (check SET_LOCALE in profile.conf)."
+        fi
+        unset _lang_fn
+    fi
     showinfo && printf "\n"
     check_updates -q
-    disp I "Profile version $PROFVERSION chargé..."
+    disp I "Profile version $PROFVERSION loaded..."
 fi
 
 # Cleanup

version

@@ -1 +1 @@
-3.99.1-4_rc_1
+4.0.0