summaryrefslogtreecommitdiff
path: root/docs/web.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-06 18:11:36 -0300
committerGabriel Schneider <[email protected]>2026-09-07 13:59:12 -0300
commit60367d8fe23f6af98ec28e3cf6c2094dfe332df0 (patch)
tree310fc734173cf771881f4691c71909135fadde97 /docs/web.md
parentfa82cac885cb4738fe36d1e49b4749b5a3e31a4a (diff)
downloadpardes-60367d8fe23f6af98ec28e3cf6c2094dfe332df0.tar.gz
pardes-60367d8fe23f6af98ec28e3cf6c2094dfe332df0.zip
Refactor panes and filesystem; replace FUSE with 9P
Consolidate pane, layout, memory and host code. Serve 9P by default over Unix sockets, with runtime mounts and optional TCP/QUIC transports. Remove FUSE and obsolete proof-of-concept examples. Fix highlighting and terminal-history performance, expand differential and stress-test infrastructure, sort navigation results while preserving the next occurrence, add syntax-colored Braille minimaps, remove SPC-k, and document 9P interaction as a repository skill.
Diffstat (limited to 'docs/web.md')
-rw-r--r--docs/web.md16
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/web.md b/docs/web.md
index 8d3a3d66..3a68f958 100644
--- a/docs/web.md
+++ b/docs/web.md
@@ -43,8 +43,8 @@ shells, and two comptime capability flags say so once each. It exposes no
`PanelCurtain`, `PanelScramble`, `PanelType`) because
`capabilities.panel_transitions` is `pardes.hosted`, and no
`Crt`/`Ripple`/`Glitch` because `capabilities.scene_shaders` is
-`platform == .gui or platform == .macos` (`src/builtins.zig:41-42`; the words
-themselves carry those availabilities in `src/runtime_config.zig:155-168`).
+`platform == .gui or platform == .macos` (`builtins.capabilities`; the words
+themselves carry those availabilities in `config.Runtime.settings`).
Applying either faithfully would require a second canvas renderer and give up
the DOM renderer's selectable/accessibility contract. Theme fades and the
delayed, side-effect-free Look hover remain grid animations and continue to use
@@ -57,14 +57,14 @@ zig build web \
-Dplatform=web \
-Dtarget=wasm32-freestanding \
-Dtree-sitter=zig \
- -Ddump=test/web-snapshots/source-list.dump.zon
+ -Ddump=test/web-snapshots/touch.dump.zon
```
The output is in `zig-out/web`. Serve that directory over HTTP; browsers do not
allow a useful WASM module load from `file:` URLs.
The browser shell has no argv: every command-line flag `src/main.zig` parses —
-`--tty`, `--tty-toggle`, `-n`, `-l`, `--fs[=<dir>]`, `--nested`,
+`--tty`, `--tty-toggle`, `-n`, `-l`, `--9p=<name>`, `--mount=<name>=<dial>`, `--nested`,
`--detach[=<name>]`, `--attach[=<name>]`, `-h`/`--help`, `--version`, and the
positional file-or-directory — is native-only, because the wasm module roots at
`src/web.zig` and never links `main.zig`. State comes from the embedded dump
@@ -92,7 +92,7 @@ the browser can never call.
same gate: both are `enabled = pardes.hosted` (`src/builtins.zig`, and
`pardes.hosted` is `tty or gui or macos`), because a detached session is a unix
socket and a page has none. Nothing in this shell speaks
-`src/detached/wire.zig`, and `push_detach` is one of the null vtable methods
+`src/detached/wire.zig`, and `detach` is one of the null vtable methods
below.
`src/web.zig` fills in six methods of `Host.VTable` and leaves the rest null,
@@ -120,8 +120,8 @@ failure; `wait_input` is null because wasm must never block, and `watch_theme`
and `dump_themes` are not reachable without a config directory. Of the
remaining nulls, `post_present` and `poll_frame` are per-frame host bookkeeping
a page has none of, `detach` has no session to leave, `gpio_toggle` belongs to
-the ESP32-P4 board, and `fs_reply` answers a FUSE control filesystem that
-`--fs` is the only way to ask for. `quit` sets the
+the ESP32-P4 board, and native filesystem replies are delivered by the 9P
+listener. `quit` sets the
core's flag, which `pardes_should_quit` reports so the page can stop its frame
loop.
@@ -133,7 +133,7 @@ zig build web-harness \
-Dplatform=web \
-Dtarget=wasm32-freestanding \
-Dtree-sitter=zig \
- -Ddump=test/web-snapshots/source-list.dump.zon
+ -Ddump=test/web-snapshots/touch.dump.zon
# Real headless Chrome, DOM rendering, and browser touch input.
zig build web-e2e