@aura3d/cli 5.0.1 → 5.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/cli",
-  "version": "5.0.1",
+  "version": "5.0.2",
   "type": "module",
   "bin": {
     "aura3d": "dist/cli.js",
@@ -27,11 +27,11 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@aura3d/asset-index": "5.0.1",
-    "@aura3d/assets": "5.0.1",
-    "@aura3d/audio": "5.0.1",
-    "@aura3d/rendering": "5.0.1",
-    "create-aura3d": "5.0.1",
+    "@aura3d/asset-index": "5.0.2",
+    "@aura3d/assets": "5.0.2",
+    "@aura3d/audio": "5.0.2",
+    "@aura3d/rendering": "5.0.2",
+    "create-aura3d": "5.0.2",
     "typescript": "^5.8.3"
   },
   "description": "Bring real GLB/glTF assets into Aura3D browser apps with typed references, provenance, catalog search, validation, screenshots, and deploy checks.",

package/skills/agent-docs/api-signatures.md

@@ -0,0 +1,411 @@
+# API signatures (answer-first)
+
+Generated by `node tools/docs/gen-api-signatures.mjs --write` from the real `@aura3d/engine` root types (`packages/engine/src/public/index.ts`). Do not edit by hand: without `--write` the same command fails when this file is stale. Read this instead of opening `node_modules/@aura3d/engine` type files; every example line is type-checked in [`recipes-src/signature-examples.check.ts`](recipes-src/signature-examples.check.ts). The complete export list is [`docs/api/root-exports.md`](../api/root-exports.md); this page covers the roots agents look up most.
+
+Columns: Call (parameters, `?` = optional), Returns, Options (the keys of the first options object, `?` = optional). Colours are CSS strings, vectors are `[x, y, z]` tuples, angles are radians unless the name says `Deg`.
+
+Defaults the types do not carry (read from `agent-api/nodes/lights.ts`):
+
+| Call | Defaults |
+|---|---|
+| `lights.ambient` | intensity 0.28, color #ffffff |
+| `lights.hemisphere` | skyColor #bcd7ff, intensity 1, position [0, 1, 0] |
+| `lights.directional` | position [3, 4, 3], intensity 1.5, color #ffffff |
+| `lights.point` | position [2, 2.5, 1.5], intensity 8, color #ffffff |
+| `lights.spot` | position [0, 4, 0], angle pi/6, penumbra 0.4, distance 12, intensity 30 |
+
+## `createAuraApp`
+
+Mounts the scene, owns renderer, resize, loop and disposal. `await app.ready()` before the first frame is judged.
+
+```ts
+const app = createAuraApp("#app", { scene: scene({ background: "#101418" }) });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `createAuraApp(target: AuraAppTarget, options: AuraCreateAppOptions)` | `AuraApp` | options: frameMode?: "sync" \| "async" \| undefi…; scene: AuraSceneBuilder \| AuraSc…; worker?: { readonly createWorker: …; physics?: { readonly layers?: AuraC…; diagnostics?: boolean \| AuraDiagnostics…; renderer?: AuraCreateAppRendererOpti…; performanceQuality?: AuraPerformanceQuality \| …; quality?: AuraQualityMode \| undefin…; preserveDrawingBuffer?: boolean \| undefined; autoStart?: boolean \| undefined; resize?: boolean \| undefined; pixelRatio?: number \| { readonly max?:…; qualityRebuild?: { readonly flags?: import…; lightin… |
+| `app.onFrame(callback: AuraFrameCallback)` | `() => void` |  |
+| `app.ready()` | `Promise<void>` |  |
+| `app.nodes` | `AuraRuntimeNodeRegistry` |  |
+| `app.setScene(scene: AuraSceneBuilder \| AuraSceneSnapshot)` | `void` |  |
+| `app.pause()` | `void` |  |
+| `app.resume()` | `void` |  |
+| `app.screenshot()` | `AuraScreenshot` |  |
+| `app.atmosphere` | `AuraAppAtmosphere \| undefined` |  |
+| `app.effects` | `AuraAppEffects \| undefined` |  |
+| `app.camera` | `AuraCameraController \| undefined` |  |
+| `app.input(options: GameInputOptions)` | `GameInputController & { recordedDeviceState(): GameInputDeviceRecordi…` | options: actions: Record<string, readonly s…; axes?: Record<string, GameInputA…; axisDefaults?: GameInputAxisSettings \| u…; bufferMs?: number \| Readonly<Record<…; target?: EventTarget \| undefined; autoListen?: boolean \| undefined; pointer?: boolean \| undefined; touch?: boolean \| undefined; gamepad?: boolean \| { readonly inde…; recordDeviceState?: "aura-game-input-device-s… |
+| `app.diagnostics()` | `AuraDiagnostics` |  |
+| `app.dispose()` | `void` |  |
+
+## `scene`
+
+Builder: `.add(node)` one node or builder at a time, `.camera(spec)`, `.background(color)`.
+
+```ts
+const stage = scene({ background: "#101418" }).add(primitives.box({ name: "crate" })).camera(camera.perspective({ position: [3, 2, 5], target: [0, 0.5, 0], fov: 45 }));
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `scene(init: AuraSceneInit \| undefined)` | `AuraSceneBuilder` | init: children?: readonly (AuraSceneNode \|…; background?: string \| AuraSceneBackgro…; camera?: AuraCameraSpec \| undefined; timeline?: AuraTimelineSpec \| undefi…; diagnostics?: boolean \| undefined; clipping?: AuraClipGroup \| AuraClipG… |
+| `scene().add(node: AuraSceneNode \| AuraNodeBuilder<AuraSceneNode>)` | `AuraSceneBuilder` |  |
+| `scene().addMany(nodes: readonly (AuraSceneNode \| AuraNodeBuilder<AuraSceneNode>)[])` | `AuraSceneBuilder` |  |
+| `scene().camera(next: AuraCameraSpec)` | `AuraSceneBuilder` | next: mode: AuraCameraMode; position?: AuraVec3 \| undefined; target?: AuraVec3 \| undefined; up?: AuraVec3 \| undefined; roll?: number \| undefined; offset?: AuraVec3 \| undefined; targetOffset?: AuraVec3 \| undefined; offsetMode?: "scene" \| "target-yaw" \| …; fov?: number \| undefined; focalLength?: number \| undefined; filmGauge?: number \| undefined; filmOffset?: number \| undefined; viewOffset?: { readonly fullWidth: num…; depth?: { readonly mode?: "standa…; near?: number \| undefined; far?: number \| undefined; layers?: number… |
+| `scene().background(color: string \| AuraSceneBackgroundImage, options?: {…})` | `AuraSceneBuilder` | options: toneMapped?: boolean \| undefined |
+| `scene().timeline(next: AuraTimelineSpec)` | `AuraSceneBuilder` | next: mode: "loop" \| "once"; seconds?: number \| undefined; startTime?: number \| undefined; duration?: number \| undefined; loop?: boolean \| undefined; easing?: "linear" \| "easeInOut" \| …; captureTime?: number \| undefined |
+| `scene().physics(next: AuraPhysicsWorldController)` | `AuraSceneBuilder` |  |
+| `scene().diagnostics(enabled?: boolean)` | `AuraSceneBuilder` |  |
+
+## `looks`
+
+Genre look presets: environment, key light, fog and grade in one unit. Spread `looks.appOptions(id)` into `createAuraApp` options.
+
+```ts
+void looks.preset("product-studio");
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `looks.preset(id: AuraLookId, overrides: AuraLookOverrides \| undefined)` (+1 overloads) | `AuraNodeBuilder<AuraGroupNode>` | overrides: sun?: { readonly azimuthDeg?: n…; exposureEv?: number \| undefined; fogDensityScale?: number \| undefined; accent?: string \| undefined; background?: string \| undefined; hdri?: AuraHdriId \| AuraAssetRef…; environmentIntensity?: number \| undefined; environmentRotationDeg?: number \| undefined; key?: { readonly color?: AuraCo…; rim?: false \| { readonly color?…; fog?: { readonly color?: AuraCo…; grade?: { readonly contrast?: num…; post?: AuraPostPresetId \| { read… |
+| `looks.nodes(id: AuraLookId, overrides: AuraLookOverrides \| undefined)` | `readonly AuraNodeBuilder<AuraSceneNode>[]` | same as `looks.preset` |
+| `looks.appOptions(id: AuraLookId, options: AuraLookBuildOptions \| undefined)` | `Pick<AuraCreateAppOptions, "pixelRatio" \| "renderer">` | options: expansion?: "auto" \| "v0" \| "v1" \| un…; flags?: QrFlags \| undefined |
+| `looks.list()` | `readonly AuraLookId[]` |  |
+| `looks.describe(id: AuraLookId)` | `AuraLookPreset` |  |
+| `looks.resolveDefault(snapshot: AuraSceneSnapshot)` | `{ readonly id: AuraLookId \| "engine-default"; readonly source: "autho…` | snapshot: schema: "aura3d-scene-snapshot/1.…; clipping?: AuraClipGroupSnapshot \| u…; background: string; backgroundImage?: AuraSceneBackgroundImage …; backgroundToneMapped?: false \| undefined; overrideMaterial?: AuraMaterialSpec \| undefi…; camera: AuraCameraSpec; timeline?: AuraTimelineSpec \| undefi…; physics?: AuraPhysicsSceneSummary \|…; nodes: readonly AuraSceneNode[]; diagnostics: { readonly enabled: boole… |
+
+## `material`
+
+Colours are CSS strings. Metals need an environment.
+
+```ts
+void material.pbr({ color: "#c8ccd4", metallic: 0.9, roughness: 0.38 });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `material.custom(spec: AuraCustomMaterialSpec)` | `AuraMaterialSpec` | spec: glsl: { readonly vertex?: strin…; wgsl?: { readonly vertex?: strin…; uniforms?: Readonly<Record<string, A…; uniformAliases?: Readonly<Record<string, s…; defines?: Readonly<Record<string, s…; transparent?: boolean \| undefined; depthWrite?: boolean \| undefined; depthTest?: boolean \| undefined; side?: "front" \| "back" \| "doubl…; blending?: "custom" \| "normal" \| "ad…; fog?: boolean \| undefined; patch?: Readonly<Record<string, s…; receiveShadow?: boolean \| undefined; castShadow?: boolean \| undefined |
+| `material.toon(options?: AuraToonMaterialOptions)` | `AuraMaterialSpec` | options: color?: string \| undefined; steps?: number \| undefined; ramp?: AuraAssetRef<"texture", s…; shadowColor?: string \| undefined; rim?: AuraMaterialRimSpec \| und… |
+| `material.matcap(options: AuraMatcapMaterialOptions)` | `AuraMaterialSpec` | options: map: AuraAssetRef<"texture"> \|…; color?: string \| undefined; opacity?: number \| undefined; transparent?: boolean \| undefined; side?: "front" \| "back" \| "doubl… |
+| `material.depth(options?: AuraDepthPreviewMaterialOptions)` | `AuraMaterialSpec` | options: near?: number \| undefined; far?: number \| undefined; side?: "front" \| "back" \| "doubl… |
+| `material.normal(options?: AuraNormalMaterialOptions)` | `AuraMaterialSpec` | options: side?: "front" \| "back" \| "doubl… |
+| `material.distance(options?: AuraDistanceMaterialOptions)` | `AuraMaterialSpec` | options: referencePosition?: AuraVec3 \| undefined; near?: number \| undefined; far?: number \| undefined; side?: "front" \| "back" \| "doubl… |
+| `material.shadow(options?: AuraShadowMaterialOptions)` | `AuraMaterialSpec` | options: color?: string \| undefined; opacity?: number \| undefined; side?: "front" \| "back" \| "doubl…; light?: "directional" \| "point" \|… |
+| `material.node(options: TslMaterialNodeOptions \| ShaderGraphMaterialOptions)` | `AuraMaterialSpec` |  |
+| `material.pbr(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.physical(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.emissive(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.metal(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.rubber(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.glass(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.clearcoat(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.neon(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.reflectiveFloor(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.solarSun(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.solarCorona(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.fabric(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.chrome(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.brushedMetal(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.frostedGlass(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.clearGlass(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.blackRubber(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.matteClay(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.ceramic(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.glowingEmissive(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.clearcoatPaint(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.sneakerMesh(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.sneakerRubber(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.felt(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.lacquer(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.carPaint(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.planet(preset?: AuraSolarPlanetMaterialPreset, options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.atmosphere(options?: AuraMaterialSpec)` | `AuraMaterialSpec` |  |
+| `material.proceduralTexture(texture: AuraProceduralTextureKind, options?: Partial<Omit<AuraProceduralTextureSpec, "texture" \| "kind">>)` | `AuraProceduralTextureSpec` | options: scale?: number \| undefined; strength?: number \| undefined; contrast?: number \| undefined; direction?: AuraVec3 \| undefined; colorA?: string \| undefined; colorB?: string \| undefined |
+| `material.proceduralTextures` | `value` |  |
+| `material.parameters(name: string, spec: AuraMaterialSpec)` | `AuraEditableMaterialParameters` |  |
+| `material.fromParameters(parameters: AuraEditableMaterialParameters)` | `AuraMaterialSpec` | parameters: kind: "aura-material-parameters"; name: string; material: AuraMaterialSpec; roughness: number; metallic: number; metalness: number; transmission: number; clearcoat: number; clearcoatRoughness: number; thickness: number; ior: number; sheen: number; iridescence: number; anisotropy: number; envMapIntensity: number; emissiveIntensity: number |
+| `material.labParameters()` | `readonly AuraEditableMaterialParameters[]` |  |
+| `material.presets()` | `Readonly<Record<string, AuraMaterialSpec>>` |  |
+| `material.inspector(name: string, spec: AuraMaterialSpec)` | `AuraMaterialInspectorPanel` |  |
+| `material.visualQA(nodes: readonly AuraSceneNode[])` | `AuraMaterialVisualQAResult` |  |
+| `material.capabilityDiagnostics(input: AuraMaterialCapabilityInput)` | `AuraMaterialCapabilityDiagnostics` |  |
+
+## `lights`
+
+Intensities are not three.js-calibrated; judge a capture.
+
+```ts
+void lights.directional({ position: [4, 6, 3], target: [0, 0, 0], intensity: 3, shadow: true });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `lights.lensFlare(options?: AuraLensFlareOptions)` | `AuraNodeBuilder<AuraSceneNode>` | options: name?: string \| undefined; position?: AuraVec3 \| undefined; light?: string \| undefined; elements?: readonly AuraLensFlareEle…; occlusion?: AuraLensFlareOcclusion \| …; edgeFade?: number \| undefined; intensity?: number \| undefined; runtime?: AuraRuntimeNodeSpec \| und… |
+| `lights.ambient(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; intensity?: number \| undefined; color?: string \| undefined |
+| `lights.hemisphere(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; skyColor?: string \| undefined; groundColor?: string \| undefined; intensity?: number \| undefined; position?: AuraVec3 \| undefined |
+| `lights.lightProbe(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; sh?: readonly number[] \| undef…; skyColor?: string \| undefined; groundColor?: string \| undefined; intensity?: number \| undefined; position?: AuraVec3 \| undefined |
+| `lights.directional(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; position?: AuraVec3 \| undefined; target?: AuraVec3 \| undefined; intensity?: number \| undefined; color?: string \| undefined; shadow?: boolean \| AuraDirectional… |
+| `lights.point(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; position?: AuraVec3 \| undefined; target?: AuraVec3 \| undefined; intensity?: number \| undefined; power?: number \| undefined; distance?: number \| undefined; decay?: number \| undefined; color?: string \| undefined; shadow?: boolean \| AuraLocalShadow…; photometricProfile?: AuraPhotometricProfile \| … |
+| `lights.spot(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; position?: AuraVec3 \| undefined; target?: AuraVec3 \| undefined; angle?: number \| undefined; penumbra?: number \| undefined; distance?: number \| undefined; decay?: number \| undefined; intensity?: number \| undefined; power?: number \| undefined; color?: string \| undefined; shadow?: boolean \| AuraLocalShadow…; photometricProfile?: AuraPhotometricProfile \| …; projectedImage?: AuraProjectedLightImage \|… |
+| `lights.studio(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: intensity?: number \| undefined |
+| `lights.rect(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | options: name?: string \| undefined; position?: AuraVec3 \| undefined; target?: AuraVec3 \| undefined; intensity?: number \| undefined; color?: string \| undefined; width?: number \| undefined; height?: number \| undefined; twoSided?: boolean \| undefined |
+| `lights.rectArea(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | same as `lights.rect` |
+| `lights.softbox(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | same as `lights.rect` |
+| `lights.productStudio(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | same as `lights.studio` |
+| `lights.materialLab(options?: {…})` | `AuraNodeBuilder<AuraLightNode>` | same as `lights.studio` |
+
+## `environments`
+
+Image-based light. Without one, authored lights render flat and metals render dark.
+
+```ts
+void environments.neutral({ intensity: 0.8, background: false });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `environments.outdoor(options?: {…})` | `WorldEnvBuilderOut` | options: texture?: AuraAssetRef<"texture", s…; name?: string \| undefined; intensity?: number \| undefined; color?: string \| undefined; reflectionTexture?: AuraAssetRef<"texture", s…; rotation?: number \| undefined; biome?: OutdoorBiome \| undefined |
+| `environments.room(options?: {…})` | `WorldEnvBuilderOut` | options: texture?: AuraAssetRef<"texture", s…; name?: string \| undefined; intensity?: number \| undefined; color?: string \| undefined; reflectionTexture?: AuraAssetRef<"texture", s…; rotation?: number \| undefined; colorTemperatureK?: number \| undefined |
+| `environments.space(options?: Partial<Omit<AuraEnvironmentNode, "environment" \| "kind">>)` | `WorldEnvBuilderOut` | options: texture?: AuraAssetRef<"texture", s…; name?: string \| undefined; intensity?: number \| undefined; color?: string \| undefined; reflectionTexture?: AuraAssetRef<"texture", s…; rotation?: number \| undefined |
+| `environments.underwater(options?: Partial<Omit<AuraEnvironmentNode, "environment" \| "kind">>)` | `WorldEnvBuilderOut` | same as `environments.space` |
+| `environments.preset(name: AuraEnvironmentPresetName, options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | options: name?: string \| undefined; intensity?: number \| undefined; diffuseIntensity?: number \| undefined; specularIntensity?: number \| undefined; rotation?: number \| undefined; background?: boolean \| AuraEnvironment…; color?: string \| undefined |
+| `environments.neutral(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.none(options?: {…})` | `AuraNodeBuilder<AuraEnvironmentNode>` | options: name?: string \| undefined |
+| `environments.capture(options?: {…})` | `AuraNodeBuilder<AuraEnvironmentNode>` | options: name?: string \| undefined; intensity?: number \| undefined; diffuseIntensity?: number \| undefined; specularIntensity?: number \| undefined; rotation?: number \| undefined; background?: boolean \| AuraEnvironment…; color?: string \| undefined; position?: AuraVec3 \| undefined; resolution?: 64 \| 128 \| 256 \| undefined; update?: "once" \| "on-demand" \| { …; include?: "all" \| "sky-only" \| unde… |
+| `environments.hdri(options: {…})` | `AuraNodeBuilder<AuraEnvironmentNode>` | options: name?: string \| undefined; intensity?: number \| undefined; diffuseIntensity?: number \| undefined; specularIntensity?: number \| undefined; rotation?: number \| undefined; background?: boolean \| AuraEnvironment…; color?: string \| undefined; texture: AuraAssetRef<"texture">; reflectionTexture?: AuraAssetRef<"texture"> \|… |
+| `environments.studio(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.materialLab(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.productHero(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.nightCinematic(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.metalStudio(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.glassStudio(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
+| `environments.presets()` | `readonly AuraEnvironmentMapPreset[]` |  |
+| `environments.forMaterial(materialClass: "metal" \| "glass" \| "studio" \| "product")` | `AuraNodeBuilder<AuraEnvironmentNode>` |  |
+
+## `sky`
+
+Procedural sky; `app.atmosphere?.setSky({ sun })` moves the sun live.
+
+```ts
+void sky.preetham({ sun: { elevationDeg: 35, azimuthDeg: 120 } });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `sky.preetham(options: AuraSkyPreethamOptions)` | `AuraNodeBuilder<AuraSceneNode>` | options: moon?: unknown; groundColor?: string \| undefined; sun: AuraSkySunSpec; turbidity?: number \| undefined; rayleigh?: number \| undefined; mieCoefficient?: number \| undefined; mieDirectionalG?: number \| undefined; exposure?: number \| undefined; stars?: AuraSkyStarsOptions \| und…; clouds?: AuraSkyCloudsOptions \| un…; name?: string \| undefined; captureEnvironment?: boolean \| undefined; affectsFog?: boolean \| undefined |
+| `sky.gradient(options: AuraSkyGradientOptions)` | `AuraNodeBuilder<AuraSceneNode>` | options: moon?: unknown; intensity?: number \| undefined; clouds?: AuraSkyCloudsOptions \| un…; sun?: AuraSkySunSpec \| undefined; zenith: string; horizon: string; ground?: string \| undefined; exponent?: number \| undefined; horizonGlow?: number \| undefined; bands?: readonly AuraSkyBand[] \| …; stars?: AuraSkyStarsOptions \| und…; name?: string \| undefined; captureEnvironment?: boolean \| undefined; affectsFog?: boolean \| undefined |
+| `sky.hdri(options: {…})` | `AuraNodeBuilder<AuraSceneNode>` | options: texture: AuraAssetRef<"texture">; intensity?: number \| undefined; rotation?: number \| undefined; blurriness?: number \| undefined; name?: string \| undefined; captureEnvironment?: boolean \| undefined; affectsFog?: boolean \| undefined |
+| `sky.dayNight(options?: {…})` | `{ readonly nodes: readonly AuraSceneNode[]; readonly background: stri…` | options: hour?: number \| undefined; seed?: number \| undefined; starCount?: number \| undefined; cloudCellCount?: number \| undefined; starLimit?: number \| undefined; cloudLimit?: number \| undefined; model?: "preetham" \| "gradient" \|… |
+
+## `primitives`
+
+Unit shapes scaled by `size` (sphere = diameter, plane = `[w, 1, d]`).
+
+```ts
+void primitives.cylinder({ name: "plinth", size: [2, 0.9, 2], material: material.pbr({ color: "#f7f8fa" }) });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `primitives.box(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | options: name?: string \| undefined; material?: AuraMaterialSpec \| undefi…; size?: number \| AuraVec3 \| undef…; castShadow?: boolean \| undefined; receiveShadow?: boolean \| undefined; physics?: AuraNodePhysicsSpec \| und…; instances?: readonly AuraTransformSpe…; instanceColors?: readonly string[] \| undef…; geometry?: AuraCustomGeometrySpec \| …; text3D?: Omit<AuraText3DGeometry, …; lod?: AuraRootLodSpec \| undefin…; params?: AuraPrimitiveParams \| und…; position?: AuraVec3 \| undefined; pivot?: AuraVec3 \| undefined; rotation?: Aur… |
+| `primitives.sphere(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.plane(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.cylinder(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.capsule(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.torus(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.cone(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.circle(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.ring(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.tube(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.lathe(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.extrude(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.shape(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.torusKnot(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.polyhedron(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+| `primitives.roundedBox(options: AuraPrimitiveOptions \| undefined)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `primitives.box` |
+
+## `effects`
+
+Post effects, fog and particle emitters as scene nodes.
+
+```ts
+void effects.bloom({ intensity: 0.7, threshold: 0.75, radius: 0.55 });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `effects.contactShadows(options?: AuraContactShadowOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: length?: number \| undefined; thickness?: number \| undefined; steps?: 8 \| 12 \| 16 \| undefined; intensity?: number \| undefined; lights?: "sun" \| "shadowed" \| unde… |
+| `effects.toon(options?: AuraToonOptions)` | `AuraCustomPostPass` | options: name?: string \| undefined; bands?: number \| undefined; bandMix?: number \| undefined; outline?: number \| undefined; ink?: readonly [number, number,…; edgeStart?: number \| undefined; edgeEnd?: number \| undefined; size?: readonly [number, number]…; order?: AuraPostPassOrder \| undef…; inkSource?: AuraToonInkSource \| undef…; fadeDistance?: number \| undefined; inkColor?: string \| undefined |
+| `effects.pixelation(options?: AuraPixelationOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: size?: number \| undefined; name?: string \| undefined |
+| `effects.halftone(options?: AuraScreenPatternOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: angle?: number \| undefined; strength?: number \| undefined; size?: number \| undefined; name?: string \| undefined |
+| `effects.dotScreen(options?: AuraScreenPatternOptions)` | `AuraNodeBuilder<AuraEffectNode>` | same as `effects.halftone` |
+| `effects.glitch(options?: AuraGlitchOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: intensity?: number \| undefined; seed?: number \| undefined; name?: string \| undefined |
+| `effects.transition(options: AuraTransitionOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: texture: AuraTextureRef; progress?: number \| undefined; name?: string \| undefined |
+| `effects.lensDirt(options: AuraLensDirtOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: texture: AuraTextureRef; intensity?: number \| undefined; name?: string \| undefined |
+| `effects.mask(options: AuraPostMaskOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: texture: AuraTextureRef; invert?: boolean \| undefined; opacity?: number \| undefined; name?: string \| undefined |
+| `effects.clearMask(options?: AuraNativePostBaseOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: name?: string \| undefined |
+| `effects.afterimage(options?: AuraAfterimageOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: decay?: number \| undefined; name?: string \| undefined |
+| `effects.bloom(options?: BloomBuilderOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.neonBloom(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.ambientOcclusion(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.contactOcclusion(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.colorGrade(options?: AuraColorGradeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.antiAlias(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.vignette(options?: PostV3EffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.filmGrain(options?: PostV3EffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.chromaticAberration(options?: PostV3EffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.shaderPass(options: AuraShaderPassOptions)` | `AuraCustomPostPass` | options: name?: string \| undefined; glsl?: string \| undefined; wgsl?: string \| undefined; fragment?: { readonly glsl?: string;…; uniforms?: Readonly<Record<string, n…; inputs?: readonly ("normal" \| "col…; insertAt?: PostInsertAt \| undefined; order?: AuraPostPassOrder \| undef…; enabled?: boolean \| undefined |
+| `effects.fog(options?: FogNodeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.cinematicBloom(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.volumetricFog(options?: AuraVolumetricFogOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.depthFog(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.outline(options?: AuraOutlineOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.screenSpaceReflections(options?: AuraScreenSpaceReflectionsOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.depthOfField(options?: AuraDepthOfFieldOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.motionBlur(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.rain(options?: AuraWeatherEffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.snow(options?: AuraWeatherEffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.flipbook(options?: {…})` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.beam(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.particles(options?: {…})` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.trail(options?: VfxNodeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.lightCone(options?: VfxNodeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.auroraRibbon(options?: VfxNodeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.meshParticles(options?: VfxNodeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+| `effects.fogVolume(options?: AuraFogVolumeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
+
+## `instances`
+
+One draw call per node. Instance colour multiplies the material colour.
+
+```ts
+void instances.cone({ name: "pines", transforms: [{ position: [0, 1, 0], scale: [2, 3, 2] }], colors: ["#2f6b34"], material: material.pbr({ color: "#ffffff" }) });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `instances.box(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | options: name?: string \| undefined; material?: AuraMaterialSpec \| undefi…; size?: number \| AuraVec3 \| undef…; castShadow?: boolean \| undefined; receiveShadow?: boolean \| undefined; physics?: AuraNodePhysicsSpec \| und…; instances?: readonly AuraTransformSpe…; instanceColors?: readonly string[] \| undef…; geometry?: AuraCustomGeometrySpec \| …; text3D?: Omit<AuraText3DGeometry, …; lod?: AuraRootLodSpec \| undefin…; params?: AuraPrimitiveParams \| und…; position?: AuraVec3 \| undefined; pivot?: AuraVec3 \| undefined; rotation?: Aur… |
+| `instances.sphere(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.plane(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.cylinder(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.capsule(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.torus(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.cone(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.circle(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.ring(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.tube(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.lathe(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.extrude(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.shape(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.torusKnot(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.polyhedron(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.roundedBox(options: AuraInstancedPrimitiveOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | same as `instances.box` |
+| `instances.mesh(geometry: AuraBatchedGeometryInput, material: AuraMaterialSpec \| undefined, count: number)` | `AuraInstancedMeshHandle` |  |
+| `instances.custom(spec: AuraCustomGeometrySpec, options: Omit<AuraInstancedPrimitiveOptions, "geometry">)` | `AuraNodeBuilder<AuraPrimitiveNode>` | spec: kind: "aura-custom-geometry"; positions: AuraVec3Attribute; normals?: AuraVec3Attribute \| undef…; uvs?: AuraVec2Attribute \| undef…; uv1s?: AuraVec2Attribute \| undef…; colors?: readonly string[] \| reado…; indices: AuraIndexAttribute; attributes?: Readonly<Record<string, A…; bounds?: { readonly min: AuraRootV…; groups?: readonly AuraGeometryGrou…; drawRange?: AuraGeometryDrawRangeSpec…; morphTargets?: readonly AuraGeometryMorp…; topology?: "triangles" \| "lines" \| "…; dynamic?: boolean \| undefined |
+| `instances.model(asset: TAsset, options: {…})` (+1 overloads) | `AuraNodeBuilder<AuraGroupNode>` | options: name?: string \| undefined; material?: AuraMaterialSpec \| undefi…; castShadow?: boolean \| undefined; receiveShadow?: boolean \| undefined; visible?: boolean \| undefined; role?: AuraModelRole \| undefined; scaleMode?: AuraModelScaleMode \| unde…; targetHeight?: number \| undefined; targetMaxDimension?: number \| undefined; targetLength?: number \| undefined; physics?: AuraNodePhysicsSpec \| und…; hiddenNodeNames?: readonly string[] \| undef…; materialOverrides?: readonly AuraModelMateria…; variant?: string \| undefined; lod?… |
+
+## `geometry`
+
+`define` builds the spec; mount it with `geometry.custom(spec, { material })`.
+
+```ts
+void geometry.define({ positions: new Float32Array(9), indices: [0, 1, 2], bounds: { min: [0, 0, 0], max: [1, 1, 1] } });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `geometry.define(spec: Omit<AuraCustomGeometrySpec, "kind">)` | `AuraCustomGeometrySpec` | spec: colors?: readonly string[] \| reado…; positions: AuraVec3Attribute; normals?: AuraVec3Attribute \| undef…; uvs?: AuraVec2Attribute \| undef…; uv1s?: AuraVec2Attribute \| undef…; indices: AuraIndexAttribute; attributes?: Readonly<Record<string, A…; bounds?: { readonly min: AuraRootV…; groups?: readonly AuraGeometryGrou…; drawRange?: AuraGeometryDrawRangeSpec…; morphTargets?: readonly AuraGeometryMorp…; topology?: "triangles" \| "lines" \| "…; dynamic?: boolean \| undefined |
+| `geometry.custom(spec: AuraCustomGeometrySpec, options?: Omit<AuraPrimitiveOptions, "geometry">)` | `AuraNodeBuilder<AuraPrimitiveNode>` | spec: kind: "aura-custom-geometry"; positions: AuraVec3Attribute; normals?: AuraVec3Attribute \| undef…; uvs?: AuraVec2Attribute \| undef…; uv1s?: AuraVec2Attribute \| undef…; colors?: readonly string[] \| reado…; indices: AuraIndexAttribute; attributes?: Readonly<Record<string, A…; bounds?: { readonly min: AuraRootV…; groups?: readonly AuraGeometryGrou…; drawRange?: AuraGeometryDrawRangeSpec…; morphTargets?: readonly AuraGeometryMorp…; topology?: "triangles" \| "lines" \| "…; dynamic?: boolean \| undefined |
+| `geometry.dynamic(spec: {…})` | `AuraCustomGeometrySpec` | spec: positions: AuraVec3Attribute; normals?: AuraVec3Attribute \| undef…; uvs?: AuraVec2Attribute \| undef…; uv1s?: AuraVec2Attribute \| undef…; colors?: readonly string[] \| reado…; indices?: AuraIndexAttribute \| unde…; attributes?: Readonly<Record<string, A…; topology?: "triangles" \| "points" \| …; groups?: readonly AuraGeometryGrou…; drawRange?: AuraGeometryDrawRangeSpec…; morphTargets?: readonly AuraGeometryMorp…; bounds?: { readonly min: AuraRootV… |
+| `geometry.computeBounds(spec: {…})` | `{ readonly min: AuraRootVec3; readonly max: AuraRootVec3; }` | spec: positions: AuraVec3Attribute |
+| `geometry.computeNormals(spec: {…})` | `Float32Array<ArrayBufferLike>` | spec: positions: AuraVec3Attribute; indices?: AuraIndexAttribute \| unde…; topology?: "triangles" \| "lines" \| "… |
+| `geometry.applyMatrix4(spec: AuraCustomGeometrySpec, matrix: readonly number[])` | `AuraCustomGeometrySpec` | same as `geometry.custom` |
+| `geometry.buildUVAtlas(input: UVAtlasGeometry, options: UVAtlasOptions)` | `UVAtlasResult` | input: kind: "aura-custom-geometry"; positions: AuraVec3Attribute; normals?: AuraVec3Attribute \| undef…; uvs?: AuraVec2Attribute \| undef…; uv1s?: AuraVec2Attribute \| undef…; colors?: readonly string[] \| reado…; indices: AuraIndexAttribute; attributes?: Readonly<Record<string, A…; bounds?: { readonly min: AuraRootV…; groups?: readonly AuraGeometryGrou…; drawRange?: AuraGeometryDrawRangeSpec…; morphTargets?: readonly AuraGeometryMorp…; topology?: "triangles" \| "lines" \| "…; dynamic?: boolean \| undefined |
+| `geometry.edges(source: AuraCustomGeometrySpec, thresholdAngle?: number)` | `AuraCustomGeometrySpec` | source: kind: "aura-custom-geometry"; positions: AuraVec3Attribute; normals?: AuraVec3Attribute \| undef…; uvs?: AuraVec2Attribute \| undef…; uv1s?: AuraVec2Attribute \| undef…; colors?: readonly string[] \| reado…; indices: AuraIndexAttribute; attributes?: Readonly<Record<string, A…; bounds?: { readonly min: AuraRootV…; groups?: readonly AuraGeometryGrou…; drawRange?: AuraGeometryDrawRangeSpec…; morphTargets?: readonly AuraGeometryMorp…; topology?: "triangles" \| "lines" \| "…; dynamic?: boolean \| undefined |
+| `geometry.wireframe(source: AuraCustomGeometrySpec)` | `AuraCustomGeometrySpec` | same as `geometry.edges` |
+| `geometry.convex(points: readonly ConvexPointInput[])` | `AuraCustomGeometrySpec` |  |
+| `geometry.toNonIndexed(source: AuraCustomGeometrySpec)` | `AuraCustomGeometrySpec` | same as `geometry.edges` |
+| `geometry.merge(specs: readonly AuraCustomGeometrySpec[])` | `AuraCustomGeometrySpec` |  |
+| `geometry.splitGroups(source: AuraCustomGeometrySpec)` | `readonly { readonly materialIndex: number; readonly geometry: AuraCus…` | same as `geometry.edges` |
+| `geometry.multiMaterial(source: AuraCustomGeometrySpec, materials: readonly AuraMaterialSpec[], options?: {…})` | `AuraNodeBuilder<AuraGroupNode>` | same as `geometry.edges` |
+
+## `interactions`
+
+`target` is a node name.
+
+```ts
+void interactions.orbit({ target: "crate" });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `interactions.orbit(options: AuraOrbitOptions \| undefined)` (+1 overloads) | `InteractionBuilder` | options: target?: AuraOrbitTarget \| undefin…; position?: AuraVec3 \| undefined; autoRotate?: number \| boolean \| undefi… |
+| `interactions.pointer(options?: {…})` | `InteractionBuilder` | options: target?: string \| undefined |
+| `interactions.keyboard(options?: {…})` | `InteractionBuilder` | same as `interactions.pointer` |
+| `interactions.hover(options?: {…})` | `InteractionBuilder` | options: target?: string \| undefined; selected?: string \| undefined |
+| `interactions.raycastHover(options?: {…})` | `InteractionBuilder` | same as `interactions.hover` |
+| `interactions.highlight(options?: {…})` | `InteractionBuilder` | same as `interactions.hover` |
+| `interactions.dragVector(options?: {…})` | `InteractionBuilder` | options: target?: string \| undefined; vector?: AuraVec3 \| undefined |
+| `interactions.clickImpulse(options?: {…})` | `InteractionBuilder` | options: target?: string \| undefined; impulse?: number \| undefined; vector?: AuraVec3 \| undefined |
+
+## `physics`
+
+Rapier-backed worlds, bodies and colliders; see `docs/api/` physics pages before use.
+
+```ts
+void physics.box;
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `physics.world(descriptor?: PhysicsWorldDescriptor)` | `AuraPhysicsWorldController` | descriptor: backend?: PhysicsBackendPreference …; gravity?: Vec3 \| undefined; fixedDelta?: number \| undefined; solverIterations?: number \| undefined; enableSleeping?: boolean \| undefined; seed?: number \| undefined; sleepVelocityThreshold?: number \| undefined; sleepDelay?: number \| undefined; continuousCollision?: PhysicsContinuousCollisio… |
+| `physics.worldFromScene(sceneValue: AuraSceneBuilder \| AuraSceneSnapshot, descriptor?: PhysicsWorldDescriptor)` | `AuraPhysicsWorldController` | same as `physics.world` |
+| `physics.body(options?: AuraPhysicsBodyOptions)` | `AuraPhysicsBodyOptions` | options: type?: RigidBodyType \| undefined; position?: Vec3 \| undefined; rotation?: Quat \| undefined; velocity?: Vec3 \| undefined; angularVelocity?: Vec3 \| undefined; mass?: number \| undefined; inertia?: Vec3 \| undefined; linearDamping?: number \| undefined; angularDamping?: number \| undefined; restitution?: number \| undefined; friction?: number \| undefined; sleeping?: boolean \| undefined; shape?: PhysicsShape \| undefined; sensor?: boolean \| undefined; material?: Partial<ColliderMaterial>…; filter?: Partial<CollisionFilter> … |
+| `physics.collider(descriptor: ColliderDescriptor)` | `ColliderDescriptor` | descriptor: shape: PhysicsShape; sensor?: boolean \| undefined; filter?: Partial<CollisionFilter> …; material?: Partial<ColliderMaterial>… |
+| `physics.box(x?: number, y?: number, z?: number)` | `PhysicsShape` |  |
+| `physics.sphere(radius?: number)` | `PhysicsShape` |  |
+| `physics.capsule(radius?: number, halfHeight?: number)` | `PhysicsShape` |  |
+| `physics.plane(normal?: AuraVec3, constant?: number)` | `PhysicsShape` |  |
+| `physics.constraint(descriptor: ConstraintDescriptor)` | `ConstraintDescriptor` | descriptor: type: ConstraintType; bodyA: RigidBody; bodyB: RigidBody; localAnchorA?: Vec3 \| undefined; localAnchorB?: Vec3 \| undefined; restLength?: number \| undefined; stiffness?: number \| undefined; axis?: Vec3 \| undefined; damping?: number \| undefined; motorSpeed?: number \| undefined; maxMotorTorque?: number \| undefined; limits?: readonly [number, number]… |
+| `physics.step(world: AuraPhysicsWorldController, options: number \| AuraPhysicsStepOptions \| undefined)` | `readonly CollisionEvent[]` |  |
+| `physics.raycast(world: AuraPhysicsWorldController, origin: AuraVec3, direction: AuraVec3, options: RaycastOptions \| undefined)` | `RaycastHit \| undefined` | options: maxDistance?: number \| undefined; mask?: number \| undefined; includeSensors?: boolean \| undefined; includeBackfaces?: boolean \| undefined; ignoreColliders?: readonly number[] \| undef…; ignoreBodies?: readonly number[] \| undef… |
+
+## `AnimationController`
+
+Clip playback and crossfades for rigged GLBs. Procedural joints are runtime handles instead (recipe 8).
+
+```ts
+void AnimationController;
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `AnimationController#on(type: K, listener: Listener<AuraAnimationControllerEventMap<TClipId, TEvent>[K]>)` | `AnimationClipEventUnsubscribe` |  |
+| `AnimationController#once(type: K, listener: Listener<AuraAnimationControllerEventMap<TClipId, TEvent>[K]>)` | `AnimationClipEventUnsubscribe` |  |
+| `AnimationController#registerClip(definition: AuraNamedAnimationClipDefinition<TClipId, TEvent>)` | `AuraRegisteredAnimationClip<TClipId, TEvent>` | definition: layer?: string \| undefined; tracks?: readonly AnimationClipTra…; layerMetadata?: AuraAnimationLayerMetadat…; requiredBones?: readonly string[] \| undef…; bones?: readonly string[] \| undef…; rootMotion?: AuraAnimationRootMotionMe…; suppressRootMotion?: boolean \| undefined; restartFromFrameZero?: boolean \| undefined; attack?: boolean \| undefined; eventSource?: string \| undefined; retarget?: AuraAnimationRetargetBind…; externalHumanoidLibrary?: AuraExternalHumanoidAnima…; pose?: AnimationPose \| undefined; fallbackPose… |
+| `AnimationController#play(clipId: TClipId, options?: AuraAnimationPlayOptions<TClipId>)` | `AuraAnimationClipPlaybackState<TClipId>` | options: id?: string \| undefined; restart?: boolean \| undefined; exclusive?: boolean \| undefined; loop?: boolean \| AnimationLoopMo…; speed?: number \| undefined; weight?: number \| undefined; layer?: string \| undefined; startTime?: number \| undefined; fadeIn?: number \| undefined; paused?: boolean \| undefined; direction?: AnimationPlaybackDirectio…; metadata?: Record<string, unknown> \|…; fallbackClipId?: TClipId \| undefined; suppressRootMotion?: boolean \| undefined; restartFromFrameZero?: boolean \| undefined; attack?: boolean… |
+| `AnimationController#pause(clipId: TClipId \| undefined)` | `void` |  |
+| `AnimationController#resume(clipId: TClipId \| undefined)` | `void` |  |
+| `AnimationController#restart(clipId: TClipId \| undefined, options?: AuraAnimationPlayOptions<TClipId>)` | `AuraAnimationClipPlaybackState<TClipId>` | same as `AnimationController#play` |
+| `AnimationController#stop(clipId: TClipId \| undefined, options?: AuraAnimationStopOptions)` | `void` | options: fadeOut?: number \| undefined |
+| `AnimationController#crossFade(toClipId: TClipId, duration: number, options?: AuraAnimationCrossFadeOptions<TClipId>)` | `AuraAnimationClipPlaybackState<TClipId>` | options: fromClipId?: TClipId \| undefined; fromLayer?: string \| undefined; id?: string \| undefined; restart?: boolean \| undefined; exclusive?: boolean \| undefined; loop?: boolean \| AnimationLoopMo…; speed?: number \| undefined; weight?: number \| undefined; layer?: string \| undefined; startTime?: number \| undefined; fadeIn?: number \| undefined; paused?: boolean \| undefined; direction?: AnimationPlaybackDirectio…; metadata?: Record<string, unknown> \|…; fallbackClipId?: TClipId \| undefined; suppressRootMotion?: boolean \| undef… |
+| `AnimationController#setLayerWeight(layer: string, weight: number)` | `AnimationController<TClipId, TEvent>` |  |
+| `AnimationController#update(dt: number)` | `AuraAnimationControllerSnapshot<TClipId>` |  |
+| `AnimationController#scrub(time: number, options: AuraAnimationScrubOptions<TClipId> \| undefined)` (+1 overloads) | `AuraAnimationPoseSnapshot<TClipId>` | options: clipId?: TClipId \| undefined; emitEvents?: boolean \| undefined; play?: boolean \| undefined; createIfMissing?: boolean \| undefined; layer?: string \| undefined; suppressRootMotion?: boolean \| undefined |
+| `AnimationController#state(clipId: TClipId \| undefined)` | `AuraAnimationClipPlaybackState<TClipId> \| undefined` |  |
+| `AnimationController#listClips()` | `readonly AuraRegisteredAnimationClip<TClipId, TEvent>[]` |  |
+| `AnimationController#dispose()` | `void` |  |
+
+## `createFixedStepLoop`
+
+Deterministic simulation loop for games.
+
+```ts
+void createFixedStepLoop({ stepSeconds: 1 / 60, step: () => undefined, render: () => undefined });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `createFixedStepLoop(options: FixedStepLoopOptions)` | `FixedStepLoop` | options: step: (stepSeconds: number, ste…; render?: ((frameSeconds: number) =…; stepSeconds?: number \| undefined; maxCatchUpSteps?: number \| undefined; maxFrameSeconds?: number \| undefined; minFrameSeconds?: number \| undefined; manual?: boolean \| undefined; isActive?: (() => boolean) \| undefin…; now?: (() => number) \| undefined; schedule?: ((callback: (nowMs: numbe…; cancel?: ((handle: unknown) => voi… |
+