winzik/engine/stubs/async.stub.php
David Nurdin fc4d0e16ec Threads: TrueAsync runtime (PHP 8.6 ZTS) and Web Workers in the browser
- docker/desktop-async: PHP 8.6 ZTS TrueAsync fork + ext/async + libuv + the SDL
  extensions (php86-compat.h, rect.c shutdown fix); game.yaml runtime: async
- JumPHP\Async: Tasks, Pool, Task, TaskFailed with three backends: TrueAsync
  threads, browser Web Workers (one PHP wasm engine each, closures through
  laravel/serializable-closure), or work spread over the frames
- games/hello-threads: fractal computed by a thread pool at 60 FPS
- browser STDERR fix (Platform::log), core dumps excluded from builds
- docs: AGENTS.md threads section, docs/async.md, README (FR/EN)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-28 08:26:12 +01:00

74 lines
2.7 KiB
PHP

<?php
// Signatures of the TrueAsync API used by JumPHP\Async (https://github.com/true-async/php-async, v0.11.3),
// for phpstan and IDEs. The extension itself only exists in the async runtime (docker/desktop-async).
// Full API: https://true-async.github.io/en/docs.html
namespace Async;
interface Completable
{
public function cancel(?AsyncCancellation $cancellation = null): void;
public function isCompleted(): bool;
public function isCancelled(): bool;
}
class AsyncCancellation extends \Exception {}
class AsyncException extends \Exception {}
class RemoteException extends AsyncException
{
public function getRemoteException(): ?\Throwable {}
public function getRemoteClass(): string {}
}
class ThreadTransferException extends AsyncException {}
final class Thread implements Completable
{
public function isRunning(): bool {}
public function isCompleted(): bool {}
public function isCancelled(): bool {}
public function getResult(): mixed {}
public function getException(): mixed {}
public function cancel(?AsyncCancellation $cancellation = null): void {}
}
final class Future implements Completable
{
public function isCompleted(): bool {}
public function isCancelled(): bool {}
public function cancel(?AsyncCancellation $cancellation = null): void {}
public function await(?Completable $cancellation = null): mixed {}
}
final class ThreadPool
{
public function __construct(int $workers = 0, int $queueSize = 0, ?\Closure $bootloader = null, bool $coroutine = false, int $concurrency = 0) {}
public function submit(callable $task, mixed ...$args): Future {}
public function map(array $items, callable $task): array {}
public function close(): void {}
public function cancel(): void {}
public function isClosed(): bool {}
public function getPendingCount(): int {}
public function getRunningCount(): int {}
public function getCompletedCount(): int {}
public function getWorkerCount(): int {}
}
final class ThreadChannel
{
public function __construct(int $capacity = 16) {}
public function send(mixed $value, ?Completable $cancellationToken = null): void {}
public function recv(?Completable $cancellationToken = null): mixed {}
public function close(): void {}
public function isClosed(): bool {}
public function count(): int {}
public function isEmpty(): bool {}
public function isFull(): bool {}
}
function spawn_thread(\Closure $task, bool $inherit = true, ?\Closure $bootloader = null): Thread {}
function available_parallelism(): int {}
function delay(int $ms): void {}
function suspend(): void {}
function await(Completable $awaitable, ?Completable $cancellation = null): mixed {}