@aura3d/engine 1.1.0 → 1.3.0

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

@@ -3,6 +3,7 @@ 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";
@@ -28,7 +29,8 @@ export * from "./YouTubeUploadAdapter.js";
 export * from "./PublishingPipeline.js";
 export * from "./CloudRenderAdapter.js";
 export * from "./BatchEpisodeRenderer.js";
-export * from "./CartoonAssetManifest.js";
+export * from "./AnimationAssetManifest.js";
+export * from "./SceneGroundingUtils.js";
 export * from "./AssetLibraryBrowser.js";
 export * from "./DialogueAlignment.js";
 export * from "./PerformancePoseEditor.js";
@@ -37,9 +39,9 @@ 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";
+export * from "./AnimationMotionQuality.js";
+export * from "./AnimationRouteProof.js";
+export * from "./AnimationEpisodePackage.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, 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";
@@ -51,16 +53,16 @@ import { applyShotPlaybackFrame, createShotPlaybackPlan, createShotTimeline, ins
 import { captionCueAtTime, createCaptionTimingProof, deriveCaptionTrackFromDialogue } from "./DialoguePerformance.js";
 import { createAuraVoiceVisemeTrack, createGlbBlendshapeVisemeCue, createPrimitiveMouthVisemeCues, sampleVisemeTrack } from "./VisemeController.js";
 import { createAuraVoiceBridgePackage, createAuraVoiceDubRerenderProof, createAuraVoiceRerenderPlan, sampleAuraVoiceBridgeAtTime } from "./AuraVoiceBridge.js";
-import { createCartoonDirectorPlan } from "./CartoonDirector.js";
-import { createCartoonPerformance } from "./CartoonPerformance.js";
-import { createCartoonRenderOutputPackageMetadata, createCartoonRenderQueue } from "./CartoonRenderQueue.js";
+import { createAnimationDirectorPlan } from "./AnimationDirector.js";
+import { createAnimationPerformance } from "./AnimationPerformance.js";
+import { createAnimationRenderOutputPackageMetadata, createAnimationRenderQueue } from "./AnimationRenderQueue.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 { createAnimationMotionQualityReport, validateAnimationMotionQuality } from "./AnimationMotionQuality.js";
+import { createAnimationRouteProof, validateAnimationRouteProof } from "./AnimationRouteProof.js";
+import { createAnimationEpisodePackageManifest, validateAnimationEpisodePackage } from "./AnimationEpisodePackage.js";
 import { createGameAppRuntime } from "./GameAppRuntime.js";
 export { Engine } from "../../core/index.js";
-export { analyzeRgbaFrameMotionRegions, createCartoonMaterialStyle, createCartoonRenderPreset, createCartoonVisualQualityReport } from "../../rendering/index.js";
+export { analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport } from "../../rendering/index.js";
 export { asAuraAppHandle, isAuraAppHandle } from "./AuraAppHandle.js";
 export { createGameAppRuntime } from "./GameAppRuntime.js";
 export { FrameLoop, createFrameLoop } from "./FrameLoop.js";
@@ -81,10 +83,11 @@ export * from "./ShotTimeline.js";
 export * from "./DialoguePerformance.js";
 export * from "./VisemeController.js";
 export * from "./PromptAnimationEvidence.js";
-export * from "./CartoonDirector.js";
-export * from "./CartoonPerformance.js";
-export * from "./CartoonRenderQueue.js";
-export * from "./CartoonAssetManifest.js";
+export * from "./AnimationDirector.js";
+export * from "./AnimationPerformance.js";
+export * from "./AnimationRenderQueue.js";
+export * from "./AnimationAssetManifest.js";
+export * from "./SceneGroundingUtils.js";
 export * from "./AssetLibraryBrowser.js";
 const auraAssetRefBrand = Symbol("AuraAssetRef");
 export function defineAuraAssets(definitions) {
@@ -3267,7 +3270,7 @@ export const game = {
     fighting: createFightingGameKit,
     evidence: collectGameRuntimeEvidence
 };
-export const cartoon = {
+export const animation = {
     episodePlan: createPromptAnimationEpisodePlan,
     storyBible: createPromptAnimationStoryBible,
     storyboard: definePromptAnimationStoryboard,
@@ -3287,19 +3290,19 @@ export const cartoon = {
     sampleAuraVoiceBridgeAtTime,
     auraVoiceRerenderPlan: createAuraVoiceRerenderPlan,
     auraVoiceDubRerenderProof: createAuraVoiceDubRerenderProof,
-    director: createCartoonDirectorPlan,
-    performance: createCartoonPerformance,
-    renderQueue: createCartoonRenderQueue,
-    renderOutputPackage: createCartoonRenderOutputPackageMetadata,
-    motionQuality: createCartoonMotionQualityReport,
-    validateMotionQuality: validateCartoonMotionQuality,
-    routeProof: createCartoonRouteProof,
-    validateRouteProof: validateCartoonRouteProof,
-    episodePackage: createCartoonEpisodePackageManifest,
-    validateEpisodePackage: validateCartoonEpisodePackage,
+    director: createAnimationDirectorPlan,
+    performance: createAnimationPerformance,
+    renderQueue: createAnimationRenderQueue,
+    renderOutputPackage: createAnimationRenderOutputPackageMetadata,
+    motionQuality: createAnimationMotionQualityReport,
+    validateMotionQuality: validateAnimationMotionQuality,
+    routeProof: createAnimationRouteProof,
+    validateRouteProof: validateAnimationRouteProof,
+    episodePackage: createAnimationEpisodePackageManifest,
+    validateEpisodePackage: validateAnimationEpisodePackage,
     evidence: collectPromptAnimationEvidence
 };
-export const animationStudio = cartoon;
+export const animationStudio = animation;
 function collectParticleBudgetDiagnostics(nodes) {
     const flattened = groups.flatten(nodes);
     const particleEffects = flattened.filter((node) => node.kind === "effect" && node.effect === "particles");
@@ -3917,7 +3920,7 @@ export const character = {
     lowPolyHumanoid: (options = {}) => createLowPolyHumanoid(options),
     authoredHumanoid: (options = {}) => createAuthoredLowPolyHumanoid(options),
     primitiveHumanoid: (options = {}) => createHierarchicalPrimitiveHumanoid(options),
-    performance: createCartoonPerformance,
+    performance: createAnimationPerformance,
     importedRigRuntime: async (options) => {
         markAuraLazySystemRequested("character-rig", "character.importedRigRuntime");
         const started = performanceNow();
@@ -5181,6 +5184,17 @@ function createRuntimeNodeHandle(node, runtime) {
         morphTargets() {
             return Object.fromEntries(morphTargetWeights.entries());
         },
+        morphInfluence(name, weight) {
+            const normalizedName = name.trim();
+            if (!normalizedName) {
+                throw new AuraRuntimeError("missing-asset", "Aura3D morph target name is required.");
+            }
+            if (weight === undefined) {
+                return morphTargetWeights.get(normalizedName) ?? 0;
+            }
+            morphTargetWeights.set(normalizedName, sanitizeRuntimeMorphWeight(weight));
+            return this;
+        },
         bounds() {
             return getBounds();
         },