winzik/ide/README.md
David Nurdin 5f9b78f058 IDE: a Terminal, Claude in tabs (windows, history), files' local history; CLI apps' screens get raw keys
- Terminal tool window (Alt+F12, desktop): the user's shell in a pseudo-terminal in the project's folder (xterm.js),
  its size follows the window; Windows: cmd.exe / PowerShell on pipes, the line edited in the IDE
- Claude: a tab per conversation, a new one never stops the others; Open in a Window (closing it brings the tab back);
  every conversation kept in .jumphp/history/claude/ (not in git), the History tab reopens them
- Show Local History: a version of a file at each save and when it changed outside the IDE (.jumphp/history/files/),
  Compare / Revert
- External Libraries: a composer install after the project opened adds its packages (the index and the tree list them again)
- Copy Path and every copy of the IDE go through the system's clipboard (the WebView has no navigator.clipboard)
- the mouse's back / forward buttons: Navigate > Back / Forward
- bin/jumphp: php_run gives Docker a terminal when it has one (TTY_FLAGS never had -t: a CLI app's screen got no raw
  keys); `run` without a game: the folder of games/ it is typed in, JUMPHP_GAME, or the only game
- CLI template: the screen uses the terminal's alternate screen (full screen, the terminal back as it was after)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-03 12:09:52 +01:00

13 lines
706 B
Markdown

# jumphp/ide
The JumPHP IDE's core (PHP, `JumPHP\Ide\`) and interface (`ui/`: HTML / CSS / JS with Monaco), shared by the desktop app
(`games/ide`) and the web IDE of jumphp.net. Documentation: [docs/ide.md](../docs/ide.md).
```bash
tools/fetch-vendor.sh # Monaco and xterm.js into ui/vendor/ (not in git)
bin/jumphp php ide vendor/bin/phpunit # from the repository root: the core's tests
```
A host makes `new JumPHP\Ide\Ide($workspace, $cacheDir, $emit)`, calls `handle($name, $payload)` for the page's commands
(a `Deferred` when the answer comes later), `tick()` every frame, and serves `ui/` with `window.JUMPHP_IDE` (web) or
`window.jumphp` (desktop) for `ui/js/backend.js`.