Add terminal color detection documentation

Author: stalep

content/docs/aesh/renderers.md

@@ -59,20 +59,65 @@ public class LoginCommand implements Command<CommandInvocation> {
 ## Colorized Output
 
 ```java
+import org.aesh.readline.terminal.formatting.TerminalColor;
+import org.aesh.readline.terminal.formatting.TerminalString;
+import org.aesh.readline.terminal.formatting.TerminalTextStyle;
+import org.aesh.readline.terminal.formatting.CharacterType;
+import org.aesh.readline.terminal.formatting.Color;
+
 public class ColorizedRenderer implements OptionRenderer<ProcessedOption> {
 
     @Override
     public String render(ProcessedOption option) {
         TerminalString colorized = new TerminalString(
             option.getValue(),
-            TerminalColor.DEFAULT_TEXT,
-            TerminalTextStyle.INTENSITY_BOLD
+            new TerminalColor(Color.CYAN, Color.DEFAULT),
+            new TerminalTextStyle(CharacterType.BOLD)
         );
         return colorized.toString();
     }
 }
 ```
 
+### Theme-Aware Rendering
+
+For colors that adapt to the terminal's light or dark theme, use the semantic color methods with detected terminal capabilities:
+
+```java
+import org.aesh.readline.terminal.TerminalColorDetector;
+import org.aesh.readline.terminal.formatting.TerminalColor;
+import org.aesh.readline.terminal.formatting.TerminalString;
+import org.aesh.terminal.utils.TerminalColorCapability;
+
+public class AdaptiveRenderer implements OptionRenderer<ProcessedOption> {
+    private final TerminalColorCapability capability;
+    
+    public AdaptiveRenderer(TerminalColorCapability capability) {
+        this.capability = capability;
+    }
+
+    @Override
+    public String render(ProcessedOption option) {
+        // Use theme-aware colors that work on both light and dark backgrounds
+        TerminalColor color = TerminalColor.forHighlight(capability);
+        return new TerminalString(option.getValue(), color).toString();
+    }
+}
+```
+
+The semantic color methods automatically choose appropriate brightness:
+
+| Method | Dark Theme | Light Theme | Use For |
+|--------|------------|-------------|---------|
+| `forError()` | Bright red | Normal red | Error messages |
+| `forSuccess()` | Bright green | Normal green | Success confirmations |
+| `forWarning()` | Bright yellow | Normal yellow | Warnings |
+| `forInfo()` | Bright cyan | Normal blue | Informational text |
+| `forHighlight()` | Bright white | Black | Emphasized text |
+| `forMuted()` | Normal white | Normal black | Secondary text |
+
+See the Readline [Terminal Colors](/docs/readline/terminal-colors) documentation for more details on RGB colors and color depth adaptation.
+
 ## Conditional Rendering
 
 ```java

content/docs/readline/_index.md

@@ -42,6 +42,8 @@ Think of it this way: Æsh is built **on top of** Æsh Readline. Æsh provides t
 - **Stream Support** - Standard out and standard error handling
 - **Shell Features** - Redirect, alias, and pipeline support
 - **Remote Connectivity** - SSH, Telnet, and WebSocket terminal servers
+- **[Color Detection](color-detection)** - Automatic terminal theme and color depth detection
+- **[Terminal Colors](terminal-colors)** - RGB colors, theme-aware styling, and color depth adaptation
 
 ## Architecture