wasm-vm documentation
Docs / Explainers
Narrated, portable, inspectable

Explain the machine with the right layer.

VizEngine owns authored SVG timelines and synchronized narration. Docstream owns GitBook-style markdown rendering and embeds. The two hosted frames below are live Orly bundles with direct links, so a missing iframe never hides the source.

two hosted explainers presentation packages are separate fallback links are intentional

Published presentation packages

The current registry snapshot checked on 2026-08-30 reports these versions. The packages are not part of the wasm-vm npm namespace.

PackageVersionDocumented role
@brett_lamy/viz-engine0.2.1Declarative, audio-synchronized SVG timeline engine. README-backed surfaces include Camera, Player, Timeline, VizPlayer, and VideoEmbed.
@brett_lamy/docstream0.3.7GitBook-aware markdown renderer and AI stream renderer. README-backed surfaces include GitbookStreamdown, parsing/serialization, source preview, Vite source clients, and VizEmbed.
@brett_lamy/docstream-editor0.3.6TipTap editor for Docstream GitBook-style markdown, including GitbookEditor, source editing, and AST conversion helpers.
 
npm install @brett_lamy/viz-engine@0.2.1 @brett_lamy/docstream@0.3.7 @brett_lamy/docstream-editor@0.3.6

Author a timeline scene

VizEngine provides the timeline/player primitives and the React-facing VizPlayer and VideoEmbed surfaces. Keep an explainer's presentation clock independent from the guest clock; the player is a presentation surface, not a second emulator scheduler. 

import {
  Camera,
  Player,
  Timeline,
  VideoEmbed,
  VizPlayer,
} from "@brett_lamy/viz-engine";
import "@brett_lamy/viz-engine/styles.css";

// Build a scene with the current VizEngine scene contract, then render it:
export function BootExplainer({ scene }) {
  return <VizPlayer scene={scene} loop />;
}

export function BootRecording({ src }) {
  return <VideoEmbed src={src} title="wasm-vm boot" />;
}

Render portable markdown

Docstream's GitBook syntax keeps a document portable. Use its current renderer/editor APIs in a React application, and use the viz subpath for the documented visualization embed boundary. 

import { GitbookStreamdown } from "@brett_lamy/docstream";
import { VizEmbed } from "@brett_lamy/docstream/viz";
import { GitbookEditor } from "@brett_lamy/docstream-editor";
import "@brett_lamy/docstream/styles.css";
import "@brett_lamy/docstream-editor/styles.css";

const markdown = [
  "# Boot trace",
  "",
  "{% embed url=\"https://orly.brett-lamy.workers.dev/?bundle=wasm-vm-internals\" /%}",
].join("\n");

export function ReadOnlyDoc() {
  return <GitbookStreamdown markdown={markdown} />;
}

Live explainer: Linux in a Tab

This frame is hosted by Orly and is separate from the wasm-vm runtime. If embedding is blocked by a browser policy, open the bundle directly.

Open Linux in a Tab directly →

Live explainer: The wasm-vm Proof Loop

This frame explains the worker/critic/evidence loop used by the repository. It is a hosted presentation, not a verification artifact; the evidence records remain in the repository.

Open the Proof Loop directly →

Audio and provenance. The Orly repository is MIT-licensed, but the inspected generated MP3 metadata did not declare per-file attribution. This project embeds the hosted explainers and does not copy or redistribute those MP3 files as local assets.

Source and ownership