@aura3d/engine 1.0.9 → 1.1.0

package/dist/engine/agent-api/index.js

@@ -1,6 +1,47 @@
 import { PhysicsDebugDraw, PhysicsStepper, PhysicsWorld, ScenePhysicsBridge, Shape as PhysicsShapeFactory } from "../../physics/index.js";
+export * from "./FrameEncoder.js";
+export * from "./BrowserFrameCaptureAdapter.js";
+export * from "./MediaRecorderFrameEncoder.js";
+export * from "./WebCodecsFrameEncoder.js";
+export * from "./PngSequenceEncoder.js";
+export * from "./AudioMuxer.js";
+export { GameInspector, createGameInspector } from "./GameInspector.js";
+import { createGameInspector } from "./GameInspector.js";
+export { createGameAudio } from "../game/GameAudio.js";
+export * from "./RenderProgressTracker.js";
+export * from "./VideoExportPipeline.js";
+export * from "./AudioVisemeAnalyzer.js";
+export * from "./ExternalPhonemeAnalyzer.js";
+export * from "./WaveformVisualizer.js";
+export * from "./VisemeTimelineTrack.js";
+export * from "./EpisodeStructure.js";
+export * from "./ShotTransitionEngine.js";
+export * from "./SceneSequencer.js";
+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 "./CartoonAssetManifest.js";
+export * from "./AssetLibraryBrowser.js";
+export * from "./DialogueAlignment.js";
+export * from "./PerformancePoseEditor.js";
+export * from "./PerformanceCaptureSession.js";
+export * from "./PerformanceBlender.js";
+export * from "./PerformanceScriptParser.js";
+export * from "./BodyLanguageLibrary.js";
+export * from "./EpisodeTemplates.js";
+export * from "./CartoonMotionQuality.js";
+export * from "./CartoonRouteProof.js";
+export * from "./CartoonEpisodePackage.js";
 import { createFrameLoop } from "./FrameLoop.js";
-import { createCombatWorld, createGameCameraDirector, createGameEffects, applyGameCombatEventsToRuntime, createGameAccessibilityFocus, createGameAccessibilityLabel, createGameAccessibilityRuntimeSettings, createGameHighContrastSource, createGameHudBindings, createGameHudComboBinding, createGameHudDebugToggleBinding, createGameHudHealthBinding, createGameHudMeterBinding, createGameHudRoundBinding, createGameHudSnapshot, createGameHudTimerBinding, createGameBoxCollider, createGameCapsuleCollider, createGameColliderDebugGeometry, createGameCombatDebugGeometry, createGameDebugOverlayData, createGameDebugSceneNodes, createGameHitboxDebugGeometry, createGameFighting2DRules, createGameInput, createGameInputReplay, createGameInputReplayDriver, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameColliders, gameEffectPresets, gameGuardboxes, gameHitboxes, gameHurtboxes, gameInputReplayEventsAt, gamePushboxes, gameTriggerVolumes } from "./GameRuntime.js";
+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, gameColliders, gameEffectPresets, gameGuardboxes, gameHitboxes, gameHurtboxes, gameInputReplayEventsAt, gamePushboxes, runGameSimulation, gameTriggerVolumes } from "./GameRuntime.js";
 import { collectGameRuntimeEvidence as collectGameRuntimeEvidenceV105 } from "./GameEvidence.js";
 import { calculateRuntimeNodeBounds } from "./RuntimeNodeHandle.js";
 import { createRuntimeNodeSpec } from "./GameSceneBridge.js";
@@ -14,12 +55,16 @@ import { createCartoonDirectorPlan } from "./CartoonDirector.js";
 import { createCartoonPerformance } from "./CartoonPerformance.js";
 import { createCartoonRenderOutputPackageMetadata, createCartoonRenderQueue } from "./CartoonRenderQueue.js";
 import { collectPromptAnimationEvidence } from "./PromptAnimationEvidence.js";
+import { createCartoonMotionQualityReport, validateCartoonMotionQuality } from "./CartoonMotionQuality.js";
+import { createCartoonRouteProof, validateCartoonRouteProof } from "./CartoonRouteProof.js";
+import { createCartoonEpisodePackageManifest, validateCartoonEpisodePackage } from "./CartoonEpisodePackage.js";
 import { createGameAppRuntime } from "./GameAppRuntime.js";
 export { Engine } from "../../core/index.js";
+export { analyzeRgbaFrameMotionRegions, createCartoonMaterialStyle, createCartoonRenderPreset, createCartoonVisualQualityReport } from "../../rendering/index.js";
 export { asAuraAppHandle, isAuraAppHandle } from "./AuraAppHandle.js";
 export { createGameAppRuntime } from "./GameAppRuntime.js";
 export { FrameLoop, createFrameLoop } 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, createGameInput, createGameInputReplay, createGameInputReplayDriver, createGameJumpAssist, createGameKinematicBody, createGamePauseControlsSource, createGameRectCollider, createGameReducedFlashSource, createGameReducedMotionSource, createGameSphereCollider, createGameTouchControlLayout, gameColliderAabb, gameColliders, gameInputReplayEventsAt, createGameLoopPlan } from "./GameRuntime.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 } from "./GameRuntime.js";
 export { collectGameSceneRuntimeNodes, createGameSceneBridge, createRuntimeNodeSpec } from "./GameSceneBridge.js";
 export { calculateRuntimeNodeBounds, createRuntimeNodeEffectAttachment, runtimeNodeHasTag } from "./RuntimeNodeHandle.js";
 export { createFightingGameKit, fighting, fighterRuntimeNode } from "./game-kits/fighting.js";
@@ -39,6 +84,8 @@ export * from "./PromptAnimationEvidence.js";
 export * from "./CartoonDirector.js";
 export * from "./CartoonPerformance.js";
 export * from "./CartoonRenderQueue.js";
+export * from "./CartoonAssetManifest.js";
+export * from "./AssetLibraryBrowser.js";
 const auraAssetRefBrand = Symbol("AuraAssetRef");
 export function defineAuraAssets(definitions) {
     const refs = {};
@@ -3163,8 +3210,13 @@ export const game = {
     runtimeNode: createRuntimeNodeSpec,
     input: createGameInput,
     inputReplay: createGameInputReplay,
+    exportReplay: exportGameInputReplay,
+    importReplay: importGameInputReplay,
     inputReplayDriver: createGameInputReplayDriver,
     inputReplayEventsAt: gameInputReplayEventsAt,
+    simulation: createGameSimulation,
+    runSimulation: runGameSimulation,
+    inspector: createGameInspector,
     touchControls: createGameTouchControlLayout,
     kinematicBody: createGameKinematicBody,
     jumpAssist: createGameJumpAssist,
@@ -3239,6 +3291,12 @@ export const cartoon = {
     performance: createCartoonPerformance,
     renderQueue: createCartoonRenderQueue,
     renderOutputPackage: createCartoonRenderOutputPackageMetadata,
+    motionQuality: createCartoonMotionQualityReport,
+    validateMotionQuality: validateCartoonMotionQuality,
+    routeProof: createCartoonRouteProof,
+    validateRouteProof: validateCartoonRouteProof,
+    episodePackage: createCartoonEpisodePackageManifest,
+    validateEpisodePackage: validateCartoonEpisodePackage,
     evidence: collectPromptAnimationEvidence
 };
 export const animationStudio = cartoon;
@@ -4907,6 +4965,51 @@ function promptPlanWarnings(plan) {
     }
     return warnings;
 }
+export function createRuntimeNodeImportedAssetEvidence(input) {
+    const clips = [...new Set(input.clips ?? [])];
+    const bones = [...new Set(input.skeletonBones ?? [])];
+    const morphTargets = [...new Set(input.morphTargets ?? [])];
+    const diagnostics = [];
+    for (const clip of input.requiredClips ?? []) {
+        if (!clips.includes(clip))
+            diagnostics.push({ severity: "error", code: "missing-clip", message: `Missing imported animation clip "${clip}".` });
+    }
+    for (const bone of input.requiredBones ?? []) {
+        if (!bones.includes(bone))
+            diagnostics.push({ severity: "error", code: "missing-bone", message: `Missing imported skeleton bone "${bone}".` });
+    }
+    for (const morph of input.requiredMorphTargets ?? []) {
+        if (!morphTargets.includes(morph))
+            diagnostics.push({ severity: "error", code: "missing-morph", message: `Missing imported morph target "${morph}".` });
+    }
+    if (bones.length === 0)
+        diagnostics.push({ severity: "warning", code: "missing-skeleton", message: "Imported asset evidence has no skeleton bones." });
+    if (!input.skinningPalette)
+        diagnostics.push({ severity: "warning", code: "missing-skinning-palette", message: "Imported asset evidence has no skinning palette." });
+    if ((input.renderItemCount ?? 0) < 1)
+        diagnostics.push({ severity: "warning", code: "missing-render-items", message: "Imported asset evidence has no render items." });
+    return {
+        kind: "aura-runtime-node-imported-asset-evidence",
+        assetId: input.assetId,
+        ...(input.nodeId ? { nodeId: input.nodeId } : {}),
+        ...(bones.length > 0 ? { skeleton: { boneCount: bones.length, boneNames: bones } } : {}),
+        clips,
+        ...(input.activeClip ? { activeClip: input.activeClip } : {}),
+        ...(input.skinningPalette ? {
+            skinningPalette: {
+                jointCount: input.skinningPalette.jointCount,
+                matrixCount: input.skinningPalette.matrixCount ?? input.skinningPalette.jointCount,
+                updated: input.skinningPalette.updated ?? true
+            }
+        } : {}),
+        morphTargets,
+        ...(input.bounds ? { bounds: isRuntimeNodeEvidenceBounds(input.bounds) ? input.bounds : calculateRuntimeNodeBounds(input.bounds) } : {}),
+        renderItemCount: input.renderItemCount ?? 0,
+        skinnedRenderItemCount: input.skinnedRenderItemCount ?? 0,
+        morphRenderItemCount: input.morphRenderItemCount ?? 0,
+        diagnostics
+    };
+}
 export class AuraRuntimeError extends Error {
     code;
     constructor(code, message) {
@@ -4961,6 +5064,7 @@ function createRuntimeNodeHandle(node, runtime) {
     let animationBinding;
     let animationPose;
     let animationPoseBinding;
+    let importedAssetEvidence;
     const getVisible = () => node.kind === "model" ? node.visible !== false : node.visible !== false;
     const getBounds = () => calculateRuntimeNodeBounds({
         position: node.position,
@@ -5049,6 +5153,13 @@ function createRuntimeNodeHandle(node, runtime) {
         animationPose() {
             return animationPose ? cloneRuntimeAnimationPose(animationPose) : undefined;
         },
+        setImportedAssetEvidence(evidence) {
+            importedAssetEvidence = evidence ? cloneRuntimeImportedAssetEvidence(evidence) : undefined;
+            return this;
+        },
+        importedAssetEvidence() {
+            return importedAssetEvidence ? cloneRuntimeImportedAssetEvidence(importedAssetEvidence) : undefined;
+        },
         setMorphTarget(name, weight) {
             const normalizedName = name.trim();
             if (!normalizedName) {
@@ -5094,6 +5205,7 @@ function createRuntimeNodeHandle(node, runtime) {
                 animationBinding,
                 animationPose: animationPose ? cloneRuntimeAnimationPose(animationPose) : undefined,
                 animationPoseBinding,
+                importedAssetEvidence: importedAssetEvidence ? cloneRuntimeImportedAssetEvidence(importedAssetEvidence) : undefined,
                 morphTargets: Object.fromEntries(morphTargetWeights.entries()),
                 bounds: getBounds(),
                 effects: [...attachedEffects]
@@ -5121,6 +5233,30 @@ function cloneRuntimeAnimationPose(pose) {
         metadata: pose.metadata ? { ...pose.metadata } : undefined
     };
 }
+function cloneRuntimeImportedAssetEvidence(evidence) {
+    return {
+        ...evidence,
+        skeleton: evidence.skeleton
+            ? { boneCount: evidence.skeleton.boneCount, boneNames: [...evidence.skeleton.boneNames] }
+            : undefined,
+        clips: [...evidence.clips],
+        skinningPalette: evidence.skinningPalette ? { ...evidence.skinningPalette } : undefined,
+        morphTargets: [...evidence.morphTargets],
+        bounds: evidence.bounds
+            ? {
+                ...evidence.bounds,
+                center: [...evidence.bounds.center],
+                size: [...evidence.bounds.size],
+                min: [...evidence.bounds.min],
+                max: [...evidence.bounds.max]
+            }
+            : undefined,
+        diagnostics: evidence.diagnostics.map((diagnostic) => ({ ...diagnostic }))
+    };
+}
+function isRuntimeNodeEvidenceBounds(value) {
+    return value.kind === "aura-runtime-node-bounds";
+}
 function sanitizeRuntimeMorphWeight(weight) {
     if (!Number.isFinite(weight))
         return 0;