Files tab: browser with breadcrumbs/sort/filter, text editor, image preview, streamed upload with progress, download, mkdir/touch/rename/move/chmod/delete, open-in-terminal; root toggle via sudo-reexecuted 'hamlab fs' helper

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-18 05:39:57 -07:00
parent 38d4ee09ae
commit 63b020d556
9 changed files with 1094 additions and 9 deletions
@@ -0,0 +1,233 @@
+import { DragEvent, useCallback, useEffect, useRef, useState } from 'react'
+import { api, FileEntry, FileInfo } from './api'
+import { fmtBytes } from './Dashboard'
+import { Btn, Loading, Spinner, toast } from './ui'
+
+const join = (dir: string, name: string) => (dir === '/' ? '/' + name : dir + '/' + name)
+const fmtTime = (ms: number) => { const d = new Date(ms); const now = new Date(); return d.toDateString() === now.toDateString() ? d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) : d.toLocaleDateString(undefined, { year: d.getFullYear() === now.getFullYear() ? undefined : 'numeric', month: 'short', day: '2-digit' }) }
+const isImage = (n: string) => /\.(png|jpe?g|gif|webp|svg|bmp|ico|avif)$/i.test(n)
+const shellQuote = (s: string) => "'" + s.replace(/'/g, "'\\''") + "'"
+const MAX_EDIT = 2 * 1024 * 1024
+
+function icon(e: FileEntry): string {
+  if (e.type === 'dir') return e.target ? '🔗' : '📁'
+  if (e.type === 'link') return e.broken ? '⛓️‍💥' : '🔗'
+  if (e.type === 'other') return '⚙️'
+  if (isImage(e.name)) return '🖼️'
+  if (/\.(zip|gz|bz2|xz|zst|tar|tgz|7z|rar)$/i.test(e.name)) return '🗜️'
+  if (/\.(sh|bash|zsh|py|go|js|ts|tsx|rb|pl|php|rs|c|h|cpp|java|lua)$/i.test(e.name) || e.mode.includes('x')) return '📜'
+  if (/\.(log|txt|md|json|ya?ml|toml|ini|conf|cfg|env|service|timer)$/i.test(e.name)) return '📄'
+  return '📄'
+}
+
+type Sort = 'name' | 'size' | 'mtime'
+
+// ---- editor / viewer ----
+function Viewer({ path, sudo, onClose, onChanged }: { path: string; sudo: boolean; onClose: () => void; onChanged: () => void }) {
+  const [info, setInfo] = useState<FileInfo | null>(null)
+  const [text, setText] = useState<string | null>(null)
+  const [orig, setOrig] = useState('')
+  const [err, setErr] = useState('')
+  const [saving, setSaving] = useState(false)
+  const name = path.split('/').pop() ?? path
+  const dirty = text !== null && text !== orig
+
+  useEffect(() => {
+    setInfo(null); setText(null); setErr('')
+    let stop = false
+    ;(async () => {
+      try {
+        const i = await api.fileStat(path, sudo)
+        if (stop) return
+        setInfo(i)
+        if (i.text && i.size <= MAX_EDIT && !isImage(name)) {
+          const t = await api.fileRead(path, sudo)
+          if (stop) return
+          setText(t); setOrig(t)
+        }
+      } catch (e) { if (!stop) setErr(e instanceof Error ? e.message : 'failed') }
+    })()
+    return () => { stop = true }
+  }, [path, sudo, name])
+
+  const save = useCallback(async () => {
+    if (text === null || !dirty) return
+    setSaving(true)
+    try { await api.fileWrite(path, text, sudo); setOrig(text); toast(`${name} saved`); onChanged() }
+    catch (e) { toast(`save failed — ${e instanceof Error ? e.message : 'failed'}`, 'err') }
+    finally { setSaving(false) }
+  }, [text, dirty, path, sudo, name, onChanged])
+
+  useEffect(() => {
+    const h = (e: KeyboardEvent) => { if ((e.ctrlKey || e.metaKey) && e.key === 's') { e.preventDefault(); save() } }
+    window.addEventListener('keydown', h)
+    return () => window.removeEventListener('keydown', h)
+  }, [save])
+
+  const close = () => { if (dirty && !window.confirm('Discard unsaved changes?')) return; onClose() }
+  const dl = api.fileDownloadURL(path, sudo)
+
+  return (
+    <div className="viewer">
+      <div className="viewer-bar">
+        <button className="btn" onClick={close}>‹ Back</button>
+        <span className="vname mono" title={path}>{name}{dirty && <span className="dirty"> •</span>}</span>
+        <span className="spacer" />
+        {info && <span className="muted num">{fmtBytes(info.size)} · {info.perm} · {info.user}</span>}
+        <a className="btn" href={dl} download={name}>Download</a>
+        {text !== null && <Btn className="btn on" disabled={!dirty || saving} onClick={save}>Save</Btn>}
+      </div>
+      {err && <div className="error">{err}</div>}
+      {!info && !err && <Loading label="Opening…" />}
+      {info && text !== null && (
+        <textarea className="editor file-editor" value={text} spellCheck={false} onChange={(e) => setText(e.target.value)} />
+      )}
+      {info && text === null && isImage(name) && <div className="preview"><img src={api.fileReadURL(path, sudo)} alt={name} /></div>}
+      {info && text === null && !isImage(name) && !err && (
+        <div className="notice">{info.type === 'dir' ? 'This is a directory.' : info.size > MAX_EDIT ? `Too large to edit here (${fmtBytes(info.size)}). Download it instead.` : 'Binary file. Download it instead.'}</div>
+      )}
+    </div>
+  )
+}
+
+// ---- page ----
+export default function Files({ onOpenInTerminal }: { onOpenInTerminal?: (cmd: string) => void }) {
+  const [path, setPath] = useState<string>(() => sessionStorage.getItem('hamlab.files.path') || '/')
+  const [sudo, setSudo] = useState<boolean>(() => sessionStorage.getItem('hamlab.files.sudo') === '1')
+  const [entries, setEntries] = useState<FileEntry[] | null>(null)
+  const [err, setErr] = useState('')
+  const [hidden, setHidden] = useState(false)
+  const [sort, setSort] = useState<Sort>('name')
+  const [q, setQ] = useState('')
+  const [pathInput, setPathInput] = useState(path)
+  const [open, setOpen] = useState<string | null>(null)
+  const [menu, setMenu] = useState<string | null>(null)
+  const [upload, setUpload] = useState<{ name: string; pct: number; n: number; of: number } | null>(null)
+  const [drag, setDrag] = useState(false)
+  const fileInput = useRef<HTMLInputElement>(null)
+  const canSudo = useRef(true)
+
+  const load = useCallback(async (p = path, s = sudo) => {
+    try {
+      const l = await api.files(p, s)
+      setEntries(l.entries); setErr('')
+      canSudo.current = true
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : 'failed'
+      setErr(msg); setEntries([])
+    }
+  }, [path, sudo])
+
+  useEffect(() => { setEntries(null); setPathInput(path); setMenu(null); load(path, sudo); sessionStorage.setItem('hamlab.files.path', path); sessionStorage.setItem('hamlab.files.sudo', sudo ? '1' : '0') }, [path, sudo, load])
+  useEffect(() => { const h = () => setMenu(null); window.addEventListener('click', h); return () => window.removeEventListener('click', h) }, [])
+
+  const go = (p: string) => { setOpen(null); setPath(p || '/') }
+  const crumbs = path === '/' ? [] : path.slice(1).split('/')
+
+  const shown = (entries ?? []).filter((e) => (hidden || !e.name.startsWith('.')) && (!q || e.name.toLowerCase().includes(q.toLowerCase())))
+    .sort((a, b) => {
+      if ((a.type === 'dir') !== (b.type === 'dir')) return a.type === 'dir' ? -1 : 1
+      if (sort === 'size') return b.size - a.size
+      if (sort === 'mtime') return b.mtime - a.mtime
+      return a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: 'base' })
+    })
+
+  // ---- actions ----
+  const act = async (label: string, fn: () => Promise<unknown>) => {
+    try { await fn(); toast(label); await load() } catch (e) { toast(`${label} — ${e instanceof Error ? e.message : 'failed'}`, 'err') }
+  }
+  const mkdir = () => { const n = window.prompt('New folder name'); if (n?.trim()) act(`created ${n.trim()}`, () => api.fileMkdir(join(path, n.trim()), sudo)) }
+  const touch = () => { const n = window.prompt('New file name'); if (n?.trim()) act(`created ${n.trim()}`, () => api.fileTouch(join(path, n.trim()), sudo)).then(() => setOpen(join(path, n.trim()))) }
+  const rename = (e: FileEntry) => { const n = window.prompt('Rename to', e.name); if (n?.trim() && n.trim() !== e.name) act(`renamed to ${n.trim()}`, () => api.fileRename(join(path, e.name), join(path, n.trim()), sudo)) }
+  const move = (e: FileEntry) => { const n = window.prompt('Move to (absolute path)', join(path, e.name)); if (n?.trim() && n.trim() !== join(path, e.name)) act(`moved to ${n.trim()}`, () => api.fileRename(join(path, e.name), n.trim(), sudo)) }
+  const chmod = (e: FileEntry) => { const n = window.prompt(`Permissions for ${e.name} (octal)`, e.perm); if (n?.trim() && n.trim() !== e.perm) act(`chmod ${n.trim()} ${e.name}`, () => api.fileChmod(join(path, e.name), n.trim(), sudo)) }
+  const del = (e: FileEntry) => {
+    const full = join(path, e.name)
+    if (e.type === 'dir' && !e.target) {
+      const typed = window.prompt(`Delete the folder "${e.name}" and everything in it?\nType its name to confirm.`)
+      if (typed !== e.name) return
+      act(`deleted ${e.name}`, () => api.fileDelete(full, true, sudo))
+    } else if (window.confirm(`Delete ${e.name}?`)) act(`deleted ${e.name}`, () => api.fileDelete(full, false, sudo))
+  }
+  const copyPath = async (e: FileEntry) => { try { await navigator.clipboard.writeText(join(path, e.name)); toast('path copied') } catch { window.prompt('Path', join(path, e.name)) } }
+  const openTerm = (p: string) => { onOpenInTerminal?.(`cd ${shellQuote(p)}`); }
+
+  // ---- upload ----
+  const uploadFiles = async (files: FileList | File[]) => {
+    const list = Array.from(files)
+    for (let i = 0; i < list.length; i++) {
+      const f = list[i]
+      setUpload({ name: f.name, pct: 0, n: i + 1, of: list.length })
+      try {
+        await api.fileUpload(path, f, sudo, (pct) => setUpload({ name: f.name, pct, n: i + 1, of: list.length }))
+      } catch (e) { toast(`upload ${f.name} — ${e instanceof Error ? e.message : 'failed'}`, 'err'); break }
+    }
+    setUpload(null)
+    toast(list.length === 1 ? `uploaded ${list[0].name}` : `uploaded ${list.length} files`)
+    load()
+  }
+  const onDrop = (e: DragEvent) => { e.preventDefault(); setDrag(false); if (e.dataTransfer.files.length) uploadFiles(e.dataTransfer.files) }
+
+  if (open) return <div className="files"><Viewer path={open} sudo={sudo} onClose={() => setOpen(null)} onChanged={() => load()} /></div>
+
+  return (
+    <div className={'files' + (drag ? ' drag' : '')} onDragOver={(e) => { e.preventDefault(); setDrag(true) }} onDragLeave={() => setDrag(false)} onDrop={onDrop}>
+      <div className="files-bar">
+        <form className="crumbs" onSubmit={(e) => { e.preventDefault(); go(pathInput.trim()) }}>
+          <button type="button" className="crumb" onClick={() => go('/')}>/</button>
+          {crumbs.map((c, i) => <button type="button" key={i} className="crumb" onClick={() => go('/' + crumbs.slice(0, i + 1).join('/'))}>{c}</button>)}
+          <input className="path-input" value={pathInput} onChange={(e) => setPathInput(e.target.value)} onBlur={() => setPathInput(path)} spellCheck={false} />
+        </form>
+        <div className="files-tools">
+          <button className={'btn' + (sudo ? ' on' : '')} title="browse as root" onClick={() => setSudo(!sudo)}>{sudo ? 'root' : 'sudo'}</button>
+          <button className={'btn' + (hidden ? ' on' : '')} title="show hidden files" onClick={() => setHidden(!hidden)}>.hidden</button>
+          <select className="btn" value={sort} onChange={(e) => setSort(e.target.value as Sort)}><option value="name">name</option><option value="size">size</option><option value="mtime">modified</option></select>
+          <input className="filter" placeholder="filter" value={q} onChange={(e) => setQ(e.target.value)} />
+          <button className="btn" onClick={mkdir}>+ folder</button>
+          <button className="btn" onClick={touch}>+ file</button>
+          <button className="btn" onClick={() => fileInput.current?.click()}>Upload</button>
+          <input ref={fileInput} type="file" multiple style={{ display: 'none' }} onChange={(e) => { if (e.target.files?.length) uploadFiles(e.target.files); e.target.value = '' }} />
+          {onOpenInTerminal && <button className="btn" title="cd here in the active terminal" onClick={() => openTerm(path)}>&gt;_ here</button>}
+          <Btn className="btn" title="reload" onClick={() => load()}>↻</Btn>
+        </div>
+      </div>
+
+      {upload && <div className="upload-bar"><Spinner /> {upload.of > 1 ? `${upload.n}/${upload.of} · ` : ''}{upload.name} · {upload.pct}%<div className="meter"><div className="fill" style={{ width: `${upload.pct}%` }} /></div></div>}
+      {err && <div className="error" style={{ padding: '6px 12px' }}>{err}{/permission denied/i.test(err) && !sudo && <> · <button className="link" onClick={() => setSudo(true)}>retry as root</button></>}</div>}
+
+      <div className="file-list">
+        {entries === null && <Loading label="Listing…" />}
+        {path !== '/' && entries !== null && (
+          <div className="file-row up" onClick={() => go(path.slice(0, path.lastIndexOf('/')) || '/')}><span className="ficon">↩</span><span className="fname">..</span></div>
+        )}
+        {shown.map((e) => {
+          const full = join(path, e.name)
+          const isDir = e.type === 'dir'
+          return (
+            <div key={e.name} className={'file-row' + (e.broken ? ' broken' : '')} onClick={() => (isDir ? go(full) : setOpen(full))}>
+              <span className="ficon">{icon(e)}</span>
+              <span className="fname" title={e.target ? `→ ${e.target}` : e.name}>{e.name}{e.target && <span className="muted"> → {e.target}</span>}</span>
+              <span className="fmeta num">{isDir ? '' : fmtBytes(e.size)}</span>
+              <span className="fmeta num">{fmtTime(e.mtime)}</span>
+              <span className="fmeta num perm">{e.perm} {e.user}</span>
+              <button className="icon-btn more" onClick={(ev) => { ev.stopPropagation(); setMenu(menu === e.name ? null : e.name) }}>⋯</button>
+              {menu === e.name && (
+                <div className="ctx" onClick={(ev) => ev.stopPropagation()}>
+                  {!isDir && <a href={api.fileDownloadURL(full, sudo)} download={e.name} onClick={() => setMenu(null)}>Download</a>}
+                  {isDir && onOpenInTerminal && <button onClick={() => { setMenu(null); openTerm(full) }}>Open in terminal</button>}
+                  <button onClick={() => { setMenu(null); rename(e) }}>Rename</button>
+                  <button onClick={() => { setMenu(null); move(e) }}>Move…</button>
+                  <button onClick={() => { setMenu(null); chmod(e) }}>Permissions ({e.perm})</button>
+                  <button onClick={() => { setMenu(null); copyPath(e) }}>Copy path</button>
+                  <button className="danger" onClick={() => { setMenu(null); del(e) }}>Delete</button>
+                </div>
+              )}
+            </div>
+          )
+        })}
+        {entries !== null && shown.length === 0 && !err && <div className="muted" style={{ padding: 12 }}>{q ? 'Nothing matches.' : 'Empty folder.'}{!hidden && entries.some((e) => e.name.startsWith('.')) ? ' (hidden files not shown)' : ''}</div>}
+      </div>
+      {drag && <div className="drop-hint">Drop to upload into {path}</div>}
+    </div>
+  )
+}
@@ -8,6 +8,7 @@ import Services from './Services'
 import Cron from './Cron'
 import Updates from './Updates'
 import Disks from './Disks'
+import Files from './Files'
 import Power from './Power'
 import { Btn, NetBar, Toasts, toast } from './ui'

@@ -18,9 +19,10 @@ const GROUPS: Group[] = [
  { id: 'cron', label: 'Cron', icon: '⏱', page: true },
  { id: 'updates', label: 'Updates', icon: '⇪', page: true },
  { id: 'disks', label: 'Disks', icon: '▤', page: true },
+  { id: 'files', label: 'Files', icon: '🗀', page: true },
 ]

-type View = 'terminal' | 'dashboard' | 'services' | 'cron' | 'updates' | 'disks'
+type View = 'terminal' | 'dashboard' | 'services' | 'cron' | 'updates' | 'disks' | 'files'

 function fmtUptime(s: number): string {
  const d = Math.floor(s / 86400), h = Math.floor((s % 86400) / 3600), m = Math.floor((s % 3600) / 60)
@@ -68,6 +70,17 @@ export default function Shell({ me, onLoggedOut }: { me: Me; onLoggedOut: () =>
  }
  async function logout() { await api.logout(); onLoggedOut() }

+  // Files → "open in terminal": type into the active shell (creating one if needed) and switch to it.
+  async function runInTerminal(cmd: string) {
+    let id = active
+    if (!id || !terms.some((t) => t.id === id && t.running)) {
+      try { const t = await api.createTerminal(); await reload(); id = t.id; setActive(t.id) } catch (e) { toast(`terminal — ${e instanceof Error ? e.message : 'failed'}`, 'err'); return }
+    }
+    setView('terminal'); setDrawer(false)
+    const send = (tries: number) => { const h = handles.current[id!]; if (h) h.input(cmd + '\n'); else if (tries > 0) window.setTimeout(() => send(tries - 1), 100) }
+    window.setTimeout(() => send(20), 50)
+  }
+
  const activeTerm = terms.find((t) => t.id === active)
  const termView = view === 'terminal'

@@ -99,6 +112,7 @@ export default function Shell({ me, onLoggedOut }: { me: Me; onLoggedOut: () =>
          {view === 'cron' && <Cron />}
          {view === 'updates' && <Updates />}
          {view === 'disks' && <Disks />}
+          {view === 'files' && <Files onOpenInTerminal={runInTerminal} />}
          {termView && terms.length === 0 && (
            <div className="center muted">
              <div>No terminals.</div>
@@ -121,7 +135,7 @@ export default function Shell({ me, onLoggedOut }: { me: Me; onLoggedOut: () =>
        <span>{me.version.startsWith('v') ? me.version : 'v' + me.version}</span>
        <span>up {fmtUptime(me.uptime)}</span>
        <span className="spacer" />
-        <span className="muted">{view === 'dashboard' ? 'Dashboard' : view === 'services' ? 'Services' : view === 'cron' ? 'Cron' : view === 'updates' ? 'Updates' : view === 'disks' ? 'Disks' : activeTerm ? activeTerm.name : ''}</span>
+        <span className="muted">{view === 'dashboard' ? 'Dashboard' : view === 'services' ? 'Services' : view === 'cron' ? 'Cron' : view === 'updates' ? 'Updates' : view === 'disks' ? 'Disks' : view === 'files' ? 'Files' : activeTerm ? activeTerm.name : ''}</span>
      </footer>
    </div>
  )
@@ -51,7 +51,8 @@ export default function TerminalPane({ id, active, register, onStatus, onExit }:
    let lastSize = ''
    const enc = new TextEncoder()

-    const send = (s: string) => { if (ws && ws.readyState === WebSocket.OPEN) ws.send(enc.encode(s)) }
+    const queued: string[] = []
+    const send = (s: string) => { if (ws && ws.readyState === WebSocket.OPEN) ws.send(enc.encode(s)); else queued.push(s) }
    const sendResize = () => {
      const key = `${term.cols}x${term.rows}`
      if (key === lastSize) return
@@ -69,7 +70,7 @@ export default function TerminalPane({ id, active, register, onStatus, onExit }:
      const sock = new WebSocket(wsURL(id))
      sock.binaryType = 'arraybuffer'
      ws = sock
-      sock.onopen = () => { retry = 0; setConn('open'); cbs.current.onStatus(true); lastSize = ''; doFit() }
+      sock.onopen = () => { retry = 0; setConn('open'); cbs.current.onStatus(true); lastSize = ''; doFit(); while (queued.length) sock.send(enc.encode(queued.shift()!)) }
      sock.onmessage = (ev) => {
        if (ev.data instanceof ArrayBuffer) { term.write(new Uint8Array(ev.data)); return }
        try {
@@ -76,7 +76,40 @@ export interface SmartInfo { device: string; available: boolean; supported: bool
 export interface ZFSSnapshot { name: string; used: number; created: number }
 export interface ZFSInfo { available: boolean; message?: string; pools: { name: string; size: number; alloc: number; free: number; frag: number; cap: number; health: string; dedup: string; scan?: string; errors?: string; config?: string }[]; datasets: { name: string; type: string; used: number; avail: number; refer: number; used_by_snapshots: number; mount?: string; compressratio: string; snapshots: number }[] }

+export interface FileEntry { name: string; type: 'dir' | 'file' | 'link' | 'other'; size: number; mode: string; perm: string; mtime: number; user: string; group: string; target?: string; broken?: boolean }
+export interface FileInfo extends FileEntry { path: string; text: boolean }
+
+const q = (path: string, sudo: boolean, extra = '') => `path=${encodeURIComponent(path)}${sudo ? '&sudo=1' : ''}${extra}`
+
 export const api = {
+  files: (path: string, sudo: boolean) => req<{ path: string; parent?: string; entries: FileEntry[] }>('GET', `/api/files?${q(path, sudo)}`),
+  fileStat: (path: string, sudo: boolean) => req<FileInfo>('GET', `/api/files/stat?${q(path, sudo)}`),
+  fileRead: async (path: string, sudo: boolean): Promise<string> => {
+    const r = await fetch(`/api/files/read?${q(path, sudo, '&max=2097152')}`, { credentials: 'same-origin' })
+    if (r.status === 401) throw new Unauthenticated()
+    if (!r.ok) { let m = r.statusText; try { m = (await r.json()).error ?? m } catch { /* */ } throw new Error(m) }
+    return r.text()
+  },
+  fileReadURL: (path: string, sudo: boolean) => `/api/files/read?${q(path, sudo)}`,
+  fileDownloadURL: (path: string, sudo: boolean) => `/api/files/download?${q(path, sudo)}`,
+  fileWrite: async (path: string, text: string, sudo: boolean) => {
+    const r = await fetch(`/api/files/write?${q(path, sudo)}`, { method: 'PUT', credentials: 'same-origin', body: text, headers: { 'Content-Type': 'application/octet-stream' } })
+    if (r.status === 401) throw new Unauthenticated()
+    if (!r.ok) { let m = r.statusText; try { m = (await r.json()).error ?? m } catch { /* */ } throw new Error(m) }
+  },
+  fileUpload: (dir: string, file: File, sudo: boolean, onProgress: (pct: number) => void) => new Promise<void>((resolve, reject) => {
+    const x = new XMLHttpRequest()
+    x.open('PUT', `/api/files/upload?${q(dir, sudo)}&name=${encodeURIComponent(file.name)}`)
+    x.upload.onprogress = (e) => { if (e.lengthComputable) onProgress(Math.round((e.loaded / e.total) * 100)) }
+    x.onload = () => { if (x.status >= 200 && x.status < 300) resolve(); else { let m = x.statusText; try { m = JSON.parse(x.responseText).error ?? m } catch { /* */ } reject(new Error(m)) } }
+    x.onerror = () => reject(new Error('network error'))
+    x.send(file)
+  }),
+  fileMkdir: (path: string, sudo: boolean) => req<void>('POST', `/api/files/mkdir${sudo ? '?sudo=1' : ''}`, { path }),
+  fileTouch: (path: string, sudo: boolean) => req<void>('POST', `/api/files/touch${sudo ? '?sudo=1' : ''}`, { path }),
+  fileRename: (path: string, to: string, sudo: boolean) => req<void>('POST', `/api/files/rename${sudo ? '?sudo=1' : ''}`, { path, to }),
+  fileDelete: (path: string, recursive: boolean, sudo: boolean) => req<void>('POST', `/api/files/delete${sudo ? '?sudo=1' : ''}`, { path, recursive }),
+  fileChmod: (path: string, mode: string, sudo: boolean) => req<void>('POST', `/api/files/chmod${sudo ? '?sudo=1' : ''}`, { path, mode }),
  storage: () => req<{ devices: StorageDevice[]; zfs: ZFSInfo; smartctl: boolean }>('GET', '/api/storage'),
  smart: (dev: string, force = false) => req<SmartInfo>('GET', `/api/storage/smart/${dev}${force ? '?force=1' : ''}`),
  smartTest: (dev: string, kind: 'short' | 'long') => req<void>('POST', `/api/storage/smart/${dev}/test/${kind}`),
@@ -249,3 +249,41 @@ h2.section { margin: 0; font-size: 13px; font-weight: 600; color: var(--muted);
 .ds-snaps { padding: 8px 12px 10px 40px; border-bottom: 1px solid var(--border); background: var(--bg); display: flex; flex-direction: column; gap: 6px; }
 .snap-list { display: flex; flex-direction: column; gap: 2px; max-height: 40vh; overflow-y: auto; }
 .snap { display: flex; justify-content: space-between; gap: 12px; font-size: 12px; }
+
+/* files */
+.files { position: absolute; inset: 0; display: flex; flex-direction: column; background: var(--bg); }
+.files.drag { outline: 2px dashed var(--accent2); outline-offset: -4px; }
+.files-bar { display: flex; flex-direction: column; gap: 6px; padding: 8px 10px; background: var(--bg2); border-bottom: 1px solid var(--border); }
+.crumbs { display: flex; align-items: center; gap: 2px; flex-wrap: wrap; }
+.crumb { padding: 3px 6px; border-radius: 4px; font-family: ui-monospace, monospace; font-size: 13px; color: var(--accent2); }
+.crumb:hover { background: var(--bg3); } .crumb + .crumb::before { content: '/'; color: var(--muted); margin-right: 4px; }
+.path-input { flex: 1; min-width: 160px; margin-left: 8px; padding: 4px 8px; background: var(--bg); border: 1px solid var(--border); border-radius: 5px; color: var(--muted); font: 12px ui-monospace, monospace; }
+.path-input:focus { color: var(--fg); border-color: var(--accent2); outline: none; }
+.files-tools { display: flex; gap: 6px; flex-wrap: wrap; align-items: center; }
+.files-tools .filter { width: 110px; padding: 5px 8px; background: var(--bg); border: 1px solid var(--border); border-radius: 5px; color: var(--fg); font-size: 13px; }
+.file-list { flex: 1; overflow-y: auto; }
+.file-row { display: grid; grid-template-columns: 28px 1fr 80px 80px 130px 32px; gap: 8px; align-items: center; padding: 7px 10px; border-bottom: 1px solid var(--border); cursor: pointer; position: relative; }
+.file-row:hover { background: var(--bg3); }
+.file-row.up { color: var(--muted); }
+.file-row.broken .fname { color: var(--bad); }
+.ficon { text-align: center; font-size: 15px; }
+.fname { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.fmeta { color: var(--muted); text-align: right; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.more { justify-self: end; }
+.ctx { position: absolute; right: 36px; top: 4px; z-index: 5; background: var(--bg2); border: 1px solid var(--border); border-radius: 8px; box-shadow: 0 6px 20px rgba(0,0,0,.5); display: flex; flex-direction: column; min-width: 180px; overflow: hidden; }
+.ctx button, .ctx a { padding: 9px 14px; text-align: left; color: var(--fg); text-decoration: none; font-size: 13px; }
+.ctx button:hover, .ctx a:hover { background: var(--bg3); } .ctx .danger { color: var(--bad); }
+.upload-bar { padding: 6px 12px; font-size: 12px; color: var(--muted); border-bottom: 1px solid var(--border); display: flex; align-items: center; gap: 8px; }
+.upload-bar .meter { flex: 1; }
+.drop-hint { position: absolute; inset: 0; display: flex; align-items: center; justify-content: center; background: rgba(17,20,24,.7); color: var(--fg); font-size: 16px; pointer-events: none; }
+.viewer { position: absolute; inset: 0; display: flex; flex-direction: column; }
+.viewer-bar { display: flex; align-items: center; gap: 8px; padding: 8px 10px; background: var(--bg2); border-bottom: 1px solid var(--border); flex-wrap: wrap; }
+.vname { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 50vw; } .dirty { color: var(--accent); }
+.file-editor { flex: 1; min-height: 0; border: 0; border-radius: 0; resize: none; font-size: 13px; }
+.preview { flex: 1; display: flex; align-items: center; justify-content: center; overflow: auto; padding: 12px; }
+.preview img { max-width: 100%; max-height: 100%; object-fit: contain; }
+@media (max-width: 800px) {
+  .file-row { grid-template-columns: 24px 1fr 70px 32px; } .file-row .fmeta:nth-child(4), .file-row .perm { display: none; }
+  .path-input { width: 100%; margin: 4px 0 0; }
+  .files-tools .filter { width: 80px; }
+}