yawn/coredocs/index.md

layout, hero, features

layout	hero	features
home	name text tagline actions Yawn raw core Worker, shared memory, and render graphs The protocol reference for building an alternative handles layer or editor without YawnCore or @yawn/handles. theme text link brand Boot from scratch /guide/boot theme text link alt Worker reference /reference/worker	title details Raw transport Start core/worker.js, correlate replies, and handle profiler events. title details Shared rows Build typed views, allocate slots, and control continuous rendering. title details Graph wire format Encode, compile, and activate complete WebGPU render and compute graphs.

Contract at a glance

The browser main thread owns the HTML canvas and starts the module worker. The worker initializes the WASM core and WebGPU against an OffscreenCanvas. All control operations are structured-clone messages. Bulk numeric state lives in one returned SharedArrayBuffer; graphs describe how named row arrays become GPU resources.

The application is responsible for three important contracts:

1. Correlate each reply by its request value; profiler messages are unsolicited.
2. Shared-memory value edits are rendered continuously; no sabDirty notification is needed. Pause before updates that must not overlap rendering.
3. Before a mutation that invalidates compiled render bundles, set signals[6] (bundleDirty), make the mutation, compile and switch a replacement graph, then let successful switch-loadout clear lane 6.

This site describes the current wire API, not the higher-level wrapper API.