jovian / venusian-appkit

0.8.x-dev 2026-09-18 17:48 UTC

Requires

• php: ^8.4|^8.5|^8.6
• jovian/appkit: ^0.8.0
• venusian-surface/bridge: ^0.8.0
• venusian-surface/contracts: ^0.8.0
• venusian-surface/drawing: ^0.8.0
• venusian-surface/human-input: ^0.8.0
• venusian-surface/native-windows: ^0.8.0
• venusian-surface/stage: ^0.8.0
• venusian-voyager/contracts: ^0.8.0

Requires (Dev)

• pestphp/pest: ^4

MIT

• Angel Gonzalez

• framework
• bindings
• appkit
• macos
• venusian

Published on Packagist.org on 2026-09-30 02:23 UTC

README

AppKit composition for Venusian Surface on macOS. Installing it publishes the macOS session behind mac.bridge, the AppKit stage host behind stage.appkit, and the input engine behind input.appkit.

ext-appkit  →  jovian/appkit  →  venusian-appkit  →  Surface
1:1 binding    typed projection   composition        cross-platform

Install

composer require jovian/venusian-appkit

Requires macOS, PHP 8.4+ and ext-appkit 0.8.0.

Input

input.appkit reads the keyboard and mouse for native windows and appkit stages from the extension's NSEvent tap, and gamepads from GameController.framework (gc-<handle>). It never pumps: the os resource drains NSApp, and each poll folds what the tap recorded.

• Keys in the engine's windows that no view takes are consumed after recording, so AppKit does not beep. Command keys still reach the menu bar.
• Focus loss releases every held key and mouse button (with release edges).
• mouse()->wheel(): dy > 0 = rolled away, whatever the scroll setting.
• A pad with an extended profile is a game controller; a micro profile is a game pad. Private profile classes (GCDualShockGamepad) work.

use Surface\HumanInput\MagicAliases\HumanInput;

$mac = HumanInput::engine('appkit');       // or INPUT_ENGINE=appkit
$mac->keyboard()->text();
foreach ($mac->gameControllers() as $id => $pad) {   // 'gc-<handle>'
    $pad->leftStick();
}

See .okf/ for the knowledge bundle.

License

MIT.