hayao 0.2.0 → 0.3.0

package/dist-studio/assets/index-CM3tjRQo.css

@@ -0,0 +1 @@
+:root{--washi: #f1ebdd;--washi-2: #f8f3e9;--sumi: #242019;--sumi-soft: #4f473b;--stone: #6f6555;--ai: #2b4257;--shu: #b5442d;--matsu: #4a7a3a;--line: #ddd3bf;--mono: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;color-scheme:light}*{box-sizing:border-box}html,body{margin:0;height:100%;background:var(--washi);color:var(--sumi);font-family:Iowan Old Style,Palatino,Georgia,serif;overscroll-behavior:none}#root{height:100%;display:flex;flex-direction:column}header.bar{display:flex;align-items:center;gap:10px;padding:10px 14px;border-bottom:1px solid var(--line);background:var(--washi-2);flex-wrap:wrap}header.bar .brand{font-weight:700;font-size:17px;color:var(--sumi);text-decoration:none;white-space:nowrap}header.bar .brand .js{font-size:11px;color:var(--stone)}header.bar select,header.bar input[type=number]{font:13px var(--mono);padding:6px 8px;border:1px solid var(--line);border-radius:6px;background:var(--washi);color:var(--sumi);max-width:44vw}header.bar .spacer{flex:1}header.bar .build{font:11px var(--mono);color:var(--stone)}main.panes{flex:1;display:flex;min-height:0}.pane{flex:1;min-width:0;display:flex;flex-direction:column;border-right:1px solid var(--line)}.pane:last-child{border-right:none}.pane .pane-head{display:flex;align-items:center;gap:8px;padding:6px 10px;font:12px var(--mono);color:var(--sumi-soft);background:var(--washi-2);border-bottom:1px solid var(--line)}.pane iframe{flex:1;width:100%;border:0;background:#fff}.drawer{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1200;background:#24201959;display:flex;justify-content:flex-end}.drawer>div,.drawer-inner{background:var(--washi)}.drawer-head{display:flex;align-items:center;gap:12px;padding:12px 16px;border-bottom:1px solid var(--line);background:var(--washi-2)}.drawer-head b{font-size:16px}.drawer-head .hy{margin-left:auto}.drawer .drawer-head,.drawer .drawer-body{width:min(520px,100vw)}.drawer{flex-direction:column;align-items:flex-end}.drawer-body{flex:1;overflow-y:auto;background:var(--washi);border-left:1px solid var(--line);padding-bottom:40px}.session-row{display:grid;grid-template-columns:1fr auto;gap:2px 10px;width:100%;text-align:left;padding:11px 16px;background:none;border:none;border-bottom:1px solid var(--line);font:inherit;color:var(--sumi);cursor:pointer}.session-row .game{font-weight:600}.session-row .when{grid-row:1 / 3;grid-column:2;align-self:center}.session-row.open{background:var(--washi-2)}.report{padding:10px 16px 16px;border-bottom:1px solid var(--line);background:var(--washi-2);font-size:14.5px}.report p{margin:7px 0;line-height:1.55}.report .stat-row{display:flex;flex-wrap:wrap;gap:6px 16px;font:600 13px var(--mono);margin:6px 0 10px}.report .good{color:var(--matsu)}.report .warn{color:var(--shu)}.report .moment{padding:5px 10px}.moment-link{background:none;border:none;border-bottom:1px dashed var(--ai);color:var(--ai);font:inherit;cursor:pointer;padding:0 2px;margin-right:8px}.phone-card{margin:auto;background:var(--washi);border:1px solid var(--line);border-radius:12px;padding:22px 26px;display:grid;gap:12px;justify-items:center;max-width:min(340px,92vw);text-align:center}.phone-card b{font-size:17px}.phone-card img{border:1px solid var(--line);border-radius:8px}.phone-card code{font:12.5px var(--mono);color:var(--ai);word-break:break-all}label.hy input[type=file]{display:none}.pane-head .tape{color:var(--shu);font-weight:700}.pane-head .hy{padding:3px 9px;font-size:11px}.timeline{display:flex;gap:10px;align-items:center;padding:8px 14px;border-top:1px solid var(--line);background:var(--washi-2);position:relative}.timeline input[type=range]{flex:1;accent-color:var(--shu);touch-action:none;min-height:28px}.timeline .frames{min-width:86px;text-align:right;font-variant-numeric:tabular-nums}.timeline .probe{position:absolute;right:10px;bottom:100%;margin:0 0 8px;max-height:46vh;max-width:min(420px,92vw);overflow:auto;background:var(--washi-2);border:1px solid var(--line);border-radius:8px;padding:10px 12px;font:11.5px var(--mono);color:var(--sumi-soft);box-shadow:0 6px 24px #2420191f}.actions{display:flex;gap:8px;padding:10px 14px;border-top:1px solid var(--line);background:var(--washi-2);flex-wrap:wrap;align-items:center}button.hy{font:600 13px var(--mono);padding:9px 14px;border-radius:8px;border:1px solid var(--line);background:var(--washi);color:var(--sumi);cursor:pointer;touch-action:manipulation}button.hy:active{transform:translateY(1px)}button.hy.feel{border-color:var(--shu);color:var(--shu)}button.hy.accept{border-color:var(--matsu);color:var(--matsu)}.note{font:11px var(--mono);color:var(--stone)}.toast{position:fixed;left:50%;bottom:86px;transform:translate(-50%);background:var(--sumi);color:var(--washi);font:12px var(--mono);padding:8px 14px;border-radius:8px;z-index:60;pointer-events:none}@media(max-width:720px){main.panes{flex-direction:column}.pane{border-right:none;border-bottom:1px solid var(--line)}header.bar .build{display:none}}

package/dist-studio/index.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Studio · hayao.js</title>
+    <meta name="description" content="Hayao Studio — playtest, tune, annotate, and A/B games with an AI co-developer." />
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 120 120'%3E%3Crect width='120' height='120' fill='%23242019'/%3E%3Crect x='32' y='30' width='58' height='58' fill='none' stroke='%23f1ebdd' stroke-width='3' opacity='.4'/%3E%3Ccircle cx='61' cy='59' r='14' fill='%23b5442d'/%3E%3C/svg%3E"
+    />
+    <script type="module" crossorigin src="./assets/index-C7tty_Wo.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-CM3tjRQo.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/docs/API.md

@@ -3,9 +3,9 @@
 > Auto-generated by `npm run api`. Everything importable from `@hayao`.
 > Grep here for the real surface — never guess an API from memory.
 
-**440 exports.**
+**664 exports.**
 
-## classs (47)
+## classs (52)
 
 - `AmbientField`
 - `AnimationPlayer`
@@ -13,6 +13,7 @@
 - `BitmapText`
 - `BroadcastChannelTransport`
 - `Camera2D`
+- `CameraController`
 - `Canvas2DRenderer`
 - `CinematicPlayer`
 - `Clock`
@@ -33,19 +34,23 @@
 - `Node`
 - `NodePool`
 - `NullStorage`
+- `ParallaxLayer`
 - `Particles`
 - `PhaseClock`
 - `PixelBuffer`
 - `PlayerInput`
+- `PointerSource`
 - `RingBuffer`
 - `Rng`
 - `RollbackSession`
 - `RoomHost`
 - `SaveManager`
 - `ScreenTransition`
+- `SessionRecorder`
 - `Shaker`
 - `Shell`
 - `Signal`
+- `SnapshotRing`
 - `SpatialHash`
 - `Sprite`
 - `SvgRenderer`
@@ -55,16 +60,22 @@
 - `UndoStack`
 - `World`
 
-## functions (185)
+## functions (291)
 
+- `abilitiesOf`: (world: WorldGraphDef, taken: readonly string[]) => Set<string>
 - `addBody`: (rw: RigidWorld, def: RigidBodyDef) => number
 - `addDistanceJoint`: (rw: RigidWorld, def: DistanceJointDef) => number
 - `addRevoluteJoint`: (rw: RigidWorld, def: RevoluteJointDef) => number
 - `addTransition`: (parent: Node, config?: TransitionConfig) => ScreenTransition
+- `albumTrack`: (id: string) => AlbumTrack | undefined
+- `analyzePlaytest`: (def: GameDefinition, session: PlaytestSession, opts?: AnalyzeOptions) => PlaytestReport
 - `applyImpulse`: (rw: RigidWorld, id: number, ix: number, iy: number, px?: number | undefined, py?: number | undefined) => void
+- `applyReverb`: (buf: StereoBuffer, opts?: ReverbOptions) => void
 - `applyTransform`: (m: Transform, p: Vec2) => Vec2
 - `asciiEntities`: (rowsAscii: string[], tileSize?: number, chars?: Record<string, TileId>) => { char: string; tx: number; ty: number; x: number; y: number; }[]
+- `assertAudio`: (buf: StereoBuffer, exp: AudioExpectation) => AudioAssertion
 - `assertDeterministic`: (makeWorld: WorldFactory, log: InputLog) => DeterminismReport
+- `assertRamp`: (difficulty: readonly number[], opts?: RampOptions) => void
 - `assertSnapshotStable`: (makeWorld: WorldFactory, log: InputLog, warmup: number) => { ok: boolean; hashA: string; hashB: string; }
 - `assertSolvable`: <State, Move>(puzzle: Puzzle<State, Move>, options?: SolveOptions) => SolveResult<Move>
 - `astar`: <N>(start: N, isGoal: (n: N) => boolean, neighbours: WeightedNeighbours<N>, key: NodeKey<N>, opts?: { heuristic?: ((n: N) => number) | undefined; maxNodes?: …
@@ -72,28 +83,40 @@
 - `autotile4`: (grid: BoolGrid) => (WangTile | null)[][]
 - `autotileToCommands`: (grid: BoolGrid, options?: AutotileDrawOptions) => (RectCommand | PolyCommand)[]
 - `availableUpgrades`: (defs: readonly UpgradeDef[], owned: readonly string[]) => UpgradeDef[]
+- `bandBalance`: (sig: Samples, sampleRate?: number) => BandBalance
 - `bfs`: <N>(start: N, neighbours: Neighbours<N>, key: NodeKey<N>, opts?: { goal?: ((n: N) => boolean) | undefined; maxNodes?: number | undefined; }) => BfsResult<N>
 - `blobPath`: (rng: Rng, radius: number, wobble?: number, lobes?: number) => string
 - `bodyAABB`: (b: RigidBody) => Rect
 - `bodyContains`: (b: RigidBody, x: number, y: number) => boolean
+- `cadenceResolves`: (romans: string[]) => boolean
+- `cameraIssues`: (samples: readonly Vec2[], opts?: CameraOptions) => string[]
+- `canvasGradient`: (ctx: { createLinearGradient(x0: number, y0: number, x1: number, y1: number): CanvasGradient; createRadialGradient(x0: number, y0: number, r0: number, x1: nu…
 - `cellFloat`: (x: number, y: number, seed?: number) => number
 - `cellHash`: (x: number, y: number, seed?: number) => number
 - `cellInt`: (x: number, y: number, n: number, seed?: number) => number
 - `changeFrames`: (timeline: ProbeFrame[], key: string) => number[]
 - `checkDeterministic`: (makeWorld: WorldFactory, log: InputLog) => DeterminismReport
+- `chordChanges`: (symbols: string[], octave?: number) => number[][]
+- `chordNotes`: (symbol: string, octave?: number) => number[]
+- `clientToDesign`: (rect: { left: number; top: number; width: number; height: number; }, width: number, height: number, clientX: number, clientY: number) => Vec2
 - `collide`: (a: RigidBody, b: RigidBody) => Manifold | null
-- `commandsToSVGInner`: (commands: DrawCommand[]) => string
+- `commandsToSVGInner`: (commands: DrawCommand[], idPrefix?: string) => string
+- `composeCampaign`: <State, Move>(spec: CampaignSpec<State, Move>) => Campaign<State, Move>
 - `composeTransform`: (m: Transform, n: Transform) => Transform
 - `connectedComponents`: (cols: number, rows: number, passable: Passable, diagonal?: boolean) => Components
 - `connectWebSocket`: (url: string) => Promise<Transport>
 - `contourToCommands`: (grid: BoolGrid, options?: AutotileDrawOptions) => PolyCommand[]
+- `contrastRatio`: (a: string, b: string) => number
 - `createPlanBot`: <Step extends { kind: string; }, Probe>(plan: Step[], execs: Record<string, StepExec<Step, Probe>>) => PlanBot<Probe>
 - `createPlatformerState`: (x: number, y: number) => PlatformerState
 - `createRigidWorld`: (opts?: RigidWorldOpts) => RigidWorld
-- `createWorld`: (def: GameDefinition, seedOverride?: number | undefined) => World
+- `createStereo`: (durationSec: number, sampleRate?: number) => StereoBuffer
+- `createWorld`: (def: GameDefinition, opts?: number | CreateWorldOptions | undefined) => World
+- `crestFactorDb`: (sig: Samples) => number
 - `dashJumpDistance`: (cfg?: PlatformerConfig) => number
 - `datan`: (x: number) => number
 - `datan2`: (y: number, x: number) => number
+- `dbfs`: (amp: number) => number
 - `dcos`: (x: number) => number
 - `decode2bit`: (source: string | bigint, width: number, height: number) => PixelBuffer
 - `decodeBits`: (source: string | bigint, width: number, height: number) => PixelBuffer
@@ -101,25 +124,48 @@
 - `decodeRLE`: (runs: readonly number[], width: number, height: number) => PixelBuffer
 - `defaultStorage`: (prefix?: string | undefined) => StorageAdapter
 - `defineGame`: (def: GameDefinition) => Required<Pick<GameDefinition, "seed" | "width" | "height" | "inputMap" | "background">> & GameDefinition
+- `defineLevel`: (spec: LevelSpec) => LevelData
 - `deserializeNode`: (data: SerializedNode) => Node
 - `dexp`: (x: number) => number
 - `dexp2`: (x: number) => number
 - `dhypot`: (x: number, y: number) => number
+- `diatonicChord`: (tonic: number, mode: "major" | "minor" | "harmonicMinor" | "melodicMinor" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "locrian" | "majorPentatonic" …
+- `diffLevels`: (a: LevelData, b: LevelData) => LevelChange[]
+- `distanceGain`: (model: DistanceModel, distance: number, refDistance?: number, maxDistance?: number, rolloff?: number) => number
 - `dlog`: (x: number) => number
+- `dpow`: (base: number, exp: number) => number
 - `drive`: (world: World, script: InputScript, until?: ((probe: Record<string, unknown>) => boolean) | undefined) => DriveResult
+- `dropShadow`: (color: string, blur: number, dx?: number, dy?: number) => Shadow
 - `dsin`: (x: number) => number
+- `duckGain`: (active: boolean, amountDb?: number) => number
 - `encodeMessage`: (msg: NetMessage) => string
 - `encodeRLE`: (buf: PixelBuffer) => number[]
+- `encodeWav`: (buf: StereoBuffer) => Uint8Array<ArrayBufferLike>
+- `estimateTempo`: (sig: Samples, sampleRate?: number) => number
+- `evalCurve`: (curve: Breakpoint[], x: number) => number
+- `featureDistance`: (reference: AudioFeatures, candidate: AudioFeatures, weights?: Partial<FeatureWeights>) => MatchResult
+- `features`: (sig: Samples, sampleRate?: number) => AudioFeatures
+- `feedbackIssues`: (contract: FeedbackContract, requiredEvents: readonly string[], opts?: FeedbackOptions) => string[]
+- `fft`: (re: Float32Array<ArrayBufferLike>, im: Float32Array<ArrayBufferLike>) => void
+- `findSoftlocks`: (world: WorldGraphDef, mode?: CompletionMode) => SoftlockReport
 - `firstFrame`: (timeline: ProbeFrame[], pred: (p: ProbeFrame) => boolean) => number
 - `floodFill`: (start: Cell, passable: Passable, opts: { cols: number; rows: number; diagonal?: boolean | undefined; }) => Cell[]
+- `fluxEnvelope`: (sig: Samples, frameSize?: number, hop?: number) => Float32Array<ArrayBufferLike>
+- `forgivenessIssues`: (spec: ForgivenessSpec, opts?: ForgivenessOptions) => string[]
 - `fractalNoise`: (x: number, y: number, seed?: number, opts?: FractalOptions) => number
 - `frameActions`: (log: InputLog, i: number) => string[]
 - `gameInputMap`: (def: GameDefinition) => InputMap
 - `generateCave`: (rng: Rng, opts: CaveOptions) => Grid
 - `generateDungeon`: (rng: Rng, opts: DungeonOptions) => Dungeon
+- `generateLevels`: <State, Move>(factory: (rng: Rng) => Puzzle<State, Move>, opts: GenerateOptions<State, Move>) => GeneratedLevel<State, Move>[]
+- `generateLevelsReport`: <State, Move>(factory: (rng: Rng) => Puzzle<State, Move>, opts: GenerateOptions<State, Move>) => GenerateReport<State, Move>
+- `genre`: (id: string) => GenreTrack | undefined
 - `getBody`: (rw: RigidWorld, id: number) => RigidBody | undefined
 - `getJoint`: (rw: RigidWorld, id: number) => Joint | undefined
+- `glow`: (color: string, blur: number) => Shadow
+- `graceWindowIssues`: (label: string, windowFrames: number, accepts: (delayFrames: number) => boolean) => string[]
 - `gradient`: (stops: readonly string[], n: number) => string[]
+- `gradientDef`: (g: Gradient, id: string) => string
 - `gridAt`: (g: Grid, x: number, y: number) => number
 - `gridFromRows`: (rows: readonly string[], solid?: string) => boolean[][]
 - `gridSet`: (g: Grid, x: number, y: number, v: number) => void
@@ -147,10 +193,19 @@
 - `jumpHeight`: (cfg?: PlatformerConfig) => number
 - `keyMentions`: (code: string) => string[]
 - `keysToActions`: (map: InputMap, keysDown: Set<string>) => string[]
+- `layerGains`: (layers: MusicLayer[], intensity: number) => Record<string, number>
 - `layoutIssues`: (commands: DrawCommand[], opts?: LayoutOptions) => string[]
 - `layoutText`: (font: BitmapFont, input: string | readonly RichChar[], options?: TextLayoutOptions) => TextLayout
+- `levelFromSeed`: <State, Move>(factory: (rng: Rng) => Puzzle<State, Move>, seed: number) => Puzzle<State, Move>
+- `levelIssues`: (data: LevelData) => string[]
+- `levelReachable`: (data: LevelData, opts?: { passable?: Passable | undefined; diagonal?: boolean | undefined; }) => ReachReport
+- `levelToTilemap`: (data: LevelData) => TilemapData
+- `linearGradient`: (stops: readonly StopInput[], angleDeg?: number) => LinearGradient
 - `lineOfSight`: (map: TilemapData, ax: number, ay: number, bx: number, by: number) => boolean
+- `lintSong`: (song: Song, opts?: LintOptions) => MusicLintResult
 - `longestLull`: (eventFrames: number[], totalFrames: number) => number
+- `lookAheadIssues`: (cameraSamples: readonly Vec2[], targetSamples: readonly Vec2[], minLead?: number) => string[]
+- `magnitudeSpectrum`: (frame: Samples) => Float32Array<ArrayBufferLike>
 - `makeGrid`: (cols: number, rows: number, fill?: number) => Grid
 - `makeReach`: (start?: number, settle?: number) => (target: number, dt: number) => number
 - `makeTransform`: (pos: Vec2, rotation: number, scale: Vec2) => Transform
@@ -158,29 +213,51 @@
 - `marchingSquaresContours`: (grid: BoolGrid, options?: ContourOptions) => ContourSegment[]
 - `mask4`: (grid: BoolGrid, x: number, y: number) => number
 - `mask8`: (grid: BoolGrid, x: number, y: number) => number
+- `matchReport`: (reference: AudioFeatures, candidate: AudioFeatures) => string
 - `measureLine`: (font: BitmapFont, chars: readonly RichChar[]) => number
 - `measureText`: (font: BitmapFont, text: string) => number
 - `mergePlayerFrames`: (players: readonly string[], inputs: ReadonlyMap<string, readonly string[]>) => string[]
+- `midiToFreq`: (midi: number, a4?: number) => number
+- `midiToName`: (midi: number) => string
 - `missingControlHints`: (world: World, inputMap: InputMap) => string[]
 - `mix`: (a: string, b: string, t: number) => string
 - `mixLinear`: (a: string, b: string, t: number) => string
+- `mixMono`: (bus: StereoBuffer, sig: Samples, startSample: number, gain?: number, pan?: number) => void
 - `moveRect`: (map: TilemapData, rect: Rect, dx: number, dy: number, opts?: MoveOpts) => MoveResult
 - `mutateColor`: (rng: Rng, hex: string, amounts?: DriftAmounts) => string
 - `netMessage`: <T extends Omit<NetMessage, "v">>(msg: T) => T & { v: number; }
 - `nineSlice`: (rect: Rect, style: NineSliceStyle, z?: number, transform?: Transform) => DrawCommand[]
+- `normalize`: (buf: StereoBuffer, target?: number) => void
+- `noteToMidi`: (name: string) => number
+- `onsetDensity`: (sig: Samples, sampleRate?: number) => number
+- `openVoicing`: (chord: number[]) => number[]
 - `packVarints`: (nums: readonly number[]) => string
+- `panFromOffset`: (dx: number, spread?: number) => number
+- `panGains`: (pan: number) => { l: number; r: number; }
 - `parseRich`: (markup: string, colorMap?: Record<string, string>) => RichChar[]
 - `parseSnapshot`: (text: string | null) => WorldSnapshot | null
 - `passableFromTilemap`: (map: TilemapData) => Passable
+- `peak`: (buf: StereoBuffer) => number
+- `peakAmp`: (sig: Samples) => number
 - `pickEntry`: <T>(rng: Rng, entries: readonly WeightedEntry<T>[]) => T
+- `pitchToFreq`: (pitch: string | number, a4?: number) => number
 - `pixelsToCommands`: (buf: PixelBuffer, palette: readonly Swatch[], options?: PixelDrawOptions) => RectCommand[]
+- `platformerReachable`: (data: LevelData, opts: PlatformerReachOptions) => ReachReport
 - `playerIds`: (count: number) => string[]
 - `pointQuery`: (rw: RigidWorld, x: number, y: number, mask?: number) => RigidBody | undefined
 - `pollDirector`: (waves: readonly WaveDef[], state: DirectorState, time: number, rng?: Rng | undefined) => SpawnEvent[]
 - `polygonBox`: (w: number, h: number) => RigidShape
+- `progression`: (tonic: number, mode: "major" | "minor" | "harmonicMinor" | "melodicMinor" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "locrian" | "majorPentatonic" …
+- `progressionPuzzle`: (world: WorldGraphDef, mode?: CompletionMode) => Puzzle<ProgressState, ProgressMove>
+- `proveCompletable`: (world: WorldGraphDef) => SolveResult<ProgressMove>
+- `proveFullCompletion`: (world: WorldGraphDef) => SolveResult<ProgressMove>
 - `pump`: (world: World, frames: number, actions?: string[]) => void
+- `radialGradient`: (stops: readonly StopInput[], opts?: { cx?: number | undefined; cy?: number | undefined; r?: number | undefined; }) => RadialGradient
+- `rampIssues`: (difficulty: readonly number[], opts?: RampOptions) => string[]
+- `rampStats`: (difficulty: readonly number[]) => RampStats
 - `rayCastRigid`: (rw: RigidWorld, x0: number, y0: number, x1: number, y1: number, mask?: number) => RigidRayHit | null
 - `raycastTiles`: (map: TilemapData, x0: number, y0: number, x1: number, y1: number) => RayHit
+- `reachableRegions`: (world: WorldGraphDef, abilities: Iterable<string>) => string[]
 - `reconstructPath`: <N>(cameFrom: Map<string, N>, key: NodeKey<N>, start: N, goal: N) => N[]
 - `recordTimeline`: (world: World, frames: string[][]) => ProbeFrame[]
 - `rectBlocked`: (map: TilemapData, x: number, y: number, w: number, h: number, solids?: SolidRect[]) => boolean
@@ -188,39 +265,69 @@
 - `rectsOverlap`: (a: Rect, b: Rect) => boolean
 - `registerNode`: (type: string, factory: NodeFactory) => void
 - `regularPolygon`: (sides: number, radius: number, rotation?: number) => number[]
+- `relLuminance`: (hex: string) => number
 - `removeBody`: (rw: RigidWorld, id: number) => void
 - `removeJoint`: (rw: RigidWorld, id: number) => void
+- `renderAudioFilmstrip`: (buf: StereoBuffer, opts?: AudioFilmstripOptions) => string
 - `renderFilmstrip`: (world: World, frames: string[][], opts: FilmstripOptions) => string
+- `renderSong`: (song: Song, opts?: { sampleRate?: number | undefined; normalizePeak?: number | undefined; }) => StereoBuffer
+- `renderSound`: (spec: SoundSpec, opts?: { rng?: Rng | undefined; sampleRate?: number | undefined; }) => Samples
 - `renderToSVGString`: (commands: DrawCommand[], width: number, height: number, background?: string) => string
 - `replay`: (makeWorld: WorldFactory, log: InputLog) => { finalHash: string; hashes: string[]; }
+- `replaySession`: (def: GameDefinition, session: PlaytestSession, opts?: number | ReplayOptions | undefined) => World
 - `resetNodeIds`: (start?: number) => void
+- `resolveTuning`: (spec: TuningSpec | undefined, overrides?: TuningValues | undefined) => TuningValues
 - `rigidStep`: (rw: RigidWorld, dt: number) => ContactEvent[]
 - `rleDecode`: (input: string) => string
 - `rleEncode`: (input: string) => string
+- `rms`: (sig: Samples) => number
 - `roomCenter`: (r: Room) => { x: number; y: number; }
+- `rootless`: (chord: number[], targetMidi?: number | undefined) => number[]
 - `runBrowser`: (def: GameDefinition, mount: HTMLElement, opts?: RunOptions) => GameHandle
 - `runBrowserNet`: (def: GameDefinition, mount: HTMLElement, opts: NetRunOptions) => NetGameHandle
+- `runFeelGates`: (spec: FeelSpec, ctx?: FeelContext) => FeelReport
 - `runHeadless`: (def: GameDefinition, inputLog?: InputLog | undefined) => HeadlessResult
+- `runStudio`: (baseDef: GameDefinition, mount: HTMLElement, opts?: StudioOptions) => StudioHandle
+- `salienceIssues`: (commands: DrawCommand[], avatarFill: string, background: string, opts?: SalienceOptions) => string[]
 - `sampleGradient`: (stops: readonly string[], t: number) => string
+- `scaleMidis`: (tonic: number, mode?: "major" | "minor" | "harmonicMinor" | "melodicMinor" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "locrian" | "majorPentatonic"…
+- `scalePitchClasses`: (tonic: number, mode?: "major" | "minor" | "harmonicMinor" | "melodicMinor" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "locrian" | "majorPentatonic"…
 - `scatter`: (x: number, y: number, probability: number, seed?: number) => boolean
 - `scatterCells`: (x0: number, y0: number, cols: number, rows: number, probability: number, seed?: number) => { x: number; y: number; }[]
+- `scoreTrack`: (buf: StereoBuffer, profile: GenreProfile) => QualityScore
 - `scriptedPlaythrough`: (world: World, script: Segment[]) => PlaythroughResult
 - `scriptToFrames`: (script: InputScript) => string[][]
+- `scrubTo`: (world: World, def: GameDefinition, ring: SnapshotRing, inputFrames: readonly string[][], axesLog: readonly (readonly [number, string, number])[], knobEvents…
 - `serializeSnapshot`: (snap: WorldSnapshot) => string
 - `series`: (timeline: ProbeFrame[], key: string) => unknown[]
 - `setOverlayHost`: (el: HTMLElement) => void
+- `setScreenObserver`: (cb: ((kind: "show" | "hide", title?: string | undefined) => void) | null) => void
+- `shadowDef`: (s: Shadow, id: string) => string
+- `shapeBBox`: (c: DrawCommand) => BBox | null
 - `shapeBox`: (cmd: DrawCommand) => { x: number; y: number; w: number; h: number; } | null
 - `showScreen`: (spec: ScreenSpec) => ScreenHandle
+- `signalHash`: (sig: Samples) => number
 - `smoothClosedPath`: (points: Vec2[], tension?: number) => string
 - `smoothOpenPath`: (points: Vec2[], tension?: number) => string
+- `softClip`: (x: number) => number
+- `softClipInPlace`: (buf: StereoBuffer) => void
 - `solidNeighbours`: (g: Grid, x: number, y: number) => number
 - `solve`: <State, Move>(puzzle: Puzzle<State, Move>, options?: SolveOptions) => SolveResult<Move>
 - `solveJoint`: (j: Joint, A: RigidBody, B: RigidBody, dt: number, scratch: JointScratch) => void
+- `songBeats`: (song: Song) => number
+- `songDuration`: (song: Song) => number
 - `sortCommands`: (cmds: DrawCommand[]) => DrawCommand[]
+- `spatialMix`: (dx: number, dy: number, hearing?: number, rolloff?: number) => SpatialMix
+- `spectralCentroid`: (sig: Samples, sampleRate?: number) => number
 - `springStep`: (s: SpringState, target: number, omega: number, dt: number) => SpringState
 - `star`: (points: number, outer: number, inner: number, rotation?: number) => number[]
 - `steer2D`: (px: number, py: number, tx: number, ty: number, out: string[], dead?: number) => void
 - `stepPlatformer`: (s: PlatformerState, input: PadInput, dt: number, map: TilemapData, cfg?: PlatformerConfig, platforms?: Platform[]) => PlatformerEvents
+- `stereoDuration`: (buf: StereoBuffer) => number
+- `stereoFrames`: (buf: StereoBuffer) => number
+- `stereoWidth`: (buf: StereoBuffer) => number
+- `subSeed`: (seed: number, i: number) => number
+- `telegraphIssues`: (timeline: readonly TelegraphFrame[], minFrames: number, label?: string) => string[]
 - `terrainHeight`: (col: number, opts: TerrainOptions) => number
 - `terrainSlice`: (startCol: number, count: number, opts: TerrainOptions) => number[]
 - `textBox`: (cmd: TextCommand) => TextBox
@@ -229,10 +336,13 @@
 - `tileAtPoint`: (map: TilemapData, x: number, y: number) => number
 - `tilemapFromAscii`: (rowsAscii: string[], tileSize?: number, chars?: Record<string, TileId>) => TilemapData
 - `toggleFullscreen`: () => void
+- `transpose`: (notes: number[], semitones: number) => number[]
 - `typewriterCount`: (total: number, elapsedSec: number, charsPerSec: number) => number
 - `unpackVarints`: (input: string) => number[]
+- `validateWorld`: (world: WorldGraphDef) => string[]
 - `valueNoise`: (x: number, y: number, seed?: number) => number
 - `vnorm`: (a: Vec2) => Vec2
+- `voiceLead`: (chords: number[][]) => number[][]
 - `wait`: (frames: number) => Segment
 - `wakeBody`: (b: RigidBody) => void
 - `wangTile`: (mask: number) => WangTile
@@ -242,17 +352,38 @@
 - `wipeStep`: (transition: ScreenTransition, opts?: WipeOptions & { name?: string | undefined; }) => CinematicStep
 - `withAlpha`: (hex: string, alpha: number) => string
 - `worldPoints`: (b: RigidBody) => number[]
+- `zcr`: (sig: Samples, sampleRate?: number) => number
 
-## interfaces (132)
+## interfaces (222)
 
+- `AcceptedProof`
+- `ActBounds`
+- `ActSpec`
+- `AlbumTrack`
 - `AmbientStyle`
+- `AnalyzeOptions`
+- `Annotation`
+- `AnnotationContext`
+- `AudioAssertion`
+- `AudioExpectation`
+- `AudioFeatures`
+- `AudioFilmstripOptions`
 - `AutotileDrawOptions`
+- `BandBalance`
+- `BBox`
 - `Behavior`
 - `BfsResult`
 - `BitmapFont`
 - `BitmapTextConfig`
 - `BotCtx`
+- `Breakpoint`
+- `CameraBounds`
 - `CameraConfig`
+- `CameraControllerConfig`
+- `CameraOptions`
+- `Campaign`
+- `CampaignLevel`
+- `CampaignSpec`
 - `CaptureTarget`
 - `CaveOptions`
 - `Cell`
@@ -265,8 +396,11 @@
 - `ContourOptions`
 - `ContourSegment`
 - `CoreEvents`
+- `CreateWorldOptions`
+- `DeathCluster`
 - `DesyncInfo`
 - `DeterminismReport`
+- `DifficultyBand`
 - `DirectorState`
 - `DistanceJoint`
 - `DistanceJointDef`
@@ -274,34 +408,63 @@
 - `DriveResult`
 - `Dungeon`
 - `DungeonOptions`
+- `FeatureDelta`
+- `FeedbackOptions`
+- `FeedbackResponse`
+- `FeelContext`
+- `FeelReport`
+- `FeelSpec`
 - `FilmstripOptions`
 - `FloatStyle`
+- `ForgivenessOptions`
+- `ForgivenessSpec`
 - `FractalOptions`
+- `FutileVerb`
 - `GameDefinition`
 - `GameHandle`
+- `GeneratedLevel`
+- `GenerateOptions`
+- `GenerateReport`
+- `GenreProfile`
+- `GenreTrack`
+- `GradientStop`
 - `Grid`
 - `HayaoCapture`
 - `HeadlessResult`
+- `HesitationSpan`
+- `HotContext`
 - `HSL`
 - `ImageCommand`
 - `InputLog`
 - `JointScratch`
+- `KnobEvent`
 - `LayoutOptions`
+- `LevelChange`
+- `LevelData`
+- `LevelEntity`
+- `LevelSpec`
+- `LinearGradient`
+- `LintOptions`
 - `LockstepOptions`
 - `LoopbackOptions`
 - `Manifold`
+- `MatchResult`
 - `MenuAction`
 - `MoveOpts`
 - `MoveResult`
+- `MusicLayer`
+- `MusicLintResult`
 - `NetGame`
 - `NetGameHandle`
 - `NetRunOptions`
 - `NetSessionConfig`
 - `NineSliceStyle`
 - `NodeConfig`
+- `Note`
 - `PadInput`
 - `Paint`
 - `Palette`
+- `ParallaxLayerConfig`
 - `ParticleStyle`
 - `PathCommand`
 - `PhaseDef`
@@ -311,15 +474,30 @@
 - `Platform`
 - `PlatformerConfig`
 - `PlatformerEvents`
+- `PlatformerReachOptions`
 - `PlatformerState`
+- `PlaytestReport`
+- `PlaytestSession`
 - `PlaythroughResult`
+- `PointerReadout`
+- `PointerTarget`
 - `PolyCommand`
+- `ProgressState`
 - `Puzzle`
+- `QualityScore`
+- `QuitContext`
+- `RadialGradient`
+- `RampOptions`
+- `RampStats`
 - `RayHit`
+- `ReachReport`
+- `RecorderInit`
 - `Rect`
 - `RectCommand`
 - `Renderer`
 - `RendererConfig`
+- `ReplayOptions`
+- `ReverbOptions`
 - `RevoluteJoint`
 - `RevoluteJointDef`
 - `RichChar`
@@ -335,21 +513,33 @@
 - `RoomClientOptions`
 - `RoomHostOptions`
 - `RunOptions`
+- `SalienceOptions`
+- `ScreenEvent`
 - `ScreenHandle`
 - `ScreenSpec`
 - `ScriptSegment`
 - `Segment`
 - `SerializedNode`
 - `Settings`
+- `Shadow`
 - `ShellOptions`
+- `SoftlockReport`
 - `SolidRect`
 - `SolveOptions`
 - `SolveResult`
+- `Song`
+- `SoundSpec`
+- `SpatialMix`
 - `SpawnEvent`
+- `SplashConfig`
 - `SpringState`
 - `SpriteConfig`
 - `StateHandlers`
+- `StereoBuffer`
 - `StorageAdapter`
+- `StudioHandle`
+- `StudioOptions`
+- `TelegraphFrame`
 - `TerrainOptions`
 - `TextBox`
 - `TextCommand`
@@ -359,15 +549,22 @@
 - `TextLayoutOptions`
 - `TextureSpriteConfig`
 - `TilemapData`
+- `TimelineEntry`
 - `TimerConfig`
 - `Tone`
+- `Track`
 - `Transform`
 - `Transition`
 - `TransitionConfig`
 - `Transport`
+- `TuningKnob`
+- `TuningSpec`
 - `UpgradeDef`
+- `Variant`
+- `VariantRef`
 - `Vec2`
 - `Volumes`
+- `WallClockMark`
 - `WangTile`
 - `WaveDef`
 - `WeatherKey`
@@ -376,18 +573,29 @@
 - `WipeOptions`
 - `WorldConfig`
 - `WorldContext`
+- `WorldEdge`
+- `WorldGraphDef`
+- `WorldPickup`
+- `WorldRegion`
 - `WorldSnapshot`
 
-## types (27)
+## types (41)
 
 - `BodyKind`
 - `BoolGrid`
+- `CompletionMode`
+- `DistanceModel`
 - `DrawCommand`
 - `Ease`
 - `Easing`
 - `Edge`
+- `EndReason`
+- `FeedbackChannel`
+- `FeedbackContract`
+- `Gradient`
 - `InputMap`
 - `InputScript`
+- `Instrument`
 - `Joint`
 - `Listener`
 - `Neighbours`
@@ -395,21 +603,29 @@
 - `NodeFactory`
 - `NodeKey`
 - `Passable`
+- `Pitch`
 - `PlayerId`
 - `ProbeFrame`
+- `ProgressMove`
 - `RigidShape`
+- `Samples`
+- `ScaleName`
 - `Shape`
 - `StepExec`
 - `Swatch`
 - `TextAlign`
 - `TileId`
+- `TuningValue`
+- `TuningValues`
 - `WangFrame`
+- `Wave`
 - `WeightedNeighbours`
 - `WipeKind`
 - `WorldFactory`
 
-## consts (48)
+## consts (57)
 
+- `ALBUM`: { title: string; subtitle: string; concept: string; tracks: AlbumTrack[]; }
 - `AMBIENT_PRESETS`: { readonly snow: (colors?: string[]) => AmbientStyle; readonly rain: (colors?: string[]) => AmbientStyle; readonly ash: (colors?: string[]) => AmbientStyle; }
 - `audio`: AudioBus
 - `clamp`: (v: number, lo: number, hi: number) => number
@@ -424,8 +640,13 @@
 - `EASINGS`: Record<string, Easing>
 - `FLOAT_PRESETS`: { readonly damage: (color?: string) => FloatStyle; readonly crit: (color?: string) => FloatStyle; readonly heal: (color?: string) => FloatStyle; readonly lab…
 - `FONT_5`: BitmapFont
+- `GENRE_PROFILES`: Record<string, GenreProfile>
+- `GENRES`: GenreTrack[]
 - `IDENTITY`: Transform
+- `INSTRUMENTS`: Record<string, Instrument>
 - `invLerp`: (a: number, b: number, v: number) => number
+- `KENTO`: { readonly gofun: "#f7f1e2"; readonly washi: "#efe7d3"; readonly kinu: "#e4d8bd"; readonly line: "#d8cbac"; readonly kinako: "#b9a882"; readonly stone: "#6c6…
+- `knob`: { num(key: string, opts: { default: number; min?: number | undefined; max?: number | undefined; step?: number | undefined; label?: string | undefined; group?…
 - `lerp`: (a: number, b: number, t: number) => number
 - `lerpDamp`: (current: number, target: number, lambda: number, dt: number) => number
 - `mapHeight`: (map: TilemapData) => number
@@ -443,18 +664,21 @@
 - `playerInput`: (world: World, player: string) => PlayerInput
 - `rad2deg`: (r: number) => number
 - `remap`: (v: number, a0: number, a1: number, b0: number, b1: number) => number
+- `SAMPLE_RATE`: 44100
 - `SAVE_FORMAT_VERSION`: 1
+- `SCALES`: { readonly major: readonly [0, 2, 4, 5, 7, 9, 11]; readonly minor: readonly [0, 2, 3, 5, 7, 8, 10]; readonly harmonicMinor: readonly [0, 2, 3, 5, 7, 8, 11]; …
 - `screenRect`: (w: number, h: number) => Rect
 - `settings`: SettingsStore
 - `smoothstep`: (edge0: number, edge1: number, v: number) => number
 - `spring`: (value?: number) => SpringState
 - `TAU`: number
 - `TILE`: { readonly EMPTY: 0; readonly SOLID: 1; readonly ONEWAY: 2; readonly HAZARD: 3; }
+- `tileCenter`: (tx: number, ty: number, tileSize: number) => { x: number; y: number; }
 - `vadd`: (a: Vec2, b: Vec2) => Vec2
 - `vdist`: (a: Vec2, b: Vec2) => number
 - `vdot`: (a: Vec2, b: Vec2) => number
 - `vec2`: (x?: number, y?: number) => Vec2
-- `VERSION`: "0.2.0"
+- `VERSION`: "0.3.0"
 - `vlen`: (a: Vec2) => number
 - `vscale`: (a: Vec2, s: number) => Vec2
 - `vsub`: (a: Vec2, b: Vec2) => Vec2