@aura3d/engine 1.5.2 → 2.0.1

package/dist/engine/agent-api/index.d.ts

@@ -1,6 +1,20 @@
-import { type Collider, type ColliderDescriptor, type CollisionEvent, type Constraint, type ConstraintDescriptor, type Contact, type DebugLine, type PhysicsBackendSelection, type PhysicsShape, type PhysicsSnapshot, type PhysicsWorldDescriptor, type RaycastHit, type RaycastOptions, type RigidBody, type RigidBodyDescriptor, type RigidBodyType, type ScenePhysicsNode, type SphereCastHit } from "@aura3d/physics";
+import type { Collider, ColliderDescriptor, CollisionEvent, Constraint, ConstraintDescriptor, Contact, DebugLine, PhysicsBackendSelection, PhysicsShape, PhysicsSnapshot, PhysicsWorldDescriptor, RaycastHit, RaycastOptions, RigidBody, RigidBodyDescriptor, RigidBodyType, ScenePhysicsNode, SphereCastHit } from "../../physics/index.js";
 import { type ProjectedLabel } from "./WorldLabelRenderer.js";
+import { defineAuraCustomGeometry, type AuraCustomGeometrySpec, type AuraText3DGeometry, type AuraText3DOptions } from "./RootGeometry.js";
+export * from "./RootGeometry.js";
 export * from "./SpatialAnchoring.js";
+export * from "./PhysicsRuntime.js";
+/**
+ * WS-2.4: mesh surface queries on the public surface.
+ *
+ * Re-exported from `@aura3d/physics` so grounding anything to a mesh is a one-liner for any
+ * genre, from `@aura3d/engine` alone. Without this a route wanting real per-point ground
+ * height had to either deep-import `@aura3d/physics/src` (banned by the lint rule) or
+ * hand-roll an analytic approximation — which is exactly what every racing route did, and
+ * why wheels sank through visible road.
+ */
+export { buildMeshBVH, createMeshSurfaceQuery, raycastMesh, type MeshBVH, type MeshRayHit, type MeshSurfaceQuery, type MeshSurfaceQueryOptions, type SurfaceSample } from "../../physics/solverless.js";
+import { type AuraCollisionLayers, type AuraPhysicsRuntime } from "./PhysicsRuntime.js";
 export * from "./FocusSelection.js";
 export * from "./WorldLabelRenderer.js";
 export * from "./VehicleChassis.js";
@@ -13,16 +27,12 @@ export * from "./FrameEncoder.js";
 export * from "./BrowserFrameCaptureAdapter.js";
 export * from "./MediaRecorderFrameEncoder.js";
 export * from "./WebCodecsFrameEncoder.js";
-export * from "./FfmpegFrameEncoder.js";
-export * from "./PngSequenceEncoder.js";
-export * from "./AudioMuxer.js";
 export { GameInspector, createGameInspector } from "./GameInspector.js";
 export type { GameInspectorRuntimeInput, GameInspectorSnapshot } from "./GameInspector.js";
-import { createGameInspector } from "./GameInspector";
+import { createGameInspector } from "./GameInspector.js";
 export { createGameAudio } from "../game/GameAudio.js";
 export type { GameAudio, GameAudioBusDefinition, GameAudioBusId, GameAudioContextLike, GameAudioCueDefinition, GameAudioCueEvent, GameAudioEvidence, GameAudioOptions } from "../game/GameAudio.js";
 export * from "./RenderProgressTracker.js";
-export * from "./VideoExportPipeline.js";
 export * from "./AudioVisemeAnalyzer.js";
 export * from "./ExternalPhonemeAnalyzer.js";
 export * from "./WaveformVisualizer.js";
@@ -34,12 +44,7 @@ export * from "./CameraPresetLibrary.js";
 export * from "./ShotCompositionRules.js";
 export * from "./CameraChoreographer.js";
 export * from "./CameraPathEditor.js";
-export * from "./CaptionExporter.js";
 export * from "./ThumbnailGenerator.js";
-export * from "./YouTubeMetadataGenerator.js";
-export * from "./YouTubeUploadAdapter.js";
-export * from "./PublishingPipeline.js";
-export * from "./CloudRenderAdapter.js";
 export * from "./BatchEpisodeRenderer.js";
 export * from "./AnimationAssetManifest.js";
 export * from "./SceneGroundingUtils.js";
@@ -57,49 +62,49 @@ export * from "./EpisodeTemplates.js";
 export * from "./AnimationMotionQuality.js";
 export * from "./AnimationRouteProof.js";
 export * from "./AnimationEpisodePackage.js";
-import type { GLTFSceneAnimationRuntime, GLTFSceneAnimationRuntimeOptions } from "@aura3d/assets/browser";
-import type { AnimationPose } from "@aura3d/animation";
-import type { GameHudBindingKind, GameRuntimeSubsystemOwnership } from "./GameRuntime";
-import { createFrameLoop } from "./FrameLoop";
-import { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameEventLog, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudCheckpointBinding, createGameHudDebugToggleBinding, createGameHudEventLogBinding, createGameHudHealthBinding, createGameHudLivesBinding, createGameHudMeterBinding, createGameHudObjectiveBinding, createGameHudRoundBinding, createGameHudScoreBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameHudValueBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, createGameCollisionWorld, createGameDebugOverlayData, createGameDebugSceneNodes, createGameHitboxDebugGeometry, createGameSimulation, exportGameInputReplay, createGameFighting2DRules, createGameInput, createGameInputReplay, createGameInputReplayDriver, importGameInputReplay, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameInputReplayEventsAt, runGameSimulation, type GameInputOptions } from "./GameRuntime";
-import { collectGameRuntimeEvidence as collectGameRuntimeEvidenceV105, type GameRuntimeEvidence, type GameRuntimeEvidenceOptions, type GameRuntimeSourceEvidence } from "./GameEvidence";
-import { type AuraRuntimeNodeAnimationPoseBindingMetadata, type AuraRuntimeNodeAnimationBindingMetadata, type AuraRuntimeNodeBounds, type AuraRuntimeNodeEffectAttachment, type RuntimeNodeBoundsInput, type RuntimeNodeMorphTargetWeights } from "./RuntimeNodeHandle";
-import { createRuntimeNodeSpec } from "./GameSceneBridge";
-import { createFightingGameKit } from "./game-kits/fighting";
-import { createGameAssetBoundPlatformerLevel, createGameAssetBoundRacingRoute, createGameFallingBlocksKit, createGameLocomotionKit, createGamePlatformerKit, createGamePlatformerSurfaceQuery, createGameRacingKit, createGameRacingSurfaceQuery, type GameAssetBoundPlatformerLevel, type GameAssetBoundRacingRoute, type GameKitRect, type GameKitVec2, type GamePlatformerCheckpoint } from "./GameGenreKits";
-import { createGamePlatformerSceneBinding, createGamePlatformerPresentationCamera, createGameRacingPresentationCamera, createGameRacingSceneBinding, type GamePlatformerPresentationCameraOptions, type GamePlatformerSceneBinding, type GameRacingCameraRigOptions, type GameScenePresentationCameraSpec, type GameRacingSceneBinding } from "./GameSceneGeometryBindings";
-import { certifyPublicPlatformerGeometry, certifyPublicRacingGeometry, type PublicGameGeometryCertification, type PublicPlatformerGeometryContract, type PublicRacingGeometryContract } from "./PublicGameGeometry";
-export { GAME_FALLING_BLOCK_PIECES, createGameAssetBoundPlatformerLevel, createGameAssetBoundRacingRoute, createGameFallingBlocksKit, createGameLocomotionKit, createGamePlatformerKit, createGamePlatformerSurfaceQuery, createGameRacingKit, createGameRacingSurfaceQuery } from "./GameGenreKits";
-export { createGamePlatformerSceneBinding, createGamePlatformerPresentationCamera, createGameRacingPresentationCamera, createGameRacingSceneBinding } from "./GameSceneGeometryBindings";
-export { certifyPublicPlatformerGeometry, certifyPublicRacingGeometry } from "./PublicGameGeometry";
-export type { GameAssetBoundPlatformerLevel, GameAssetBoundPlatformerLevelBinding, GameAssetBoundPlatformerLevelOptions, GameAssetBoundRacingRoute, GameAssetBoundRacingRouteBinding, GameAssetBoundRacingRouteOptions, GameFallingBlockAction, GameFallingBlockActivePiece, GameFallingBlockBoard, GameFallingBlockCell, GameFallingBlockPiece, GameFallingBlockRotation, GameFallingBlocksEvent, GameFallingBlocksKit, GameFallingBlocksOptions, GameFallingBlocksSnapshot, GameKitRect, GameKitVec2, GameLocomotionClipMap, GameLocomotionEventInput, GameLocomotionInput, GameLocomotionKit, GameLocomotionOptions, GameLocomotionSnapshot, GameLocomotionState, GamePlatformerCheckpoint, GamePlatformerCollectible, GamePlatformerEvent, GamePlatformerEventType, GamePlatformerHazard, GamePlatformerInput, GamePlatformerKit, GamePlatformerLevel, GamePlatformerGroundContact, GamePlatformerSurfaceQuery, GamePlatformerMovingPlatform, GamePlatformerPlayerState, GamePlatformerSnapshot, GamePlatformerWorldAssetBinding, GameRacingCameraSnapshot, GameRacingEvent, GameRacingEventType, GameRacingInput, GameRacingKit, GameRacingSpeedModel, GameRacingSurfaceContact, GameRacingSurfaceQuery, GameRacingOptions, GameRacingRoute, GameRacingSnapshot } from "./GameGenreKits";
-export type { PublicGameAssetCertification, PublicGameBounds2, PublicGameGeometryCategory, PublicGameGeometryCertification, PublicGameGeometrySource, PublicGameRetainedProof, PublicPlatformerCheckpoint, PublicPlatformerGeometryContract, PublicPlatformerHazard, PublicPlatformerSurface, PublicRacingGeometryCheckpoint, PublicRacingGeometryContract, PublicRacingGeometryPoint } from "./PublicGameGeometry";
-export type { GamePlatformerSceneBinding, GamePlatformerSceneBindingOptions, GamePlatformerPresentationCameraOptions, GameRacingSceneBinding, GameRacingSceneBindingOptions, GameRacingPresentationCameraOptions, GameRacingCameraRigOptions, GameRacingCameraSelectionEvidence, GameRacingSceneSpeedModel, GameRacingScenePose, GameScenePresentationCameraSpec, GameSceneTransform } from "./GameSceneGeometryBindings";
-import { createPromptAnimationEpisodePlan, createPromptAnimationStoryBible, definePromptAnimationStoryboard } from "./PromptAnimationContract";
-import { applyShotPlaybackFrame, createShotPlaybackPlan, createShotTimeline, installShotPlayback, sampleShotPlaybackPlan } from "./ShotTimeline";
-import { captionCueAtTime, createCaptionTimingProof, deriveCaptionTrackFromDialogue } from "./DialoguePerformance";
-import { createAuraVoiceVisemeTrack, createGlbBlendshapeVisemeCue, createPrimitiveMouthVisemeCues, sampleVisemeTrack } from "./VisemeController";
-import { createAuraVoiceBridgePackage, createAuraVoiceDubRerenderProof, createAuraVoiceRerenderPlan, sampleAuraVoiceBridgeAtTime } from "./AuraVoiceBridge";
-import { createAnimationDirectorPlan } from "./AnimationDirector";
-import { createAnimationPerformance } from "./AnimationPerformance";
-import { createAnimationRenderOutputPackageMetadata, createAnimationRenderQueue } from "./AnimationRenderQueue";
-import { collectPromptAnimationEvidence } from "./PromptAnimationEvidence";
-import { createAnimationMotionQualityReport, validateAnimationMotionQuality } from "./AnimationMotionQuality";
-import { createAnimationRouteProof, validateAnimationRouteProof } from "./AnimationRouteProof";
-import { createAnimationEpisodePackageManifest, validateAnimationEpisodePackage } from "./AnimationEpisodePackage";
-import { type GameAppRuntime, type GameAppRuntimeOptions } from "./GameAppRuntime";
-export { Engine } from "@aura3d/core";
-export { analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport } from "@aura3d/rendering";
-export type { AnimationFrameVisualInput, AnimationFrameVisualQuality, AnimationMaterialStyle, AnimationMaterialStyleOptions, AnimationRenderPresetEvidence, AnimationRenderPresetOptions, AnimationVisualQualityOptions, AnimationVisualQualityReport, FrameMotionRegion, FrameMotionRegionMetrics } from "@aura3d/rendering";
-export { asAuraAppHandle, isAuraAppHandle, type AuraAppFrame, type AuraAppFrameCallback, type AuraAppHandle, type AuraAppNodeRegistryLike, type AuraAppRuntimeState, type AuraAppScreenshot } from "./AuraAppHandle";
-export { createGameAppRuntime, type GameAppRuntime, type GameAppRuntimeEvidence, type GameAppRuntimeLoopOptions, type GameAppRuntimeOptions, type GameAppRuntimeResize, type GameAppRuntimeStatus } from "./GameAppRuntime";
-export { FrameLoop, createFrameLoop, type FrameLoopCallback, type FrameLoopFrame, type FrameLoopOptions, type FrameLoopSnapshot, type FrameLoopSource } from "./FrameLoop";
-export { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudDebugToggleBinding, createGameHudHealthBinding, createGameHudMeterBinding, createGameHudRoundBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, createGameDebugOverlayData, createGameDebugSceneNodes, createGameHitboxDebugGeometry, createGameSimulation, createGameInput, createGameInputReplay, createGameInputReplayDriver, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameColliders, gameInputReplayEventsAt, createGameLoopPlan, runGameSimulation, type GameAccessibilityFocusOptions, type GameAccessibilityLabelOptions, type GameAccessibilityPauseControlsOptions, type GameAccessibilityPreferenceOptions, type GameAccessibilityRuntimeSettings, type GameAccessibilityRuntimeSettingsOptions, type GameAccessibilitySource, type GameAccessibilitySourceKind, type GameAabb, type GameBounds3, type GameCameraDirector, type GameCameraDirectorOptions, type GameCameraSnapshot, type GameCameraTarget, type GameCollisionAddBodyOptions, type GameCollisionBodyHandle, type GameCollisionBodyOptions, type GameCollisionBodySnapshot, type GameCollisionBox, type GameCollisionContact, type GameCollisionEvent, type GameCollisionParticipant, type GameCollisionQueryFilter, type GameCollisionSweepHit, type GameCollisionSweepOptions, type GameCollisionWorld, type GameCollisionWorldSnapshot, type GameCombatActorOptions, type GameCombatActorSnapshot, type GameCombatActiveAttackSnapshot, type GameCombatEvent, type GameCombatEventRuntimeBridgeOptions, type GameCombatEventRuntimeBridgeResult, type GameCombatEventType, type GameCombatMove, type GameCombatWorld, type GameCombatWorldSnapshot, type GameBoxCollider, type GameBoxColliderOptions, type GameCapsuleCollider, type GameCapsuleColliderOptions, type GameCollider, type GameColliderAxis, type GameColliderBase, type GameColliderDimension, type GameColliderFactoryOptions, type GameColliderKind, type GameColliderPlane, type GameDebugGeometryNode, type GameDebugGeometryOptions, type GameDebugGeometryPrimitive, type GameDebugOverlayData, type GameDebugOverlayMetric, type GameDebugOverlayOptions, type GameDebugOverlaySection, type GameDebugSceneNode, type GameDebugSceneNodeOptions, type GameDebugScenePrimitive, type GameEffectInstance, type GameEffectAttachment, type GameEffectKind, type GameEffectOptions, type GameEffectsController, type GameEffectsSnapshot, type GameEventInput, type GameEventLog, type GameEventLogOptions, type GameEventLogSnapshot, type GameEventRecord, type GameEventSeverity, type GameHudActorBindingOptions, type GameHudBinding, type GameHudBindingKind, type GameHudComboBindingOptions, type GameHudDebugToggleBindingOptions, type GameHudEventLogBindingOptions, type GameHudObjectiveBindingOptions, type GameHudResolvedValue, type GameHudRoundBindingOptions, type GameHudScoreBindingOptions, type GameHudSourceKind, type GameHudSnapshot, type GameHudSnapshotItem, type GameHudSnapshotOptions, type GameHudTimerBindingOptions, type GameHudValueBindingOptions, type GameHudValueFormat, type GameInputActionState, type GameInputAxisSettings, type GameInputAxisBinding, type GameInputController, type GameInputOptions, type GameInputReplayDriver, type GameInputReplayDriverSnapshot, type GameInputReplayEvent, type GameInputReplayOptions, type GameInputReplayPlan, type GameInputSnapshot, type GameJumpAssistController, type GameJumpAssistOptions, type GameJumpAssistSnapshot, type GameJumpAssistUpdate, type GameKinematicBody, type GameKinematicBodyOptions, type GameKinematicBodySnapshot, type GameLoopPlan, type GamePointerSnapshot, type GameRectCollider, type GameRectColliderOptions, type GameRuntimeSubsystemId, type GameRuntimeSubsystemOwnership, type GameSimulation, type GameSimulationFrame, type GameSimulationOptions, type GameSimulationResult, type GameSimulationStepContext, type GameSimulationStepResult, type GameSphereCollider, type GameSphereColliderOptions, type GameSubsystemOwner, type GameTouchControlAnchor, type GameTouchControlKind, type GameTouchControlLayout, type GameTouchControlLayoutOptions, type GameTouchControlRegion, type GameTouchControlRequest, type GameVec3, type GamepadSnapshot } from "./GameRuntime";
-export { collectGameSceneRuntimeNodes, createGameSceneBridge, createRuntimeNodeSpec, type GameSceneBridge, type GameSceneBridgeApp, type GameSceneBridgeBodyLike, type GameSceneBridgeEvidence, type GameSceneBridgeNodeHandle, type GameSceneRuntimeNode } from "./GameSceneBridge";
-export { calculateRuntimeNodeBounds, createRuntimeNodeEffectAttachment, runtimeNodeHasTag, type AuraRuntimeNodeAnimationPoseBindingMetadata, type AuraRuntimeNodeAnimationBindingMetadata, type AuraRuntimeNodeBounds, type AuraRuntimeNodeEffectAttachment, type AuraRuntimeNodeEffectKind, type RuntimeNodeAnimationSpecLike, type RuntimeNodeBoundsInput, type RuntimeNodeHandleLike, type RuntimeNodeMorphTargetWeights, type RuntimeNodeVec3 } from "./RuntimeNodeHandle";
-export { createFightingGameKit, fighting, fighterRuntimeNode, type FightingActorState, type FightingControls, type FightingGameKit, type FightingGameKitOptions, type FightingGameSnapshot, type FightingStageOptions } from "./game-kits/fighting";
-export { gameKits } from "./game-kits";
-export type { GameRuntimeEvidence, GameRuntimeEvidenceApp, GameRuntimeEvidenceOptions, GameRuntimeSourceEvidence } from "./GameEvidence";
+import type { GLTFSceneAnimationRuntime, GLTFSceneAnimationRuntimeOptions } from "../../assets/browser-index.js";
+import type { AnimationPose } from "../../animation/index.js";
+import type { GameHudBindingKind, GameRuntimeSubsystemOwnership } from "./GameRuntime.js";
+import { createFrameLoop } from "./FrameLoop.js";
+import { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameEventLog, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudCheckpointBinding, createGameHudDebugToggleBinding, createGameHudEventLogBinding, createGameHudHealthBinding, createGameHudLivesBinding, createGameHudMeterBinding, createGameHudObjectiveBinding, createGameHudRoundBinding, createGameHudScoreBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameHudValueBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, createGameCollisionWorld, createGamePlanarCollisionWorld, createGameDebugOverlayData, createGameDebugSceneNodes, createGameHitboxDebugGeometry, createGameSimulation, exportGameInputReplay, createGameFighting2DRules, createGameInput, createGameInputReplay, createGameInputReplayDriver, importGameInputReplay, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameInputReplayEventsAt, runGameSimulation, type GameInputOptions } from "./GameRuntime.js";
+import { collectGameRuntimeEvidence as collectGameRuntimeEvidenceV105, type GameRuntimeEvidence, type GameRuntimeEvidenceOptions, type GameRuntimeSourceEvidence } from "./GameEvidence.js";
+import { type AuraRuntimeNodeAnimationPoseBindingMetadata, type AuraRuntimeNodeAnimationBindingMetadata, type AuraRuntimeNodeBounds, type AuraRuntimeNodeEffectAttachment, type RuntimeNodeBoundsInput, type RuntimeNodeMorphTargetWeights } from "./RuntimeNodeHandle.js";
+import { createRuntimeNodeSpec } from "./GameSceneBridge.js";
+import { createFightingGameKit } from "./game-kits/fighting.js";
+import { createGameAssetBoundPlatformerLevel, createGameAssetBoundRacingRoute, createGameFallingBlocksKit, createGameLocomotionKit, createGamePlatformerKit, createGamePlatformerSurfaceQuery, createGameRacingKit, createGameRacingSurfaceQuery, type GameAssetBoundPlatformerLevel, type GameAssetBoundRacingRoute, type GameKitRect, type GameKitVec2, type GamePlatformerCheckpoint } from "./GameGenreKits.js";
+import { createGamePlatformerSceneBinding, createGamePlatformerPresentationCamera, createGameRacingPresentationCamera, createGameRacingSceneBinding, type GamePlatformerPresentationCameraOptions, type GamePlatformerSceneBinding, type GameRacingCameraRigOptions, type GameScenePresentationCameraSpec, type GameRacingSceneBinding } from "./GameSceneGeometryBindings.js";
+import { certifyPublicPlatformerGeometry, certifyPublicRacingGeometry, type PublicGameGeometryCertification, type PublicPlatformerGeometryContract, type PublicRacingGeometryContract } from "./PublicGameGeometry.js";
+export { GAME_FALLING_BLOCK_PIECES, createGameAssetBoundPlatformerLevel, createGameAssetBoundRacingRoute, createGameFallingBlocksKit, createGameLocomotionKit, createGamePlatformerKit, createGamePlatformerSurfaceQuery, createGameRacingKit, createGameRacingSurfaceQuery } from "./GameGenreKits.js";
+export { createGamePlatformerSceneBinding, createGamePlatformerPresentationCamera, createGameRacingPresentationCamera, createGameRacingSceneBinding } from "./GameSceneGeometryBindings.js";
+export { certifyPublicPlatformerGeometry, certifyPublicRacingGeometry } from "./PublicGameGeometry.js";
+export type { GameAssetBoundPlatformerLevel, GameAssetBoundPlatformerLevelBinding, GameAssetBoundPlatformerLevelOptions, GameAssetBoundRacingRoute, GameAssetBoundRacingRouteBinding, GameAssetBoundRacingRouteOptions, GameFallingBlockAction, GameFallingBlockActivePiece, GameFallingBlockBoard, GameFallingBlockCell, GameFallingBlockPiece, GameFallingBlockRotation, GameFallingBlocksEvent, GameFallingBlocksKit, GameFallingBlocksOptions, GameFallingBlocksSnapshot, GameKitRect, GameKitVec2, GameLocomotionClipMap, GameLocomotionEventInput, GameLocomotionInput, GameLocomotionKit, GameLocomotionOptions, GameLocomotionSnapshot, GameLocomotionState, GamePlatformerCheckpoint, GamePlatformerCollectible, GamePlatformerEvent, GamePlatformerEventType, GamePlatformerHazard, GamePlatformerInput, GamePlatformerKit, GamePlatformerLevel, GamePlatformerGroundContact, GamePlatformerSurfaceQuery, GamePlatformerMovingPlatform, GamePlatformerPlayerState, GamePlatformerSnapshot, GamePlatformerWorldAssetBinding, GameRacingCameraSnapshot, GameRacingEvent, GameRacingEventType, GameRacingInput, GameRacingKit, GameRacingSpeedModel, GameRacingSurfaceContact, GameRacingSurfaceQuery, GameRacingOptions, GameRacingRoute, GameRacingSnapshot } from "./GameGenreKits.js";
+export type { PublicGameAssetCertification, PublicGameBounds2, PublicGameGeometryCategory, PublicGameGeometryCertification, PublicGameGeometrySource, PublicGameRetainedProof, PublicPlatformerCheckpoint, PublicPlatformerGeometryContract, PublicPlatformerHazard, PublicPlatformerSurface, PublicRacingGeometryCheckpoint, PublicRacingGeometryContract, PublicRacingGeometryPoint } from "./PublicGameGeometry.js";
+export type { GamePlatformerSceneBinding, GamePlatformerSceneBindingOptions, GamePlatformerPresentationCameraOptions, GameRacingSceneBinding, GameRacingSceneBindingOptions, GameRacingPresentationCameraOptions, GameRacingCameraRigOptions, GameRacingCameraSelectionEvidence, GameRacingSceneSpeedModel, GameRacingScenePose, GameScenePresentationCameraSpec, GameSceneTransform } from "./GameSceneGeometryBindings.js";
+import { createPromptAnimationEpisodePlan, createPromptAnimationStoryBible, definePromptAnimationStoryboard } from "./PromptAnimationContract.js";
+import { applyShotPlaybackFrame, createShotPlaybackPlan, createShotTimeline, installShotPlayback, sampleShotPlaybackPlan } from "./ShotTimeline.js";
+import { captionCueAtTime, createCaptionTimingProof, deriveCaptionTrackFromDialogue } from "./DialoguePerformance.js";
+import { createAuraVoiceVisemeTrack, createGlbBlendshapeVisemeCue, createPrimitiveMouthVisemeCues, sampleVisemeTrack } from "./VisemeController.js";
+import { createAuraVoiceBridgePackage, createAuraVoiceDubRerenderProof, createAuraVoiceRerenderPlan, sampleAuraVoiceBridgeAtTime } from "./AuraVoiceBridge.js";
+import { createAnimationDirectorPlan } from "./AnimationDirector.js";
+import { createAnimationPerformance } from "./AnimationPerformance.js";
+import { createAnimationRenderOutputPackageMetadata, createAnimationRenderQueue } from "./AnimationRenderQueue.js";
+import { collectPromptAnimationEvidence } from "./PromptAnimationEvidence.js";
+import { createAnimationMotionQualityReport, validateAnimationMotionQuality } from "./AnimationMotionQuality.js";
+import { createAnimationRouteProof, validateAnimationRouteProof } from "./AnimationRouteProof.js";
+import { createAnimationEpisodePackageManifest, validateAnimationEpisodePackage } from "./AnimationEpisodePackage.js";
+import { type GameAppRuntime, type GameAppRuntimeOptions } from "./GameAppRuntime.js";
+export { Engine } from "../../core/index.js";
+export { analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport } from "../../rendering/index.js";
+export type { AnimationFrameVisualInput, AnimationFrameVisualQuality, AnimationMaterialStyle, AnimationMaterialStyleOptions, AnimationRenderPresetEvidence, AnimationRenderPresetOptions, AnimationVisualQualityOptions, AnimationVisualQualityReport, FrameMotionRegion, FrameMotionRegionMetrics } from "../../rendering/index.js";
+export { asAuraAppHandle, isAuraAppHandle, type AuraAppFrame, type AuraAppFrameCallback, type AuraAppHandle, type AuraAppNodeRegistryLike, type AuraAppRuntimeState, type AuraAppScreenshot } from "./AuraAppHandle.js";
+export { createGameAppRuntime, type GameAppRuntime, type GameAppRuntimeEvidence, type GameAppRuntimeLoopOptions, type GameAppRuntimeOptions, type GameAppRuntimeResize, type GameAppRuntimeStatus } from "./GameAppRuntime.js";
+export { FrameLoop, createFrameLoop, type FrameLoopCallback, type FrameLoopFrame, type FrameLoopOptions, type FrameLoopSnapshot, type FrameLoopSource } from "./FrameLoop.js";
+export { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudDebugToggleBinding, createGameHudHealthBinding, createGameHudMeterBinding, createGameHudRoundBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, createGameDebugOverlayData, createGameDebugSceneNodes, createGameHitboxDebugGeometry, createGameSimulation, createGameInput, createGameInputReplay, createGameInputReplayDriver, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameColliders, gameInputReplayEventsAt, createGameLoopPlan, runGameSimulation, type GameAccessibilityFocusOptions, type GameAccessibilityLabelOptions, type GameAccessibilityPauseControlsOptions, type GameAccessibilityPreferenceOptions, type GameAccessibilityRuntimeSettings, type GameAccessibilityRuntimeSettingsOptions, type GameAccessibilitySource, type GameAccessibilitySourceKind, type GameAabb, type GameBounds3, type GameCameraDirector, type GameCameraDirectorOptions, type GameCameraSnapshot, type GameCameraTarget, type GameCollisionAddBodyOptions, type GameCollisionBodyHandle, type GameCollisionBodyOptions, type GameCollisionBodySnapshot, type GameCollisionBox, type GameCollisionContact, type GameCollisionEvent, type GameCollisionParticipant, type GameCollisionQueryFilter, type GameCollisionSweepHit, type GameCollisionSweepOptions, type GameCollisionWorld, type GameCollisionWorldSnapshot, type GameCombatActorOptions, type GameCombatActorSnapshot, type GameCombatActiveAttackSnapshot, type GameCombatEvent, type GameCombatEventRuntimeBridgeOptions, type GameCombatEventRuntimeBridgeResult, type GameCombatEventType, type GameCombatMove, type GameCombatWorld, type GameCombatWorldSnapshot, type GameBoxCollider, type GameBoxColliderOptions, type GameCapsuleCollider, type GameCapsuleColliderOptions, type GameCollider, type GameColliderAxis, type GameColliderBase, type GameColliderDimension, type GameColliderFactoryOptions, type GameColliderKind, type GameColliderPlane, type GameDebugGeometryNode, type GameDebugGeometryOptions, type GameDebugGeometryPrimitive, type GameDebugOverlayData, type GameDebugOverlayMetric, type GameDebugOverlayOptions, type GameDebugOverlaySection, type GameDebugSceneNode, type GameDebugSceneNodeOptions, type GameDebugScenePrimitive, type GameEffectInstance, type GameEffectAttachment, type GameEffectKind, type GameEffectOptions, type GameEffectsController, type GameEffectsSnapshot, type GameEventInput, type GameEventLog, type GameEventLogOptions, type GameEventLogSnapshot, type GameEventRecord, type GameEventSeverity, type GameHudActorBindingOptions, type GameHudBinding, type GameHudBindingKind, type GameHudComboBindingOptions, type GameHudDebugToggleBindingOptions, type GameHudEventLogBindingOptions, type GameHudObjectiveBindingOptions, type GameHudResolvedValue, type GameHudRoundBindingOptions, type GameHudScoreBindingOptions, type GameHudSourceKind, type GameHudSnapshot, type GameHudSnapshotItem, type GameHudSnapshotOptions, type GameHudTimerBindingOptions, type GameHudValueBindingOptions, type GameHudValueFormat, type GameInputActionState, type GameInputAxisSettings, type GameInputAxisBinding, type GameInputController, type GameInputOptions, type GameInputReplayDriver, type GameInputReplayDriverSnapshot, type GameInputReplayEvent, type GameInputReplayOptions, type GameInputReplayPlan, type GameInputSnapshot, type GameJumpAssistController, type GameJumpAssistOptions, type GameJumpAssistSnapshot, type GameJumpAssistUpdate, type GameKinematicBody, type GameKinematicBodyOptions, type GameKinematicBodySnapshot, type GameLoopPlan, type GamePointerSnapshot, type GameRectCollider, type GameRectColliderOptions, type GameRuntimeSubsystemId, type GameRuntimeSubsystemOwnership, type GameSimulation, type GameSimulationFrame, type GameSimulationOptions, type GameSimulationResult, type GameSimulationStepContext, type GameSimulationStepResult, type GameSphereCollider, type GameSphereColliderOptions, type GameSubsystemOwner, type GameTouchControlAnchor, type GameTouchControlKind, type GameTouchControlLayout, type GameTouchControlLayoutOptions, type GameTouchControlRegion, type GameTouchControlRequest, type GameVec3, type GamepadSnapshot } from "./GameRuntime.js";
+export { collectGameSceneRuntimeNodes, createGameSceneBridge, createRuntimeNodeSpec, type GameSceneBridge, type GameSceneBridgeApp, type GameSceneBridgeBodyLike, type GameSceneBridgeEvidence, type GameSceneBridgeNodeHandle, type GameSceneRuntimeNode } from "./GameSceneBridge.js";
+export { calculateRuntimeNodeBounds, createRuntimeNodeEffectAttachment, runtimeNodeHasTag, type AuraRuntimeNodeAnimationPoseBindingMetadata, type AuraRuntimeNodeAnimationBindingMetadata, type AuraRuntimeNodeBounds, type AuraRuntimeNodeEffectAttachment, type AuraRuntimeNodeEffectKind, type RuntimeNodeAnimationSpecLike, type RuntimeNodeBoundsInput, type RuntimeNodeHandleLike, type RuntimeNodeMorphTargetWeights, type RuntimeNodeVec3 } from "./RuntimeNodeHandle.js";
+export { createFightingGameKit, fighting, fighterRuntimeNode, type FightingActorState, type FightingControls, type FightingGameKit, type FightingGameKitOptions, type FightingGameSnapshot, type FightingStageOptions } from "./game-kits/fighting.js";
+export { gameKits } from "./game-kits/index.js";
+export type { GameRuntimeEvidence, GameRuntimeEvidenceApp, GameRuntimeEvidenceOptions, GameRuntimeSourceEvidence } from "./GameEvidence.js";
 export * from "./GameAssetValidation.js";
 export * from "./CharacterAssembly.js";
 export * from "./AssetEvidence.js";
@@ -123,7 +128,7 @@ export * from "./TouchControlBinding.js";
 export * from "./AssetLibraryBrowser.js";
 export type AuraVec3 = readonly [number, number, number];
 export type AuraColor = `#${string}` | string;
-export type AuraAssetType = "model" | "texture" | "environment" | "audio";
+export type AuraAssetType = "model" | "texture" | "environment" | "audio" | "navigation";
 export type AuraModelFormat = "glb" | "gltf";
 export type AuraTextureFormat = "png" | "jpg" | "jpeg" | "webp" | "ktx2";
 export type AuraProceduralTextureKind = "fabric-normal" | "rubber-roughness" | "brushed-metal-anisotropy" | "plastic-micro-scratch";
@@ -160,6 +165,11 @@ export interface AuraAssetMetadata {
     };
     readonly thumbnailUrl?: string;
     readonly license?: string;
+    readonly author?: string;
+    readonly provenance?: {
+        readonly sourceUrl?: string;
+        readonly [key: string]: unknown;
+    };
 }
 declare const auraAssetRefBrand: unique symbol;
 export type AuraAssetRef<TType extends AuraAssetType = AuraAssetType, TId extends string = string> = AuraAssetDefinition & {
@@ -303,6 +313,8 @@ export interface AuraModelOptions extends AuraTransformSpec {
     readonly targetMaxDimension?: number;
     readonly targetLength?: number;
     readonly physics?: AuraNodePhysicsSpec;
+    /** Exact glTF node names to suppress when composing a typed model into a route. */
+    readonly hiddenNodeNames?: readonly string[];
 }
 export interface AuraPrimitiveOptions extends AuraTransformSpec {
     readonly name?: string;
@@ -311,6 +323,23 @@ export interface AuraPrimitiveOptions extends AuraTransformSpec {
     readonly castShadow?: boolean;
     readonly receiveShadow?: boolean;
     readonly physics?: AuraNodePhysicsSpec;
+    readonly instances?: readonly AuraTransformSpec[];
+    readonly instanceColors?: readonly AuraColor[];
+    readonly geometry?: AuraCustomGeometrySpec;
+    readonly text3D?: Omit<AuraText3DGeometry, "geometry">;
+    readonly lod?: AuraRootLodSpec;
+}
+export type AuraBuiltinPrimitive = "box" | "sphere" | "plane" | "cylinder" | "capsule" | "torus";
+export interface AuraRootLodLevelSpec {
+    readonly name: string;
+    readonly maxDistance?: number;
+    readonly primitive?: AuraBuiltinPrimitive;
+    readonly geometry?: AuraCustomGeometrySpec;
+    readonly material?: AuraMaterialSpec;
+}
+export interface AuraRootLodSpec {
+    readonly levels: readonly AuraRootLodLevelSpec[];
+    readonly hysteresis?: number;
 }
 export interface AuraAnimationSpec {
     readonly clip?: string;
@@ -449,11 +478,12 @@ export interface AuraModelNode extends AuraTransformSpec {
     readonly animation?: AuraAnimationSpec;
     readonly interaction?: AuraInteractionSpec;
     readonly physics?: AuraNodePhysicsSpec;
+    readonly hiddenNodeNames?: readonly string[];
     readonly runtime?: AuraRuntimeNodeSpec;
 }
 export interface AuraPrimitiveNode extends AuraTransformSpec {
     readonly kind: "primitive";
-    readonly primitive: "box" | "sphere" | "plane" | "cylinder" | "capsule" | "torus";
+    readonly primitive: AuraBuiltinPrimitive | "custom";
     readonly name?: string;
     readonly material?: AuraMaterialSpec;
     readonly size?: number | AuraVec3;
@@ -463,6 +493,11 @@ export interface AuraPrimitiveNode extends AuraTransformSpec {
     readonly interaction?: AuraInteractionSpec;
     readonly physics?: AuraNodePhysicsSpec;
     readonly runtime?: AuraRuntimeNodeSpec;
+    readonly instances?: readonly AuraTransformSpec[];
+    readonly instanceColors?: readonly AuraColor[];
+    readonly geometry?: AuraCustomGeometrySpec;
+    readonly text3D?: Omit<AuraText3DGeometry, "geometry">;
+    readonly lod?: AuraRootLodSpec;
 }
 export interface AuraGroupNode extends AuraTransformSpec {
     readonly kind: "group";
@@ -673,6 +708,8 @@ export interface AuraRendererDiagnosticReport {
         readonly requestedPasses: readonly string[];
         readonly actualPasses: readonly string[];
         readonly fallbackPasses: readonly string[];
+        /** Device-observed render-target format used by the mounted composer. */
+        readonly targetFormat?: "rgba8" | "rgba16f" | "rgba32f";
         readonly evidence: string;
     };
     readonly runtime: {
@@ -681,6 +718,16 @@ export interface AuraRendererDiagnosticReport {
         readonly postprocessVerified: boolean;
         readonly passNames: readonly string[];
         readonly warnings: readonly string[];
+        readonly nativeInstancedSubmissions: number;
+        readonly submittedObjects: number;
+        readonly visibleObjects: number;
+        readonly culledObjects: number;
+        readonly frustumTestedObjects: number;
+        readonly lodSelections: readonly {
+            readonly nodeName: string;
+            readonly levelIndex: number;
+            readonly levelName: string;
+        }[];
     };
     readonly environment: {
         readonly enabled: boolean;
@@ -811,6 +858,41 @@ export declare const primitives: {
     readonly capsule: (options?: AuraPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
     readonly torus: (options?: AuraPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
 };
+export declare const instances: {
+    readonly box: (options: AuraPrimitiveOptions & {
+        readonly transforms: readonly AuraTransformSpec[];
+        readonly colors?: readonly AuraColor[];
+    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly sphere: (options: AuraPrimitiveOptions & {
+        readonly transforms: readonly AuraTransformSpec[];
+        readonly colors?: readonly AuraColor[];
+    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly plane: (options: AuraPrimitiveOptions & {
+        readonly transforms: readonly AuraTransformSpec[];
+        readonly colors?: readonly AuraColor[];
+    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly cylinder: (options: AuraPrimitiveOptions & {
+        readonly transforms: readonly AuraTransformSpec[];
+        readonly colors?: readonly AuraColor[];
+    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly capsule: (options: AuraPrimitiveOptions & {
+        readonly transforms: readonly AuraTransformSpec[];
+        readonly colors?: readonly AuraColor[];
+    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly torus: (options: AuraPrimitiveOptions & {
+        readonly transforms: readonly AuraTransformSpec[];
+        readonly colors?: readonly AuraColor[];
+    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+};
+export declare const geometry: {
+    readonly define: typeof defineAuraCustomGeometry;
+    readonly custom: (spec: AuraCustomGeometrySpec, options?: Omit<AuraPrimitiveOptions, "geometry">) => AuraNodeBuilder<AuraPrimitiveNode>;
+};
+export declare function text3D(text: string, options?: AuraText3DOptions & Omit<AuraPrimitiveOptions, "geometry" | "text3D">): AuraNodeBuilder<AuraPrimitiveNode>;
+export declare function distanceLod(options: Omit<AuraPrimitiveOptions, "lod" | "geometry"> & {
+    readonly levels: readonly AuraRootLodLevelSpec[];
+    readonly hysteresis?: number;
+}): AuraNodeBuilder<AuraPrimitiveNode>;
 export declare const groups: {
     readonly create: typeof group;
     readonly flatten: (nodes: readonly AuraSceneNode[]) => readonly AuraSceneNode[];
@@ -1211,11 +1293,13 @@ export interface AuraCityStateChangeEvidence {
 }
 export interface AuraCityInstancingPlan {
     readonly kind: "aura-city-instancing-plan";
-    readonly rendererPath: "auraWebGL2PrimitiveBatches";
+    readonly rendererPath: "productionRuntimeNativeInstancing";
     readonly windows: number;
     readonly props: number;
     readonly roadMarkings: number;
     readonly lights: number;
+    readonly nativeInstanceGroups: number;
+    readonly nativeInstances: number;
     readonly groups: readonly string[];
     readonly instanced: boolean;
 }
@@ -1440,14 +1524,14 @@ export declare const games: {
     readonly createMiniGolfState: () => AuraMiniGolfStateController;
     readonly miniGolfPointerShot: typeof miniGolfPointerShotFromDrag;
     readonly fighting: {
-        readonly controls: typeof import("./game-kits").defaultFightingControls;
-        readonly moves: typeof import("./game-kits").defaultFightingMoves;
-        readonly runtimeNode: typeof import("./game-kits").fighterRuntimeNode;
-        readonly stagePreset: typeof import("./game-kits").fightingStagePreset;
-        readonly stagePresets: Record<import("./game-kits").FightingStagePresetName, import("./game-kits").FightingStageOptions>;
-        readonly stage: typeof import("./game-kits").createFightingStage;
-        readonly validateStage: typeof import("./game-kits").validateFightingStage;
-        readonly stageNodes: typeof import("./game-kits").fightingStageNodes;
+        readonly controls: typeof import("./game-kits/index.js").defaultFightingControls;
+        readonly moves: typeof import("./game-kits/index.js").defaultFightingMoves;
+        readonly runtimeNode: typeof import("./game-kits/index.js").fighterRuntimeNode;
+        readonly stagePreset: typeof import("./game-kits/index.js").fightingStagePreset;
+        readonly stagePresets: Record<import("./game-kits/index.js").FightingStagePresetName, import("./game-kits/index.js").FightingStageOptions>;
+        readonly stage: typeof import("./game-kits/index.js").createFightingStage;
+        readonly validateStage: typeof import("./game-kits/index.js").validateFightingStage;
+        readonly stageNodes: typeof import("./game-kits/index.js").fightingStageNodes;
         readonly createKit: typeof createFightingGameKit;
     };
     readonly createFightingGameKit: typeof createFightingGameKit;
@@ -1802,6 +1886,7 @@ export declare const game: {
     readonly touchControls: typeof createGameTouchControlLayout;
     readonly kinematicBody: typeof createGameKinematicBody;
     readonly collisionWorld: typeof createGameCollisionWorld;
+    readonly planarCollisionWorld: typeof createGamePlanarCollisionWorld;
     readonly jumpAssist: typeof createGameJumpAssist;
     readonly collider: {
         readonly box: typeof createGameBoxCollider;
@@ -1817,40 +1902,40 @@ export declare const game: {
         };
     };
     readonly hitbox: {
-        readonly rect: typeof import("./GameRuntime").createGameHitboxRect;
-        readonly box: typeof import("./GameRuntime").createGameHitboxRect;
+        readonly rect: typeof import("./GameRuntime.js").createGameHitboxRect;
+        readonly box: typeof import("./GameRuntime.js").createGameHitboxRect;
     };
     readonly hurtbox: {
-        readonly rect: typeof import("./GameRuntime").createGameHurtboxRect;
-        readonly box: typeof import("./GameRuntime").createGameHurtboxRect;
+        readonly rect: typeof import("./GameRuntime.js").createGameHurtboxRect;
+        readonly box: typeof import("./GameRuntime.js").createGameHurtboxRect;
     };
     readonly guardbox: {
-        readonly rect: typeof import("./GameRuntime").createGameGuardboxRect;
-        readonly box: typeof import("./GameRuntime").createGameGuardboxRect;
+        readonly rect: typeof import("./GameRuntime.js").createGameGuardboxRect;
+        readonly box: typeof import("./GameRuntime.js").createGameGuardboxRect;
     };
     readonly pushbox: {
-        readonly rect: typeof import("./GameRuntime").createGamePushboxRect;
-        readonly box: typeof import("./GameRuntime").createGamePushboxRect;
+        readonly rect: typeof import("./GameRuntime.js").createGamePushboxRect;
+        readonly box: typeof import("./GameRuntime.js").createGamePushboxRect;
     };
     readonly trigger: {
-        readonly box: (options?: import("./GameRuntime").GameBoxColliderOptions) => import("./GameRuntime").GameBoxCollider;
-        readonly sphere: (options?: import("./GameRuntime").GameSphereColliderOptions) => import("./GameRuntime").GameSphereCollider;
-        readonly capsule: (options?: import("./GameRuntime").GameCapsuleColliderOptions) => import("./GameRuntime").GameCapsuleCollider;
-        readonly rect: (options?: import("./GameRuntime").GameRectColliderOptions) => import("./GameRuntime").GameRectCollider;
+        readonly box: (options?: import("./GameRuntime.js").GameBoxColliderOptions) => import("./GameRuntime.js").GameBoxCollider;
+        readonly sphere: (options?: import("./GameRuntime.js").GameSphereColliderOptions) => import("./GameRuntime.js").GameSphereCollider;
+        readonly capsule: (options?: import("./GameRuntime.js").GameCapsuleColliderOptions) => import("./GameRuntime.js").GameCapsuleCollider;
+        readonly rect: (options?: import("./GameRuntime.js").GameRectColliderOptions) => import("./GameRuntime.js").GameRectCollider;
     };
     readonly combatWorld: typeof createCombatWorld;
     readonly combatEvents: typeof applyGameCombatEventsToRuntime;
     readonly cameraDirector: typeof createGameCameraDirector;
     readonly effects: typeof createGameEffects;
     readonly effectPresets: {
-        readonly hitSpark: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly blockSpark: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly groundDust: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly dashTrail: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly slashTrail: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly shockwave: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly auraBurst: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
-        readonly superBurst: (options?: import("./GameRuntime").GameEffectOptions) => import("./GameRuntime").GameEffectPreset;
+        readonly hitSpark: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly blockSpark: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly groundDust: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly dashTrail: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly slashTrail: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly shockwave: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly auraBurst: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
+        readonly superBurst: (options?: import("./GameRuntime.js").GameEffectOptions) => import("./GameRuntime.js").GameEffectPreset;
     };
     readonly debug: {
         readonly colliders: typeof createGameColliderDebugGeometry;
@@ -2275,6 +2360,16 @@ export declare const promptRecipes: {
     readonly "mini-game": (asset: AuraAssetRef<"model">, plan: AuraPromptPlan) => AuraSceneBuilder;
     readonly "material-studio": (asset: AuraAssetRef<"model">, plan: AuraPromptPlan) => AuraSceneBuilder;
 };
+/**
+ * Which backend a mounted app is drawing with.
+ *
+ * `"canvas2d"` is **internal and diagnostic-only** (WS-2.5). It is never selected for a scene that
+ * declares renderable content: such a scene either renders through WebGL2/WebGPU or raises a diagnosable
+ * error. It appears here because `diagnostics().backend` can still report it for a scene with nothing to
+ * render, and hiding that would make the diagnostic less useful, not more honest.
+ *
+ * Do not treat a `"canvas2d"` reading as a render. See `renderDiagnosticPreviewToCanvas`.
+ */
 export type AuraBackend = "webgl2" | "webgpu" | "canvas2d" | "headless";
 export interface AuraDiagnostics {
     readonly backend: AuraBackend;
@@ -2491,12 +2586,80 @@ export interface AuraApp {
     readonly backend: AuraBackend;
     readonly nodes: AuraRuntimeNodeRegistry;
     readonly runtime: AuraRuntimeState;
+    /**
+     * The live physics simulation for this app.
+     *
+     * This is the seam that makes `@aura3d/engine` a game engine rather than a scene
+     * declaration format. Before it existed, `.physics({ type: "dynamic" })` let a developer
+     * watch a box fall and nothing else: no force, no collision callback, no raycast, no
+     * joint. Every genre outside the four bundled kits had no path at all.
+     *
+     * Bodies declared on scene nodes are registered here under their node name, so
+     * `app.physics.bodies.require("crate").applyImpulse([4, 0, 0])` works with no extra setup.
+     */
+    readonly physics: AuraPhysicsRuntime;
     setScene(scene: AuraSceneBuilder | AuraSceneSnapshot): void;
     onFrame(callback: AuraFrameCallback): () => void;
     offFrame(callback: AuraFrameCallback): void;
     input(options: GameInputOptions): ReturnType<typeof createGameInput>;
     pause(): void;
     resume(): void;
+    /**
+     * Resolves once the renderer has finished mounting and a frame can be drawn.
+     *
+     * WS-2.9. The production WebGL renderer mounts asynchronously, so immediately after
+     * `createAuraApp` returns there is a window in which nothing can be drawn yet. `step(dt)` used to
+     * fall through to a Canvas-2D path in that window and render nothing, with no warning — a blank
+     * image for anyone writing a headless capture or a deterministic test.
+     *
+     * Awaiting this is the fix, and it exists because a warning that says "wait for the mount" is
+     * useless without a way to wait:
+     *
+     * ```ts
+     * const app = createAuraApp(canvas, { scene, autoStart: false });
+     * await app.ready();
+     * app.step(1 / 60);           // now renders
+     * ```
+     *
+     * Resolves immediately for a scene with no async mount, and resolves — rather than rejecting — if
+     * the mount fails, because the failure is already reported through `diagnostics().errors` and a
+     * rejection here would make the common `await app.ready()` line throw for a diagnosable condition.
+     */
+    ready(): Promise<void>;
+    /**
+     * Subscribe to WebGL context loss. Returns an unsubscribe function.
+     *
+     * WS-2.6. A lost context is not something a developer can prevent — the browser reclaims GPU
+     * resources under memory pressure, on driver reset, or when a tab is backgrounded too long. What they
+     * can do is be told, and until 1.6 they could not be: `WebGL2Device` has tracked and handled
+     * `webglcontextlost` for a long time, but nothing surfaced it, so the only symptom reaching a
+     * developer was a canvas that stopped updating.
+     *
+     * That distinction is why the parity table listed this as a gap while the listeners existed. The
+     * device layer was never the gap; the absence of a public signal was.
+     *
+     * ```ts
+     * app.onDeviceLost(() => showReconnectingOverlay());
+     * app.onDeviceRestored(() => hideReconnectingOverlay());
+     * ```
+     *
+     * Registering before the renderer has mounted is safe: the subscription is held and attached when the
+     * device arrives, so a caller does not have to await `ready()` first.
+     */
+    onDeviceLost(listener: () => void): () => void;
+    /** Subscribe to WebGL context restoration. Returns an unsubscribe function. See {@link onDeviceLost}. */
+    onDeviceRestored(listener: () => void): () => void;
+    /** True while the WebGL context is lost, so a caller can check state rather than only react to events. */
+    deviceLost(): boolean;
+    /**
+     * Advance deterministic application state without presenting a rendered frame.
+     *
+     * This runs the same `onFrame` callbacks and app-owned physics step as {@link step},
+     * but deliberately skips renderer submission. Use it for fixed-step simulation,
+     * replay, and evidence runs that only need pixels at named milestones; call
+     * `step(0)` when a milestone should be presented.
+     */
+    advance(dt?: number): void;
     step(dt?: number): void;
     diagnostics(): AuraDiagnostics;
     evidence(options?: GameRuntimeEvidenceOptions): ReturnType<typeof collectGameRuntimeEvidenceV105>;
@@ -2505,6 +2668,21 @@ export interface AuraApp {
 }
 export interface AuraCreateAppOptions {
     readonly scene: AuraSceneBuilder | AuraSceneSnapshot;
+    /**
+     * Configuration for {@link AuraApp.physics}.
+     *
+     * `layers` has to be supplied here rather than per body, because a collision mask is only
+     * meaningful relative to the complete set of layers: building the bitmask for "bullet"
+     * requires knowing every layer that exists. Without this option a developer could call
+     * `createCollisionLayers` and then have nowhere to put the result — which is exactly the
+     * hole the clean-room top-down shooter hit, since "bullets hit enemies but not each other"
+     * is the first thing any shooter needs.
+     */
+    readonly physics?: {
+        readonly layers?: AuraCollisionLayers | undefined;
+        /** World gravity. Defaults to `[0, -9.81, 0]`; top-down games usually want zero. */
+        readonly gravity?: readonly [number, number, number] | undefined;
+    };
     readonly diagnostics?: boolean | AuraDiagnosticsOptions;
     readonly renderer?: AuraCreateAppRendererOptions;
     readonly pixelRatio?: number;
@@ -2533,6 +2711,31 @@ export declare class AuraRuntimeError extends Error {
     constructor(code: AuraRuntimeError["code"], message: string);
 }
 export declare function createAuraApp(target: AuraAppTarget, options: AuraCreateAppOptions): AuraApp;
+/**
+ * Control surface for every app mounted on this page.
+ *
+ * Exposed on `globalThis.__AURA3D_LIVE_APPS__` as well as being exported, so a Playwright
+ * `page.evaluate` can reach it without the route having to opt in.
+ */
+export interface AuraAppRegistry {
+    readonly kind: "aura3d-live-app-registry";
+    /** Number of apps currently mounted. */
+    count(): number;
+    /** Pause every app's frame loop. Returns how many were paused. */
+    pauseAll(): number;
+    /** Resume every app's frame loop. */
+    resumeAll(): number;
+    /**
+     * Pause every app and advance each by a fixed number of fixed-size steps.
+     *
+     * This is what makes a capture reproducible: rather than photographing an arbitrary moment of a
+     * live loop, a caller settles every scene to a *named* frame — the same `steps` and `dt` always
+     * produce the same state, so a screenshot hash becomes a stable thing to approve.
+     */
+    settle(steps?: number, dt?: number): number;
+    all(): readonly AuraApp[];
+}
+export declare const auraAppRegistry: AuraAppRegistry;
 export declare function createGameApp(target: AuraAppTarget, options: AuraCreateGameAppOptions): GameAppRuntime<AuraApp>;
 export declare function createAuraRouteHealthSnapshot(app: AuraApp): {
     readonly status: "ready" | "error";