yawn/docs/index.md

layout, hero, features

layout	hero	features
home	name text tagline actions Yawn Shared render data and a render graph. Two core files, 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 public shared-row client and its worker. The worker owns the fixed 64-byte-aligned arena, S-expression graph compiler, WebGPU loadout, and transient texture aliasing. Every scene convention and every byte of WGSL comes from an addon or application.

JSO / FXNode ──▶ AST ──▶ S-expression ──▶ core 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.