raea/asset

staticFile names a file in the project, so the renderer finds it wherever the composition runs. The generated assets (sao for a sound effect, tokensynthNote for an instrument's note, lyria for music, fish for speech) are made the first time a render needs them and kept in the project's asset store, so later renders reuse them.

import { Audio } from "raea";
import { sao } from "raea/asset";

function Door() {
  return <Audio src={sao("a heavy wooden door creaks open", { seconds: 3 }).src} />;
}

import { fish, glbBytes, isGeneratedAsset, linearRgba } from "raea/asset"

raea/asset exports 9 functions, 1 value, 8 types. Bevy's counterpart: bevy_asset. Source: sdk/raea/src/asset.ts.

#Functions

#fish

Retired on 2026-11-05: Fish narration is no longer part of raea. Narrate with <Speech text start> from raea/speech (Pocket TTS, on this computer), or make a line with a raea gen step on fish:<model> and your own FISH_API_KEY. Kept as a name only, so an older edit says what to use instead of failing to bundle.

function fish(text: string, _options?: Record<string, unknown>): never

#glbBytes

The scene as glTF binary bytes.

function glbBytes(scene: GlbScene): Uint8Array<ArrayBufferLike>

#isGeneratedAsset

Whether a value is a generated asset (what sao, tokensynthNote and lyria return), not a file path.

function isGeneratedAsset(v: unknown): v is GeneratedAsset

#linearRgba

sRGB hex to linear rgba

function linearRgba(c: string | Rgba, alpha?: number): Rgba

#lyria

Music an older edit generated (30 seconds by default). Retired: a take already made plays, a new one is refused.

function lyria(prompt: string, options?: { seconds?: number; }): GeneratedAsset

#sao

A sound effect to generate (2 seconds by default).

function sao(prompt: string, options?: { seconds?: number; }): GeneratedAsset

#staticFile

The URL of a file in the space's media folder, each path segment URL-encoded.

function staticFile(path: string): string

#tokensynthNote

One note of an instrument described in words, rendered by TokenSynth (local, CPU): a Sampler's root note.

function tokensynthNote(timbre: string, midi: number, options?: { seconds?: number; velocity?: number; seed?: number; precision?: "fp32" | "fp16" | "bf16" | "int8" | "coreml"; }): GeneratedAsset

#writeGlb

The scene written as a.glb named by its content (once per process), its path: a <Model src>. Under plain bun (no engine) nothing is written and the would-be path is still returned, so a composition can be checked.

function writeGlb(scene: GlbScene): string

#Values

#MEDIA_ROOT

Where the space's media folder is served from.

#Types

#AssetKind

type AssetKind = "lyria" | "sao" | "tokensynth"

#GeneratedAsset

#GlbClip

#GlbJoint

#GlbMaterial

#GlbPrimitive

#GlbScene

#Rgba

type Rgba = [number, number, number, number]