jumPhp/games/hello-hybrid/AGENTS.md
David Nurdin e0e82a22cc Desktop apps: hybrid games, clipboard, tray, global shortcuts, Windows / macOS runtime
- ui: hybrid: an SDL game that also drives Tauri (Application::run() hands over to JumPHP\Tauri\Hybrid): native
  dialogs, tray icon, shortcuts and HTML windows beside its own; a plain game headless, in the browser, on phones and
  without FFI. bin/jumphp run uses the Tauri image; export:standalone a micro with SDL + FFI (tools/hybrid-extensions.txt).
  games/hello-hybrid: SDL balls + an HTML control panel.
- JumPHP\Native\Clipboard (Tauri, browser copy), App::tray() (JumPHP\Tauri\Tray), App::globalShortcut();
  native.copy / native.paste for pages; a command PHP waits for that fails now fails its Task ('result' event)
- runtime: clipboard-manager, global-shortcut, tray-icon; panics of a command stay on the native side; idle time
  after each frame so WebViews keep painting beside a busy game; JUMPHP_TAURI_TRACE=1
- .github/workflows/tauri.yml: the library for Linux, Windows, macOS (universal), hello-desktop run for real on
  each, release tauri-<key> (tools/tauri-key.sh); bin/jumphp tauri:download, used before building
- app:export --windows; the standalone workflow takes an extension list (the apps' / hybrid games' micros)
- docs/tauri.md, docs/tauri.fr.md, AGENTS.md §16, README, TODO

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01JkYTqpYNZKwTnRZHQRD5HP
2026-10-31 22:30:21 +01:00

764 B

hello-hybrid — notes for agents

A hybrid game (config/game.yaml: ui: hybrid, main: App\Desktop): an SDL game (read ../../AGENTS.md) that also drives Tauri (read ../../docs/tauri.md, "Hybrid games").

  • src/Scene/BallsScene.php: the game (balls bouncing). Uses JumPHP\Native (FilePicker::save for S, Dialog::confirm for Escape) when Native::supports() says so; headless it is a plain game (Escape quits).
  • src/Desktop.php (AppMain): the panel's commands (settings, set, shot), the tray icon, the global shortcut.
  • src/Settings.php: the state both sides share (static).
  • ui/: the HTML panel (second window).
  • Tests: tests/HybridTest.php (GameTestCase: the game), tests/DesktopTest.php (AppTestCase: the native side).