pcbjam/wasm/bindings/pcbjam_async_policy.h

24 lines
940 B
C
Raw Normal View History

jspi: migration phases 0-7 — build knob, scheduler shim, test successor suite Toolchain: emsdk 6.0.6 (versions.sh; cache-hash keys on it). Build knob PCBJAM_ASYNC_BACKEND=jspi|asyncify: build-kicad-target.sh links editors with -sJSPI + -sJSPI_EXPORTS=@scripts/common/jspi-exports.txt + --pre-js jspi-scheduler.js (no DYNCALLS, no post-link asyncify pipeline); wx build stamps the backend and forces clean on flip or unknown provenance; docker/build.sh passes the knob, seeds the emscripten ports cache from the volume every launch, jspi postprocess = patch-env-shim only. scripts/common/shims/jspi-scheduler.js: the JSPI successor scheduler — token-wait registry, resume turnstile (one armed resume between engine re-entries, SP swaps only at microtask boundaries), green-region spill stacks (16-aligned tops), S1 embind mutator FIFO lane + parker wraps, S6 shutdown, libctx integration hooks (suspend/end/quarantine + g_current arm/clear), SuspendError attributor, lost-wake + stuck-window watchdogs, __wxWaitDump observability. Embind: PARKER registrations get emscripten::async() under PCBJAM_JSPI (wasm/bindings/pcbjam_async_policy.h). nanosleep yields route via the shim. Tests: tests/asyncify -> tests/jspi successor suite (jspi-stack red/green shadow-stack battery, jspi-coroutine MiniCoro harness, suspend-races semantic scenarios + __wxWaitDump books coherence); projects jspi-firefox/ jspi-chrome (asyncify-webkit retired — no JSPI in WebKit); unconditional Firefox JSPI pref; guard-beacons -> wait-beacons (+wxScheduler/libctxJspi families); Makefile.wasm links test apps against JSPI with the shim as a tracked link prerequisite. Web: WasmTool setRo await + __wxWaitDump forensics, open-flow contained promise, scheduler-shim.test.ts retargeted (8 green). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NDeBaKKhQztd8KiVtHuyXr
2026-08-13 07:06:24 +02:00
/*
* PCBJAM_PARKER_POLICY registration policy for the suspending embind
* exports (the doc-18 "PARKER" class: kicadOpenFile / kicadOpenFiles /
* kicadLibsReload, whose bodies park on wx wait tokens mid-load).
*
* JSPI backend: they MUST be registered emscripten::async() so embind wraps
* the invoker in WebAssembly.promising the call returns a real Promise and
* the suspension is legal. Without it the first park throws SuspendError
* ("trying to suspend without WebAssembly.promising").
*
* Asyncify backend: no policy the legacy contract stands (placeholder
* return, callers gate on kicadOpenFileBusy; the scheduler shim owns the
* await surface).
*
* Usage (note the macro carries its own leading comma):
* function( "kicadOpenFile", &kicadOpenFile PCBJAM_PARKER_POLICY );
*/
#pragma once
#ifdef PCBJAM_JSPI
#define PCBJAM_PARKER_POLICY , emscripten::async()
#else
#define PCBJAM_PARKER_POLICY
#endif