Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

10.7 KB
Raw Blame
import { useState, useEffect, useRef, useCallback } from 'react';
import { File, Folder, FolderOpen, ChevronUp, HardDrive, Home, X, Check, AlertCircle } from 'lucide-react';
import * as api from '../services/api';
import BrailleSpinner from './BrailleSpinner';
import Modal from './ui/Modal.jsx';

export default function FolderPicker({ value, onChange, defaultPath, mode = 'directory', ariaLabel = 'Browse folders' }) {
  const [isOpen, setIsOpen] = useState(false);
  const [currentPath, setCurrentPath] = useState('');
  const [parentPath, setParentPath] = useState(null);
  const [directories, setDirectories] = useState([]);
  const [files, setFiles] = useState([]);
  const [drives, setDrives] = useState(null);
  const [loading, setLoading] = useState(false);
  const [error, setError] = useState(null);
  // Remember when `defaultPath` has already failed once so re-opens skip the
  // wasted round trip (and the server-side 400 it logs). Ref-not-state because
  // changing it must not re-trigger the open effect.
  const defaultPathUnavailableRef = useRef(false);

  // Load directory contents. When fallbackToDefault is true and the requested
  // path fails BECAUSE IT DOESN'T EXIST (e.g. iCloud Obsidian folder absent),
  // silently retry with the server's default so the picker still opens
  // somewhere usable. Other failures (server down, permission denied,
  // transient 5xx) propagate as errors and do NOT poison the
  // defaultPathUnavailable cache — otherwise a one-time network blip would
  // permanently disable the default for the rest of the session.
  const loadDirectory = useCallback(async (path = null, { fallbackToDefault = false } = {}) => {
    // Local helper so it stays inside the useCallback closure — keeps
    // react-hooks/exhaustive-deps quiet and rules out stale-closure surprises
    // if it ever starts reading state/props in the future.
    const isPathAbsentError = (err) => (
      err?.status === 400 && (err.code === 'INVALID_PATH' || err.code === 'NOT_A_DIRECTORY')
    );
    setLoading(true);
    setError(null);
    const applyResult = (result) => {
      setCurrentPath(result.currentPath);
      setParentPath(result.parentPath);
      setDirectories(result.directories || []);
      setFiles(result.files || []);
      setDrives(result.drives ?? null);
    };
    let lastError = null;
    let result = await api.getDirectories(path, { includeFiles: mode === 'file' }).catch((err) => {
      lastError = err;
      return null;
    });
    if (!result && fallbackToDefault && path != null && isPathAbsentError(lastError)) {
      defaultPathUnavailableRef.current = true;
      lastError = null;
      result = await api.getDirectories(null, { includeFiles: mode === 'file' }).catch((err) => {
        lastError = err;
        return null;
      });
    }
    if (result) {
      applyResult(result);
    } else if (lastError) {
      setError(lastError.message || 'Failed to load directory');
    }
    setLoading(false);
  }, [mode]);

  // Load initial directory when opened
  useEffect(() => {
    if (isOpen) {
      const useDefault = !value && !!defaultPath && !defaultPathUnavailableRef.current;
      const selectedDirectory = mode === 'file' && value ? value.replace(/[/\\][^/\\]+$/, '') : value;
      const initialPath = selectedDirectory || (useDefault ? defaultPath : null);
      loadDirectory(initialPath, { fallbackToDefault: useDefault });
    }
  }, [isOpen, loadDirectory, value, defaultPath, mode]);

  // Reset the "default unavailable" cache when the caller changes which
  // defaultPath to try — a different path is worth probing again.
  useEffect(() => {
    defaultPathUnavailableRef.current = false;
  }, [defaultPath]);

  const handleSelect = () => {
    onChange(currentPath);
    setIsOpen(false);
  };

  const handleNavigate = (path) => {
    loadDirectory(path);
  };

  return (
    <div>
      <button
        type="button"
        onClick={() => setIsOpen(true)}
        className="px-3 py-3 bg-port-border hover:bg-port-border/80 text-white rounded-lg transition-colors"
        title={ariaLabel}
        aria-label={ariaLabel}
      >
        <Folder size={20} />
      </button>

      {/* Only mount the Modal while open so its children (the directory list in
          particular) aren't rebuilt on every parent re-render while closed.
          usePortal renders the overlay at <body> so the fixed positioning
          escapes any backdrop-filter / transform ancestor (e.g. the enclosing
          bg-port-card card, which becomes a containing block on "glass" themes)
          — otherwise the overlay is trapped inside that card and mis-positioned
          on mobile. */}
      {isOpen && (
        <Modal
          open
          onClose={() => setIsOpen(false)}
          size="md"
          usePortal
          ariaLabelledBy="folder-picker-title"
          panelClassName="bg-port-card border border-port-border rounded-xl flex flex-col shadow-2xl"
        >
          {/* Header */}
          <div className="flex items-center justify-between p-4 border-b border-port-border">
            <h3 id="folder-picker-title" className="text-lg font-semibold text-white">{mode === 'file' ? 'Select File' : 'Select Folder'}</h3>
            <button
              type="button"
              onClick={() => setIsOpen(false)}
              className="p-1 text-gray-400 hover:text-white min-h-[44px] min-w-[44px] flex items-center justify-center"
              aria-label="Close folder picker"
            >
              <X size={20} />
            </button>
          </div>

          {/* Current Path + Quick Nav */}
          <div className="px-4 py-2 bg-port-bg border-b border-port-border flex items-center gap-2">
            <p className="flex-1 text-sm font-mono text-gray-400 truncate" title={currentPath}>
              {currentPath}
            </p>
            {/* Home directory button */}
            <button
              type="button"
              onClick={() => handleNavigate('~')}
              className="min-h-[44px] min-w-[44px] inline-flex items-center justify-center p-1 text-gray-500 hover:text-white shrink-0"
              title="Home directory" aria-label="Home directory"
            >
              <Home size={16} />
            </button>
          </div>

          {/* Windows Drive Selector */}
          {drives && drives.length > 0 && (
            <div className="px-4 py-2 border-b border-port-border flex items-center gap-1 flex-wrap">
              <HardDrive size={14} className="text-gray-500 shrink-0 mr-1" />
              {drives.map((drive) => (
                <button
                  key={drive}
                  type="button"
                  onClick={() => handleNavigate(drive)}
                  className={`px-2 py-0.5 text-xs font-mono rounded transition-colors ${
                    currentPath.toUpperCase().startsWith(drive.charAt(0).toUpperCase())
                      ? 'bg-port-accent text-white'
                      : 'bg-port-border text-gray-400 hover:text-white hover:bg-port-border/80'
                  }`}
                >
                  {drive.charAt(0)}:
                </button>
              ))}
            </div>
          )}

          {/* Directory List */}
          <div className="flex-1 overflow-auto p-2 min-h-[300px]">
            {loading ? (
              <div className="flex items-center justify-center h-full">
                <BrailleSpinner text="Loading" />
              </div>
            ) : error ? (
              <div className="flex flex-col items-center justify-center h-full gap-2 text-gray-500 px-4">
                <AlertCircle size={24} className="text-port-error" />
                <p className="text-sm text-center">{error}</p>
                <button
                  type="button"
                  onClick={() => loadDirectory(null)}
                  className="mt-2 text-xs text-port-accent hover:underline"
                >
                  Go to default directory
                </button>
              </div>
            ) : (
              <div className="space-y-1">
                {/* Go Up */}
                {parentPath && (
                  <button
                    type="button"
                    onClick={() => handleNavigate(parentPath)}
                    aria-label="Go to parent folder"
                    className="w-full flex items-center gap-3 px-3 py-2 text-left rounded-lg hover:bg-port-border/50 text-gray-400 hover:text-white transition-colors"
                  >
                    <ChevronUp size={18} />
                    <span>..</span>
                  </button>
                )}

                {/* Directories */}
                {directories.map((dir) => (
                  <button
                    key={dir.path}
                    type="button"
                    onClick={() => handleNavigate(dir.path)}
                    className="w-full flex items-center gap-3 px-3 py-2 text-left rounded-lg hover:bg-port-border/50 text-white transition-colors"
                  >
                    <FolderOpen size={18} className="text-port-accent shrink-0" />
                    <span className="truncate">{dir.name}</span>
                  </button>
                ))}

                {files.map(file => (
                  <button key={file.path} type="button"
                    onClick={() => { onChange(file.path); setIsOpen(false); }}
                    className="w-full flex items-center gap-3 px-3 py-2 text-left rounded-lg hover:bg-port-border/50 text-white">
                    <File size={18} className="shrink-0" />
                    <span className="truncate">{file.name}</span>
                  </button>
                ))}

                {directories.length === 0 && !parentPath && (
                  <div className="text-center text-gray-500 py-8">
                    No subdirectories
                  </div>
                )}
              </div>
            )}
          </div>

          {/* Footer */}
          <div className="flex items-center justify-between gap-3 p-4 border-t border-port-border">
            <button
              type="button"
              onClick={() => setIsOpen(false)}
              className="px-4 py-2 text-gray-400 hover:text-white transition-colors"
            >
              Cancel
            </button>
            <button
              type="button"
              onClick={handleSelect}
              disabled={mode === 'file' || !currentPath || loading || !!error}
              className="flex items-center gap-2 px-4 py-2 bg-port-accent hover:bg-port-accent/80 text-white rounded-lg transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
            >
              <Check size={18} />
              {mode === 'file' ? 'Choose a file above' : 'Select This Folder'}
            </button>
          </div>
        </Modal>
      )}
    </div>
  );
}