docs: Update documentation for 145 files

Generated by AurionDocs
Job ID: c99fff50-67a3-4294-b4df-3e73f4f12de9
Source commit: 4dcb480

docs/auriondocs/Code/src/EchoHub.Client/UI/Helpers/DroppedFileParser.cs.md

@@ -0,0 +1,28 @@
+# DroppedFileParser
+
+> **File:** `src/EchoHub.Client/UI/Helpers/DroppedFileParser.cs`  
+> **Kind:** class
+
+```csharp
+public static class DroppedFileParser
+```
+
+
+DroppedFileParser is a small utility that interprets terminal-dropped input as potential file paths and resolves them to existing files. Use it when you need to convert user-typed or pasted text into concrete file paths without scattering filesystem checks across callers.
+
+## Remarks
+This abstraction centralizes the logic for recognizing path-like input and for extracting one or more existing file paths from either a single path or a space-separated list of paths. It exposes a fast pre-check (LooksLikePath) to avoid expensive filesystem calls for clearly non-path input, and a test-friendly parser (TryGetFiles) that can inject a custom file existence predicate. The design favors explicit handling of both Windows (drive letters and UNC) and POSIX-style absolute paths, including quoted components and spaces.
+
+## Example
+```csharp
+var input = "\"C:\\Temp\\report.pdf\" C:\\Data\\log.txt";
+if (DroppedFileParser.TryGetFiles(input, out var files))
+{
+    // files contains: ["C:\\Temp\\report.pdf", "C:\\Data\\log.txt"]
+}
+```
+
+## Notes
+- LookSLikePath may return true for strings that resemble paths (e.g., starting with a quote, a slash, UNC prefix, or a drive letter), so TryGetFiles should be used to confirm actual file existence.
+- TryGetFiles enforces that all tokens are fully-qualified paths and that each path exists (via the injectable fileExists predicate, which defaults to File.Exists). This reduces accidental assumptions about the input.
+- The tokenization logic respects quoted segments so that spaces within a single path do not split tokens unintentionally.

docs/auriondocs/Code/src/EchoHub.Client/UI/Helpers/EmojiHelper.cs.md

@@ -0,0 +1,19 @@
+# EmojiHelper
+
+> **File:** `src/EchoHub.Client/UI/Helpers/EmojiHelper.cs`  
+> **Kind:** class
+
+```csharp
+public static class EmojiHelper
+```
+
+
+EmojiHelper converts emoji grapheme clusters to text shortcodes for safe TUI rendering. It replaces emoji with fixed-width ASCII shortcodes when available, falling back to a generic [emoji] placeholder for unknown symbols; non-emoji text passes through unchanged.
+
+## Remarks
+
+This utility uses grapheme-aware processing to handle complex emoji sequences (including ZWJ-joined glyphs and modifier-bearing emojis) by iterating over text elements rather than individual code points. It first attempts a full-grapheme shortcode lookup, then falls back to the base emoji (the first rune of the grapheme) if necessary, and finally uses the [emoji] placeholder when no mapping exists. An initial pass quickly determines whether any emoji exist in the input to avoid unnecessary work. The implementation relies on StringBuilder for efficient string construction, StringInfo for grapheme segmentation, and the EmojiShortcodes mapping as the source of truth for replacements.
+
+## Notes
+
+- Unknown or unmapped emoji are replaced with [emoji], which can reduce expressiveness if the shortcode dictionary is incomplete. Ensure EmojiShortcodes covers the emoji you expect to render in your UI.

docs/auriondocs/Code/src/EchoHub.Client/UI/Helpers/HexColorHelper.cs.md

@@ -0,0 +1,18 @@
+# HexColorHelper
+
+> **File:** `src/EchoHub.Client/UI/Helpers/HexColorHelper.cs`  
+> **Kind:** class
+
+```csharp
+public static class HexColorHelper
+```
+
+
+HexColorHelper is a small utility that converts hex color strings into Terminal.Gui coloring primitives. Use ParseHexColor to obtain an Attribute suitable for styling a control's foreground, and ParseHexToColor when you need a Color value with a safe fallback for invalid input.
+
+## Remarks
+By centralizing hex parsing, HexColorHelper avoids duplicating color-conversion logic and provides predictable fallbacks for malformed input. It interprets a hex string as an RGB triplet and applies it as the foreground color (with no explicit background). This keeps styling decisions consistent across the UI while keeping the parsing logic isolated in one place.
+
+## Notes
+- Invalid input yields null (for ParseHexColor) or the provided fallback (for ParseHexToColor); no exceptions are thrown.
+- A 6-digit hex value is required after an optional leading '#'. Non-hex characters or incorrect length return fallback/null.

docs/auriondocs/Code/src/EchoHub.Client/UI/Helpers/NickColorHelper.cs.md

@@ -0,0 +1,25 @@
+# NickColorHelper
+
+> **File:** `src/EchoHub.Client/UI/Helpers/NickColorHelper.cs`  
+> **Kind:** class
+
+```csharp
+public static class NickColorHelper
+```
+
+
+NickColorHelper deterministically assigns a stable color to every nickname, ensuring the same nick always maps to the same palette entry. This mirrors classic IRC behavior and lets busy channels stay readable without per-user configuration.
+
+## Remarks
+NickColorHelper isolates color selection from rendering logic by exposing a pure function GetPaletteIndex and GetAttribute. The palette itself is a fixed sequence of medium-saturation colors designed for legibility on both dark and light backgrounds; changing the palette order would re-color every nick and break visual consistency across sessions.
+
+## Example
+```csharp
+var color = NickColorHelper.GetAttribute("Alice");
+// Use `color` when rendering Alice's username in the UI
+```
+
+## Notes
+- Null nick will throw; ensure non-null before calling GetPaletteIndex.
+- The palette order is fixed; reordering or removing entries changes every nickname's color.
+- The mapping uses a case-insensitive FNV-1a hash; changing the hash or its normalization will alter which nick gets which color.