explorer
File-Explorer in zid: Fokus, Tastatur/Navigation, Mehrfachauswahl, Papierkorb, Anlegen/Umbenennen, .gitignore-Anzeige und Tab-Nachführung. Use when touching src/ui/file_explorer*, explorer_ops.zig, di
SKILL.md.claude/skills/explorer/SKILL.md
GitHubExplorer: Fokus, Tastatur, Auswahl, Papierkorb
Symlink auf einen Ordner ist ein Ordner (
explorer_ops.isDirectoryfolgt dem Link, z. B.wartungsheft/business-plan -> ../business/auto-service).TabBar.appendFileTablehnt Verzeichnisse miterror.IsDirab, egal ob Explorer, Ctrl+P, Agent oder RPCopen_file. Scheitert der Buffer-Load beim Tab-Wechsel trotzdem (z. B. AccessDenied), meldetmain.zigden Fehler einmal, schließt den Tab und nulltpending_switch_path; sonst wiederholt sich der Fehler in jedem Frame. E2E:python3 scripts/e2e_symlink_dir.py.Fokus (
ui_state.explorer_focused) setzt jeder Klick in die Sidebar, Escape gibt ihn ab; die Sidebar zeigt ihn als linken Rahmen inborder_focus. Mit Fokus erreicht keine Taste den Editor: Explorer-Kürzel ausshortcuts.zig(Scopeexplorer, auch ohne markierten Eintrag) → sonstFileExplorerState.handleNavKey(↑↓ mit Shift-Bereich, ←→ zu-/aufklappen bzw. Eltern/Kind, Enter/Space öffnet, Home/End, PageUp/PageDown) → Rest wird geschluckt. Buchstaben wie in nvim-tree/yazi:dPapierkorb,rumbenennen,a/Shift+Aanlegen,y/x/pkopieren/ ausschneiden/einfügen,Ctrl+Dduplizieren,c/Shift+CPfad,Shift+R/F5 neu laden,walles zuklappen,Ctrl+Aalles markieren. Kein Type-ahead: Buchstaben sind Kürzel.Auswahl ist eine Menge (
selected_nodes, Ctrl+Klick toggelt, Shift+Klick/Shift+↑↓ Bereich abanchor_index),selected_indexist der Cursor. Ordner-Klick markiert und toggelt.selectedPathslässt Kinder markierter Ordner weg. Ctrl+Klick lässt sich per RPC nicht auslösen (Modifier gelten nur fürkey_press_mods), der E2E nimmt Shift+↓.Anzeige: Namen werden auf die Sidebar-Breite gekürzt („…“,
ellipsizemisst permeasureTextWidth), ein Tooltip mit dem vollen Pfad erscheint nach 700 ms über einer Zeile (hover_index/hover_since_ms, Elementfx_tooltip). Ordner erben die Git-Farbe ihrer Nachfahren (folderStatus, C > M > A > ?), Icons nach Endung (fileIcon-Tabelle). Versteckte Einträge zeigt Taste.oder „Toggle Hidden Files" im View-Menü (show_hidden, gedämpft, mit Häkchen). Das Filterfeld öffnet/(Name enthält Text, Elternordner bleiben, Ordner mit Treffern gelten als aufgeklappt; nur geladene Knoten werden durchsucht; Enter behält den Filter, Escape leert ihn). Drag & Drop: Ziehen eines Eintrags auf einen Ordner (oder eine Datei darin) fragt „Move 'a' into 'b'?“ und ruftperformMove(drag/pending_move).Gemerkter Zustand (
src/ui/user_state.zig, unit-getestet):$XDG_CONFIG_HOME/zid/statebzw.~/.config/zid/statemitsidebar_widthundshow_hidden; geschrieben nach dem Splitter-Ziehen und beim Umschalten, gelesen inUI.loadUserStatenachsetupClay. E2E setztXDG_CONFIG_HOME=tmp/xdg-config.Kontextmenü ist datengetrieben (
context_menu_items, Labels/Kürzel aus der Tabelle, IDsfx_menu_<command>, gezeichnet übercontext_menu.zig); der Klick landet inpending_command, die UI führtexecuteCommandaus.Kleine Editierfelder (Umbenennen, Anlegen, Filter, Picker-Suche, Pfad im Ordner-Dialog, Commit-Nachricht) teilen
explorer_ops.EditBufferundline_edit.zig. Auswahl:anchorim Puffer, Shift+Pfeile/Pos1/Ende/↑↓ erweitern, Ctrl+←/→ wortweise (moveWordLeft/Right, Klassen Wort/Satzzeichen/Leerraum), Ctrl+A/C/X/V überline_edit.Clipboard(UI.editClipboard: Fenster oder headlesslast_clipboard_text), Shift+Klick und Ziehen (handleClick(extend),handleDrag,handleRelease;mouse_selectingim Puffer). Tippen/Backspace/Entf/Einfügen ersetzen die Auswahl imEditBuffer, einzeilige Felder machen beim Einfügen aus Umbrüchen Leerzeichen (insertText(multiline)). Markierung: Element<feld-id>_sel(Commit-Feldsc_input_selje Zeile). Die Feld-Handler bekommenline_edit.Modsund?Clipboardvonmod.zig(editMods). Unit-Tests inexplorer_ops.zig, E2Epython3 scripts/e2e_line_edit.py. Anlegen zeigt eine Eingabezeile unter dem Zielordner (startCreate,targetFolder: markierter Ordner, sonst Elternordner, sonst Root); Enter legt an (Dateien werden geöffnet), Escape bricht ab.Löschen = Papierkorb (
explorer_ops.trashPath:$XDG_DATA_HOME/Trashbzw.~/.local/share/Trash,files/+info/*.trashinfo, DeletionDate in UTC), Fallbackgio trash, nie endgültig. Über Laufwerksgrenzen (USB-Stick, Netz, andere Partition) geht das Rename nicht; dann kopiertexplorer_ops.moveByCopyin den Home-Papierkorb und löscht danach das Original (scheitert ein Schritt, bleibt das Original). Kein eigener Ablageort: der Home-Papierkorb ist der, den die Oberfläche zeigt, und „Wiederherstellen“ folgt dem Pfad in der.trashinfo. E2E-Skripte setzenXDG_DATA_HOME=tmp/xdg, damit der echte Papierkorb leer bleibt. Fehler von Explorer-Aktionen landen intakeError→ Dialog „Error“ statt nur im Log.Windows (
src/platform/recycle_bin.zig): Recycle Bin überSHFileOperationWmitFOF_ALLOWUNDO, aber nur auf festen Laufwerken (GetDriveTypeW == DRIVE_FIXED). Netz- und Wechsellaufwerke haben keinen Papierkorb, Windows würde dort mitFOF_NOCONFIRMATIONstill endgültig löschen; deshalbFileExplorer.recycleViaStaging: Kopie nach%LOCALAPPDATA%\zid\recycled(copyPath), die Kopie in den Recycle Bin, dann das Original entfernen. Die Datei liegt so im normalen Papierkorb; „Wiederherstellen“ legt sie in den Zwischenordner, nicht aufs Netzlaufwerk zurück (die API kennt keinen fremden Ursprungsort; das$I-Format selbst zu schreiben wäre undokumentiert). Die Statusmeldung nennt den Ordner. Ein gesetztesXDG_DATA_HOMEerzwingt auch unter Windows die freedesktop-Ablage (E2E).build.ziglinkt dafürshell32.Dialoge per Tastatur (
dialog_ops.zig, unit-getestet): Enter wählt den fokussierten Button (Start: erster = primär), Escape Cancel, Tab/Shift+Tab wandern, Anfangsbuchstabe wählt (dDelete,sSave,nDon't Save). Bei offenem Dialog erreicht keine Taste und kein Zeichen den Editor. InrenderExamplewirdad.key_resulterst nach dem Übernehmen inpending_dialog_resultgeleert, weilres = render(...) orelse ad.key_resultauf das Feld verweisen kann.Explorer testen:
explorer_entriesliefert Viewport-Bounds,row_height,scrollund die sichtbaren Zeilen mit Index; Zeilenmitte =viewport.y + index*row_height + row_height/2 - scroll. Zeilen außerhalb des Viewports vorher mitscroll x y lines(negativ = runter) hereinholen. Das ist die UI-Konvention allerscrollLines(positiv = hoch). Im Fenster spiegeltplatform/wheel.zigdas wio-Delta (positiv = Rad nach unten, auf jeder Plattform gleich) ohne OS-Sonderfall; der RPC umgeht diese Stelle, das Vorzeichen deckt nur der Unit-Test ab. Beim Prüfen von Hand: das Touchpad hat unter GNOME Natural Scrolling, die Maus nicht. Rechtsklick auf eine Zeile öffnet das Menü (Rename/Delete); F2/Entf wirken auf den markierten Eintrag, aber nur wenn der letzte Klick im Explorer war (ui_state.explorer_focused).python3 scripts/e2e_explorer.pyfährt Fokus, Kürzel, Dialog-Tastatur, Papierkorb, Navigation, Anlegen/Umbenennen, Zwischenablage, Mehrfachauswahl und Kontextmenü headless durch.
Explorer: .gitignore-Einträge
taskGitStatusruftgit status --porcelain=v2 --branch --null --ignored(im Projekt ~50 ms mehr) und schreibt zusätzlichroot:<toplevel>(ausrev-parse --show-toplevel): porcelain-Pfade sind relativ zur Repo-Wurzel, nicht zum Projektordner. Das Parsing steckt ingit_worker.parseStatusOutput(unit-getestet); ignorierte Einträge kommen alsI:<pfad>, Ordner ohne den abschließenden Schrägstrich von! pfad/.FileExplorer.isIgnored(path): Eintrag selbst oder ein Vorfahr mitI→ Name intheme.muted, kein Badge;folderStatusüberspringtI, damit ein ignorierter Ordner keinen Status nach oben vererbt. RPCexplorer_entries[].ignored; E2E-Schrittstep_gitignorenutzt, dasstmp/im Projekt ignoriert ist.file_explorer.git_statushängt angit_status_mutex: der Main-Thread ersetzt die Map inupdateGitStatus(Keys werden freigegeben), währendexplorer_entriessie gleichzeitig liest. Zugriff nur überstatusFor,isIgnored,folderStatus, nie direkt auf die Map (sonst Segfault inisIgnored).
Explorer: Umbenennen/Löschen und offene Tabs
- Umbenennen zieht Tab-Pfad, Titel, Buffer-Pfad und
open_buffers-Schlüssel mit, auch für alle Tabs unter einem umbenannten Ordner (Preview-Tabs mitpreview://-Präfix ebenso). - Klick in den Editor setzt
selection_anchor = cursor; jede Eingabe hebt den Anker wieder auf (deleteSelection), sonst ersetzt das zweite getippte Zeichen das erste. - Löschen schließt Tabs ohne ungespeicherte Änderungen; geänderte Tabs bleiben offen mit
Stern, Speichern legt die Datei wieder an (Verhalten wie VS Code). Buffer gelöschter
Dateien wandern nach
orphan_buffers(bis Programmende), damit ein neu angelegtes File mit gleichem Namen nicht den alten Inhalt bekommt. - Ablauf: Explorer setzt
pending_fs_change,UI.update()holt es pertakeFsChangeab und wendet es vor dem Layout an (applyFsChange).