ZDDC
fb13ff4fd8
All checks were successful
Notify chart dev on beta cut / notify-chart-dev (push) Successful in 5s
A new HTML tool — browse — that lists the contents of any directory.
Designed for ZDDC archives but no ZDDC-specific filtering; just a
straight folder browser with expand/collapse, sort, and name filter.
Modes (auto-detected at page load):
- Online: when served by zddc-server at a folder URL, queries
the same URL with Accept: application/json to load the listing
and renders it. Auto-served as the default at any directory
under ZDDC_ROOT without an index.html (replacing the previous
minimal-HTML stub from directory.go).
- Local: 'Select Directory' button uses FileSystemAccessAPI to
pick any folder on disk; works in Chromium-based browsers.
Features (Phase 1 — what's in this commit):
- Tree view with lazy-loaded folders (children fetched on first
expand).
- Sort by name / size / extension / date (column header click).
- Filter by name substring (toolbar input).
- File click opens in a new tab — for server-backed pages,
routes through zddc-server's normal handler so .archive
redirects + apps cascade overrides + ACL all apply.
Phase 2 deferred:
- ZIP files inline expansion (treat archive entries as virtual
children).
- File preview popup (reuse shared/preview-lib.js).
- Extension multi-select filter.
Wiring:
- browse/ added to top-level ./build's per-tool list, embed
block, versions.txt, and the lockstep release commit + tag set.
All seven tools (archive, transmittal, classifier, mdedit,
landing, form, browse) advance together on stable cuts.
- shared/build-lib.sh: browse added to ZDDC_RELEASE_TOOLS and
verify_channel_links's per-tool loop.
- zddc/internal/apps/embed.go: //go:embed browse.html +
EmbeddedBytes("browse") case.
- zddc/internal/apps/availability.go: browse available at every
directory (same as archive).
- zddc/internal/apps/handler.go: MatchAppHTML routes
/<dir>/browse.html → 'browse'.
- zddc/internal/handler/directory.go: when a directory request
arrives with Accept: text/html and no index.html exists,
serve the embedded browse.html bytes (with a JSON-fallback
if the embedded slot is empty during bootstrap).
53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# browse — directory listing tool
|
|
|
|
Generic file browser for any directory. Designed to work with ZDDC
|
|
archives but useful for any folder. Single-file HTML, no install.
|
|
|
|
## How it's used
|
|
|
|
Two modes, auto-detected at page load:
|
|
|
|
1. **Online (zddc-server backed).** When this HTML is served by
|
|
zddc-server at a folder URL — which it is by default for any
|
|
directory under `ZDDC_ROOT` that doesn't have an `index.html` —
|
|
the JS queries the same URL with `Accept: application/json` to
|
|
load the directory's listing and renders it as a sortable,
|
|
filterable table.
|
|
|
|
2. **Local (FileSystemAccessAPI).** Click "Select Directory" in the
|
|
header to pick any folder on your computer. Works in
|
|
Chromium-based browsers (Chrome, Edge, Brave, etc.). No server
|
|
required; the directory is read directly from disk.
|
|
|
|
## What it does
|
|
|
|
- Lists files and folders with name, size, type (extension), and
|
|
modified date.
|
|
- Click a folder to expand inline. Children load lazily on first
|
|
expand.
|
|
- Click a column header to sort by that column. Click again to
|
|
reverse.
|
|
- Type in the filter to narrow to entries whose name contains the
|
|
substring.
|
|
- Click any file to open it in a new tab — for server-backed pages,
|
|
this routes through zddc-server's normal handler (so an `.archive`
|
|
redirect, an apps cascade override, etc. all work as expected).
|
|
|
|
## Design notes
|
|
|
|
- **No ZDDC-specific filtering.** This tool is intentionally
|
|
domain-agnostic. The companion `archive` tool layers ZDDC
|
|
parsing (project / status / revision filters, tracking-number
|
|
resolution) on top of the same listing API. Use `archive` when
|
|
you want ZDDC semantics; use `browse` when you just want to see
|
|
what's in a folder.
|
|
- **Default at directory URLs.** zddc-server's `directory.go`
|
|
serves the embedded browse.html bytes for any directory request
|
|
with `Accept: text/html` and no `index.html` present. This
|
|
means a user navigating to any folder under `ZDDC_ROOT` gets a
|
|
usable browser without anyone having to drop a file into the
|
|
archive.
|
|
- **Apps cascade override.** Like every other ZDDC tool, the
|
|
served `browse.html` can be overridden per-folder via a `.zddc
|
|
apps:` entry. The default is the embedded copy from the binary;
|
|
operators can pin a specific version or URL if they want.
|