@aura3d/engine 1.3.2 → 1.4.0

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

@@ -48,11 +48,17 @@ import type { GLTFSceneAnimationRuntime, GLTFSceneAnimationRuntimeOptions } from
 import type { AnimationPose } from "@aura3d/animation";
 import type { GameHudBindingKind, GameRuntimeSubsystemOwnership } from "./GameRuntime";
 import { createFrameLoop } from "./FrameLoop";
-import { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudDebugToggleBinding, createGameHudHealthBinding, createGameHudMeterBinding, createGameHudRoundBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, 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 { 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, createGameRacingKit, type GameAssetBoundPlatformerLevel, type GameAssetBoundRacingRoute } from "./GameGenreKits";
+import { createGamePlatformerSceneBinding, createGamePlatformerPresentationCamera, createGameRacingPresentationCamera, createGameRacingSceneBinding, type GamePlatformerSceneBinding, type GameRacingSceneBinding } from "./GameSceneGeometryBindings";
+export { GAME_FALLING_BLOCK_PIECES, createGameAssetBoundPlatformerLevel, createGameAssetBoundRacingRoute, createGameFallingBlocksKit, createGameLocomotionKit, createGamePlatformerKit, createGameRacingKit } from "./GameGenreKits";
+export { createGamePlatformerSceneBinding, createGamePlatformerPresentationCamera, createGameRacingPresentationCamera, createGameRacingSceneBinding } from "./GameSceneGeometryBindings";
+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, GamePlatformerMovingPlatform, GamePlatformerPlayerState, GamePlatformerSnapshot, GamePlatformerWorldAssetBinding, GameRacingCameraSnapshot, GameRacingEvent, GameRacingEventType, GameRacingInput, GameRacingKit, GameRacingOptions, GameRacingRoute, GameRacingSnapshot } from "./GameGenreKits";
+export type { GamePlatformerSceneBinding, GamePlatformerSceneBindingOptions, GamePlatformerPresentationCameraOptions, GameRacingSceneBinding, GameRacingSceneBindingOptions, GameRacingPresentationCameraOptions, 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";
@@ -72,7 +78,7 @@ export type { AnimationFrameVisualInput, AnimationFrameVisualQuality, AnimationM
 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 GameCollisionBox, 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 GameHudActorBindingOptions, type GameHudBinding, type GameHudBindingKind, type GameHudComboBindingOptions, type GameHudDebugToggleBindingOptions, type GameHudResolvedValue, type GameHudRoundBindingOptions, type GameHudSourceKind, type GameHudSnapshot, type GameHudSnapshotItem, type GameHudSnapshotOptions, type GameHudTimerBindingOptions, 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 { 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";
@@ -127,6 +133,12 @@ export interface AuraAssetMetadata {
     readonly materials?: readonly string[];
     readonly animations?: readonly string[];
     readonly textures?: readonly string[];
+    readonly boundsMetadata?: {
+        readonly min?: readonly number[];
+        readonly max?: readonly number[];
+        readonly size?: readonly number[];
+        readonly center?: readonly number[];
+    };
     readonly thumbnailUrl?: string;
     readonly license?: string;
 }
@@ -236,12 +248,41 @@ export interface AuraMaterialVisualQAResult {
     readonly minimumMaterialDistance: number;
     readonly problems: readonly string[];
 }
+export type AuraMaterialCapabilityFeatureId = "base-color" | "base-color-texture" | "metallic-roughness" | "normal-map" | "emissive" | "alpha" | "double-sided" | "clearcoat" | "sheen" | "transmission" | "variants" | "hdr-ibl" | "shadow-maps";
+export type AuraMaterialCapabilitySupport = "supported" | "partial" | "metadata-only" | "unsupported" | "internal";
+export interface AuraMaterialCapabilityFeature {
+    readonly id: AuraMaterialCapabilityFeatureId;
+    readonly label: string;
+    readonly rootSafeApi: AuraMaterialCapabilitySupport;
+    readonly productionRuntime: AuraMaterialCapabilitySupport;
+    readonly requested: boolean;
+    readonly evidence: string;
+    readonly claimRule: string;
+}
+export interface AuraMaterialCapabilityDiagnostics {
+    readonly kind: "aura-material-capability-diagnostics";
+    readonly rendererPath: "root-createAuraApp";
+    readonly requestedFeatures: readonly AuraMaterialCapabilityFeatureId[];
+    readonly unsupportedRequestedFeatures: readonly AuraMaterialCapabilityFeatureId[];
+    readonly partialRequestedFeatures: readonly AuraMaterialCapabilityFeatureId[];
+    readonly features: readonly AuraMaterialCapabilityFeature[];
+    readonly warnings: readonly string[];
+    readonly claimBoundary: string;
+}
+export type AuraMaterialCapabilityInput = AuraMaterialSpec | readonly AuraMaterialSpec[] | AuraSceneBuilder | AuraSceneSnapshot | readonly AuraSceneNode[] | undefined;
+export type AuraModelRole = "primaryCharacter" | "primaryVehicle" | "primaryWorld" | "primaryTrack" | "setDressing" | "debug" | "collider" | "uiOnly";
+export type AuraModelScaleMode = "normalized" | "fit" | "world";
 export interface AuraModelOptions extends AuraTransformSpec {
     readonly name?: string;
     readonly material?: AuraMaterialSpec;
     readonly castShadow?: boolean;
     readonly receiveShadow?: boolean;
     readonly visible?: boolean;
+    readonly role?: AuraModelRole;
+    readonly scaleMode?: AuraModelScaleMode;
+    readonly targetHeight?: number;
+    readonly targetMaxDimension?: number;
+    readonly targetLength?: number;
     readonly physics?: AuraNodePhysicsSpec;
 }
 export interface AuraPrimitiveOptions extends AuraTransformSpec {
@@ -381,6 +422,11 @@ export interface AuraModelNode extends AuraTransformSpec {
     readonly castShadow: boolean;
     readonly receiveShadow: boolean;
     readonly visible: boolean;
+    readonly role?: AuraModelRole;
+    readonly scaleMode?: AuraModelScaleMode;
+    readonly targetHeight?: number;
+    readonly targetMaxDimension?: number;
+    readonly targetLength?: number;
     readonly animation?: AuraAnimationSpec;
     readonly interaction?: AuraInteractionSpec;
     readonly physics?: AuraNodePhysicsSpec;
@@ -419,10 +465,11 @@ export interface AuraLightNode extends AuraTransformSpec {
 }
 export type AuraEffectType = "fog" | "bloom" | "rain" | "particles" | "ambient-occlusion" | "contact-occlusion";
 export type AuraParticleMaterialMode = "additive-glow" | "soft-alpha" | "spark" | "smoke" | "splash" | "dust" | "star";
-export interface AuraEffectNode {
+export interface AuraEffectNode extends AuraTransformSpec {
     readonly kind: "effect";
     readonly effect: AuraEffectType;
     readonly name?: string;
+    readonly animation?: AuraAnimationSpec;
     readonly intensity?: number;
     readonly density?: number;
     readonly color?: AuraColor;
@@ -514,9 +561,35 @@ export interface AuraRendererQualityPreset {
     readonly maxRecommendedDrawCalls: number;
     readonly evidence: string;
 }
+export type AuraRendererQualityProfileId = "safe-basic" | "production" | "cinematic" | "experimental-webgpu";
+export type AuraRendererMode = "safe-basic" | "production";
+export type AuraRendererFallbackMode = "safe-basic";
+export interface AuraRendererQualityProfile {
+    readonly kind: "aura-renderer-quality-profile";
+    readonly id: AuraRendererQualityProfileId;
+    readonly label: string;
+    readonly rendererMode: AuraRendererMode;
+    readonly status: "supported" | "fallback-only" | "experimental";
+    readonly antialiasing: "msaa" | "msaa-plus-high-dpi";
+    readonly pixelRatio: number;
+    readonly preserveDrawingBuffer: boolean;
+    readonly maxRecommendedDrawCalls: number;
+    readonly requestedFeatures: readonly string[];
+    readonly supportedInRoot: readonly string[];
+    readonly blockedInRoot: readonly string[];
+    readonly claimBoundary: string;
+}
+export interface AuraCreateAppRendererOptions {
+    readonly mode?: AuraRendererMode;
+    readonly fallback?: AuraRendererFallbackMode;
+    readonly qualityProfile?: AuraRendererQualityProfileId;
+}
 export interface AuraRendererDiagnosticReport {
     readonly kind: "aura-renderer-diagnostics";
     readonly colorManagement: AuraRendererColorManagementPreset;
+    readonly rendererMode: AuraRendererMode;
+    readonly fallbackMode?: AuraRendererFallbackMode;
+    readonly qualityProfile: AuraRendererQualityProfile;
     readonly sceneCategory: AuraSceneCategory;
     readonly exposure: AuraSceneExposurePreset;
     readonly toneMapping: "aces-filmic";
@@ -563,7 +636,7 @@ export interface AuraRendererDiagnosticReport {
     };
     readonly runtime: {
         readonly mounted: boolean;
-        readonly backend: "scene-plan" | "webgl2-agent-runtime";
+        readonly backend: "scene-plan" | "webgl2-agent-runtime" | "production-runtime";
         readonly postprocessVerified: boolean;
         readonly passNames: readonly string[];
         readonly warnings: readonly string[];
@@ -576,6 +649,7 @@ export interface AuraRendererDiagnosticReport {
     };
     readonly antialiasing: AuraRendererQualityPreset["antialiasing"];
     readonly screenshotQuality: AuraRendererQualityPreset;
+    readonly materialCapabilities: AuraMaterialCapabilityDiagnostics;
     readonly warnings: readonly string[];
 }
 declare global {
@@ -747,6 +821,7 @@ export declare const material: {
     readonly presets: () => Readonly<Record<string, AuraMaterialSpec>>;
     readonly inspector: (name: string, spec: AuraMaterialSpec) => AuraMaterialInspectorPanel;
     readonly visualQA: (nodes: readonly AuraSceneNode[]) => AuraMaterialVisualQAResult;
+    readonly capabilityDiagnostics: (input?: AuraMaterialCapabilityInput) => AuraMaterialCapabilityDiagnostics;
 };
 export declare const lights: {
     readonly ambient: (options?: {
@@ -797,6 +872,9 @@ export interface AuraCameraSpec {
     readonly mode: AuraCameraMode;
     readonly position?: AuraVec3;
     readonly target?: AuraVec3;
+    readonly offset?: AuraVec3;
+    readonly targetOffset?: AuraVec3;
+    readonly offsetMode?: "scene" | "target-yaw";
     readonly fov?: number;
     readonly distance?: number;
     readonly from?: AuraVec3;
@@ -812,6 +890,19 @@ export interface AuraBoundsSpec {
     readonly min: AuraVec3;
     readonly max: AuraVec3;
 }
+export interface AuraCameraFrameAssetOptions {
+    readonly targetHeight?: number;
+    readonly targetMaxDimension?: number;
+    readonly targetLength?: number;
+    readonly position?: AuraVec3;
+    readonly floorY?: number;
+    readonly target?: AuraVec3;
+    readonly padding?: number;
+    readonly fov?: number;
+    readonly azimuth?: number;
+    readonly elevation?: number;
+    readonly minDistance?: number;
+}
 export declare const camera: {
     readonly perspective: (options?: Omit<AuraCameraSpec, "mode">) => AuraCameraSpec;
     readonly orbit: (options?: Omit<AuraCameraSpec, "mode">) => AuraCameraSpec;
@@ -836,6 +927,7 @@ export declare const camera: {
         readonly padding?: number;
         readonly fov?: number;
     }) => AuraCameraSpec;
+    readonly frameAsset: (asset: AuraAssetRef<"model">, options?: AuraCameraFrameAssetOptions) => AuraCameraSpec;
     readonly physics: () => AuraCameraSpec;
     readonly charts: () => AuraCameraSpec;
     readonly materials: () => AuraCameraSpec;
@@ -967,8 +1059,10 @@ export declare const renderer: {
     readonly exposurePresets: () => Readonly<Record<AuraSceneCategory, AuraSceneExposurePreset>>;
     readonly exposureFor: (category: AuraSceneCategory) => AuraSceneExposurePreset;
     readonly qualityPresets: () => Readonly<Record<"interactive" | "screenshot", AuraRendererQualityPreset>>;
+    readonly qualityProfiles: () => Readonly<Record<AuraRendererQualityProfileId, AuraRendererQualityProfile>>;
+    readonly qualityProfile: (id: AuraRendererQualityProfileId) => AuraRendererQualityProfile;
     readonly screenshotQuality: () => AuraRendererQualityPreset;
-    readonly diagnostics: (sceneValue: AuraSceneBuilder | AuraSceneSnapshot) => AuraRendererDiagnosticReport;
+    readonly diagnostics: (sceneValue: AuraSceneBuilder | AuraSceneSnapshot, options?: AuraCreateAppRendererOptions) => AuraRendererDiagnosticReport;
 };
 export interface AuraSceneSnapshot {
     readonly schema: "aura3d-scene-snapshot/1.0";
@@ -1460,6 +1554,30 @@ export declare const gameRules: typeof createAuraGameRules & {
     fighting2D: typeof createGameFighting2DRules;
 };
 export declare function createAuraGameRuntime(options?: AuraGameRuntimeOptions): AuraGameRuntime;
+export interface AuraRacingPresentationTrackOptions {
+    readonly sceneBinding: GameRacingSceneBinding;
+    readonly route: GameAssetBoundRacingRoute;
+    readonly mode?: "standalone" | "asset-overlay" | "game-circuit";
+    readonly guideVisibility?: "public" | "evidence" | "full";
+    readonly roadY?: number;
+    readonly roadColor?: AuraColor;
+    readonly terrainColor?: AuraColor;
+    readonly curbColor?: AuraColor;
+    readonly laneColor?: AuraColor;
+}
+export interface AuraPlatformerPresentationSurfaceOptions {
+    readonly sceneBinding: GamePlatformerSceneBinding;
+    readonly level: GameAssetBoundPlatformerLevel;
+    readonly mode?: "standalone" | "asset-overlay" | "game-level";
+    readonly guideVisibility?: "public" | "evidence" | "full";
+    readonly platformColor?: AuraColor;
+    readonly platformTrimColor?: AuraColor;
+    readonly hazardColor?: AuraColor;
+    readonly collectibleColor?: AuraColor;
+    readonly finishColor?: AuraColor;
+}
+export declare function createGameRacingPresentationTrackNodes(options: AuraRacingPresentationTrackOptions): readonly AuraSceneNode[];
+export declare function createGamePlatformerPresentationSurfaceNodes(options: AuraPlatformerPresentationSurfaceOptions): readonly AuraSceneNode[];
 export declare const game: {
     readonly createRuntime: typeof createAuraGameRuntime;
     readonly rules: typeof createAuraGameRules & {
@@ -1477,8 +1595,23 @@ export declare const game: {
     readonly simulation: typeof createGameSimulation;
     readonly runSimulation: typeof runGameSimulation;
     readonly inspector: typeof createGameInspector;
+    readonly locomotion: typeof createGameLocomotionKit;
+    readonly assetBoundPlatformerLevel: typeof createGameAssetBoundPlatformerLevel;
+    readonly platformerSceneBinding: typeof createGamePlatformerSceneBinding;
+    readonly platformerPresentationCamera: typeof createGamePlatformerPresentationCamera;
+    readonly platformerPresentationSurfaces: typeof createGamePlatformerPresentationSurfaceNodes;
+    readonly platformer: typeof createGamePlatformerKit;
+    readonly assetBoundRacingRoute: typeof createGameAssetBoundRacingRoute;
+    readonly racingSceneBinding: typeof createGameRacingSceneBinding;
+    readonly racingPresentationCamera: typeof createGameRacingPresentationCamera;
+    readonly racingPresentationTrack: typeof createGameRacingPresentationTrackNodes;
+    readonly racing: typeof createGameRacingKit;
+    readonly fallingBlocks: typeof createGameFallingBlocksKit;
+    readonly fallingBlockPieces: readonly ["I", "J", "L", "O", "S", "T", "Z"];
+    readonly eventLog: typeof createGameEventLog;
     readonly touchControls: typeof createGameTouchControlLayout;
     readonly kinematicBody: typeof createGameKinematicBody;
+    readonly collisionWorld: typeof createGameCollisionWorld;
     readonly jumpAssist: typeof createGameJumpAssist;
     readonly collider: {
         readonly box: typeof createGameBoxCollider;
@@ -1542,6 +1675,12 @@ export declare const game: {
         readonly timer: typeof createGameHudTimerBinding;
         readonly combo: typeof createGameHudComboBinding;
         readonly round: typeof createGameHudRoundBinding;
+        readonly score: typeof createGameHudScoreBinding;
+        readonly lives: typeof createGameHudLivesBinding;
+        readonly objective: typeof createGameHudObjectiveBinding;
+        readonly checkpoint: typeof createGameHudCheckpointBinding;
+        readonly value: typeof createGameHudValueBinding;
+        readonly eventLog: typeof createGameHudEventLogBinding;
         readonly debugToggle: typeof createGameHudDebugToggleBinding;
         readonly bindings: typeof createGameHudBindings;
         readonly snapshot: typeof createGameHudSnapshot;
@@ -2097,6 +2236,8 @@ export interface AuraRuntimeNodeImportedAssetEvidence {
         readonly updated: boolean;
     } | undefined;
     readonly morphTargets: readonly string[];
+    readonly activeMorphTargets: RuntimeNodeMorphTargetWeights;
+    readonly missingMorphTargets: readonly string[];
     readonly bounds?: AuraRuntimeNodeBounds | undefined;
     readonly renderItemCount: number;
     readonly skinnedRenderItemCount: number;
@@ -2120,6 +2261,8 @@ export interface AuraRuntimeNodeImportedAssetEvidenceInput {
         readonly updated?: boolean | undefined;
     } | undefined;
     readonly morphTargets?: readonly string[] | undefined;
+    readonly activeMorphTargets?: RuntimeNodeMorphTargetWeights | undefined;
+    readonly missingMorphTargets?: readonly string[] | undefined;
     readonly bounds?: AuraRuntimeNodeBounds | RuntimeNodeBoundsInput | undefined;
     readonly renderItemCount?: number | undefined;
     readonly skinnedRenderItemCount?: number | undefined;
@@ -2164,6 +2307,7 @@ export interface AuraApp {
 export interface AuraCreateAppOptions {
     readonly scene: AuraSceneBuilder | AuraSceneSnapshot;
     readonly diagnostics?: boolean | AuraDiagnosticsOptions;
+    readonly renderer?: AuraCreateAppRendererOptions;
     readonly pixelRatio?: number;
     readonly autoStart?: boolean;
     readonly resize?: boolean;