yawn/docs/index.md

layout, hero, features

layout	hero	features
home	name text tagline actions Yawn Shared render data and a render graph. One Rust/WASM core, one fixed arena, no built-in scene model or shader. theme text link brand Open the playground /playground	title details Shared rows Allocate an SOA row array once by message, then mutate its SAB views directly from any thread. title details External graphs JSO and FXNode addons serialize DAGs to the S-expression AST consumed by the worker. title details Up-front loadouts Pipelines, GPU resources, pass order, and compatible transient aliases are prepared before activation.

The entire boundary

const color = await core.allocateRows({
  name: "triangle.color",
  rows: 1,
  stride: 16,
  format: "f32",
});

color.write(0, [0.2, 0.65, 1, 1]);
color.row(0)[0] = 0.8; // direct SharedArrayBuffer write
await loadGraph(core, graph); // infrequent message

@yawn/core contains only the Rust/WASM render-data arena and graph compiler plus the browser worker required to execute WebGPU. Rust owns the fixed 64-byte-aligned shared arena, DAG ordering, resource culling, and transient texture planning; the worker materializes the resulting loadout. Every scene convention and every byte of WGSL comes from an addon or application.

JSO / FXNode ──▶ AST ──▶ S-expression ──▶ Rust/WASM ──▶ worker ──▶ WebGPU
any JS thread ────────────── direct SAB row writes ────────────────────┘

The addon packages provide graph serialization, optional WGSL, glTF import directly into shared rows, and conventional camera/material/mesh handles. None of them add semantics to core.