hayao 0.2.0 → 0.4.0

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.**
+**717 exports.**
 
-## classs (47)
+## classs (59)
 
 - `AmbientField`
 - `AnimationPlayer`
@@ -13,16 +13,21 @@
 - `BitmapText`
 - `BroadcastChannelTransport`
 - `Camera2D`
+- `CameraController`
 - `Canvas2DRenderer`
 - `CinematicPlayer`
 - `Clock`
+- `Coroutines`
+- `DepthSort`
 - `EventBus`
 - `FloatingText`
 - `Fsm`
+- `GamepadSource`
 - `HeadlessRenderer`
 - `InputBuffer`
 - `InputRecorder`
 - `InputState`
+- `IsoPrism`
 - `KeyboardSource`
 - `LocalStorageAdapter`
 - `LockstepSession`
@@ -33,38 +38,52 @@
 - `Node`
 - `NodePool`
 - `NullStorage`
+- `ParallaxLayer`
 - `Particles`
 - `PhaseClock`
 - `PixelBuffer`
 - `PlayerInput`
+- `PointerSource`
 - `RingBuffer`
 - `Rng`
 - `RollbackSession`
 - `RoomHost`
 - `SaveManager`
 - `ScreenTransition`
+- `SessionRecorder`
 - `Shaker`
 - `Shell`
 - `Signal`
+- `SnapshotRing`
 - `SpatialHash`
 - `Sprite`
 - `SvgRenderer`
 - `Text`
 - `TextureSprite`
 - `Timer`
+- `TouchControls`
 - `UndoStack`
+- `VerletChain`
+- `WebGL2Renderer`
 - `World`
 
-## functions (185)
+## functions (310)
 
+- `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
+- `all`: (...waits: Wait[]) => Wait
+- `analyzePlaytest`: (def: GameDefinition<Record<string, unknown>>, 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,59 +91,99 @@
 - `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
+- `bootDom`: (def: GameDefinition<Record<string, unknown>>, mount?: HTMLElement | undefined) => DomHarness
+- `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`: <TState extends Record<string, unknown> = Record<string, unknown>>(def: GameDefinition<TState>, 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
 - `decodeMessage`: (data: string) => NetMessage | null
 - `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
+- `defineGame`: <TState extends Record<string, unknown> = Record<string, unknown>>(def: GameDefinition<TState>) => Required<Pick<GameDefinition<TState>, "seed" | "width" | "…
+- `defineLevel`: (spec: LevelSpec) => LevelData
 - `deserializeNode`: (data: SerializedNode) => Node
 - `dexp`: (x: number) => number
 - `dexp2`: (x: number) => number
 - `dhypot`: (x: number, y: number) => number
+- `diamondPoints`: (w: number, h: 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
-- `drive`: (world: World, script: InputScript, until?: ((probe: Record<string, unknown>) => boolean) | undefined) => DriveResult
+- `dpow`: (base: number, exp: number) => number
+- `drive`: (world: World<Record<string, unknown>>, 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
+- `fitViewport`: (rect: { width: number; height: number; }, width: number, height: number) => Viewport
 - `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
+- `frameAxes`: (log: InputLog, i: number) => AxisFrame | undefined
+- `gameInputMap`: (def: GameDefinition<Record<string, unknown>>) => Readonly<Record<string, readonly string[]>>
 - `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
 - `gridToTilemap`: (g: Grid, tileSize?: number) => TilemapData
 - `groundAt`: (map: TilemapData, x: number, y: number, w: number, h: number, solids?: SolidRect[], dropThrough?: boolean) => { grounded: boolean; solid: number; }
+- `hashNoise`: (...values: number[]) => number
 - `hashString`: (str: string) => number
 - `hashValue`: (value: unknown) => string
 - `hexToHsl`: (hex: string) => HSL
@@ -136,21 +195,32 @@
 - `initDirector`: (waves: readonly WaveDef[]) => DirectorState
 - `inputDensity`: (frames: string[][]) => number
 - `installCapture`: (target: CaptureTarget) => HayaoCapture
+- `invalidCommandReason`: (c: DrawCommand) => string | null
 - `invertTransform`: (m: Transform) => Transform
 - `inVisionCone`: (map: TilemapData, ex: number, ey: number, faceX: number, faceY: number, fov: number, range: number, tx: number, ty: number) => boolean
 - `isCaptureMode`: () => boolean
 - `isGround`: (col: number, row: number, opts: TerrainOptions) => boolean
 - `isMonotonic`: (values: number[], dir: "up" | "down", slack?: number) => boolean
+- `iso`: (cfg: IsoConfig) => IsoProjection
 - `joinRoom`: (opts: RoomClientOptions) => Promise<NetGame>
 - `jumpAirtime`: (cfg?: PlatformerConfig) => number
 - `jumpDistance`: (cfg?: PlatformerConfig) => number
 - `jumpHeight`: (cfg?: PlatformerConfig) => number
 - `keyMentions`: (code: string) => string[]
-- `keysToActions`: (map: InputMap, keysDown: Set<string>) => string[]
+- `keysToActions`: (map: Readonly<Record<string, readonly string[]>>, 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,69 +228,130 @@
 - `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[]
-- `missingControlHints`: (world: World, inputMap: InputMap) => string[]
+- `midiToFreq`: (midi: number, a4?: number) => number
+- `midiToName`: (midi: number) => string
+- `missingControlHints`: (world: World<Record<string, unknown>>, inputMap: Readonly<Record<string, readonly string[]>>) => 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; }
+- `nextStep`: () => Wait
 - `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
-- `pump`: (world: World, frames: number, actions?: string[]) => void
+- `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<Record<string, unknown>>, frames: number, actions?: string[]) => void
+- `quantizeAngle`: (radians: number, buckets: number) => number
+- `race`: (...waits: Wait[]) => Wait
+- `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[]
+- `recordTimeline`: (world: World<Record<string, unknown>>, frames: string[][]) => ProbeFrame[]
 - `rectBlocked`: (map: TilemapData, x: number, y: number, w: number, h: number, solids?: SolidRect[]) => boolean
 - `rectContains`: (r: Rect, p: Vec2) => boolean
 - `rectsOverlap`: (a: Rect, b: Rect) => boolean
 - `registerNode`: (type: string, factory: NodeFactory) => void
 - `regularPolygon`: (sides: number, radius: number, rotation?: number) => number[]
+- `regularPolyPoints`: (sides: number, r: number, rotation?: number) => number[]
+- `relLuminance`: (hex: string) => number
 - `removeBody`: (rw: RigidWorld, id: number) => void
 - `removeJoint`: (rw: RigidWorld, id: number) => void
-- `renderFilmstrip`: (world: World, frames: string[][], opts: FilmstripOptions) => string
+- `renderAudioFilmstrip`: (buf: StereoBuffer, opts?: AudioFilmstripOptions) => string
+- `renderFilmstrip`: (world: World<Record<string, unknown>>, 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<Record<string, unknown>>, session: PlaytestSession, opts?: number | ReplayOptions | undefined) => World<...>
 - `resetNodeIds`: (start?: number) => void
+- `resetZzfxWarnings`: () => 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; }
-- `runBrowser`: (def: GameDefinition, mount: HTMLElement, opts?: RunOptions) => GameHandle
-- `runBrowserNet`: (def: GameDefinition, mount: HTMLElement, opts: NetRunOptions) => NetGameHandle
-- `runHeadless`: (def: GameDefinition, inputLog?: InputLog | undefined) => HeadlessResult
+- `rootless`: (chord: number[], targetMidi?: number | undefined) => number[]
+- `runBrowser`: (def: GameDefinition<Record<string, unknown>>, mount: HTMLElement, opts?: RunOptions) => GameHandle
+- `runBrowserNet`: (def: GameDefinition<Record<string, unknown>>, mount: HTMLElement, opts: NetRunOptions) => NetGameHandle
+- `runFeelGates`: (spec: FeelSpec, ctx?: FeelContext) => FeelReport
+- `runHeadless`: <TState extends Record<string, unknown> = Record<string, unknown>>(def: GameDefinition<TState>, inputLog?: InputLog | undefined) => HeadlessResult<TState>
+- `runStudio`: (baseDef: GameDefinition<Record<string, unknown>>, 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; }[]
-- `scriptedPlaythrough`: (world: World, script: Segment[]) => PlaythroughResult
+- `scoreTrack`: (buf: StereoBuffer, profile: GenreProfile) => QualityScore
+- `scriptedPlaythrough`: (world: World<Record<string, unknown>>, script: Segment[]) => PlaythroughResult
 - `scriptToFrames`: (script: InputScript) => string[][]
+- `scrubTo`: (world: World<Record<string, unknown>>, def: GameDefinition<Record<string, unknown>>, ring: SnapshotRing, inputFrames: readonly string[][], axesLog: readonly…
 - `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
+- `shadeHex`: (hex: string, f: number) => string
+- `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
+- `sleep`: (seconds: number) => Wait
 - `smoothClosedPath`: (points: Vec2[], tension?: number) => string
 - `smoothOpenPath`: (points: Vec2[], tension?: number) => string
+- `snapAxis`: (value: number, buckets: number, min?: number, max?: number) => number
+- `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
+- `specFromZzfx`: (p: readonly (number | undefined)[]) => SoundSpec
+- `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,30 +360,57 @@
 - `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
+- `waitFor`: (cond: () => boolean) => Wait
 - `wakeBody`: (b: RigidBody) => void
 - `wangTile`: (mask: number) => WangTile
+- `warnCommandOnce`: (kind: string, reason: string, detail?: unknown) => void
 - `weatherEnvelope`: (t: number, keys: readonly WeatherKey[]) => number
 - `weightedIndex`: (rng: Rng, weights: readonly number[]) => number
 - `weightedPick`: <T>(rng: Rng, items: readonly T[], weights: readonly number[]) => T
 - `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 (240)
 
+- `AcceptedProof`
+- `ActBounds`
+- `ActSpec`
+- `AlbumTrack`
 - `AmbientStyle`
+- `AnalyzeOptions`
+- `Annotation`
+- `AnnotationContext`
+- `ArcCommand`
+- `AudioAssertion`
+- `AudioExpectation`
+- `AudioFeatures`
+- `AudioFilmstripOptions`
 - `AutotileDrawOptions`
+- `BandBalance`
+- `BBox`
 - `Behavior`
 - `BfsResult`
 - `BitmapFont`
 - `BitmapTextConfig`
 - `BotCtx`
+- `Breakpoint`
+- `CameraBounds`
 - `CameraConfig`
+- `CameraControllerConfig`
+- `CameraOptions`
+- `Campaign`
+- `CampaignLevel`
+- `CampaignSpec`
 - `CaptureTarget`
 - `CaveOptions`
 - `Cell`
@@ -265,43 +423,84 @@
 - `ContourOptions`
 - `ContourSegment`
 - `CoreEvents`
+- `CoroutineHandle`
+- `CreateWorldOptions`
+- `DeathCluster`
+- `DepthSortConfig`
 - `DesyncInfo`
 - `DeterminismReport`
+- `DifficultyBand`
 - `DirectorState`
 - `DistanceJoint`
 - `DistanceJointDef`
+- `DomHarness`
 - `DriftAmounts`
 - `DriveResult`
 - `Dungeon`
 - `DungeonOptions`
+- `EllipseCommand`
+- `FeatureDelta`
+- `FeedbackOptions`
+- `FeedbackResponse`
+- `FeelContext`
+- `FeelReport`
+- `FeelSpec`
 - `FilmstripOptions`
 - `FloatStyle`
+- `ForgivenessOptions`
+- `ForgivenessSpec`
 - `FractalOptions`
+- `FutileVerb`
 - `GameDefinition`
 - `GameHandle`
+- `GamepadSourceOptions`
+- `GeneratedLevel`
+- `GenerateOptions`
+- `GenerateReport`
+- `GenreProfile`
+- `GenreTrack`
+- `GradientStop`
 - `Grid`
 - `HayaoCapture`
 - `HeadlessResult`
+- `HesitationSpan`
+- `HotContext`
 - `HSL`
 - `ImageCommand`
 - `InputLog`
+- `InputSource`
+- `IsoConfig`
+- `IsoPrismConfig`
+- `IsoProjection`
 - `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 +510,32 @@
 - `Platform`
 - `PlatformerConfig`
 - `PlatformerEvents`
+- `PlatformerReachOptions`
 - `PlatformerState`
+- `PlaytestReport`
+- `PlaytestSession`
 - `PlaythroughResult`
+- `PointerReadout`
+- `PointerSourceOptions`
+- `PointerTarget`
 - `PolyCommand`
+- `PostProcessPass`
+- `ProgressState`
 - `Puzzle`
+- `QualityScore`
+- `QuitContext`
+- `RadialGradient`
+- `RampOptions`
+- `RampStats`
 - `RayHit`
+- `ReachReport`
+- `RecorderInit`
 - `Rect`
 - `RectCommand`
 - `Renderer`
 - `RendererConfig`
+- `ReplayOptions`
+- `ReverbOptions`
 - `RevoluteJoint`
 - `RevoluteJointDef`
 - `RichChar`
@@ -335,21 +551,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,35 +587,61 @@
 - `TextLayoutOptions`
 - `TextureSpriteConfig`
 - `TilemapData`
+- `TimelineEntry`
 - `TimerConfig`
 - `Tone`
+- `TouchButton`
+- `TouchControlsLayout`
+- `TouchStick`
+- `Track`
 - `Transform`
 - `Transition`
 - `TransitionConfig`
 - `Transport`
+- `TuningKnob`
+- `TuningSpec`
 - `UpgradeDef`
+- `Variant`
+- `VariantRef`
 - `Vec2`
+- `VerletChainConfig`
+- `Viewport`
 - `Volumes`
+- `WallClockMark`
 - `WangTile`
 - `WaveDef`
 - `WeatherKey`
+- `WebGLRendererConfig`
 - `WeightedEdge`
 - `WeightedEntry`
 - `WipeOptions`
 - `WorldConfig`
 - `WorldContext`
+- `WorldEdge`
+- `WorldGraphDef`
+- `WorldPickup`
+- `WorldRegion`
 - `WorldSnapshot`
 
-## types (27)
+## types (46)
 
+- `AxisFrame`
 - `BodyKind`
 - `BoolGrid`
+- `CompletionMode`
+- `DistanceModel`
 - `DrawCommand`
 - `Ease`
 - `Easing`
 - `Edge`
+- `EndReason`
+- `FeedbackChannel`
+- `FeedbackContract`
+- `GamepadMap`
+- `Gradient`
 - `InputMap`
 - `InputScript`
+- `Instrument`
 - `Joint`
 - `Listener`
 - `Neighbours`
@@ -395,25 +649,38 @@
 - `NodeFactory`
 - `NodeKey`
 - `Passable`
+- `PauseMode`
+- `Pitch`
 - `PlayerId`
 - `ProbeFrame`
+- `ProgressMove`
 - `RigidShape`
+- `Samples`
+- `ScaleName`
 - `Shape`
 - `StepExec`
 - `Swatch`
 - `TextAlign`
 - `TileId`
+- `TuningValue`
+- `TuningValues`
+- `UniformValue`
+- `Wait`
 - `WangFrame`
+- `Wave`
 - `WeightedNeighbours`
 - `WipeKind`
 - `WorldFactory`
 
-## consts (48)
+## consts (61)
 
+- `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
+- `BLOOM_PIPELINE`: PostProcessPass[]
 - `clamp`: (v: number, lo: number, hi: number) => number
-- `DEFAULT_INPUT_MAP`: InputMap
+- `DEFAULT_GAMEPAD_MAP`: GamepadMap
+- `DEFAULT_INPUT_MAP`: Readonly<Record<string, readonly string[]>>
 - `DEFAULT_PLATFORMER`: PlatformerConfig
 - `DEFAULT_SESSION_CONFIG`: NetSessionConfig
 - `DEFAULT_TILE_CHARS`: Record<string, TileId>
@@ -424,13 +691,19 @@
 - `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
 - `mapWidth`: (map: TilemapData) => number
 - `MEADOW`: Palette
+- `MOUSE_ACTIONS`: readonly ["mouse.left", "mouse.right", "mouse.middle"]
 - `NEIGHBORS_4`: readonly Cell[]
 - `NEIGHBORS_8`: readonly Cell[]
 - `NET_PROTOCOL_VERSION`: 1
@@ -440,24 +713,28 @@
 - `PAPER`: Palette
 - `PARTICLE_PRESETS`: { readonly dust: (colors?: string[]) => ParticleStyle; readonly burst: (colors?: string[]) => ParticleStyle; readonly hit: (colors?: string[]) => ParticleSty…
 - `playerAction`: (player: string, action: string) => string
-- `playerInput`: (world: World, player: string) => PlayerInput
+- `playerInput`: (world: World<Record<string, unknown>>, 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.4.0"
 - `vlen`: (a: Vec2) => number
 - `vscale`: (a: Vec2, s: number) => Vec2
 - `vsub`: (a: Vec2, b: Vec2) => Vec2
+- `WEBGL_EFFECTS`: { readonly passthrough: "#version 300 es\nprecision mediump float;\nin vec2 v_uv;\nuniform sampler2D u_scene;\nuniform sampler2D u_prev;\nout vec4 fragColor;…
 
 ## exports (1)