clang: make file paths with spaces clickable via OSC 8 hyperlinks

crates/libs/rdl/src/error.rs

@@ -31,14 +31,34 @@ impl std::fmt::Display for Error {
                 f,
                 "\nerror: {}\n --> {}:{}:{}",
                 &self.message,
-                &self.file_name,
+                hyperlink_path(&self.file_name),
                 self.line,
                 self.column + 1
             )
         } else if self.file_name.is_empty() {
             write!(f, "\nerror: {}", &self.message)
         } else {
-            write!(f, "\nerror: {}\n --> {}", &self.message, &self.file_name)
+            write!(
+                f,
+                "\nerror: {}\n --> {}",
+                &self.message,
+                hyperlink_path(&self.file_name)
+            )
         }
     }
 }
+
+/// Wraps `path` in an OSC 8 hyperlink escape sequence when stderr is an
+/// interactive terminal, making the path clickable in supporting terminals.
+/// Falls back to returning the path unchanged for non-TTY output so that
+/// redirected output (log files, CI runners, etc.) is not polluted with
+/// escape codes.
+fn hyperlink_path(path: &str) -> String {
+    use std::io::IsTerminal as _;
+    if path.is_empty() || !std::io::stderr().is_terminal() {
+        return path.to_string();
+    }
+    // OSC 8 format: ESC ] 8 ; params ; uri ST  link-text  ESC ] 8 ; ; ST
+    // where ST (String Terminator) is ESC \.
+    format!("\x1b]8;;{path}\x1b\\{path}\x1b]8;;\x1b\\")
+}