lecodes-sdk 0.19.2 → 0.20.2

package/dist/global.d.ts

@@ -11,8 +11,11 @@ declare global {
   const Animator: typeof SDK.Animator
   const Aspect: typeof SDK.Aspect
   const AudioPlayer: typeof SDK.AudioPlayer
+  const AudioSource: typeof SDK.AudioSource
+  const AudioZone: typeof SDK.AudioZone
   const Autotile2D: typeof SDK.Autotile2D
   const Bitmap: typeof SDK.Bitmap
+  const Bus: typeof SDK.Bus
   const Camera: typeof SDK.Camera
   const Camera2D: typeof SDK.Camera2D
   const CameraFollow: typeof SDK.CameraFollow
@@ -24,6 +27,8 @@ declare global {
   const ClickEvent: typeof SDK.ClickEvent
   const Color: typeof SDK.Color
   const DateValue: typeof SDK.DateValue
+  const DecalSet: typeof SDK.DecalSet
+  const Feet: typeof SDK.Feet
   const File: typeof SDK.File
   const FollowPath: typeof SDK.FollowPath
   const FormData: typeof SDK.FormData
@@ -44,6 +49,7 @@ declare global {
   const LongPressEvent: typeof SDK.LongPressEvent
   const LookAt: typeof SDK.LookAt
   const Loop: typeof SDK.Loop
+  const MapView: typeof SDK.MapView
   const Mat4: typeof SDK.Mat4
   const Material: typeof SDK.Material
   const MaterialHandle: typeof SDK.MaterialHandle
@@ -74,6 +80,7 @@ declare global {
   const Push: typeof SDK.Push
   const QRScanner: typeof SDK.QRScanner
   const Quat: typeof SDK.Quat
+  const REVERB_PRESETS: typeof SDK.REVERB_PRESETS
   const Ragdoll: typeof SDK.Ragdoll
   const Ray: typeof SDK.Ray
   const Replicated: typeof SDK.Replicated
@@ -82,10 +89,12 @@ declare global {
   const Scene: typeof SDK.Scene
   const Scene2D: typeof SDK.Scene2D
   const Scene2dHandle: typeof SDK.Scene2dHandle
+  const SceneAudio: typeof SDK.SceneAudio
   const SceneHandle: typeof SDK.SceneHandle
   const Service: typeof SDK.Service
   const Shape: typeof SDK.Shape
   const Shape2D: typeof SDK.Shape2D
+  const Sound: typeof SDK.Sound
   const Spin: typeof SDK.Spin
   const Sprite: typeof SDK.Sprite
   const SpriteAnimation: typeof SDK.SpriteAnimation
@@ -127,6 +136,8 @@ declare global {
   const Vec3: typeof SDK.Vec3
   const Vehicle: typeof SDK.Vehicle
   const VideoPlayer: typeof SDK.VideoPlayer
+  const Voice: typeof SDK.Voice
+  const Warp: typeof SDK.Warp
   const WebSocket: typeof SDK.WebSocket
   const Wheel: typeof SDK.Wheel
   const __GizmoBuffer: typeof SDK.__GizmoBuffer
@@ -151,6 +162,7 @@ declare global {
   const animate: typeof SDK.animate
   const animateMat4: typeof SDK.animateMat4
   const app: typeof SDK.app
+  const audio: typeof SDK.audio
   const cells: typeof SDK.cells
   const clipboard: typeof SDK.clipboard
   const colorCurve: typeof SDK.colorCurve
@@ -210,17 +222,24 @@ declare global {
   type AppState = SDK.AppState
   type Aspect<K extends string, P = Node, E extends EventMap = {}> = SDK.Aspect<K, P, E>
   type AspectEntry<A extends Aspect<any, any> = Aspect<any, any>> = SDK.AspectEntry<A>
+  type AudioCone = SDK.AudioCone
   type AudioPlayer = SDK.AudioPlayer
+  type AudioSource = SDK.AudioSource
+  type AudioStats = SDK.AudioStats
+  type AudioZone = SDK.AudioZone
   type AutoPaintRules = SDK.AutoPaintRules
   type Autotile2D = SDK.Autotile2D
   type Bitmap = SDK.Bitmap
+  type BlendMember = SDK.BlendMember
   type BlendPosition = SDK.BlendPosition
   type BlockEntry = SDK.BlockEntry
+  type Bus = SDK.Bus
   type Camera = SDK.Camera
   type Camera2D = SDK.Camera2D
   type Camera2dNodeDef = SDK.Camera2dNodeDef
   type CameraFacing = SDK.CameraFacing
   type CameraFollow = SDK.CameraFollow
+  type CameraMove = SDK.CameraMove
   type CameraNodeDef = SDK.CameraNodeDef
   type CameraPlace = SDK.CameraPlace
   type CameraView = SDK.CameraView
@@ -230,7 +249,11 @@ declare global {
   type CharacterController2D = SDK.CharacterController2D
   type ClickEvent<T = any> = SDK.ClickEvent<T>
   type ClientChannel<E extends Record<string, unknown> = Record<string, unknown>> = SDK.ClientChannel<E>
+  type ClipAlign = SDK.ClipAlign
+  type ClipCycle = SDK.ClipCycle
   type ClipDef = SDK.ClipDef
+  type ClipEventHandler = SDK.ClipEventHandler
+  type ClipInfo = SDK.ClipInfo
   type ClipKey<V> = SDK.ClipKey<V>
   type ClipTrackDef = SDK.ClipTrackDef
   type CompAxis = SDK.CompAxis
@@ -239,9 +262,15 @@ declare global {
   type ConformOptions = SDK.ConformOptions
   type DateInput = SDK.DateInput
   type DateValue = SDK.DateValue
+  type DecalOptions = SDK.DecalOptions
+  type DecalPlacement = SDK.DecalPlacement
+  type DecalSet = SDK.DecalSet
+  type DecalSetOptions = SDK.DecalSetOptions
+  type DecalSpawnOptions = SDK.DecalSpawnOptions
   type DifferentialMode = SDK.DifferentialMode
   type Displacement = SDK.Displacement
   type DriveLayout = SDK.DriveLayout
+  type EchoParams = SDK.EchoParams
   type EdgeSlot = SDK.EdgeSlot
   type EditorApi = SDK.EditorApi
   type EditorRayHit = SDK.EditorRayHit
@@ -249,12 +278,14 @@ declare global {
   type EditorWindowFn = SDK.EditorWindowFn
   type EngineConfig = SDK.EngineConfig
   type EventMap = SDK.EventMap
+  type Feet = SDK.Feet
   type FeetOptions = SDK.FeetOptions
   type FetchResponse = SDK.FetchResponse
   type FieldMeta<T = unknown> = SDK.FieldMeta<T>
   type File = SDK.File
   type FileData = SDK.FileData
   type FillBlock = SDK.FillBlock
+  type FitOptions = SDK.FitOptions
   type FollowPath = SDK.FollowPath
   type FootState = SDK.FootState
   type FormData = SDK.FormData
@@ -277,6 +308,7 @@ declare global {
   type InspectorUI = SDK.InspectorUI
   type InstanceTransform = SDK.InstanceTransform
   type InstancedMesh = SDK.InstancedMesh
+  type KneeAxisReport = SDK.KneeAxisReport
   type Layer = SDK.Layer
   type LayerOptions = SDK.LayerOptions
   type LevelBuild = SDK.LevelBuild
@@ -290,7 +322,10 @@ declare global {
   type Light = SDK.Light
   type LightDef = SDK.LightDef
   type Lightmap = SDK.Lightmap
+  type LineLayer = SDK.LineLayer
+  type LineLayerOptions = SDK.LineLayerOptions
   type LitMaterialDef = SDK.LitMaterialDef
+  type LngLat = SDK.LngLat
   type LoadedScene<D extends SceneDef> = SDK.LoadedScene<D>
   type LoadedScene2d<D extends Scene2dDef> = SDK.LoadedScene2d<D>
   type Locale = SDK.Locale
@@ -300,12 +335,24 @@ declare global {
   type LocomotionSet = SDK.LocomotionSet
   type LocomotionState = SDK.LocomotionState
   type LocomotionTuning = SDK.LocomotionTuning
+  type LodMode = SDK.LodMode
   type LongPressEvent<T = any> = SDK.LongPressEvent<T>
   type LookAt = SDK.LookAt
   type Loop = SDK.Loop
   type LoopDef = SDK.LoopDef
   type LoopOptions = SDK.LoopOptions
   type MakeEntry<A extends Record<string, unknown> = Record<string, unknown>> = SDK.MakeEntry<A>
+  type MapCamera = SDK.MapCamera
+  type MapOptions = SDK.MapOptions
+  type MapPaddingValues = SDK.MapPaddingValues
+  type MapStyle = SDK.MapStyle
+  type MapStyleName = SDK.MapStyleName
+  type MapTap = SDK.MapTap
+  type MapView = SDK.MapView
+  type MarkerItem = SDK.MarkerItem
+  type MarkerLayer = SDK.MarkerLayer
+  type MarkerLayerOptions = SDK.MarkerLayerOptions
+  type MarkerTap = SDK.MarkerTap
   type Mat4 = SDK.Mat4
   type Material = SDK.Material
   type MaterialData = SDK.MaterialData
@@ -358,6 +405,7 @@ declare global {
   type Plane = SDK.Plane
   type PlayAnimation = SDK.PlayAnimation
   type PlayOptions = SDK.PlayOptions
+  type PlaySoundOptions = SDK.PlaySoundOptions
   type Playback = SDK.Playback
   type PresentOptions = SDK.PresentOptions
   type Presentable = SDK.Presentable
@@ -372,7 +420,10 @@ declare global {
   type RagdollPart = SDK.RagdollPart
   type Ray = SDK.Ray
   type Replicated = SDK.Replicated
+  type ReverbParams = SDK.ReverbParams
+  type ReverbPreset = SDK.ReverbPreset
   type RibbonOptions = SDK.RibbonOptions
+  type Rolloff = SDK.Rolloff
   type RpcError = SDK.RpcError
   type Scene = SDK.Scene
   type Scene2D = SDK.Scene2D
@@ -380,6 +431,7 @@ declare global {
   type Scene2dEnv = SDK.Scene2dEnv
   type Scene2dHandle<D extends Scene2dDef = Scene2dDef> = SDK.Scene2dHandle<D>
   type Scene2dNodeDef = SDK.Scene2dNodeDef
+  type SceneAudio = SDK.SceneAudio
   type SceneDef = SDK.SceneDef
   type SceneHandle<D extends SceneDef = SceneDef> = SDK.SceneHandle<D>
   type SceneInstance<D extends SceneDef> = SDK.SceneInstance<D>
@@ -391,6 +443,9 @@ declare global {
   type Shape2D = SDK.Shape2D
   type SheetSprite = SDK.SheetSprite
   type Signal<T> = SDK.Signal<T>
+  type Sound = SDK.Sound
+  type SoundOptions = SDK.SoundOptions
+  type SpatialOptions = SDK.SpatialOptions
   type Spin = SDK.Spin
   type Sprite = SDK.Sprite
   type SpriteAnimation = SDK.SpriteAnimation
@@ -405,6 +460,8 @@ declare global {
   type StateMachineEvents = SDK.StateMachineEvents
   type StatesDef<C> = SDK.StatesDef<C>
   type SteeringConfig = SDK.SteeringConfig
+  type StepHandler = SDK.StepHandler
+  type StepWarpOptions = SDK.StepWarpOptions
   type StopOptions = SDK.StopOptions
   type System<K extends string, S extends SystemHost = Scene, E extends EventMap = {}> = SDK.System<K, S, E>
   type SystemHost = SDK.SystemHost
@@ -418,6 +475,7 @@ declare global {
   type TerrainSnapshot = SDK.TerrainSnapshot
   type Texture = SDK.Texture
   type Texture2D = SDK.Texture2D
+  type TextureLoadOptions = SDK.TextureLoadOptions
   type ThemeAccessors<T> = SDK.ThemeAccessors<T>
   type ThemeValues = SDK.ThemeValues
   type TileBlock = SDK.TileBlock
@@ -475,11 +533,15 @@ declare global {
   type UIWidgetStyle = SDK.UIWidgetStyle
   type Unit = SDK.Unit
   type UnlitMaterialDef = SDK.UnlitMaterialDef
+  type UserLocationOptions = SDK.UserLocationOptions
   type VRScene = SDK.VRScene
   type Vec2 = SDK.Vec2
   type Vec3 = SDK.Vec3
   type Vehicle = SDK.Vehicle
   type VideoPlayer = SDK.VideoPlayer
+  type Voice = SDK.Voice
+  type VoiceEvents = SDK.VoiceEvents
+  type Warp = SDK.Warp
   type WarpOptions = SDK.WarpOptions
   type WebSocket = SDK.WebSocket
   type Wheel = SDK.Wheel

package/dist/host.d.ts

@@ -29,6 +29,9 @@ declare global {
     error(...data: any[]): void
   }
 
+  /** Compile-time macro: `asset('./data.json')` yields the file's PARSED data (a .json file is
+   *  data, not code — it ships inside the bundle). See the `string` overload for everything else. */
+  function asset(path: `${string}.json`): any
   /** Compile-time macro: `asset('./hero.png')` is desugared by the bundler into the module import
    *  for that resource. The file must exist — a path that resolves to nothing fails the compile
    *  (`asset not found: ./hero.png (main.ts:3)`); there is no runtime fallback. Calls inside

package/dist/types/audio/Bus.d.ts

@@ -0,0 +1,45 @@
+export type ReverbPreset = "room" | "hall" | "cave" | "arena" | "bathroom" | "outdoor";
+export type ReverbParams = {
+    /** 0 (a closet) … 1 (a cathedral). */
+    roomSize?: number;
+    /** High-frequency loss per reflection, 0 … 1. */
+    damping?: number;
+    /** Stereo width of the tail, 0 … 1. */
+    width?: number;
+    /** Wet amount, 0 … 1. */
+    mix?: number;
+    /** Seconds before the tail starts (a big hall: 0.02 … 0.05). */
+    preDelay?: number;
+};
+export type EchoParams = {
+    /** Seconds between repeats (up to 2). */
+    delay?: number;
+    /** Feedback, 0 … 0.95 — how many repeats survive. */
+    decay?: number;
+    /** Wet amount, 0 … 1. */
+    mix?: number;
+};
+export declare const REVERB_PRESETS: Record<ReverbPreset, Required<ReverbParams>>;
+export declare class Bus {
+    readonly name: string;
+    private _volume;
+    private _muted;
+    private _reverb;
+    private _echo;
+    private _lowpass;
+    private get _live();
+    get volume(): number;
+    set volume(v: number);
+    get muted(): boolean;
+    set muted(v: boolean);
+    /** A preset name, explicit params, or null (off). */
+    get reverb(): ReverbPreset | ReverbParams | null;
+    set reverb(v: ReverbPreset | ReverbParams | null);
+    get echo(): EchoParams | null;
+    set echo(v: EchoParams | null);
+    /** Low-pass cutoff in Hz (20 … 20000), null = off. */
+    get lowpass(): number | null;
+    set lowpass(v: number | null);
+    /** Stop every voice on this bus (fade in seconds). */
+    stopAll(fade?: number): void;
+}

package/dist/types/audio/Sound.d.ts

@@ -0,0 +1,28 @@
+export type SoundOptions = {
+    /** Keep two channels (2D playback of stereo material — music beds, ambiences). Default: the clip
+     *  is decoded MONO, which is what 3D spatialization needs and what SFX are anyway. */
+    stereo?: boolean;
+};
+export declare class Sound {
+    /** The urls this clip was loaded from (one per variant). */
+    readonly urls: readonly string[];
+    private readonly _durations;
+    private _channels;
+    private _disposed;
+    private _last;
+    private constructor();
+    /** Fetch + decode. An array = variants: `play` picks a random one (never the same twice in a row
+     *  when there are 3 or more). Rejects with the failing url when a file cannot be decoded. */
+    static load(src: string | string[], options?: SoundOptions): Promise<Sound>;
+    /** Seconds (the first variant's). 0 for a silent clip. */
+    get duration(): number;
+    /** Decoded channel count: 1, or 2 with `{ stereo: true }`. */
+    get channels(): number;
+    /** How many variants this clip carries. */
+    get variants(): number;
+    /** True when the engine has this clip (false on hosts without audio, or after dispose). */
+    get ready(): boolean;
+    get disposed(): boolean;
+    /** Free the engine's PCM. Voices playing it stop at once. Idempotent. */
+    dispose(): void;
+}

package/dist/types/audio/Voice.d.ts

@@ -0,0 +1,27 @@
+import { Emitter } from "../core/events";
+export type VoiceEvents = {
+    /** The voice is over: the clip ended, `stop` completed, or the pool reused the slot. */
+    ended: () => void;
+};
+export declare class Voice extends Emitter<VoiceEvents> {
+    private _volume;
+    private _pitch;
+    private _pan;
+    private _over;
+    addEventListener<K extends keyof VoiceEvents>(channel: K, callback: VoiceEvents[K]): void;
+    /** True while the engine plays this voice. */
+    get playing(): boolean;
+    /** Seconds into the clip. */
+    get time(): number;
+    get volume(): number;
+    set volume(v: number);
+    get pitch(): number;
+    set pitch(v: number);
+    /** 2D voices only: -1 left … 1 right. */
+    get pan(): number;
+    set pan(v: number);
+    /** Stop now, or fade out over `fade` seconds. `ended` fires from the engine afterwards. */
+    stop(options?: {
+        fade?: number;
+    }): void;
+}

package/dist/types/audio/audio.d.ts

@@ -0,0 +1,83 @@
+import { type Vec3Like } from "../math/vec";
+import { Bus } from "./Bus";
+import type { Sound } from "./Sound";
+import { Voice } from "./Voice";
+export type PlaySoundOptions = {
+    /** 0 … 1 (and above, at your own risk). Default 1. */
+    volume?: number;
+    /** Playback rate, 1 = unchanged. Default 1. */
+    pitch?: number;
+    loop?: boolean;
+    /** Bus name; default: the source's bus, `sfx` for 2D. */
+    bus?: string;
+    /** Higher survives voice stealing when the pool is full. Default 0. */
+    priority?: number;
+    /** Fade-in seconds. Default 0. */
+    fade?: number;
+    /** Seconds into the clip to start from. */
+    startAt?: number;
+    /** 2D only: -1 left … 1 right. */
+    pan?: number;
+};
+export type Rolloff = "none" | "inverse" | "linear" | "exponential";
+/** Distance model of an AudioSource / playAt. */
+export type SpatialOptions = {
+    /** Metres of full volume around the source. Default 1. */
+    minDistance?: number;
+    /** Metres beyond which the source no longer gets quieter. Default 50. */
+    maxDistance?: number;
+    /** How volume falls between the two: `inverse` (default, physical), `linear`, `exponential`, `none`. */
+    rolloff?: Rolloff;
+};
+export declare const ROLLOFF: Record<Rolloff, number>;
+export type AudioStats = {
+    voicesPlaying: number;
+    voicesMono: number;
+    voicesStereo: number;
+    /** Voices displaced (or dropped) by a fuller pool since start. */
+    stolen: number;
+    clips: number;
+    clipBytes: number;
+    /** Master peak since the previous read, linear (1 = full scale). */
+    peak: number;
+    sampleRate: number;
+    /** The reverb zone the listener is in (0 = none) and how far inside (0 … 1). */
+    listenerZone: number;
+    zoneBlend: number;
+    /** Voices rendered binaurally right now (see `audio.hrtf`). */
+    hrtfVoices: number;
+};
+declare class AudioSystem {
+    private readonly _buses;
+    private _hrtf;
+    private _hrtfVoices;
+    private _timeScalePitch;
+    /** True when this host mixes sound. Everything below is a silent no-op otherwise. */
+    get supported(): boolean;
+    /** HRTF binaural rendering (MIT KEMAR filters on the CPU): sounds get a real up / down / behind in
+     *  HEADPHONES. Off by default — on speakers it only smears the image. Applies to the `hrtfVoices`
+     *  nearest 3D voices; the rest keep plain panning. */
+    get hrtf(): boolean;
+    set hrtf(v: boolean);
+    /** `Time.scale` also pitches the sfx bus: slow motion drops every effect's tone, like a film. Default
+     *  false — a pause only mutes sfx, the menu click keeps its pitch. */
+    get timeScalePitch(): boolean;
+    set timeScalePitch(v: boolean);
+    /** How many voices get the (CPU-heavier) binaural path. Default 16. */
+    get hrtfVoices(): number;
+    set hrtfVoices(n: number);
+    /** A bus by name — the five built-ins, or an app-defined one created on first use. */
+    bus(name: string): Bus;
+    get master(): Bus;
+    /** 2D playback (UI, stingers, music one-shots). */
+    play(sound: Sound, options?: PlaySoundOptions): Voice;
+    /** A one-shot at a world position with its own transient source — impacts, ricochets, debris.
+     *  The source is freed when the voice ends. */
+    playAt(sound: Sound, position: Vec3Like, options?: PlaySoundOptions & SpatialOptions): Voice;
+    /** Stop every voice on every bus (fade in seconds). */
+    stopAll(fade?: number): void;
+    /** Engine counters for a debug overlay or a perf log. */
+    get stats(): AudioStats;
+}
+export declare const audio: AudioSystem;
+export type { AudioSystem };

package/dist/types/audio/support.d.ts

@@ -0,0 +1 @@
+export declare const audioSupported: boolean;

package/dist/types/gl/AudioSource.d.ts

@@ -0,0 +1,60 @@
+import { Aspect } from "../core/Aspect";
+import type { FieldMeta } from "../core/fields";
+import { type PlaySoundOptions, type Rolloff } from "../audio/audio";
+import type { Sound } from "../audio/Sound";
+import type { Voice } from "../audio/Voice";
+import type { Node } from "./Node";
+export type AudioCone = {
+    /** Degrees of full volume around the node's −Z. */
+    inner: number;
+    /** Degrees where the volume has fallen to `outerGain`. */
+    outer: number;
+    /** Volume behind the source, 0 … 1. */
+    outerGain?: number;
+};
+export declare class AudioSource extends Aspect<"audio", Node> {
+    static readonly aspect = "audio";
+    static fields: FieldMeta<AudioSource>;
+    private _minDistance;
+    private _maxDistance;
+    private _rolloff;
+    private _cone;
+    private _doppler;
+    private _spread;
+    private _occlusion;
+    private _bus;
+    /** Metres of full volume around the node. Default 1. */
+    get minDistance(): number;
+    set minDistance(v: number);
+    /** Metres beyond which the source no longer gets quieter. Default 50. */
+    get maxDistance(): number;
+    set maxDistance(v: number);
+    /** `inverse` (default), `linear`, `exponential`, `none`. */
+    get rolloff(): Rolloff;
+    set rolloff(v: Rolloff);
+    /** Directional source along the node's −Z; null = omnidirectional (default). */
+    get cone(): AudioCone | null;
+    set cone(v: AudioCone | null);
+    /** Doppler amount 0 … 1 (0 = off, the default) — needs the node to actually move. */
+    get doppler(): number;
+    set doppler(v: number);
+    /** 0 = pin-point panning (default) … 1 = the same on every speaker (a big, close source). */
+    get spread(): number;
+    set spread(v: number);
+    /** The engine raycasts listener → source (against solid bodies) and muffles the voices when
+     *  something is in the way. Default false. */
+    get occlusion(): boolean;
+    set occlusion(v: boolean);
+    /** Default bus for voices on this source. Default `sfx`. */
+    get bus(): string;
+    set bus(v: string);
+    /** Live voices on this source. */
+    get voices(): number;
+    onAttach(): void;
+    onDetach(): void;
+    /** Play a clip from this node. */
+    play(sound: Sound, options?: PlaySoundOptions): Voice;
+    /** Stop every voice on this source (fade in seconds). */
+    stopAll(fade?: number): void;
+    private _push;
+}

package/dist/types/gl/AudioZone.d.ts

@@ -0,0 +1,32 @@
+import { Aspect } from "../core/Aspect";
+import { type ReverbParams, type ReverbPreset } from "../audio/Bus";
+import { type Vec3Like } from "../math/vec";
+import type { Node } from "./Node";
+export declare class AudioZone extends Aspect<"audioZone", Node> {
+    static readonly aspect = "audioZone";
+    private _box;
+    private _sphere;
+    private _reverb;
+    private _blend;
+    private _bus;
+    /** The engine's zone id — what `audio.stats.listenerZone` reports while the listener is inside. */
+    get id(): number;
+    /** Half-extents [hx, hy, hz]; falls back to the node's Shape box, then a 1 m cube. */
+    get box(): Vec3Like | null;
+    set box(v: Vec3Like | null);
+    /** Radius; falls back to the node's Shape sphere. */
+    get sphere(): number | null;
+    set sphere(v: number | null);
+    /** A preset name or explicit params (see Bus.reverb). */
+    get reverb(): ReverbPreset | ReverbParams;
+    set reverb(v: ReverbPreset | ReverbParams);
+    /** Crossfade depth in metres inside the border (0 = a hard edge). Default 1. */
+    get blend(): number;
+    set blend(v: number);
+    /** The bus the zone's reverb rides on. Default `sfx`. */
+    get bus(): string;
+    set bus(v: string);
+    onAttach(): void;
+    onDetach(): void;
+    private _push;
+}

package/dist/types/gl/DecalSet.d.ts

@@ -0,0 +1,103 @@
+import { Node } from "./Node";
+import { Material } from "./Material";
+import type { Texture } from "./Texture";
+import { type Vec3Like } from "../math/vec";
+import { type QuatLike } from "../math/quat";
+import { type ColorInput } from "../core/color";
+/** Per-decal look and life — defaults come from the set's options. */
+export type DecalOptions = {
+    /** Image width and height on the surface (world units); a number = square. Default 0.2. */
+    size?: number | [number, number];
+    /** Projection depth (world units): how far in front of and behind the hit point the decal still
+     *  lands. Default = the smaller of width / height. */
+    depth?: number;
+    /** Atlas cell (row-major from the top-left) for a set with a `sheet`; `"random"` picks one.
+     *  Default 0. */
+    frame?: number | "random";
+    /** Tint multiplied into the image. Default white. */
+    tint?: ColorInput;
+    /** 0..1 on top of the tint's alpha. Default 1. */
+    opacity?: number;
+    /** Seconds until the decal is gone; 0 = stays until recycled. Default 0. */
+    life?: number;
+    /** Seconds to fade in after spawning. Default 0. */
+    fadeIn?: number;
+    /** Seconds of fade at the end of `life` (ignored with life 0). Default 0. */
+    fadeOut?: number;
+};
+export type DecalSetOptions = DecalOptions & {
+    /** The material — `Material.decal({ map })` by default (`map` below is its shortcut). A custom
+     *  material must keep decal.mat's vertex contract. */
+    material?: Material;
+    /** Atlas texture for the default material. */
+    map?: Texture;
+    /** Tangent-space normal atlas (same cell grid) → a RELIEF decal that bends the surface's
+     *  lighting instead of painting a colour (`Material.decal` `normalMap`). Footprints and dents
+     *  need only this; a bullet hole gives `map` too and its colour multiplies in. */
+    normalMap?: Texture;
+    /** Relief strength for `normalMap`. Default 1. Default material only. */
+    bump?: number;
+    /** Atlas grid of the map: columns, or [columns, rows]. Default 1 (the whole texture). */
+    sheet?: number | [number, number];
+    /** Slot budget — the most decals alive at once. Default 256. */
+    max?: number;
+    /** Soft fraction (0..1) of the box's half depth at both ends, so an oblique surface leaves the
+     *  box gently. Default 0.3. Default material only. */
+    edge?: number;
+    /** Surfaces turned more than this away from the projection axis fade out — the cosine of the
+     *  angle (0.3 ≈ 72°) keeps a floor hit off the wall it meets; 0 = project onto anything.
+     *  Default 0.3. Default material only. */
+    angleFade?: number;
+    /** HDR boost of the image (0 = none). Default material only. */
+    emissive?: number;
+    name?: string;
+    /** Coarse draw order, 0 (first) … 7 (last); default 4 — see `Mesh.renderPriority`. Decals are
+     *  blended and sort with the other blended draws of their priority. */
+    renderPriority?: number;
+};
+/** `spawn` placement: where the image sits on the surface. */
+export type DecalSpawnOptions = DecalOptions & {
+    /** World direction the image's top points along the surface (projected onto it) — a footprint's
+     *  travel direction. Default: a random spin. */
+    up?: Vec3Like;
+    /** Extra spin around the normal, radians. Default: random when `up` is not given, else 0. */
+    rotation?: number;
+};
+/** `place` / `update` placement: a full frame, like a node looking INTO the surface (its −Z is the
+ *  projection direction, +Y the image's top). */
+export type DecalPlacement = DecalOptions & {
+    position: Vec3Like;
+    /** A quaternion, or Euler degrees (YXZ) like `Node.eulerAngles`. Default identity = projecting
+     *  down −Z. */
+    rotation?: QuatLike | Vec3Like;
+};
+export declare class DecalSet extends Node {
+    private _material;
+    private readonly _max;
+    private readonly _cols;
+    private readonly _rows;
+    private readonly _defaults;
+    private readonly _rec;
+    private readonly _slots;
+    private static _warned;
+    constructor(options?: DecalSetOptions);
+    get material(): Material;
+    /** Decals alive right now. */
+    get count(): number;
+    /** The slot budget the set was created with. */
+    get max(): number;
+    /** Coarse draw order, 0 … 7 — see `Mesh.renderPriority`. Write-only. */
+    set renderPriority(v: number);
+    /** Stamp a decal on a surface: `point` on it, `normal` out of it (a raycast hit, a foot plant
+     *  with `Vec3.up`). Returns the slot for `update` / `remove` (−1 when the host draws none). */
+    spawn(point: Vec3Like, normal: Vec3Like, options?: DecalSpawnOptions): number;
+    /** Place a decal by a full frame (an editor-placed stain, a moving marker). Returns the slot. */
+    place(placement: DecalPlacement): number;
+    /** Move / restyle a placed decal; fields left out keep the values it was placed with. Its birth
+     *  time (the life clock) is kept. */
+    update(slot: number, placement: Partial<DecalPlacement>): this;
+    remove(slot: number): this;
+    clear(): this;
+    private _writePlacement;
+    private _write;
+}

package/dist/types/gl/Geometry.d.ts

@@ -10,6 +10,11 @@ export declare class Geometry {
      *  tiles per face, which would fold every face onto the same texels); absent = the host reuses
      *  `uv`, which is right for a plane. */
     uv1?: Float32Array;
+    /** Per-vertex COLOURS: 4 bytes (r, g, b, a) per vertex, 0..255. A material that declares
+     *  `requires: [color]` reads them through `getColor()` — one mesh, many colours, no material per
+     *  shade (a debug drawer, a gradient along a curve). Absent = every vertex white, which is what
+     *  the built-in materials expect. */
+    colors?: Uint8Array;
     constructor(vertices: Float32Array, normals: Float32Array, indices: Uint16Array, uv: Float32Array);
     translate(x: number, y: number, z: number): this;
     scale(x: number, y: number, z: number): this;

package/dist/types/gl/Light.d.ts

@@ -53,6 +53,7 @@ export declare class Light extends Node {
     private _intensity;
     /** The most recently created sun — what `Lightmap.load` uses unless told otherwise. */
     static lastSun: Light | null;
+    _shadowDistance: number;
     /** A directional sun light. */
     static sun(options?: SunOptions): Light;
     /**
@@ -70,4 +71,10 @@ export declare class Light extends Node {
     set intensity(value: number);
     destroy(): void;
     set color(value: ColorInput);
+    get color(): ColorInput;
+    /** Sun direction as created (the engine keeps it; a settings menu rebuilds a sun from it). */
+    get direction(): [number, number, number];
+    /** Sun shadow options as created — creation-time in the engine, so a change means a new sun. */
+    get shadowsQuality(): number;
+    get shadowDistance(): number;
 }