Feat: Support and continous using environment variables in breadcrumb paths.

Author: senatov

GUI/Sources/BreadCrumbNav/BreadCrumbControlWrapper.swift

@@ -256,7 +256,7 @@ struct BreadCrumbControlWrapper: View {
 
     // MARK: - Helpers
     private var currentPath: String {
-        appState.path(for: panelSide)
+        appState.breadcrumbDisplayPath(for: panelSide)
     }
 
     private var navigator: PathNavigationService {
@@ -277,7 +277,12 @@ struct BreadCrumbControlWrapper: View {
             return true
         }
 
-        let url = URL(fileURLWithPath: path)
+        guard let resolved = PathEnvironmentResolver.expand(path) else {
+            log.error("Path contains unresolved environment variable: \(path)")
+            return false
+        }
+
+        let url = URL(fileURLWithPath: (resolved.expanded as NSString).expandingTildeInPath)
         guard FileManager.default.fileExists(atPath: url.path) else {
             log.error("Path does not exist: \(path)")
             return false

GUI/Sources/BreadCrumbNav/BreadCrumbView.swift

@@ -92,6 +92,7 @@ struct BreadCrumbView: View {
         let text: String  // shown (may be truncated)
         let fullName: String  // full name for tooltip + hover-expand
         let originalIndex: Int  // index in pathComponents for navigation
+        let isEnvironmentVariable: Bool
         var isTruncated: Bool { text != fullName }
     }
 
@@ -100,12 +101,14 @@ struct BreadCrumbView: View {
     ///   remote  → ["SFTP demo@host", "pub", "docs"]   (first segment = origin label)
     ///   archive → ["archive.zip", "subdir"]
     ///   local   → ["Users", "senat", "Develop"]
-    private var pathComponents: [String] {
+    private var pathComponents: [BreadCrumbDisplayComponent] {
         let panelURL = panelURL
 
         // ── Remote (SFTP / FTP) ──────────────────────────────────────────────
         if AppState.isRemotePath(panelURL) {
-            return remoteComponents(for: panelURL)
+            return remoteComponents(for: panelURL).map {
+                BreadCrumbDisplayComponent(text: $0, isEnvironmentVariable: false)
+            }
         }
 
         // ── Archive (virtual) ────────────────────────────────────────────────
@@ -117,14 +120,24 @@ struct BreadCrumbView: View {
                 currentPath: panelURL.path,
                 archiveName: archiveURL.lastPathComponent,
                 tempDir: tempDir.standardizedFileURL.path
-            )
+            ).map { BreadCrumbDisplayComponent(text: $0, isEnvironmentVariable: false) }
         }
 
         // ── Local filesystem ─────────────────────────────────────────────────
-        return panelURL.path
-            .split(separator: "/")
-            .map(String.init)
-            .filter { !$0.isEmpty }
+        return PathEnvironmentResolver.displayComponents(from: appState.breadcrumbDisplayPath(for: panelSide))
+    }
+
+    private var pathComponentTexts: [String] {
+        pathComponents.map(\.text)
+    }
+
+    private var localDisplayPath: String {
+        appState.breadcrumbDisplayPath(for: panelSide)
+    }
+
+    private func makeLocalDisplayPath(through index: Int) -> String {
+        let joined = pathComponentTexts.prefix(index + 1).joined(separator: "/")
+        return localDisplayPath.hasPrefix("/") ? "/" + joined : joined
     }
 
     // MARK: - remoteComponents
@@ -196,20 +209,32 @@ struct BreadCrumbView: View {
         guard !components.isEmpty else { return [] }
 
         if components.count == 1 {
-            return [DisplaySegment(text: components[0], fullName: components[0], originalIndex: 0)]
+            return [
+                DisplaySegment(
+                    text: components[0].text,
+                    fullName: components[0].text,
+                    originalIndex: 0,
+                    isEnvironmentVariable: components[0].isEnvironmentVariable
+                )
+            ]
         }
 
         let charWidth: CGFloat = 7.5
         let totalSepWidth = CGFloat(components.count - 1) * separatorWidth
         let budgetForText = availableWidth - totalSepWidth - 16
 
-        let widths = components.map { CGFloat($0.count) * charWidth }
+        let widths = components.map { CGFloat($0.text.count) * charWidth }
         let totalWidth = widths.reduce(0, +)
 
         if totalWidth <= budgetForText {
             return components.enumerated()
-                .map { i, name in
-                    DisplaySegment(text: name, fullName: name, originalIndex: i)
+                .map { i, component in
+                    DisplaySegment(
+                        text: component.text,
+                        fullName: component.text,
+                        originalIndex: i,
+                        isEnvironmentVariable: component.isEnvironmentVariable
+                    )
                 }
         }
 
@@ -222,8 +247,9 @@ struct BreadCrumbView: View {
             var priority: Int
         }
         var segs = components.enumerated()
-            .map { i, name in
-                Seg(
+            .map { i, component in
+                let name = component.text
+                return Seg(
                     index: i, name: name, display: name, width: widths[i],
                     priority: truncPriority(index: i, total: components.count, len: name.count))
             }
@@ -243,7 +269,14 @@ struct BreadCrumbView: View {
             segs[idx].width = newWidth
             segs[idx].priority = 0
         }
-        return segs.map { DisplaySegment(text: $0.display, fullName: $0.name, originalIndex: $0.index) }
+        return segs.map {
+            DisplaySegment(
+                text: $0.display,
+                fullName: $0.name,
+                originalIndex: $0.index,
+                isEnvironmentVariable: components[$0.index].isEnvironmentVariable
+            )
+        }
     }
 
     // MARK: - truncPriority — never truncate first/last; longer middle first
@@ -267,20 +300,20 @@ struct BreadCrumbView: View {
             return origin + "/"
         }
 
-        let parts = Array(pathComponents[1...segment.originalIndex])
+        let parts = Array(pathComponentTexts[1...segment.originalIndex])
         return origin + "/" + parts.joined(separator: "/")
     }
 
     private func archiveTargetPath(for segment: DisplaySegment) -> String? {
         guard let tempDir = archiveTempDir else { return nil }
         guard segment.originalIndex > 0 else { return nil }
 
-        let sub = Array(pathComponents[1...segment.originalIndex])
+        let sub = Array(pathComponentTexts[1...segment.originalIndex])
         return tempDir.standardizedFileURL.path + "/" + sub.joined(separator: "/")
     }
 
     private func localTargetPath(for segment: DisplaySegment) -> String {
-        ("/" + pathComponents.prefix(segment.originalIndex + 1).joined(separator: "/"))
+        makeLocalDisplayPath(through: segment.originalIndex)
             .replacingOccurrences(of: "//", with: "/")
     }
 
@@ -297,6 +330,8 @@ struct BreadCrumbView: View {
         ExpandableSegmentButton(
             segment: segment,
             textColor: textColor,
+            variableTextColor: colorStore.activeTheme.breadcrumbVariableColor,
+            variableItalic: colorStore.breadcrumbVariableItalic,
             fontSize: fontSize,
             onTap: { handleTap(segment: segment) },
             helpText: tooltip(for: segment),
@@ -336,19 +371,19 @@ struct BreadCrumbView: View {
             if segment.originalIndex == 0 {
                 return "🌐 \(segment.fullName) — tap to go to root"
             }
-            let parts = Array(pathComponents[1...segment.originalIndex])
+            let parts = Array(pathComponentTexts[1...segment.originalIndex])
             return "📂 /\(parts.joined(separator: "/"))"
         }
 
         if isInsideArchive {
             if segment.originalIndex == 0 {
                 return "📦 \(segment.fullName) — tap to exit archive"
             }
-            let parts = pathComponents.prefix(segment.originalIndex + 1)
+            let parts = pathComponentTexts.prefix(segment.originalIndex + 1)
             return "📂 \(parts.joined(separator: "/"))"
         }
 
-        let fullPath = "/" + pathComponents.prefix(segment.originalIndex + 1).joined(separator: "/")
+        let fullPath = makeLocalDisplayPath(through: segment.originalIndex)
         return "📂 Open \(fullPath)"
     }
 
@@ -360,7 +395,7 @@ struct BreadCrumbView: View {
                 ?? segment.fullName
         }
 
-        let parts = Array(pathComponents[1...segment.originalIndex])
+        let parts = Array(pathComponentTexts[1...segment.originalIndex])
         return "/" + parts.joined(separator: "/")
     }
 
@@ -370,7 +405,7 @@ struct BreadCrumbView: View {
         }
 
         guard let tempDir = archiveTempDir else { return "" }
-        let sub = Array(pathComponents[1...segment.originalIndex])
+        let sub = Array(pathComponentTexts[1...segment.originalIndex])
         return tempDir.standardizedFileURL.path + "/" + sub.joined(separator: "/")
     }
 
@@ -383,7 +418,7 @@ struct BreadCrumbView: View {
         } else if isInsideArchive {
             pathToCopy = archiveCopyPath(for: segment)
         } else {
-            pathToCopy = "/" + pathComponents.prefix(segment.originalIndex + 1).joined(separator: "/")
+            pathToCopy = makeLocalDisplayPath(through: segment.originalIndex)
         }
 
         NSPasteboard.general.clearContents()

GUI/Sources/BreadCrumbNav/ExpandableSegmentButton.swift

@@ -16,6 +16,8 @@ struct ExpandableSegmentButton: View {
 
     let segment: BreadCrumbView.DisplaySegment
     let textColor: Color      // breadcrumbText(Active|Inactive) from theme
+    let variableTextColor: Color
+    let variableItalic: Bool
     let fontSize: CGFloat     // breadcrumbFontSize from theme
     let onTap: () -> Void
     let helpText: String
@@ -28,11 +30,20 @@ struct ExpandableSegmentButton: View {
         (isHovered && segment.isTruncated) ? segment.fullName : segment.text
     }
 
+    private var displayColor: Color {
+        segment.isEnvironmentVariable ? variableTextColor : textColor
+    }
+
+    private var displayFont: Font {
+        let base = Font.system(size: fontSize, weight: .regular, design: .rounded)
+        return segment.isEnvironmentVariable && variableItalic ? base.italic() : base
+    }
+
     var body: some View {
         Button(action: onTap) {
             Text(displayText)
-                .font(.system(size: fontSize, weight: .regular, design: .rounded))
-                .foregroundStyle(textColor)
+                .font(displayFont)
+                .foregroundStyle(displayColor)
                 .kerning(0.1)
                 .padding(.vertical, 2)
                 .padding(.horizontal, isHovered && segment.isTruncated ? 4 : 0)

GUI/Sources/BreadCrumbNav/PathAutoCompleteField.swift

@@ -117,12 +117,15 @@ struct PathAutoCompleteField: View {
 
     // MARK: - Update Suggestions
     private func updateSuggestions(for path: String) {
-        guard isValidAbsolutePath(path) else {
+        guard let resolvedPath = expandedPath(path),
+              isValidAbsolutePath(resolvedPath)
+        else {
             dismissPopup()
             return
         }
 
-        let (dirURL, prefix) = splitPathAndPrefix(path)
+        let (dirURL, _) = splitPathAndPrefix(resolvedPath)
+        let prefix = splitDisplayPathAndPrefix(path).prefix
 
         guard directoryExists(dirURL) else {
             dismissPopup()
@@ -144,6 +147,11 @@ struct PathAutoCompleteField: View {
         !path.isEmpty && path.hasPrefix("/")
     }
 
+    private func expandedPath(_ path: String) -> String? {
+        guard let resolved = PathEnvironmentResolver.expand(path) else { return nil }
+        return (resolved.expanded as NSString).expandingTildeInPath
+    }
+
     private func directoryExists(_ url: URL) -> Bool {
         FileManager.default.fileExists(atPath: url.path)
     }
@@ -215,10 +223,11 @@ struct PathAutoCompleteField: View {
 
     // MARK: - Apply Suggestion
     private func applySuggestion(_ name: String) {
-        let (dirURL, _) = splitPathAndPrefix(text)
-        let fullPath = dirURL.appendingPathComponent(name).path
+        let displayParts = splitDisplayPathAndPrefix(text)
+        let fullPath = appendDisplayComponent(name, to: displayParts.directory)
+        let resolvedFullPath = expandedPath(fullPath) ?? fullPath
         suppressOnChange = true
-        if isDirAtURL(URL(fileURLWithPath: fullPath)) {
+        if isDirAtURL(URL(fileURLWithPath: resolvedFullPath)) {
             text = fullPath + "/"
         } else {
             text = fullPath
@@ -256,6 +265,22 @@ struct PathAutoCompleteField: View {
     }
 
     // MARK: - Helpers
+    private func splitDisplayPathAndPrefix(_ path: String) -> (directory: String, prefix: String) {
+        if path.hasSuffix("/") {
+            return (String(path.dropLast()), "")
+        }
+
+        let nsPath = path as NSString
+        let directory = nsPath.deletingLastPathComponent
+        return (directory == "." ? "" : directory, nsPath.lastPathComponent)
+    }
+
+    private func appendDisplayComponent(_ component: String, to directory: String) -> String {
+        guard !directory.isEmpty else { return component }
+        guard directory != "/" else { return "/" + component }
+        return directory + "/" + component
+    }
+
     private func splitPathAndPrefix(_ path: String) -> (URL, String) {
         if path.hasSuffix("/") {
             return (URL(fileURLWithPath: path), "")
@@ -265,7 +290,7 @@ struct PathAutoCompleteField: View {
         }
     }
 
-    private func currentPrefix() -> String { splitPathAndPrefix(text).1 }
+    private func currentPrefix() -> String { splitDisplayPathAndPrefix(text).prefix }
 
     private func isDirAtURL(_ url: URL) -> Bool {
         var isDir: ObjCBool = false