folder_open Discovery — Panduan Penggunaan

Discovery adalah sidebar untuk menjelajahi file, mengedit kode, mengelola snippet, dan pengaturan editor — semuanya langsung di dalam aplikasi.

1. Sidebar Workspace (Pohon Folder)

1.2. Menambah Folder Proyek

Cara	Tindakan
Klik tombol + (Add Folder) di header sidebar	Membuka dialog pilih folder → folder ditambahkan
Menu Project di sidebar	Sama dengan tombol +

1.3. Menghapus Folder Proyek

Klik kanan header folder proyek → Remove Workspace Folder, atau klik tombol − di header sidebar.

1.4. Navigasi Pohon

Tindakan	Hasil
Klik chevron ▸	Membuka/menutup folder
Klik nama folder	Memilih folder
Klik nama berkas	Membuka berkas di editor
Klik kanan	Menu sesuai tipe elemen

1.5. Context Menu

Tipe	Menu
File	Open, Open Browser, Open Terminal, Open Folder, Add to Chat, Rename, Delete, Duplicate, Copy, Cut, Copy Name, Copy Path, Copy Relative Path
Folder	New File, New Folder, Open Terminal, Open Folder, Add to Source Control, Rename, Delete, Copy, Cut, Paste, Copy Name, Copy Path, Copy Relative Path
Workspace Root	New File, New Folder, Add Workspace Folder, Remove Workspace Folder, Open Terminal, Open Folder, Add to Source Control, Paste
Background	Add Workspace Folder, Paste

1.6. State Expand Tetap Tersimpan

Setelah refresh halaman (F5) atau setelah membuat/menghapus file, folder yang sebelumnya sudah dibuka akan tetap terbuka secara otomatis.

2. Editor Berkas

2.1. Format yang Didukung

Jenis	Keterangan
Teks / Kode	Editor dengan pewarnaan sintaks
Markdown `.md`	Tab Markdown + Preview (layar terbagi)
Gambar `.png .jpg .gif .webp .svg .ico .avif`	Pratinjau gambar langsung
DOCX / DOC / WPS	Pratinjau hasil konversi HTML
XLSX / XLS / ET	Tabel dengan tab per sheet
PPTX / PPT / DPS	Menampilkan ikon + informasi file
PDF	Tampilan inline

2.2. Tema Editor

Terang: Default, Eclipse, Neo, IDEA
Gelap: Monokai, Ambiance, Cobalt, Dracula, Material Darker, Base16 Dark

2.3. Pintasan Keyboard

Pintasan	Fungsi
`Ctrl+S`	Simpan berkas
`Ctrl+F`	Cari
`Ctrl+H`	Cari & Ganti
`F3`	Cari berikutnya
`Shift+F3`	Cari sebelumnya
`Ctrl+L`	Add to Chat — kirim teks ke Chat
`Ctrl+K`	Quick Edit — edit dengan AI
`Tab`	Autocomplete / saran

2.6. Penanganan File Besar

Ukuran File	Perilaku
Kecil (< 2.200 baris)	Normal, semua fitur aktif
Sedang (≥ 2.200 baris)	Beberapa fitur otomatis nonaktif demi performa
Besar (≥ 9.500 baris)	Mulai tanpa pewarnaan, pewarnaan aktif setelah jeda

3. Pratinjau Berkas Non-Teks

File gambar (.png .jpg .gif .webp .svg .bmp .ico .avif) ditampilkan dengan header nama file + ukuran + tipe dan latar kotak-kotak untuk indikasi transparansi. File DOCX/DOC/WPS dikonversi ke HTML. File XLSX/XLS/ET ditampilkan dengan tab per sheet. File PDF ditampilkan inline.

4. Markdown Editor Split

Untuk file .md, editor menampilkan dua tab:

Tab	Konten
Markdown	Editor teks sumber
Preview	Hasil pratinjau HTML langsung

Fitur preview: pewarnaan sintaks untuk blok kode, Diagram Mermaid, Emoji, Checklist / task list, Tautan heading otomatis.

5. Quick Edit (`Ctrl+K`) — Edit Inline dengan AI

Pilih kode di editor Discovery.
Tekan Ctrl+K atau klik tombol Quick di toolbar mengambang.
Panel Quick Edit muncul di dekat seleksi.
Tulis perintah (mis. "ubah jadi arrow function").
Tekan Enter atau klik tombol generate.
AI memproses → hasil edit ditampilkan.
Accept → terapkan. Reject → batalkan. Regenerate → ulangi.

Mode	Deskripsi
Edit Selection	Hanya mengubah kode yang dipilih
Edit File	Mengubah seluruh isi file

Perubahan baru ditandai hijau, baris yang dihapus ditandai merah.

6. Snippet Kode

Buka via File → Discovery → Snippets. Panel dua kolom: form di kiri, daftar snippet di kanan.

Field	Deskripsi
Judul snippet	Nama untuk ditemukan di daftar
Mode (syntax)	JavaScript, JSON, CSS, HTML, Markdown, XML, SQL, YAML, PHP, Plain text
Isi kode	Editor dengan pewarnaan sesuai mode

Saat mengetik di editor, judul snippet muncul sebagai saran otomatis — cukup klik untuk menyisipkan kode snippet.

7. Pengaturan Editor (Settings)

Buka via File → Discovery → Editor Settings.

Opsi	Deskripsi
Ukuran font	10–28 px
Font	Pilihan font (Consolas, Fira Code, JetBrains Mono, dll.)
Nomor baris	Tampilkan/Sembunyikan nomor baris
Potong baris panjang	Bungkus baris yang melebihi lebar editor
Ukuran tab	2, 4, atau 8 spasi
Indent per level	2, 4, atau 8
Ikuti Mode visual	Sesuaikan tema dengan mode terang/gelap

8. Operasi CRUD pada Berkas/Folder

Baru: Klik kanan folder → New File / New Folder → ketik nama langsung di pohon.
Hapus: Pilih file/folder → klik kanan → Delete.
Ganti Nama: Klik kanan → Rename → ketik nama baru langsung di pohon.
Duplikat: Klik kanan → Duplicate → salinan muncul dengan nama nama (copy).ext.
Cut / Copy / Paste: Pindahkan atau salin file/folder ke lokasi baru.

9. Drag-and-Drop

Seret file/folder ke panel Chat → jadi referensi @namaFile
Seret header folder proyek ke posisi baru → susun ulang urutan
Node yang diseret tampak redup; target tujuan highlight biru

10. Multi-Select (`Ctrl+Click`)

Tekan Ctrl+Click untuk memilih beberapa file/folder. Operasi yang didukung: Delete, Copy, Cut, Copy Name, Copy Path, Copy Relative Path. Klik di area kosong untuk membatalkan seleksi.

15. History Editor — Riwayat Versi File

Setiap kali file disimpan (Ctrl+S di editor atau AI menulis file via Chat), snapshot isi file otomatis disimpan ke %APPDATA%\Nxcode\file-history\. Maksimal 30 versi per file.

Tindakan	Cara
Hapus satu snapshot	Hover baris snapshot → klik icon delete
Hapus semua snapshot satu file	Hover baris file di daftar → klik icon delete
Hapus semua riwayat	Hover header HISTORY → klik icon delete_sweep

16. Timeline — Log Aktivitas

Timeline mencatat setiap file yang dibuka dan disimpan secara kronologis terbalik. Maksimal 100 entri.

Rentang	Tampilan
Kurang dari 1 menit	"baru saja"
Kurang dari 60 menit	"X mnt lalu"
Kurang dari 24 jam	"X jam lalu"
Kemarin	"kemarin HH:MM"
Lebih lama	"DD/MM HH:MM"

Nxdom Framework