Explorer Sidebar - Developer Guide

Overview

The Explorer Sidebar is a dedicated panel found in the Wardian sidebar (SidebarIconRail), designed to give users direct access to their local workspace. Depending on whether an agent is actively selected, it contextualizes its root directory seamlessly:

1. Global View: Shows the ~/.wardian/ home directory.
2. Agent View: Shows the specific workspace configured for the active agent (agent.config.folder).

Key Components

1. ExplorerPanel.tsx

This is the main container component for the file explorer tab.

• Root Resolution: It queries the backend command get_explorer_root(sessionId) to identify which path to render.
• Context Menu Context: Provides right-click operations tailored to FileTree items (Reveal in OS, Delete, Copy Absolute Path, Preview).
• Preview Modal: Implements a themed modal overlay to securely display raw text file contents queried from the OS.

2. FileTree.tsx

A recursive, lazy-loading component responsible for accurately representing nested directory structures.

• Lazy Loading: Instead of indexing the entire workspace at once, it fetches child nodes only when a directory is expanded, ensuring optimal performance for large projects.
• Theming: Integrates seamlessly with Wardian typography and spacing. Nested items have fixed padding metrics to align correctly underneath parent elements without succumbing to horizontal flex contraction (shrink-0). File icons use lucide-react with colors mapped explicitly to wardian-* CSS variables based on file extensions.

3. Backend Commands (src-tauri/src/commands/fs.rs)

The file system operations strictly enforce security and platform agnosticism:

• get_explorer_root: Safely queries AppState to determine the correct target directory.
• get_directory_tree: Non-recursive listing of immediate children of a given path. Sorts directories first, then alphabetical.
• read_file_preview: Simple text reader.
• reveal_in_explorer: OS-specific std::process::Command routing to invoke explorer, open, or xdg-open.
• delete_file: Recursively deletes a directory or permanently removes a file string.

Technical Decisions

• Option<String> vs Strict Strings: Using null / Option for Session IDs enables elegant toggling between global and localized modes without parallel commands.
• Scroll Handling: Native scrollbars (overflow-auto) are preserved to prevent users from losing their place in deeply nested directory trees, resolving initial constraints that collapsed items dynamically.