A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
refactor(ai): the AI runtimes move to their own subpath
esenginef0d2f98c69d1
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 6a9b7eb56..5663d798d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -23,6 +23,13 @@ published separately; it ships inside the editor.### Changed+- **The AI runtimes are a subpath: `import { NavAgent } from 'esengine/ai'`.** Navigation,+ perception, state machines and behaviour trees were 77KB in every package. What stays on+ `esengine` is the verb vocabulary — `registerAction`, `aiRegistry`, `Blackboard` — because+ an authored event binding and a UI controller register actions with no runtime behind+ them, and the UI-game template does exactly that. A game with no agents now carries 14KB+ of registry instead of 91KB of runtime.+- **Script graphs are a subpath: `import { … } from 'esengine/logic'`.** Same reason astilemaps below: 65 names re-exported as values put the graph compiler and its nodelibrary in every package, 23KB in a game with no graph, plus the asset loader thediff --git a/desktop b/desktopindex 3c4a0b283..8bbc2f7ef 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit 3c4a0b2837b023f26d03c65bf3cbd395b86c59f1+Subproject commit 8bbc2f7efbf0cae84407b68c344435070695a0cddiff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.jsonindex 31b1493b8..fa1217224 100644--- a/docs/astro/src/data/apiStability.generated.json+++ b/docs/astro/src/data/apiStability.generated.json@@ -3,10 +3,10 @@"counts": {"public": 115,"beta": 98,- "experimental": 1835,+ "experimental": 1712,"deprecated": 3},- "total": 2048,+ "total": 1925,"subsystems": [{"id": "ecs",diff --git a/examples/celestial-heights/src/ai/vesper.ts b/examples/celestial-heights/src/ai/vesper.tsindex e032234f7..22993b24b 100644--- a/examples/celestial-heights/src/ai/vesper.ts+++ b/examples/celestial-heights/src/ai/vesper.ts@@ -1,4 +1,5 @@-import { registerAction, registerCondition, Perception, Status } from 'esengine';+import { registerAction, registerCondition } from 'esengine';+import { Perception, Status } from 'esengine/ai';import { Boss, Charge, Summoner } from '../components';// Leaves for assets/ai/vesper.esbt. Vesper reuses the wisps' vocabulary fordiff --git a/examples/celestial-heights/src/ai/wisp.ts b/examples/celestial-heights/src/ai/wisp.tsindex 893e588f3..9f382ac5b 100644--- a/examples/celestial-heights/src/ai/wisp.ts+++ b/examples/celestial-heights/src/ai/wisp.ts@@ -1,8 +1,5 @@-import {- defineSystem, Query, Mut,- registerAction, registerCondition, setNavDestination,- Perception, Status,-} from 'esengine';+import { defineSystem, Query, Mut, registerAction, registerCondition } from 'esengine';+import { setNavDestination, Perception, Status } from 'esengine/ai';import { Facing, Swing } from '../components';// Leaves for assets/ai/wisp.esbt. The tree is authored as data and resolvesdiff --git a/examples/celestial-heights/src/systems/boss.ts b/examples/celestial-heights/src/systems/boss.tsindex 58e7ad509..2172f94e4 100644--- a/examples/celestial-heights/src/systems/boss.ts+++ b/examples/celestial-heights/src/systems/boss.ts@@ -1,8 +1,5 @@-import {- defineSystem, Query, Mut, Res, GetWorld,- Transform, CharacterController2D, Prefabs, Time, Perception,- NavAgent, setNavDestination, stopNavAgent,-} from 'esengine';+import { defineSystem, Query, Mut, Res, GetWorld, Transform, CharacterController2D, Prefabs, Time } from 'esengine';+import { Perception, NavAgent, setNavDestination, stopNavAgent } from 'esengine/ai';import type { Entity } from 'esengine';import { Boss, Charge, Facing, Vitality, Summoner } from '../components';diff --git a/examples/celestial-heights/src/systems/world.ts b/examples/celestial-heights/src/systems/world.tsindex a6702ac6e..89bfb3530 100644--- a/examples/celestial-heights/src/systems/world.ts+++ b/examples/celestial-heights/src/systems/world.ts@@ -1,12 +1,9 @@-import {- defineSystem, Query, Mut, Res, Commands, GetWorld,- Transform, Camera, FollowTarget, RuntimeOnly, Text, Sprite, Prefabs,- Nav, SceneManager, transitionTo,-} from 'esengine';+import { defineSystem, Query, Mut, Res, Commands, GetWorld, Transform, Camera, FollowTarget, RuntimeOnly, Text, Sprite, Prefabs, SceneManager, transitionTo } from 'esengine';+import { Nav } from 'esengine/ai';// Tilemaps are a subpath: a package that imports it carries the subsystem, and// one that does not carries none of it.import { TilemapLayer, navGridFromTilemapLayer } from 'esengine/tilemap';-import { NavGrid } from 'esengine';+import { NavGrid } from 'esengine/ai';import { Area, AreaLabel, Player, Gate, NavGridBuilt, Spawner, Spawned } from '../components';import { session } from '../state';diff --git a/examples/celestial-heights/tsconfig.json b/examples/celestial-heights/tsconfig.jsonindex c46932a2c..90aa72361 100644--- a/examples/celestial-heights/tsconfig.json+++ b/examples/celestial-heights/tsconfig.json@@ -13,6 +13,7 @@"paths": {"esengine": ["./.esengine/sdk/index.d.ts"],"esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],+ "esengine/ai": ["./.esengine/sdk/ai/index.d.ts"],"esengine/tilemap": ["./.esengine/sdk/tilemap/index.d.ts"]}},diff --git a/examples/cutscene/src/systems/gameplay.ts b/examples/cutscene/src/systems/gameplay.tsindex d788dabce..92f026c0f 100644--- a/examples/cutscene/src/systems/gameplay.ts+++ b/examples/cutscene/src/systems/gameplay.ts@@ -1,7 +1,5 @@-import {- defineSystem, Query, Mut, Res, Time, Input, Transform,- StateMachineAgent, AiFsm,-} from 'esengine';+import { defineSystem, Query, Mut, Res, Time, Input, Transform } from 'esengine';+import { StateMachineAgent, AiFsm } from 'esengine/ai';import { HeroControl } from '../components';// The whole cutscene runs in DATA: the director's FSM (assets/ai/director.esfsm)diff --git a/examples/cutscene/tsconfig.json b/examples/cutscene/tsconfig.jsonindex 1f11ff310..90226ed97 100644--- a/examples/cutscene/tsconfig.json+++ b/examples/cutscene/tsconfig.json@@ -12,7 +12,8 @@"rootDir": ".","paths": {"esengine": ["./.esengine/sdk/index.d.ts"],- "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],+ "esengine/ai": ["./.esengine/sdk/ai/index.d.ts"]}},"include": ["src/**/*"],diff --git a/examples/enemy-ai-3d/src/enemy.ts b/examples/enemy-ai-3d/src/enemy.tsindex 30f10b72c..bd63b0ef4 100644--- a/examples/enemy-ai-3d/src/enemy.ts+++ b/examples/enemy-ai-3d/src/enemy.ts@@ -1,7 +1,5 @@-import {- defineSystem, Query, Mut, GetWorld, Transform, Marker, NavAgent, Perception,- setNavDestination, stopNavAgent,-} from 'esengine';+import { defineSystem, Query, Mut, GetWorld, Transform, Marker } from 'esengine';+import { NavAgent, Perception, setNavDestination, stopNavAgent } from 'esengine/ai';import type { Vec3 } from 'esengine';/**diff --git a/examples/enemy-ai-3d/src/player.ts b/examples/enemy-ai-3d/src/player.tsindex 20cc6e2cf..a251e6148 100644--- a/examples/enemy-ai-3d/src/player.ts+++ b/examples/enemy-ai-3d/src/player.ts@@ -1,7 +1,5 @@-import {- defineSystem, Query, Mut, Res, ResMut, Input, Time, Transform, Camera,- CharacterController3D, NavAgent, NavDebugDraw, Physics3DDebugDraw, NavObstacle,-} from 'esengine';+import { defineSystem, Query, Mut, Res, ResMut, Input, Time, Transform, Camera, CharacterController3D, Physics3DDebugDraw } from 'esengine';+import { NavAgent, NavDebugDraw, NavObstacle } from 'esengine/ai';const WALK_SPEED = 340;diff --git a/examples/enemy-ai-3d/tsconfig.json b/examples/enemy-ai-3d/tsconfig.jsonindex 1f11ff310..90226ed97 100644--- a/examples/enemy-ai-3d/tsconfig.json+++ b/examples/enemy-ai-3d/tsconfig.json@@ -12,7 +12,8 @@"rootDir": ".","paths": {"esengine": ["./.esengine/sdk/index.d.ts"],- "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],+ "esengine/ai": ["./.esengine/sdk/ai/index.d.ts"]}},"include": ["src/**/*"],diff --git a/examples/enemy-ai/src/enemy.ts b/examples/enemy-ai/src/enemy.tsindex 39fa5d5ca..1c41f40b3 100644--- a/examples/enemy-ai/src/enemy.ts+++ b/examples/enemy-ai/src/enemy.ts@@ -1,7 +1,5 @@-import {- defineSystem, Res,- registerAction, registerCondition, setNavDestination, Nav, NavGrid, Perception,-} from 'esengine';+import { defineSystem, Res, registerAction, registerCondition } from 'esengine';+import { setNavDestination, Nav, NavGrid, Perception } from 'esengine/ai';// Leaf actions/conditions shared by BOTH brains — the state machine// (assets/ai/enemy.esfsm) and the behavior tree (assets/ai/enemy.esbt) resolvediff --git a/examples/enemy-ai/tsconfig.json b/examples/enemy-ai/tsconfig.jsonindex 1f11ff310..90226ed97 100644--- a/examples/enemy-ai/tsconfig.json+++ b/examples/enemy-ai/tsconfig.json@@ -12,7 +12,8 @@"rootDir": ".","paths": {"esengine": ["./.esengine/sdk/index.d.ts"],- "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],+ "esengine/ai": ["./.esengine/sdk/ai/index.d.ts"]}},"include": ["src/**/*"],diff --git a/pipeline/src/bundle/esengineResolve.ts b/pipeline/src/bundle/esengineResolve.tsindex da4090d01..c66316186 100644--- a/pipeline/src/bundle/esengineResolve.ts+++ b/pipeline/src/bundle/esengineResolve.ts@@ -26,6 +26,7 @@ export const ESENGINE_SUBPATHS: Readonly<Record<string, string>> = {'esengine/spine': 'spine/index.js','esengine/tilemap': 'tilemap/index.js','esengine/logic': 'logic/index.js',+ 'esengine/ai': 'ai/index.js','esengine/dragonbones': 'dragonbones/index.js','esengine/physics': 'physics/index.js','esengine/physics3d': 'physics3d/index.js',diff --git a/pipeline/src/export/exportMiniGame.ts b/pipeline/src/export/exportMiniGame.tsindex cb04adbcb..396c4a199 100644--- a/pipeline/src/export/exportMiniGame.ts+++ b/pipeline/src/export/exportMiniGame.ts@@ -467,10 +467,13 @@ export async function exportMiniGame(profile: MiniGameExportProfile, opts: {// package needs the tilemap subpath.const CONTENT_SUBPATH: Partial<Record<Subsystem, string>> = {tilemap: 'esengine/tilemap',+ ai: 'esengine/ai',};/** …and the ones a document names by asset rather than by component. */const ASSET_SUBPATH: Readonly<Record<string, string>> = {'.esgraph': 'esengine/logic',+ '.esfsm': 'esengine/ai',+ '.esbt': 'esengine/ai',};const usedSubsystems = await contentSubsystems(opts.root, cook.includedPaths);const needed = new Set(sideModules.map((m) => m.id));diff --git a/pipeline/src/project/targetSupport.ts b/pipeline/src/project/targetSupport.tsindex eeb0d8379..ec9e23716 100644--- a/pipeline/src/project/targetSupport.ts+++ b/pipeline/src/project/targetSupport.ts@@ -26,7 +26,7 @@import { NATIVE_PLATFORMS, type ExportPlatform } from './platforms';/** An engine subsystem a build target may lack. */-export type Subsystem = 'text' | 'tilemap' | 'particles' | 'postprocess' | 'physics' | 'spine' | 'video';+export type Subsystem = 'text' | 'tilemap' | 'particles' | 'postprocess' | 'physics' | 'spine' | 'video' | 'ai';/*** The authored vocabulary that puts a subsystem in use: a scene or prefab@@ -46,6 +46,10 @@ export const SUBSYSTEM_COMPONENTS: Readonly<Record<Subsystem, readonly string[]>],spine: ['SpineAnimation'],video: ['Video'],+ ai: [+ 'NavAgent', 'NavArea', 'NavLink', 'NavObstacle', 'NavVolume',+ 'Perceiver', 'Perception', 'StateMachineAgent', 'BehaviorTreeAgent',+ ],};/** Human name, for a message someone packaging a game has to act on. */@@ -57,6 +61,7 @@ export const SUBSYSTEM_LABEL: Readonly<Record<Subsystem, string>> = {physics: 'Physics (Box2D)',spine: 'Spine animation',video: 'Video',+ ai: 'Gameplay AI',};/**diff --git a/pipeline/src/runtime/gameHost.ts b/pipeline/src/runtime/gameHost.tsindex 0911a7a3d..35f523f45 100644--- a/pipeline/src/runtime/gameHost.ts+++ b/pipeline/src/runtime/gameHost.ts@@ -15,12 +15,37 @@ import {createWebApp, setEditorMode, setPlayMode, Assets,indexPackagedManifest, createPackagedAssetSource, applyAssetRefResolvers, initRuntime,HttpBackend, fetchDecodePixels, registerPackagedSideModules,- packagedAppOptions, packagedRuntimeInit, Transform, SceneManager, Nav, UINode,+ packagedAppOptions, packagedRuntimeInit, Transform, SceneManager, UINode,acquireWebGPUDevice, ThirdPersonCamera, CharacterController3D, AnimatorController,Animator, TPC_SPEED, TPC_GROUNDED, Particle, MeleeAttack, Health,- Hunter, NavAgent, Perception, AnimatorRootMotion, Playthrough, Name,+ AnimatorRootMotion, Playthrough, Name,worldResidencyReport, PostProcess, Renderer, Audio, Camera,+ getComponentRegistry,} from 'esengine';++/**+ * A component this host only READS, by the name the registry knows it by.+ * Importing it would put its subsystem in every package the host is in, which+ * is all of them — and this is a probe the verifier calls, not something the+ * game needs to run.+ */+/** The registry's entry for a name, or null where the subsystem is not shipped. */+function optionalDef(name: string): never | null {+ return (getComponentRegistry().get(name) as never | undefined) ?? null;+}++/** How many entities carry a component the package may not ship at all. */+function countOfIn(app: { world: { getEntitiesWithComponents(c: never[]): readonly unknown[] } }, name: string): number {+ const def = optionalDef(name);+ return def === null ? 0 : app.world.getEntitiesWithComponents([def]).length;+}++function optionalRead(app: { world: { has(e: number, c: never): boolean; get(e: number, c: never): unknown } },+ entity: number, name: string): Record<string, never> | null {+ const def = optionalDef(name);+ if (def === null || !app.world.has(entity, def)) return null;+ return app.world.get(entity, def) as Record<string, never>;+}import type {SceneData, AddressableManifest, PackagedGameConfig, RenderSurfaceSource, WorldManifest,} from 'esengine';@@ -374,15 +399,15 @@ async function boot(): Promise<void> {attackId: 0, health: 0,};const enemy = app.world.findEntityByName(enemyName);- if (enemy === null || !app.world.has(enemy, Hunter)) return blank;+ const hunter = enemy === null ? null : optionalRead(app, enemy, 'Hunter');+ if (enemy === null || hunter === null) return blank;// The composed placement is stale until something asks: a reading taken// between frames would otherwise report where the enemy was, beside a// distance computed from where it is.app.world.ensureTransformsComposed();- const hunter = app.world.get(enemy, Hunter);- const sight = app.world.has(enemy, Perception) ? app.world.get(enemy, Perception) : null;- const agent = app.world.has(enemy, NavAgent) ? app.world.get(enemy, NavAgent) : null;+ const sight = optionalRead(app, enemy, 'Perception');+ const agent = optionalRead(app, enemy, 'NavAgent');const body = app.world.has(enemy, CharacterController3D)? app.world.get(enemy, CharacterController3D) : null;const root = app.world.has(enemy, AnimatorRootMotion)@@ -560,7 +585,8 @@ async function boot(): Promise<void> {* game means the route stays right when the level is re-authored.*/pathBetween(fromName: string, toName: string): Array<{ x: number; y: number }> | null {- if (!app.hasResource(Nav)) return null;+ const nav = optionalDef('Nav');+ if (nav === null || !app.hasResource(nav)) return null;const ends = [fromName, toName].map((name) => {const entity = app.world.findEntityByName(name);if (entity === null || !app.world.has(entity, Transform)) return null;@@ -568,7 +594,8 @@ async function boot(): Promise<void> {return { x: p.x, y: p.y };});if (!ends[0] || !ends[1]) return null;- return app.getResource(Nav).findWorldPath(ends[0], ends[1]);+ return (app.getResource(nav) as { findWorldPath(a: { x: number; y: number }, b: { x: number; y: number }): Array<{ x: number; y: number }> | null })+ .findWorldPath(ends[0], ends[1]);},/*** What the last frame's renderer counted — the work a picture cannot show.@@ -719,8 +746,8 @@ async function boot(): Promise<void> {// Rows physics still keeps for entities the world no longer has. A// teardown that forgot one shows up here and nowhere else.stalePhysics,- navAgents: app.world.getEntitiesWithComponents([NavAgent]).length,- hunters: app.world.getEntitiesWithComponents([Hunter]).length,+ navAgents: countOfIn(app, 'NavAgent'),+ hunters: countOfIn(app, 'Hunter'),entities: app.world.entityCount(),};},diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.mdindex bb6cda85f..8a540d3a8 100644--- a/sdk/etc/index.api.md+++ b/sdk/etc/index.api.md@@ -1,7 +1,7 @@# API surface — esengine/index<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 91 beta · 1671 experimental · 3 deprecated+Symbols: 115 public · 91 beta · 1548 experimental · 3 deprecated## ABI_LAYOUT_HASH — const @experimental```@@ -192,11 +192,6 @@ separator: string | undefinedtouches: AiTouchesSource | undefined```-## AiBt — const @experimental-```-ResourceDef<BehaviorTrees>-```-## AiCondition — type @experimental```(ctx: Ctx, bb: Blackboard) => boolean@@ -215,11 +210,6 @@ set: <C extends AnyComponentDef>(component: C, data: ComponentData<C>) => voidworld: World```-## AiFsm — const @experimental-```-ResourceDef<StateMachines>-```-## AiOutputDef — interface @experimental```label: string | undefined@@ -1501,25 +1491,6 @@ touches: SystemTouches | undefinedupdate: ((ctx: BehaviorContext<S>, dt: number) => void) | undefined```-## BehaviorTreeAgent — const @experimental-```-ComponentDef<BehaviorTreeAgentData>-```--## BehaviorTreeAgentData — interface @experimental-```-bt: string-status: string-```--## BehaviorTrees — class @experimental-```-blackboard: (entity: Entity) => Blackboard-status: (entity: Entity) => string | null-static new (states: Map<Entity, BtAgentState>): BehaviorTrees-static prototype: BehaviorTrees-```-## BezierPoints — interface @experimental```p1x: number@@ -1643,75 +1614,6 @@ isSensor: booleanrestitution: number```-## BtDefinition — interface @experimental-```-orphans: BtNode[] | undefined-root: BtNode-```--## BtEdge — interface @experimental-```-from: string-id: string-to: string-```--## BtNode — interface @experimental-```-arg: string | undefined-children: BtNode[] | undefined-count: number | undefined-id: string | undefined-name: string | undefined-params: Record<string, AiParamValue> | undefined-policy: "all" | "one" | undefined-seconds: number | undefined-type: BtNodeType-x: number | undefined-y: number | undefined-```--## BtNodeType — type @experimental-```-| 'sequence' | 'selector' | 'parallel'- // decorators (one child)- | 'inverter' | 'succeeder' | 'repeater' | 'wait'- // leaves- | 'action' | 'condition'-```--## BtPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): BtPlugin-static prototype: BtPlugin-```--## BtRunState — type @experimental-```-Map<string, NodeState>-```--## BuildNavMeshOptions — interface @experimental-```-agentHeight: number | undefined-agentRadius: number | undefined-areas: readonly NavAreaBox[] | undefined-cellHeight: number-cellSize: number-links: readonly NavLinkSegment[] | undefined-max: Vec3-maxEdgeLength: number | undefined-maxSimplificationError: number | undefined-maxSlopeDegrees: number | undefined-maxVertsPerPoly: number | undefined-min: Vec3-minRegionArea: number | undefined-obstacles: readonly NavObstacleBox[] | undefined-stepHeight: number | undefined-```-## BuildProfile — interface @experimental```remoteRoot: string | undefined@@ -2173,12 +2075,6 @@ type: stringuv: { offset: [number, number]; scale: [number, number]; } | undefined```-## Cell — interface @experimental-```-x: number-y: number-```-## CellResidency — type @experimental```'unloaded' | 'preparing' | 'prepared' | 'publishing' | 'resident' | 'unloading'@@ -2367,13 +2263,6 @@ n: [number, number, number]p: [number, number, number]```-## CollectNavGeometryOptions — interface @experimental-```-layers: number | undefined-max: Vec3-min: Vec3-```-## Collider2DInstance — interface @experimental```enabled: boolean@@ -2485,12 +2374,6 @@ static prototype: CommandsInstance'==' | '!=' | '<' | '<=' | '>' | '>=' | 'truthy' | 'falsy'```-## CompiledFsm — interface @experimental-```-initial: string-states: Map<string, FsmState>-```-## Completable — interface @experimental```cancel: () => void@@ -3865,60 +3748,6 @@ text: numbertriangles: number```-## FsmActionRef — type @experimental-```-string | { name: string; arg?: string; params?: Record<string, AiParamValue> }-```--## FsmDefinition — interface @experimental-```-initial: string-states: FsmState[]-```--## FsmEdge — type @experimental-```-from: string-id: string-index: number-to: string-transition: FsmTransition-```--## FsmPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): FsmPlugin-static prototype: FsmPlugin-```--## FsmRunState — interface @experimental-```-current: string-entered: boolean-previous: string | null-```--## FsmState — interface @experimental-```-name: string-onEnter: FsmActionRef | undefined-onExit: FsmActionRef | undefined-onUpdate: FsmActionRef | undefined-transitions: FsmTransition[] | undefined-x: number | undefined-y: number | undefined-```--## FsmTransition — interface @experimental-```-condition: string | undefined-guard: BlackboardGuard | BlackboardGuard[] | undefined-to: string-trigger: string | undefined-```-## GLDebug — const @experimental```{ enable(): void; disable(): void; check(context: string): number; diagnose(): void; }@@ -5453,251 +5282,6 @@ ComponentDef<NameData>value: string```-## Nav — const @experimental-```-ResourceDef<Navigation>-```--## NavAgent — const @experimental-```-ComponentDef<NavAgentData>-```--## NavAgentData — interface @experimental-```-arriveRadius: number-arrived: boolean-hasTarget: boolean-radius: number-repathInterval: number-speed: number-targetX: number-targetY: number-targetZ: number-```--## NavArea — const @experimental-```-ComponentDef<NavAreaData>-```--## NavAreaBox — interface @experimental-```-area: number-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavAreaData — interface @experimental-```-cost: number-enabled: boolean-halfExtents: Vec3-```--## NavDebugDraw — const @experimental-```-ResourceDef<NavDebugDrawConfig>-```--## NavDebugDrawConfig — interface @experimental-```-enabled: boolean-showBorders: boolean-showFaces: boolean-showLinks: boolean-```--## NavGeometry — interface @experimental-```-bodyCount: number-indices: Uint32Array<ArrayBufferLike>-verts: Float32Array<ArrayBufferLike>-```--## NavGrid — class @experimental-```-cellSize: number-cellToWorld: (gx: number, gy: number) => Vec3-clearCosts: () => void-clearObstructions: () => void-clearanceAt: (gx: number, gy: number) => number-costAt: (gx: number, gy: number) => number-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-height: number-inBounds: (gx: number, gy: number) => boolean-index: (gx: number, gy: number) => number-isNavigable: (p: NavPoint) => boolean-isWalkable: (gx: number, gy: number) => boolean-nearestWalkable: (gx: number, gy: number, maxRadius?: number, clearance?: number) => Cell | null-originX: number-originY: number-originZ: number-setCost: (gx: number, gy: number, cost: number) => void-setObstructed: (gx: number, gy: number, obstructed: boolean) => void-setWalkable: (gx: number, gy: number, walkable: boolean) => void-up: Vec3-walkable: Uint8Array<ArrayBufferLike>-width: number-worldToCell: (p: NavPoint) => Cell-static new (opts: NavGridOptions): NavGrid-static prototype: NavGrid-```--## NavGridOptions — interface @experimental-```-cellSize: number-height: number-origin: { x: number; y: number; z?: number; } | undefined-walkable: ArrayLike<number> | undefined-width: number-```--## NavLink — const @experimental-```-ComponentDef<NavLinkData>-```--## NavLinkData — interface @experimental-```-bidirectional: boolean-enabled: boolean-end: Vec3-radius: number-start: Vec3-```--## NavLinkSegment — interface @experimental-```-bidirectional: boolean-end: Vec3-radius: number-start: Vec3-```--## NavMesh — class @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-connect: (segments: readonly NavLinkSegment[]) => void-contains: (p: number, x: number, z: number) => boolean-corner: (p: number, i: number, out: Vec3) => Vec3-costOf: (p: number) => number-describe: (sink: NavSurfaceSink) => void-findPoly: (p: NavPoint, out?: Vec3, snap?: number) => number-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-heightAt: (p: number, x: number, z: number) => number-isNavigable: (p: NavPoint) => boolean-linkCount: number-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-setAreaCost: (area: number, cost: number) => void-snapDistance: number-up: Vec3-vertexCount: (p: number) => number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-static new (data: NavMeshData): NavMesh-static prototype: NavMesh-```--## NavMeshData — interface @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-snapDistance: number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-```--## NavObstacle — const @experimental-```-ComponentDef<NavObstacleData>-```--## NavObstacleBox — interface @experimental-```-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavObstacleData — interface @experimental-```-enabled: boolean-halfExtents: Vec3-```--## NavPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): NavPlugin-static prototype: NavPlugin-```--## NavPoint — interface @experimental-```-x: number-y: number-z: number | undefined-```--## NavQueryOptions — interface @experimental-```-radius: number | undefined-```--## NavSurface — interface @experimental-```-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-isNavigable: (p: NavPoint) => boolean-up: Vec3-```--## NavSurfaceSink — interface @experimental-```-border: (a: Vec3, b: Vec3) => void-face: (corners: readonly Vec3[]) => void-link: (a: Vec3, b: Vec3) => void-```--## NavVolume — const @experimental-```-ComponentDef<NavVolumeData>-```--## NavVolumeData — interface @experimental-```-agentHeight: number-agentRadius: number-cellHeight: number-cellSize: number-halfExtents: Vec3-layers: number-maxSlopeDegrees: number-stepHeight: number-```--## Navigation — class @experimental-```-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-hasSurface: () => boolean-setSurface: (surface: NavSurface | null) => void-surface: NavSurface | null-static new (): Navigation-static prototype: Navigation-```-## NestedPrefabRef — interface @experimental```overrides: PrefabOverride[]@@ -6031,56 +5615,6 @@ x: numberz: number```-## PathfindOptions — interface @experimental-```-clearance: number | undefined-diagonal: boolean | undefined-snapRadius: number | undefined-```--## Perceiver — const @experimental-```-ComponentDef<PerceiverData>-```--## PerceiverData — interface @experimental-```-facingAxis: FacingAxis-fovDegrees: number-losLayers: number-range: number-```--## Perception — const @experimental-```-ComponentDef<PerceptionData>-```--## PerceptionData — interface @experimental-```-dirX: number-dirY: number-dirZ: number-distance: number-targetX: number-targetY: number-targetZ: number-visible: boolean-```--## PerceptionPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): PerceptionPlugin-static prototype: PerceptionPlugin-```--## PerceptionTarget — const @experimental-```-ComponentDef<{}>-```-## Physics2D — const @beta```ResourceDef<Physics2DAPI>@@ -8035,13 +7569,6 @@ world: WorldBuiltinComponentDef<SegmentCollider2DData>```-## SenseResult — interface @experimental-```-dir: Vec3-distance: number-visible: boolean-```-## SensorEvent — interface @experimental```sensorEntity: number@@ -8587,26 +8114,6 @@ reason: stringsite: "variant" | "nested" | "instance"```-## StateMachineAgent — const @experimental-```-ComponentDef<StateMachineAgentData>-```--## StateMachineAgentData — interface @experimental-```-current: string-fsm: string-```--## StateMachines — class @experimental-```-blackboard: (entity: Entity) => Blackboard-fire: (entity: Entity, trigger: string) => void-state: (entity: Entity) => string | null-static new (states: Map<Entity, AgentState>): StateMachines-static prototype: StateMachines-```-## Stats — const @experimental```ResourceDef<FrameStats>@@ -8653,13 +8160,6 @@ position: StatsPosition | undefined'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'```-## Status — enum @experimental-```-Failure = "failure"-Running = "running"-Success = "success"-```-## Stick — const @public```(stick: "left" | "right", pad?: number) => Binding@@ -10487,21 +9987,6 @@ TransformData(requested: RenderBackendRequest, onError?: (message: string) => void): Promise<WebGPUBootResult>```-## actionRefArg — function @experimental-```-(ref: FsmActionRef | undefined): string | undefined-```--## actionRefName — function @experimental-```-(ref: FsmActionRef | undefined): string-```--## actionRefParams — function @experimental-```-(ref: FsmActionRef | undefined): Record<string, AiParamValue> | undefined-```-## activeRemoteRoot — function @experimental```(config: AssetGroupsConfig | null | undefined): string | undefined@@ -10532,16 +10017,6 @@ TransformData(def: AnimatorControllerDef, from: string, to: string, layer?: number): AnimatorControllerDef```-## addBtChild — function @experimental-```-(def: BtDefinition, parentId: string, type: BtNodeType, x?: number, y?: number): BtDefinition-```--## addBtOrphan — function @experimental-```-(def: BtDefinition, type: BtNodeType, x?: number, y?: number): BtDefinition-```-## addNode — function @beta```(g: MaterialGraph, type: GraphNodeType, x: number, y: number): { graph: MaterialGraph; id: string; }@@ -10562,11 +10037,6 @@ TransformData(system: SystemDef): void```-## addState — function @experimental-```-(def: FsmDefinition, name: string, x?: number, y?: number): FsmDefinition-```-## addSystem — function @experimental```(system: SystemDef): void@@ -10582,21 +10052,6 @@ TransformData(schedule: Schedule, system: SystemDef): void```-## addTransition — function @experimental-```-(def: FsmDefinition, from: string, to: string): FsmDefinition-```--## agentBlackboard — function @experimental-```-(states: Map<Entity, AgentState>, entity: Entity): Blackboard-```--## agentBtBlackboard — function @experimental-```-(states: Map<Entity, BtAgentState>, entity: Entity): Blackboard-```-## aiRegistry — const @experimental```AiRegistry<AiContext>@@ -10677,11 +10132,6 @@ AnimationPlugin(def: AnimatorControllerDef): AnimatorScope[]```-## applyAreasToGrid — function @experimental-```-(grid: NavGrid, areas: ReadonlyArray<NavAreaBox & { cost: number; }>): void-```-## applyAssetRefResolvers — function @experimental```(app: App, resolveRef: (ref: string) => string): void@@ -10707,11 +10157,6 @@ AnimationPlugin(source: PrefabData, delta: SourceDelta): PrefabData```-## applyObstaclesToGrid — function @experimental-```-(grid: NavGrid, obstacles: readonly NavObstacleBox[]): void-```-## applyOverrides — function @experimental```(entity: OverrideTarget, overrides: readonly PrefabOverride[] | undefined): void@@ -10832,21 +10277,6 @@ MotionDriver<AnimatorBlend2DMotion>(blend: AnimatorBlend2DMotion, x: number, y: number, out: { weight: number; }[]): void```-## btEdges — function @experimental-```-(def: BtDefinition): BtEdge[]-```--## btNodes — function @experimental-```-(def: BtDefinition): BtNode[]-```--## btPlugin — const @experimental-```-BtPlugin-```-## bucketOverridesByEntity — function @experimental```(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>@@ -10857,11 +10287,6 @@ BtPlugin(input: FrameProfileInput): FrameProfile```-## buildNavMesh — function @experimental-```-(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh-```-## buildText — function @experimental```(init?: TextInit): TextData@@ -10927,11 +10352,6 @@ BtPlugin(module: ESEngineModule): boolean```-## canHaveChildren — function @experimental-```-(type: BtNodeType): boolean-```-## captureFramePixels — function @beta```(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>@@ -10977,21 +10397,11 @@ BtPlugin(): void```-## clearBtStore — function @experimental-```-(): void-```-## clearDrawCallbacks — function @experimental```(): void```-## clearFsmStore — function @experimental-```-(): void-```-## clearProjectSideModules — function @experimental```(): void@@ -11062,26 +10472,6 @@ BtPlugin(): boolean```-## collectNavAreas — function @experimental-```-(world: World): Array<NavAreaBox & { cost: number; }>-```--## collectNavGeometry — function @experimental-```-(world: World, opts: CollectNavGeometryOptions): NavGeometry-```--## collectNavLinks — function @experimental-```-(world: World): NavLinkSegment[]-```--## collectNavObstacles — function @experimental-```-(world: World): NavObstacleBox[]-```-## collectNestedPrefabPaths — function @experimental```(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]@@ -11107,11 +10497,6 @@ BtPlugin(a: DrawRank, b: DrawRank): number```-## compileFsm — function @experimental-```-(def: FsmDefinition): CompiledFsm-```-## compileMaterialGraph — function @beta```(graph: MaterialGraph): string@@ -11182,11 +10567,6 @@ Plugin(textures: string[]): AnimClipAssetData```-## createBtRunState — function @experimental-```-(): BtRunState-```-## createButton — function @experimental```(opts: ButtonOptions): ButtonHandle@@ -11217,11 +10597,6 @@ Plugin(baseUrl: string): SideModuleHost```-## createFsmRunState — function @experimental-```-(fsm: CompiledFsm): FsmRunState-```-## createHeadlessApp — function @beta```(module: ESEngineModule, options?: HeadlessAppOptions): App@@ -11562,16 +10937,6 @@ DragPlugin(): AnimatorAvatar & { version: number; }```-## emptyBt — function @experimental-```-(): BtDefinition-```--## emptyFsm — function @experimental-```-(): FsmDefinition-```-## enableSceneOrigins — function @experimental```(app: App): void@@ -11592,11 +10957,6 @@ DragPlugin(adapter: WebGPUAdapterLike): string[]```-## ensureBtIds — function @experimental-```-(def: BtDefinition): BtDefinition-```-## enterStatePath — function @experimental```(scope: AnimatorScope, name: string): string[]@@ -11697,11 +11057,6 @@ EventBindingPlugin(entities: readonly ExtractEntity[], rootId: number, name: string, makeId?: (sourceId: number) => PrefabEntityId): PrefabData```-## facingFromRotation — function @experimental-```-(rot: Quat, axis?: FacingAxis): Vec3-```-## facingYaw — function @experimental```(direction: Vec3): number@@ -11722,11 +11077,6 @@ EventBindingPlugin(world: World, name: string): Entity | null```-## findPath — function @experimental-```-(grid: NavGrid, start: Cell, goal: Cell, opts?: PathfindOptions): Cell[] | null-```-## fingerprint — function @experimental```(report: DiagnosticReport): string@@ -11782,16 +11132,6 @@ FocusPlugin(frame: CapturedFrame): FrameProfile```-## fsmEdges — function @experimental-```-(def: FsmDefinition): FsmEdge[]-```--## fsmPlugin — const @experimental-```-FsmPlugin-```-## fxPreviewOrPlayMode — function @experimental```(): boolean@@ -11837,11 +11177,6 @@ GameplayPlugin(extensionOrPath: string): AssetTypeEntry | undefined```-## getBt — function @experimental-```-(key: string): BtDefinition | undefined-```-## getComponent — function @experimental```(name: string): AnyComponentDef | undefined@@ -11927,11 +11262,6 @@ GameplayPlugin(): string[]```-## getFsm — function @experimental-```-(key: string): CompiledFsm | undefined-```-## getLogger — function @experimental```(): Logger@@ -12292,11 +11622,6 @@ Logger(value: unknown): value is string```-## makeLosCheck — function @experimental-```-(physics: Physics2DAPI): LosCheck-```-## makeWidgetInteractable — function @experimental```(world: World, entity: Entity, init?: WidgetInteractionInit): void@@ -12312,11 +11637,6 @@ Logger(tag: string, available: readonly string[]): string | null```-## maxChildren — function @experimental-```-(type: BtNodeType): number-```-## meanFrameProfile — function @experimental```(profiles: readonly FrameProfile[]): FrameProfile@@ -12382,11 +11702,6 @@ MeshRendererPlugin(def: AnimatorControllerDef, name: string, x: number, y: number, layer?: number): AnimatorControllerDef```-## moveBtNode — function @experimental-```-(def: BtDefinition, id: string, x: number, y: number): BtDefinition-```-## moveEditorViewFocus — function @experimental```(view: EditorViewData, right: number, up: number, forward?: number): void@@ -12397,44 +11712,14 @@ MeshRendererPlugin(g: MaterialGraph, id: string, x: number, y: number): MaterialGraph```-## moveState — function @experimental-```-(def: FsmDefinition, name: string, x: number, y: number): FsmDefinition-```--## navAreaDigest — function @experimental-```-(areas: ReadonlyArray<NavAreaBox>): number-```--## navGeometryReady — function @experimental-```-(world: World, layers?: number): boolean-```--## navLinkDigest — function @experimental-```-(links: readonly NavLinkSegment[]): number-```--## navObstacleDigest — function @experimental-```-(obstacles: readonly NavObstacleBox[]): number-```--## navPlugin — const @experimental-```-NavPlugin-```-## newMaterialGraph — function @beta```(): MaterialGraph```-## normalizeAngle — function @experimental+## noInput — const @experimental```-(a: number): number+() => InputState```## normalizeBundleMode — function @experimental@@ -12562,11 +11847,6 @@ ParticlePlugin(scene: SceneData, sceneName: string, options: PartitionOptions): WorldPartition | null```-## pathToWorld — function @experimental-```-(grid: NavGrid, path: Cell[]): Vec3[]-```-## percent — const @public```(n: number) => Dimension@@ -12577,11 +11857,6 @@ ParticlePlugin(values: readonly number[], p: number): number```-## perceptionPlugin — const @experimental-```-PerceptionPlugin-```-## persistentEntityRows — function @experimental```(app: App, manifest: WorldManifest): ReadonlyMap<number, Entity>@@ -12847,11 +12122,6 @@ PrefabsPlugin(key: string, def: AnimatorControllerDef): void```-## registerBt — function @experimental-```-(key: string, def: BtDefinition): BtDefinition-```-## registerCensusProbe — function @experimental```(probe: CensusProbe): () => void@@ -12872,11 +12142,6 @@ PrefabsPlugin(id: string, fn: DrawCallback, scene?: string): void```-## registerFsm — function @experimental-```-(key: string, def: FsmDefinition): CompiledFsm-```-## registerPackagedSideModules — function @experimental```(config: Pick<PackagedGameConfig, "sideModules">): void@@ -12947,46 +12212,21 @@ PrefabsPlugin(def: AnimatorControllerDef, from: string, index: number, layer?: number): AnimatorControllerDef```-## removeBtNode — function @experimental-```-(def: BtDefinition, id: string): BtDefinition-```-## removeNode — function @beta```(g: MaterialGraph, id: string): MaterialGraph```-## removeState — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```--## removeTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number): FsmDefinition-```-## renameAnimatorState — function @experimental```(def: AnimatorControllerDef, oldName: string, newName: string, layer?: number): AnimatorControllerDef```-## renameState — function @experimental-```-(def: FsmDefinition, oldName: string, newName: string): FsmDefinition-```-## renderMeshPreview — function @experimental```(module: unknown, mesh: number, w: number, h: number): Promise<ImageData | null>```-## reparentBtNode — function @experimental-```-(def: BtDefinition, id: string, newParentId: string): BtDefinition-```-## replay — function @experimental```(scope: SpeculationScope, body: (commands: CommandsInstance) => SpeculationOutcome): ReplayReport@@ -13177,11 +12417,6 @@ Plugin(forms: PluralForms, count: number, selector: PluralSelector): string```-## senseTarget — function @experimental-```-(observer: Vec3, facing: Vec3, target: Vec3, range: number, halfFov: number, isBlocked?: (from: Vec3, to: Vec3) => boolean): SenseResult-```-## serializeAnimClip — function @experimental```(asset: AnimClipAssetData): Record<string, unknown>@@ -13232,11 +12467,6 @@ ServicesPlugin(def: AnimatorControllerDef, name: string, patch: { speed?: number; loop?: boolean; rootMotion?: boolean; }, layer?: number): AnimatorControllerDef```-## setBtNodeField — function @experimental-```-(def: BtDefinition, id: string, patch: Partial<BtNode>): BtDefinition-```-## setButtonState — function @experimental```(world: World, entity: Entity, state: string): void@@ -13277,11 +12507,6 @@ ServicesPlugin(enabled: boolean): void```-## setInitial — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```-## setLayerState — function @experimental```(a: AnimatorData, index: number, path: string): void@@ -13292,11 +12517,6 @@ ServicesPlugin(level: LogLevel): void```-## setNavDestination — function @experimental-```-(world: World, entity: Entity, target: { x: number; y: number; z?: number; }): void-```-## setPlayMode — function @experimental```(active: boolean): void@@ -13307,11 +12527,6 @@ ServicesPlugin(bytes: number): void```-## setStateHook — function @experimental-```-(def: FsmDefinition, name: string, hook: "onEnter" | "onUpdate" | "onExit", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition-```-## setTextureBudget — function @experimental```(bytes: number): void@@ -13502,21 +12717,6 @@ MotionDriver<AnimatorClipMotion>StatsPlugin```-## stepFsm — function @experimental-```-<Ctx>(fsm: CompiledFsm, run: FsmRunState, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>): boolean-```--## stepPerception — function @experimental-```-(world: PerceptionWorldView, isBlocked?: LosCheck): void-```--## stopNavAgent — function @experimental-```-(world: World, entity: Entity): void-```-## summarizeCapture — function @experimental```(capture: ProfileCapture): CaptureSummary@@ -13572,11 +12772,6 @@ TextPlugin(): ThemeType```-## tickBt — function @experimental-```-<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status-```-## timelinePlugin — const @experimental```TimelinePlugin@@ -13722,11 +12917,6 @@ UIVisibilityPlugin(world: World, aspectRatio: number): void```-## updateTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition-```-## v2 — const @experimental```{ readonly create: (x?: number, y?: number) => Vec2; readonly clone: (a: Vec2) => Vec2; readonly add: (a: Vec2, b: Vec2) => Vec2; readonly sub: (a: Vec2, b: Vec2) => Vec2; readonly scale: (a: Vec2, s: number) => Vec2; readonly mul: (a: Vec2, b: Vec2) => Vec2; readonly neg: (a: Vec2) => Vec2; readonly dot: (a: Vec2, b: Vec2) => number; readonly cross: (a: Vec2, b: Vec2) => number; readonly len: (a: Vec2) => number; readonly len2: (a: Vec2) => number; readonly dist: (a: Vec2, b: Vec2) => number; readonly dist2: (a: Vec2, b: Vec2) => number; readonly normalize: (a: Vec2) => Vec2; readonly lerp: (a: Vec2, b: Vec2, t: number) => Vec2; readonly angle: (a: Vec2) => number; readonly fromAngle: (radians: number, length?: number) => Vec2; readonly rotate: (a: Vec2, radians: number) => Vec2; readonly perp: (a: Vec2) => Vec2; readonly equals: (a: Vec2, b: Vec2, epsilon?: number) => boolean; }diff --git a/sdk/etc/index.native.api.md b/sdk/etc/index.native.api.mdindex 8beccf9dd..b679e57f1 100644--- a/sdk/etc/index.native.api.md+++ b/sdk/etc/index.native.api.md@@ -1,7 +1,7 @@# API surface — esengine/index.native<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 96 beta · 1690 experimental · 3 deprecated+Symbols: 115 public · 96 beta · 1567 experimental · 3 deprecated## ABI_LAYOUT_HASH — const @experimental```@@ -192,11 +192,6 @@ separator: string | undefinedtouches: AiTouchesSource | undefined```-## AiBt — const @experimental-```-ResourceDef<BehaviorTrees>-```-## AiCondition — type @experimental```(ctx: Ctx, bb: Blackboard) => boolean@@ -215,11 +210,6 @@ set: <C extends AnyComponentDef>(component: C, data: ComponentData<C>) => voidworld: World```-## AiFsm — const @experimental-```-ResourceDef<StateMachines>-```-## AiOutputDef — interface @experimental```label: string | undefined@@ -1501,25 +1491,6 @@ touches: SystemTouches | undefinedupdate: ((ctx: BehaviorContext<S>, dt: number) => void) | undefined```-## BehaviorTreeAgent — const @experimental-```-ComponentDef<BehaviorTreeAgentData>-```--## BehaviorTreeAgentData — interface @experimental-```-bt: string-status: string-```--## BehaviorTrees — class @experimental-```-blackboard: (entity: Entity) => Blackboard-status: (entity: Entity) => string | null-static new (states: Map<Entity, BtAgentState>): BehaviorTrees-static prototype: BehaviorTrees-```-## BezierPoints — interface @experimental```p1x: number@@ -1643,75 +1614,6 @@ isSensor: booleanrestitution: number```-## BtDefinition — interface @experimental-```-orphans: BtNode[] | undefined-root: BtNode-```--## BtEdge — interface @experimental-```-from: string-id: string-to: string-```--## BtNode — interface @experimental-```-arg: string | undefined-children: BtNode[] | undefined-count: number | undefined-id: string | undefined-name: string | undefined-params: Record<string, AiParamValue> | undefined-policy: "all" | "one" | undefined-seconds: number | undefined-type: BtNodeType-x: number | undefined-y: number | undefined-```--## BtNodeType — type @experimental-```-| 'sequence' | 'selector' | 'parallel'- // decorators (one child)- | 'inverter' | 'succeeder' | 'repeater' | 'wait'- // leaves- | 'action' | 'condition'-```--## BtPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): BtPlugin-static prototype: BtPlugin-```--## BtRunState — type @experimental-```-Map<string, NodeState>-```--## BuildNavMeshOptions — interface @experimental-```-agentHeight: number | undefined-agentRadius: number | undefined-areas: readonly NavAreaBox[] | undefined-cellHeight: number-cellSize: number-links: readonly NavLinkSegment[] | undefined-max: Vec3-maxEdgeLength: number | undefined-maxSimplificationError: number | undefined-maxSlopeDegrees: number | undefined-maxVertsPerPoly: number | undefined-min: Vec3-minRegionArea: number | undefined-obstacles: readonly NavObstacleBox[] | undefined-stepHeight: number | undefined-```-## BuildProfile — interface @experimental```remoteRoot: string | undefined@@ -2173,12 +2075,6 @@ type: stringuv: { offset: [number, number]; scale: [number, number]; } | undefined```-## Cell — interface @experimental-```-x: number-y: number-```-## CellResidency — type @experimental```'unloaded' | 'preparing' | 'prepared' | 'publishing' | 'resident' | 'unloading'@@ -2367,13 +2263,6 @@ n: [number, number, number]p: [number, number, number]```-## CollectNavGeometryOptions — interface @experimental-```-layers: number | undefined-max: Vec3-min: Vec3-```-## Collider2DInstance — interface @experimental```enabled: boolean@@ -2485,12 +2374,6 @@ static prototype: CommandsInstance'==' | '!=' | '<' | '<=' | '>' | '>=' | 'truthy' | 'falsy'```-## CompiledFsm — interface @experimental-```-initial: string-states: Map<string, FsmState>-```-## Completable — interface @experimental```cancel: () => void@@ -3873,60 +3756,6 @@ text: numbertriangles: number```-## FsmActionRef — type @experimental-```-string | { name: string; arg?: string; params?: Record<string, AiParamValue> }-```--## FsmDefinition — interface @experimental-```-initial: string-states: FsmState[]-```--## FsmEdge — type @experimental-```-from: string-id: string-index: number-to: string-transition: FsmTransition-```--## FsmPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): FsmPlugin-static prototype: FsmPlugin-```--## FsmRunState — interface @experimental-```-current: string-entered: boolean-previous: string | null-```--## FsmState — interface @experimental-```-name: string-onEnter: FsmActionRef | undefined-onExit: FsmActionRef | undefined-onUpdate: FsmActionRef | undefined-transitions: FsmTransition[] | undefined-x: number | undefined-y: number | undefined-```--## FsmTransition — interface @experimental-```-condition: string | undefined-guard: BlackboardGuard | BlackboardGuard[] | undefined-to: string-trigger: string | undefined-```-## GLDebug — const @experimental```{ enable(): void; disable(): void; check(context: string): number; diagnose(): void; }@@ -5631,251 +5460,6 @@ static new (bridge_: NativeBridge): NativePlatformAdapterstatic prototype: NativePlatformAdapter```-## Nav — const @experimental-```-ResourceDef<Navigation>-```--## NavAgent — const @experimental-```-ComponentDef<NavAgentData>-```--## NavAgentData — interface @experimental-```-arriveRadius: number-arrived: boolean-hasTarget: boolean-radius: number-repathInterval: number-speed: number-targetX: number-targetY: number-targetZ: number-```--## NavArea — const @experimental-```-ComponentDef<NavAreaData>-```--## NavAreaBox — interface @experimental-```-area: number-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavAreaData — interface @experimental-```-cost: number-enabled: boolean-halfExtents: Vec3-```--## NavDebugDraw — const @experimental-```-ResourceDef<NavDebugDrawConfig>-```--## NavDebugDrawConfig — interface @experimental-```-enabled: boolean-showBorders: boolean-showFaces: boolean-showLinks: boolean-```--## NavGeometry — interface @experimental-```-bodyCount: number-indices: Uint32Array<ArrayBufferLike>-verts: Float32Array<ArrayBufferLike>-```--## NavGrid — class @experimental-```-cellSize: number-cellToWorld: (gx: number, gy: number) => Vec3-clearCosts: () => void-clearObstructions: () => void-clearanceAt: (gx: number, gy: number) => number-costAt: (gx: number, gy: number) => number-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-height: number-inBounds: (gx: number, gy: number) => boolean-index: (gx: number, gy: number) => number-isNavigable: (p: NavPoint) => boolean-isWalkable: (gx: number, gy: number) => boolean-nearestWalkable: (gx: number, gy: number, maxRadius?: number, clearance?: number) => Cell | null-originX: number-originY: number-originZ: number-setCost: (gx: number, gy: number, cost: number) => void-setObstructed: (gx: number, gy: number, obstructed: boolean) => void-setWalkable: (gx: number, gy: number, walkable: boolean) => void-up: Vec3-walkable: Uint8Array<ArrayBufferLike>-width: number-worldToCell: (p: NavPoint) => Cell-static new (opts: NavGridOptions): NavGrid-static prototype: NavGrid-```--## NavGridOptions — interface @experimental-```-cellSize: number-height: number-origin: { x: number; y: number; z?: number; } | undefined-walkable: ArrayLike<number> | undefined-width: number-```--## NavLink — const @experimental-```-ComponentDef<NavLinkData>-```--## NavLinkData — interface @experimental-```-bidirectional: boolean-enabled: boolean-end: Vec3-radius: number-start: Vec3-```--## NavLinkSegment — interface @experimental-```-bidirectional: boolean-end: Vec3-radius: number-start: Vec3-```--## NavMesh — class @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-connect: (segments: readonly NavLinkSegment[]) => void-contains: (p: number, x: number, z: number) => boolean-corner: (p: number, i: number, out: Vec3) => Vec3-costOf: (p: number) => number-describe: (sink: NavSurfaceSink) => void-findPoly: (p: NavPoint, out?: Vec3, snap?: number) => number-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-heightAt: (p: number, x: number, z: number) => number-isNavigable: (p: NavPoint) => boolean-linkCount: number-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-setAreaCost: (area: number, cost: number) => void-snapDistance: number-up: Vec3-vertexCount: (p: number) => number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-static new (data: NavMeshData): NavMesh-static prototype: NavMesh-```--## NavMeshData — interface @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-snapDistance: number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-```--## NavObstacle — const @experimental-```-ComponentDef<NavObstacleData>-```--## NavObstacleBox — interface @experimental-```-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavObstacleData — interface @experimental-```-enabled: boolean-halfExtents: Vec3-```--## NavPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): NavPlugin-static prototype: NavPlugin-```--## NavPoint — interface @experimental-```-x: number-y: number-z: number | undefined-```--## NavQueryOptions — interface @experimental-```-radius: number | undefined-```--## NavSurface — interface @experimental-```-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-isNavigable: (p: NavPoint) => boolean-up: Vec3-```--## NavSurfaceSink — interface @experimental-```-border: (a: Vec3, b: Vec3) => void-face: (corners: readonly Vec3[]) => void-link: (a: Vec3, b: Vec3) => void-```--## NavVolume — const @experimental-```-ComponentDef<NavVolumeData>-```--## NavVolumeData — interface @experimental-```-agentHeight: number-agentRadius: number-cellHeight: number-cellSize: number-halfExtents: Vec3-layers: number-maxSlopeDegrees: number-stepHeight: number-```--## Navigation — class @experimental-```-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-hasSurface: () => boolean-setSurface: (surface: NavSurface | null) => void-surface: NavSurface | null-static new (): Navigation-static prototype: Navigation-```-## NestedPrefabRef — interface @experimental```overrides: PrefabOverride[]@@ -6214,56 +5798,6 @@ x: numberz: number```-## PathfindOptions — interface @experimental-```-clearance: number | undefined-diagonal: boolean | undefined-snapRadius: number | undefined-```--## Perceiver — const @experimental-```-ComponentDef<PerceiverData>-```--## PerceiverData — interface @experimental-```-facingAxis: FacingAxis-fovDegrees: number-losLayers: number-range: number-```--## Perception — const @experimental-```-ComponentDef<PerceptionData>-```--## PerceptionData — interface @experimental-```-dirX: number-dirY: number-dirZ: number-distance: number-targetX: number-targetY: number-targetZ: number-visible: boolean-```--## PerceptionPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): PerceptionPlugin-static prototype: PerceptionPlugin-```--## PerceptionTarget — const @experimental-```-ComponentDef<{}>-```-## Physics2D — const @beta```ResourceDef<Physics2DAPI>@@ -8228,13 +7762,6 @@ world: WorldBuiltinComponentDef<SegmentCollider2DData>```-## SenseResult — interface @experimental-```-dir: Vec3-distance: number-visible: boolean-```-## SensorEvent — interface @experimental```sensorEntity: number@@ -8780,26 +8307,6 @@ reason: stringsite: "variant" | "nested" | "instance"```-## StateMachineAgent — const @experimental-```-ComponentDef<StateMachineAgentData>-```--## StateMachineAgentData — interface @experimental-```-current: string-fsm: string-```--## StateMachines — class @experimental-```-blackboard: (entity: Entity) => Blackboard-fire: (entity: Entity, trigger: string) => void-state: (entity: Entity) => string | null-static new (states: Map<Entity, AgentState>): StateMachines-static prototype: StateMachines-```-## Stats — const @experimental```ResourceDef<FrameStats>@@ -8846,13 +8353,6 @@ position: StatsPosition | undefined'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'```-## Status — enum @experimental-```-Failure = "failure"-Running = "running"-Success = "success"-```-## Stick — const @public```(stick: "left" | "right", pad?: number) => Binding@@ -10680,21 +10180,6 @@ TransformData(requested: RenderBackendRequest, onError?: (message: string) => void): Promise<WebGPUBootResult>```-## actionRefArg — function @experimental-```-(ref: FsmActionRef | undefined): string | undefined-```--## actionRefName — function @experimental-```-(ref: FsmActionRef | undefined): string-```--## actionRefParams — function @experimental-```-(ref: FsmActionRef | undefined): Record<string, AiParamValue> | undefined-```-## activeRemoteRoot — function @experimental```(config: AssetGroupsConfig | null | undefined): string | undefined@@ -10725,16 +10210,6 @@ TransformData(def: AnimatorControllerDef, from: string, to: string, layer?: number): AnimatorControllerDef```-## addBtChild — function @experimental-```-(def: BtDefinition, parentId: string, type: BtNodeType, x?: number, y?: number): BtDefinition-```--## addBtOrphan — function @experimental-```-(def: BtDefinition, type: BtNodeType, x?: number, y?: number): BtDefinition-```-## addNode — function @beta```(g: MaterialGraph, type: GraphNodeType, x: number, y: number): { graph: MaterialGraph; id: string; }@@ -10755,11 +10230,6 @@ TransformData(system: SystemDef): void```-## addState — function @experimental-```-(def: FsmDefinition, name: string, x?: number, y?: number): FsmDefinition-```-## addSystem — function @experimental```(system: SystemDef): void@@ -10775,21 +10245,6 @@ TransformData(schedule: Schedule, system: SystemDef): void```-## addTransition — function @experimental-```-(def: FsmDefinition, from: string, to: string): FsmDefinition-```--## agentBlackboard — function @experimental-```-(states: Map<Entity, AgentState>, entity: Entity): Blackboard-```--## agentBtBlackboard — function @experimental-```-(states: Map<Entity, BtAgentState>, entity: Entity): Blackboard-```-## aiRegistry — const @experimental```AiRegistry<AiContext>@@ -10870,11 +10325,6 @@ AnimationPlugin(def: AnimatorControllerDef): AnimatorScope[]```-## applyAreasToGrid — function @experimental-```-(grid: NavGrid, areas: ReadonlyArray<NavAreaBox & { cost: number; }>): void-```-## applyAssetRefResolvers — function @experimental```(app: App, resolveRef: (ref: string) => string): void@@ -10900,11 +10350,6 @@ AnimationPlugin(source: PrefabData, delta: SourceDelta): PrefabData```-## applyObstaclesToGrid — function @experimental-```-(grid: NavGrid, obstacles: readonly NavObstacleBox[]): void-```-## applyOverrides — function @experimental```(entity: OverrideTarget, overrides: readonly PrefabOverride[] | undefined): void@@ -11040,21 +10485,6 @@ MotionDriver<AnimatorBlend2DMotion>(blend: AnimatorBlend2DMotion, x: number, y: number, out: { weight: number; }[]): void```-## btEdges — function @experimental-```-(def: BtDefinition): BtEdge[]-```--## btNodes — function @experimental-```-(def: BtDefinition): BtNode[]-```--## btPlugin — const @experimental-```-BtPlugin-```-## bucketOverridesByEntity — function @experimental```(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>@@ -11065,11 +10495,6 @@ BtPlugin(input: FrameProfileInput): FrameProfile```-## buildNavMesh — function @experimental-```-(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh-```-## buildText — function @experimental```(init?: TextInit): TextData@@ -11135,11 +10560,6 @@ BtPlugin(module: ESEngineModule): boolean```-## canHaveChildren — function @experimental-```-(type: BtNodeType): boolean-```-## captureFramePixels — function @beta```(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>@@ -11185,21 +10605,11 @@ BtPlugin(): void```-## clearBtStore — function @experimental-```-(): void-```-## clearDrawCallbacks — function @experimental```(): void```-## clearFsmStore — function @experimental-```-(): void-```-## clearProjectSideModules — function @experimental```(): void@@ -11270,26 +10680,6 @@ BtPlugin(): boolean```-## collectNavAreas — function @experimental-```-(world: World): Array<NavAreaBox & { cost: number; }>-```--## collectNavGeometry — function @experimental-```-(world: World, opts: CollectNavGeometryOptions): NavGeometry-```--## collectNavLinks — function @experimental-```-(world: World): NavLinkSegment[]-```--## collectNavObstacles — function @experimental-```-(world: World): NavObstacleBox[]-```-## collectNestedPrefabPaths — function @experimental```(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]@@ -11315,11 +10705,6 @@ BtPlugin(a: DrawRank, b: DrawRank): number```-## compileFsm — function @experimental-```-(def: FsmDefinition): CompiledFsm-```-## compileMaterialGraph — function @beta```(graph: MaterialGraph): string@@ -11390,11 +10775,6 @@ Plugin(textures: string[]): AnimClipAssetData```-## createBtRunState — function @experimental-```-(): BtRunState-```-## createButton — function @experimental```(opts: ButtonOptions): ButtonHandle@@ -11425,11 +10805,6 @@ Plugin(baseUrl: string): SideModuleHost```-## createFsmRunState — function @experimental-```-(fsm: CompiledFsm): FsmRunState-```-## createHeadlessApp — function @beta```(module: ESEngineModule, options?: HeadlessAppOptions): App@@ -11795,16 +11170,6 @@ DragPlugin(): AnimatorAvatar & { version: number; }```-## emptyBt — function @experimental-```-(): BtDefinition-```--## emptyFsm — function @experimental-```-(): FsmDefinition-```-## enableSceneOrigins — function @experimental```(app: App): void@@ -11825,11 +11190,6 @@ DragPlugin(adapter: WebGPUAdapterLike): string[]```-## ensureBtIds — function @experimental-```-(def: BtDefinition): BtDefinition-```-## enterStatePath — function @experimental```(scope: AnimatorScope, name: string): string[]@@ -11930,11 +11290,6 @@ EventBindingPlugin(entities: readonly ExtractEntity[], rootId: number, name: string, makeId?: (sourceId: number) => PrefabEntityId): PrefabData```-## facingFromRotation — function @experimental-```-(rot: Quat, axis?: FacingAxis): Vec3-```-## facingYaw — function @experimental```(direction: Vec3): number@@ -11955,11 +11310,6 @@ EventBindingPlugin(world: World, name: string): Entity | null```-## findPath — function @experimental-```-(grid: NavGrid, start: Cell, goal: Cell, opts?: PathfindOptions): Cell[] | null-```-## fingerprint — function @experimental```(report: DiagnosticReport): string@@ -12015,16 +11365,6 @@ FocusPlugin(frame: CapturedFrame): FrameProfile```-## fsmEdges — function @experimental-```-(def: FsmDefinition): FsmEdge[]-```--## fsmPlugin — const @experimental-```-FsmPlugin-```-## fxPreviewOrPlayMode — function @experimental```(): boolean@@ -12070,11 +11410,6 @@ GameplayPlugin(extensionOrPath: string): AssetTypeEntry | undefined```-## getBt — function @experimental-```-(key: string): BtDefinition | undefined-```-## getComponent — function @experimental```(name: string): AnyComponentDef | undefined@@ -12160,11 +11495,6 @@ GameplayPlugin(): string[]```-## getFsm — function @experimental-```-(key: string): CompiledFsm | undefined-```-## getLogger — function @experimental```(): Logger@@ -12535,11 +11865,6 @@ Logger(value: unknown): value is string```-## makeLosCheck — function @experimental-```-(physics: Physics2DAPI): LosCheck-```-## makeWidgetInteractable — function @experimental```(world: World, entity: Entity, init?: WidgetInteractionInit): void@@ -12555,11 +11880,6 @@ Logger(tag: string, available: readonly string[]): string | null```-## maxChildren — function @experimental-```-(type: BtNodeType): number-```-## meanFrameProfile — function @experimental```(profiles: readonly FrameProfile[]): FrameProfile@@ -12625,11 +11945,6 @@ MeshRendererPlugin(def: AnimatorControllerDef, name: string, x: number, y: number, layer?: number): AnimatorControllerDef```-## moveBtNode — function @experimental-```-(def: BtDefinition, id: string, x: number, y: number): BtDefinition-```-## moveEditorViewFocus — function @experimental```(view: EditorViewData, right: number, up: number, forward?: number): void@@ -12640,44 +11955,14 @@ MeshRendererPlugin(g: MaterialGraph, id: string, x: number, y: number): MaterialGraph```-## moveState — function @experimental-```-(def: FsmDefinition, name: string, x: number, y: number): FsmDefinition-```--## navAreaDigest — function @experimental-```-(areas: ReadonlyArray<NavAreaBox>): number-```--## navGeometryReady — function @experimental-```-(world: World, layers?: number): boolean-```--## navLinkDigest — function @experimental-```-(links: readonly NavLinkSegment[]): number-```--## navObstacleDigest — function @experimental-```-(obstacles: readonly NavObstacleBox[]): number-```--## navPlugin — const @experimental-```-NavPlugin-```-## newMaterialGraph — function @beta```(): MaterialGraph```-## normalizeAngle — function @experimental+## noInput — const @experimental```-(a: number): number+() => InputState```## normalizeBundleMode — function @experimental@@ -12805,11 +12090,6 @@ ParticlePlugin(scene: SceneData, sceneName: string, options: PartitionOptions): WorldPartition | null```-## pathToWorld — function @experimental-```-(grid: NavGrid, path: Cell[]): Vec3[]-```-## percent — const @public```(n: number) => Dimension@@ -12820,11 +12100,6 @@ ParticlePlugin(values: readonly number[], p: number): number```-## perceptionPlugin — const @experimental-```-PerceptionPlugin-```-## persistentEntityRows — function @experimental```(app: App, manifest: WorldManifest): ReadonlyMap<number, Entity>@@ -13090,11 +12365,6 @@ PrefabsPlugin(key: string, def: AnimatorControllerDef): void```-## registerBt — function @experimental-```-(key: string, def: BtDefinition): BtDefinition-```-## registerCensusProbe — function @experimental```(probe: CensusProbe): () => void@@ -13115,11 +12385,6 @@ PrefabsPlugin(id: string, fn: DrawCallback, scene?: string): void```-## registerFsm — function @experimental-```-(key: string, def: FsmDefinition): CompiledFsm-```-## registerPackagedSideModules — function @experimental```(config: Pick<PackagedGameConfig, "sideModules">): void@@ -13190,46 +12455,21 @@ PrefabsPlugin(def: AnimatorControllerDef, from: string, index: number, layer?: number): AnimatorControllerDef```-## removeBtNode — function @experimental-```-(def: BtDefinition, id: string): BtDefinition-```-## removeNode — function @beta```(g: MaterialGraph, id: string): MaterialGraph```-## removeState — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```--## removeTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number): FsmDefinition-```-## renameAnimatorState — function @experimental```(def: AnimatorControllerDef, oldName: string, newName: string, layer?: number): AnimatorControllerDef```-## renameState — function @experimental-```-(def: FsmDefinition, oldName: string, newName: string): FsmDefinition-```-## renderMeshPreview — function @experimental```(module: unknown, mesh: number, w: number, h: number): Promise<ImageData | null>```-## reparentBtNode — function @experimental-```-(def: BtDefinition, id: string, newParentId: string): BtDefinition-```-## replay — function @experimental```(scope: SpeculationScope, body: (commands: CommandsInstance) => SpeculationOutcome): ReplayReport@@ -13420,11 +12660,6 @@ Plugin(forms: PluralForms, count: number, selector: PluralSelector): string```-## senseTarget — function @experimental-```-(observer: Vec3, facing: Vec3, target: Vec3, range: number, halfFov: number, isBlocked?: (from: Vec3, to: Vec3) => boolean): SenseResult-```-## serializeAnimClip — function @experimental```(asset: AnimClipAssetData): Record<string, unknown>@@ -13475,11 +12710,6 @@ ServicesPlugin(def: AnimatorControllerDef, name: string, patch: { speed?: number; loop?: boolean; rootMotion?: boolean; }, layer?: number): AnimatorControllerDef```-## setBtNodeField — function @experimental-```-(def: BtDefinition, id: string, patch: Partial<BtNode>): BtDefinition-```-## setButtonState — function @experimental```(world: World, entity: Entity, state: string): void@@ -13520,11 +12750,6 @@ ServicesPlugin(enabled: boolean): void```-## setInitial — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```-## setLayerState — function @experimental```(a: AnimatorData, index: number, path: string): void@@ -13535,11 +12760,6 @@ ServicesPlugin(level: LogLevel): void```-## setNavDestination — function @experimental-```-(world: World, entity: Entity, target: { x: number; y: number; z?: number; }): void-```-## setPlayMode — function @experimental```(active: boolean): void@@ -13550,11 +12770,6 @@ ServicesPlugin(bytes: number): void```-## setStateHook — function @experimental-```-(def: FsmDefinition, name: string, hook: "onEnter" | "onUpdate" | "onExit", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition-```-## setTextureBudget — function @experimental```(bytes: number): void@@ -13745,21 +12960,6 @@ MotionDriver<AnimatorClipMotion>StatsPlugin```-## stepFsm — function @experimental-```-<Ctx>(fsm: CompiledFsm, run: FsmRunState, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>): boolean-```--## stepPerception — function @experimental-```-(world: PerceptionWorldView, isBlocked?: LosCheck): void-```--## stopNavAgent — function @experimental-```-(world: World, entity: Entity): void-```-## summarizeCapture — function @experimental```(capture: ProfileCapture): CaptureSummary@@ -13815,11 +13015,6 @@ TextPlugin(): ThemeType```-## tickBt — function @experimental-```-<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status-```-## timelinePlugin — const @experimental```TimelinePlugin@@ -13965,11 +13160,6 @@ UIVisibilityPlugin(world: World, aspectRatio: number): void```-## updateTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition-```-## v2 — const @experimental```{ readonly create: (x?: number, y?: number) => Vec2; readonly clone: (a: Vec2) => Vec2; readonly add: (a: Vec2, b: Vec2) => Vec2; readonly sub: (a: Vec2, b: Vec2) => Vec2; readonly scale: (a: Vec2, s: number) => Vec2; readonly mul: (a: Vec2, b: Vec2) => Vec2; readonly neg: (a: Vec2) => Vec2; readonly dot: (a: Vec2, b: Vec2) => number; readonly cross: (a: Vec2, b: Vec2) => number; readonly len: (a: Vec2) => number; readonly len2: (a: Vec2) => number; readonly dist: (a: Vec2, b: Vec2) => number; readonly dist2: (a: Vec2, b: Vec2) => number; readonly normalize: (a: Vec2) => Vec2; readonly lerp: (a: Vec2, b: Vec2, t: number) => Vec2; readonly angle: (a: Vec2) => number; readonly fromAngle: (radians: number, length?: number) => Vec2; readonly rotate: (a: Vec2, radians: number) => Vec2; readonly perp: (a: Vec2) => Vec2; readonly equals: (a: Vec2, b: Vec2, epsilon?: number) => boolean; }diff --git a/sdk/etc/index.node.api.md b/sdk/etc/index.node.api.mdindex 361516cc5..fdad5354c 100644--- a/sdk/etc/index.node.api.md+++ b/sdk/etc/index.node.api.md@@ -1,7 +1,7 @@# API surface — esengine/index.node<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 93 beta · 1670 experimental · 3 deprecated+Symbols: 115 public · 93 beta · 1547 experimental · 3 deprecated## ANCHOR_AXES — const @experimental```@@ -187,11 +187,6 @@ separator: string | undefinedtouches: AiTouchesSource | undefined```-## AiBt — const @experimental-```-ResourceDef<BehaviorTrees>-```-## AiCondition — type @experimental```(ctx: Ctx, bb: Blackboard) => boolean@@ -210,11 +205,6 @@ set: <C extends AnyComponentDef>(component: C, data: ComponentData<C>) => voidworld: World```-## AiFsm — const @experimental-```-ResourceDef<StateMachines>-```-## AiOutputDef — interface @experimental```label: string | undefined@@ -1496,25 +1486,6 @@ touches: SystemTouches | undefinedupdate: ((ctx: BehaviorContext<S>, dt: number) => void) | undefined```-## BehaviorTreeAgent — const @experimental-```-ComponentDef<BehaviorTreeAgentData>-```--## BehaviorTreeAgentData — interface @experimental-```-bt: string-status: string-```--## BehaviorTrees — class @experimental-```-blackboard: (entity: Entity) => Blackboard-status: (entity: Entity) => string | null-static new (states: Map<Entity, BtAgentState>): BehaviorTrees-static prototype: BehaviorTrees-```-## BezierPoints — interface @experimental```p1x: number@@ -1638,75 +1609,6 @@ isSensor: booleanrestitution: number```-## BtDefinition — interface @experimental-```-orphans: BtNode[] | undefined-root: BtNode-```--## BtEdge — interface @experimental-```-from: string-id: string-to: string-```--## BtNode — interface @experimental-```-arg: string | undefined-children: BtNode[] | undefined-count: number | undefined-id: string | undefined-name: string | undefined-params: Record<string, AiParamValue> | undefined-policy: "all" | "one" | undefined-seconds: number | undefined-type: BtNodeType-x: number | undefined-y: number | undefined-```--## BtNodeType — type @experimental-```-| 'sequence' | 'selector' | 'parallel'- // decorators (one child)- | 'inverter' | 'succeeder' | 'repeater' | 'wait'- // leaves- | 'action' | 'condition'-```--## BtPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): BtPlugin-static prototype: BtPlugin-```--## BtRunState — type @experimental-```-Map<string, NodeState>-```--## BuildNavMeshOptions — interface @experimental-```-agentHeight: number | undefined-agentRadius: number | undefined-areas: readonly NavAreaBox[] | undefined-cellHeight: number-cellSize: number-links: readonly NavLinkSegment[] | undefined-max: Vec3-maxEdgeLength: number | undefined-maxSimplificationError: number | undefined-maxSlopeDegrees: number | undefined-maxVertsPerPoly: number | undefined-min: Vec3-minRegionArea: number | undefined-obstacles: readonly NavObstacleBox[] | undefined-stepHeight: number | undefined-```-## BuildProfile — interface @experimental```remoteRoot: string | undefined@@ -2168,12 +2070,6 @@ type: stringuv: { offset: [number, number]; scale: [number, number]; } | undefined```-## Cell — interface @experimental-```-x: number-y: number-```-## CellResidency — type @experimental```'unloaded' | 'preparing' | 'prepared' | 'publishing' | 'resident' | 'unloading'@@ -2362,13 +2258,6 @@ n: [number, number, number]p: [number, number, number]```-## CollectNavGeometryOptions — interface @experimental-```-layers: number | undefined-max: Vec3-min: Vec3-```-## Collider2DInstance — interface @experimental```enabled: boolean@@ -2480,12 +2369,6 @@ static prototype: CommandsInstance'==' | '!=' | '<' | '<=' | '>' | '>=' | 'truthy' | 'falsy'```-## CompiledFsm — interface @experimental-```-initial: string-states: Map<string, FsmState>-```-## Completable — interface @experimental```cancel: () => void@@ -3860,60 +3743,6 @@ text: numbertriangles: number```-## FsmActionRef — type @experimental-```-string | { name: string; arg?: string; params?: Record<string, AiParamValue> }-```--## FsmDefinition — interface @experimental-```-initial: string-states: FsmState[]-```--## FsmEdge — type @experimental-```-from: string-id: string-index: number-to: string-transition: FsmTransition-```--## FsmPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): FsmPlugin-static prototype: FsmPlugin-```--## FsmRunState — interface @experimental-```-current: string-entered: boolean-previous: string | null-```--## FsmState — interface @experimental-```-name: string-onEnter: FsmActionRef | undefined-onExit: FsmActionRef | undefined-onUpdate: FsmActionRef | undefined-transitions: FsmTransition[] | undefined-x: number | undefined-y: number | undefined-```--## FsmTransition — interface @experimental-```-condition: string | undefined-guard: BlackboardGuard | BlackboardGuard[] | undefined-to: string-trigger: string | undefined-```-## GLDebug — const @experimental```{ enable(): void; disable(): void; check(context: string): number; diagnose(): void; }@@ -5448,251 +5277,6 @@ ComponentDef<NameData>value: string```-## Nav — const @experimental-```-ResourceDef<Navigation>-```--## NavAgent — const @experimental-```-ComponentDef<NavAgentData>-```--## NavAgentData — interface @experimental-```-arriveRadius: number-arrived: boolean-hasTarget: boolean-radius: number-repathInterval: number-speed: number-targetX: number-targetY: number-targetZ: number-```--## NavArea — const @experimental-```-ComponentDef<NavAreaData>-```--## NavAreaBox — interface @experimental-```-area: number-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavAreaData — interface @experimental-```-cost: number-enabled: boolean-halfExtents: Vec3-```--## NavDebugDraw — const @experimental-```-ResourceDef<NavDebugDrawConfig>-```--## NavDebugDrawConfig — interface @experimental-```-enabled: boolean-showBorders: boolean-showFaces: boolean-showLinks: boolean-```--## NavGeometry — interface @experimental-```-bodyCount: number-indices: Uint32Array<ArrayBufferLike>-verts: Float32Array<ArrayBufferLike>-```--## NavGrid — class @experimental-```-cellSize: number-cellToWorld: (gx: number, gy: number) => Vec3-clearCosts: () => void-clearObstructions: () => void-clearanceAt: (gx: number, gy: number) => number-costAt: (gx: number, gy: number) => number-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-height: number-inBounds: (gx: number, gy: number) => boolean-index: (gx: number, gy: number) => number-isNavigable: (p: NavPoint) => boolean-isWalkable: (gx: number, gy: number) => boolean-nearestWalkable: (gx: number, gy: number, maxRadius?: number, clearance?: number) => Cell | null-originX: number-originY: number-originZ: number-setCost: (gx: number, gy: number, cost: number) => void-setObstructed: (gx: number, gy: number, obstructed: boolean) => void-setWalkable: (gx: number, gy: number, walkable: boolean) => void-up: Vec3-walkable: Uint8Array<ArrayBufferLike>-width: number-worldToCell: (p: NavPoint) => Cell-static new (opts: NavGridOptions): NavGrid-static prototype: NavGrid-```--## NavGridOptions — interface @experimental-```-cellSize: number-height: number-origin: { x: number; y: number; z?: number; } | undefined-walkable: ArrayLike<number> | undefined-width: number-```--## NavLink — const @experimental-```-ComponentDef<NavLinkData>-```--## NavLinkData — interface @experimental-```-bidirectional: boolean-enabled: boolean-end: Vec3-radius: number-start: Vec3-```--## NavLinkSegment — interface @experimental-```-bidirectional: boolean-end: Vec3-radius: number-start: Vec3-```--## NavMesh — class @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-connect: (segments: readonly NavLinkSegment[]) => void-contains: (p: number, x: number, z: number) => boolean-corner: (p: number, i: number, out: Vec3) => Vec3-costOf: (p: number) => number-describe: (sink: NavSurfaceSink) => void-findPoly: (p: NavPoint, out?: Vec3, snap?: number) => number-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-heightAt: (p: number, x: number, z: number) => number-isNavigable: (p: NavPoint) => boolean-linkCount: number-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-setAreaCost: (area: number, cost: number) => void-snapDistance: number-up: Vec3-vertexCount: (p: number) => number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-static new (data: NavMeshData): NavMesh-static prototype: NavMesh-```--## NavMeshData — interface @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-snapDistance: number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-```--## NavObstacle — const @experimental-```-ComponentDef<NavObstacleData>-```--## NavObstacleBox — interface @experimental-```-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavObstacleData — interface @experimental-```-enabled: boolean-halfExtents: Vec3-```--## NavPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): NavPlugin-static prototype: NavPlugin-```--## NavPoint — interface @experimental-```-x: number-y: number-z: number | undefined-```--## NavQueryOptions — interface @experimental-```-radius: number | undefined-```--## NavSurface — interface @experimental-```-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-isNavigable: (p: NavPoint) => boolean-up: Vec3-```--## NavSurfaceSink — interface @experimental-```-border: (a: Vec3, b: Vec3) => void-face: (corners: readonly Vec3[]) => void-link: (a: Vec3, b: Vec3) => void-```--## NavVolume — const @experimental-```-ComponentDef<NavVolumeData>-```--## NavVolumeData — interface @experimental-```-agentHeight: number-agentRadius: number-cellHeight: number-cellSize: number-halfExtents: Vec3-layers: number-maxSlopeDegrees: number-stepHeight: number-```--## Navigation — class @experimental-```-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-hasSurface: () => boolean-setSurface: (surface: NavSurface | null) => void-surface: NavSurface | null-static new (): Navigation-static prototype: Navigation-```-## NestedPrefabRef — interface @experimental```overrides: PrefabOverride[]@@ -6026,56 +5610,6 @@ x: numberz: number```-## PathfindOptions — interface @experimental-```-clearance: number | undefined-diagonal: boolean | undefined-snapRadius: number | undefined-```--## Perceiver — const @experimental-```-ComponentDef<PerceiverData>-```--## PerceiverData — interface @experimental-```-facingAxis: FacingAxis-fovDegrees: number-losLayers: number-range: number-```--## Perception — const @experimental-```-ComponentDef<PerceptionData>-```--## PerceptionData — interface @experimental-```-dirX: number-dirY: number-dirZ: number-distance: number-targetX: number-targetY: number-targetZ: number-visible: boolean-```--## PerceptionPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): PerceptionPlugin-static prototype: PerceptionPlugin-```--## PerceptionTarget — const @experimental-```-ComponentDef<{}>-```-## Physics2D — const @beta```ResourceDef<Physics2DAPI>@@ -8030,13 +7564,6 @@ world: WorldBuiltinComponentDef<SegmentCollider2DData>```-## SenseResult — interface @experimental-```-dir: Vec3-distance: number-visible: boolean-```-## SensorEvent — interface @experimental```sensorEntity: number@@ -8582,26 +8109,6 @@ reason: stringsite: "variant" | "nested" | "instance"```-## StateMachineAgent — const @experimental-```-ComponentDef<StateMachineAgentData>-```--## StateMachineAgentData — interface @experimental-```-current: string-fsm: string-```--## StateMachines — class @experimental-```-blackboard: (entity: Entity) => Blackboard-fire: (entity: Entity, trigger: string) => void-state: (entity: Entity) => string | null-static new (states: Map<Entity, AgentState>): StateMachines-static prototype: StateMachines-```-## Stats — const @experimental```ResourceDef<FrameStats>@@ -8648,13 +8155,6 @@ position: StatsPosition | undefined'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'```-## Status — enum @experimental-```-Failure = "failure"-Running = "running"-Success = "success"-```-## Stick — const @public```(stick: "left" | "right", pad?: number) => Binding@@ -10482,21 +9982,6 @@ TransformData(requested: RenderBackendRequest, onError?: (message: string) => void): Promise<WebGPUBootResult>```-## actionRefArg — function @experimental-```-(ref: FsmActionRef | undefined): string | undefined-```--## actionRefName — function @experimental-```-(ref: FsmActionRef | undefined): string-```--## actionRefParams — function @experimental-```-(ref: FsmActionRef | undefined): Record<string, AiParamValue> | undefined-```-## activeRemoteRoot — function @experimental```(config: AssetGroupsConfig | null | undefined): string | undefined@@ -10527,16 +10012,6 @@ TransformData(def: AnimatorControllerDef, from: string, to: string, layer?: number): AnimatorControllerDef```-## addBtChild — function @experimental-```-(def: BtDefinition, parentId: string, type: BtNodeType, x?: number, y?: number): BtDefinition-```--## addBtOrphan — function @experimental-```-(def: BtDefinition, type: BtNodeType, x?: number, y?: number): BtDefinition-```-## addNode — function @beta```(g: MaterialGraph, type: GraphNodeType, x: number, y: number): { graph: MaterialGraph; id: string; }@@ -10557,11 +10032,6 @@ TransformData(system: SystemDef): void```-## addState — function @experimental-```-(def: FsmDefinition, name: string, x?: number, y?: number): FsmDefinition-```-## addSystem — function @experimental```(system: SystemDef): void@@ -10577,21 +10047,6 @@ TransformData(schedule: Schedule, system: SystemDef): void```-## addTransition — function @experimental-```-(def: FsmDefinition, from: string, to: string): FsmDefinition-```--## agentBlackboard — function @experimental-```-(states: Map<Entity, AgentState>, entity: Entity): Blackboard-```--## agentBtBlackboard — function @experimental-```-(states: Map<Entity, BtAgentState>, entity: Entity): Blackboard-```-## aiRegistry — const @experimental```AiRegistry<AiContext>@@ -10672,11 +10127,6 @@ AnimationPlugin(def: AnimatorControllerDef): AnimatorScope[]```-## applyAreasToGrid — function @experimental-```-(grid: NavGrid, areas: ReadonlyArray<NavAreaBox & { cost: number; }>): void-```-## applyAssetRefResolvers — function @experimental```(app: App, resolveRef: (ref: string) => string): void@@ -10702,11 +10152,6 @@ AnimationPlugin(source: PrefabData, delta: SourceDelta): PrefabData```-## applyObstaclesToGrid — function @experimental-```-(grid: NavGrid, obstacles: readonly NavObstacleBox[]): void-```-## applyOverrides — function @experimental```(entity: OverrideTarget, overrides: readonly PrefabOverride[] | undefined): void@@ -10827,21 +10272,6 @@ MotionDriver<AnimatorBlend2DMotion>(blend: AnimatorBlend2DMotion, x: number, y: number, out: { weight: number; }[]): void```-## btEdges — function @experimental-```-(def: BtDefinition): BtEdge[]-```--## btNodes — function @experimental-```-(def: BtDefinition): BtNode[]-```--## btPlugin — const @experimental-```-BtPlugin-```-## bucketOverridesByEntity — function @experimental```(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>@@ -10852,11 +10282,6 @@ BtPlugin(input: FrameProfileInput): FrameProfile```-## buildNavMesh — function @experimental-```-(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh-```-## buildText — function @experimental```(init?: TextInit): TextData@@ -10922,11 +10347,6 @@ BtPlugin(module: ESEngineModule): boolean```-## canHaveChildren — function @experimental-```-(type: BtNodeType): boolean-```-## captureFramePixels — function @beta```(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>@@ -10972,21 +10392,11 @@ BtPlugin(): void```-## clearBtStore — function @experimental-```-(): void-```-## clearDrawCallbacks — function @experimental```(): void```-## clearFsmStore — function @experimental-```-(): void-```-## clearProjectSideModules — function @experimental```(): void@@ -11057,26 +10467,6 @@ BtPlugin(): boolean```-## collectNavAreas — function @experimental-```-(world: World): Array<NavAreaBox & { cost: number; }>-```--## collectNavGeometry — function @experimental-```-(world: World, opts: CollectNavGeometryOptions): NavGeometry-```--## collectNavLinks — function @experimental-```-(world: World): NavLinkSegment[]-```--## collectNavObstacles — function @experimental-```-(world: World): NavObstacleBox[]-```-## collectNestedPrefabPaths — function @experimental```(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]@@ -11102,11 +10492,6 @@ BtPlugin(a: DrawRank, b: DrawRank): number```-## compileFsm — function @experimental-```-(def: FsmDefinition): CompiledFsm-```-## compileMaterialGraph — function @beta```(graph: MaterialGraph): string@@ -11177,11 +10562,6 @@ Plugin(textures: string[]): AnimClipAssetData```-## createBtRunState — function @experimental-```-(): BtRunState-```-## createButton — function @experimental```(opts: ButtonOptions): ButtonHandle@@ -11212,11 +10592,6 @@ Plugin(baseUrl: string): SideModuleHost```-## createFsmRunState — function @experimental-```-(fsm: CompiledFsm): FsmRunState-```-## createHeadlessApp — function @beta```(module: ESEngineModule, options?: HeadlessAppOptions): App@@ -11557,16 +10932,6 @@ DragPlugin(): AnimatorAvatar & { version: number; }```-## emptyBt — function @experimental-```-(): BtDefinition-```--## emptyFsm — function @experimental-```-(): FsmDefinition-```-## enableSceneOrigins — function @experimental```(app: App): void@@ -11587,11 +10952,6 @@ DragPlugin(adapter: WebGPUAdapterLike): string[]```-## ensureBtIds — function @experimental-```-(def: BtDefinition): BtDefinition-```-## enterStatePath — function @experimental```(scope: AnimatorScope, name: string): string[]@@ -11692,11 +11052,6 @@ EventBindingPlugin(entities: readonly ExtractEntity[], rootId: number, name: string, makeId?: (sourceId: number) => PrefabEntityId): PrefabData```-## facingFromRotation — function @experimental-```-(rot: Quat, axis?: FacingAxis): Vec3-```-## facingYaw — function @experimental```(direction: Vec3): number@@ -11717,11 +11072,6 @@ EventBindingPlugin(world: World, name: string): Entity | null```-## findPath — function @experimental-```-(grid: NavGrid, start: Cell, goal: Cell, opts?: PathfindOptions): Cell[] | null-```-## fingerprint — function @experimental```(report: DiagnosticReport): string@@ -11777,16 +11127,6 @@ FocusPlugin(frame: CapturedFrame): FrameProfile```-## fsmEdges — function @experimental-```-(def: FsmDefinition): FsmEdge[]-```--## fsmPlugin — const @experimental-```-FsmPlugin-```-## fxPreviewOrPlayMode — function @experimental```(): boolean@@ -11832,11 +11172,6 @@ GameplayPlugin(extensionOrPath: string): AssetTypeEntry | undefined```-## getBt — function @experimental-```-(key: string): BtDefinition | undefined-```-## getComponent — function @experimental```(name: string): AnyComponentDef | undefined@@ -11922,11 +11257,6 @@ GameplayPlugin(): string[]```-## getFsm — function @experimental-```-(key: string): CompiledFsm | undefined-```-## getLogger — function @experimental```(): Logger@@ -12292,11 +11622,6 @@ Logger(value: unknown): value is string```-## makeLosCheck — function @experimental-```-(physics: Physics2DAPI): LosCheck-```-## makeWidgetInteractable — function @experimental```(world: World, entity: Entity, init?: WidgetInteractionInit): void@@ -12312,11 +11637,6 @@ Logger(tag: string, available: readonly string[]): string | null```-## maxChildren — function @experimental-```-(type: BtNodeType): number-```-## meanFrameProfile — function @experimental```(profiles: readonly FrameProfile[]): FrameProfile@@ -12382,11 +11702,6 @@ MeshRendererPlugin(def: AnimatorControllerDef, name: string, x: number, y: number, layer?: number): AnimatorControllerDef```-## moveBtNode — function @experimental-```-(def: BtDefinition, id: string, x: number, y: number): BtDefinition-```-## moveEditorViewFocus — function @experimental```(view: EditorViewData, right: number, up: number, forward?: number): void@@ -12397,49 +11712,19 @@ MeshRendererPlugin(g: MaterialGraph, id: string, x: number, y: number): MaterialGraph```-## moveState — function @experimental-```-(def: FsmDefinition, name: string, x: number, y: number): FsmDefinition-```--## navAreaDigest — function @experimental-```-(areas: ReadonlyArray<NavAreaBox>): number-```--## navGeometryReady — function @experimental-```-(world: World, layers?: number): boolean-```--## navLinkDigest — function @experimental-```-(links: readonly NavLinkSegment[]): number-```--## navObstacleDigest — function @experimental-```-(obstacles: readonly NavObstacleBox[]): number-```--## navPlugin — const @experimental-```-NavPlugin-```-## newMaterialGraph — function @beta```(): MaterialGraph```-## nodeAdapter — const @beta+## noInput — const @experimental```-NodePlatformAdapter+() => InputState```-## normalizeAngle — function @experimental+## nodeAdapter — const @beta```-(a: number): number+NodePlatformAdapter```## normalizeBundleMode — function @experimental@@ -12567,11 +11852,6 @@ ParticlePlugin(scene: SceneData, sceneName: string, options: PartitionOptions): WorldPartition | null```-## pathToWorld — function @experimental-```-(grid: NavGrid, path: Cell[]): Vec3[]-```-## percent — const @public```(n: number) => Dimension@@ -12582,11 +11862,6 @@ ParticlePlugin(values: readonly number[], p: number): number```-## perceptionPlugin — const @experimental-```-PerceptionPlugin-```-## persistentEntityRows — function @experimental```(app: App, manifest: WorldManifest): ReadonlyMap<number, Entity>@@ -12852,11 +12127,6 @@ PrefabsPlugin(key: string, def: AnimatorControllerDef): void```-## registerBt — function @experimental-```-(key: string, def: BtDefinition): BtDefinition-```-## registerCensusProbe — function @experimental```(probe: CensusProbe): () => void@@ -12877,11 +12147,6 @@ PrefabsPlugin(id: string, fn: DrawCallback, scene?: string): void```-## registerFsm — function @experimental-```-(key: string, def: FsmDefinition): CompiledFsm-```-## registerPackagedSideModules — function @experimental```(config: Pick<PackagedGameConfig, "sideModules">): void@@ -12952,46 +12217,21 @@ PrefabsPlugin(def: AnimatorControllerDef, from: string, index: number, layer?: number): AnimatorControllerDef```-## removeBtNode — function @experimental-```-(def: BtDefinition, id: string): BtDefinition-```-## removeNode — function @beta```(g: MaterialGraph, id: string): MaterialGraph```-## removeState — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```--## removeTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number): FsmDefinition-```-## renameAnimatorState — function @experimental```(def: AnimatorControllerDef, oldName: string, newName: string, layer?: number): AnimatorControllerDef```-## renameState — function @experimental-```-(def: FsmDefinition, oldName: string, newName: string): FsmDefinition-```-## renderMeshPreview — function @experimental```(module: unknown, mesh: number, w: number, h: number): Promise<ImageData | null>```-## reparentBtNode — function @experimental-```-(def: BtDefinition, id: string, newParentId: string): BtDefinition-```-## replay — function @experimental```(scope: SpeculationScope, body: (commands: CommandsInstance) => SpeculationOutcome): ReplayReport@@ -13182,11 +12422,6 @@ Plugin(forms: PluralForms, count: number, selector: PluralSelector): string```-## senseTarget — function @experimental-```-(observer: Vec3, facing: Vec3, target: Vec3, range: number, halfFov: number, isBlocked?: (from: Vec3, to: Vec3) => boolean): SenseResult-```-## serializeAnimClip — function @experimental```(asset: AnimClipAssetData): Record<string, unknown>@@ -13237,11 +12472,6 @@ ServicesPlugin(def: AnimatorControllerDef, name: string, patch: { speed?: number; loop?: boolean; rootMotion?: boolean; }, layer?: number): AnimatorControllerDef```-## setBtNodeField — function @experimental-```-(def: BtDefinition, id: string, patch: Partial<BtNode>): BtDefinition-```-## setButtonState — function @experimental```(world: World, entity: Entity, state: string): void@@ -13282,11 +12512,6 @@ ServicesPlugin(enabled: boolean): void```-## setInitial — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```-## setLayerState — function @experimental```(a: AnimatorData, index: number, path: string): void@@ -13297,11 +12522,6 @@ ServicesPlugin(level: LogLevel): void```-## setNavDestination — function @experimental-```-(world: World, entity: Entity, target: { x: number; y: number; z?: number; }): void-```-## setPlayMode — function @experimental```(active: boolean): void@@ -13312,11 +12532,6 @@ ServicesPlugin(bytes: number): void```-## setStateHook — function @experimental-```-(def: FsmDefinition, name: string, hook: "onEnter" | "onUpdate" | "onExit", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition-```-## setTextureBudget — function @experimental```(bytes: number): void@@ -13507,21 +12722,6 @@ MotionDriver<AnimatorClipMotion>StatsPlugin```-## stepFsm — function @experimental-```-<Ctx>(fsm: CompiledFsm, run: FsmRunState, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>): boolean-```--## stepPerception — function @experimental-```-(world: PerceptionWorldView, isBlocked?: LosCheck): void-```--## stopNavAgent — function @experimental-```-(world: World, entity: Entity): void-```-## summarizeCapture — function @experimental```(capture: ProfileCapture): CaptureSummary@@ -13577,11 +12777,6 @@ TextPlugin(): ThemeType```-## tickBt — function @experimental-```-<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status-```-## timelinePlugin — const @experimental```TimelinePlugin@@ -13727,11 +12922,6 @@ UIVisibilityPlugin(world: World, aspectRatio: number): void```-## updateTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition-```-## v2 — const @experimental```{ readonly create: (x?: number, y?: number) => Vec2; readonly clone: (a: Vec2) => Vec2; readonly add: (a: Vec2, b: Vec2) => Vec2; readonly sub: (a: Vec2, b: Vec2) => Vec2; readonly scale: (a: Vec2, s: number) => Vec2; readonly mul: (a: Vec2, b: Vec2) => Vec2; readonly neg: (a: Vec2) => Vec2; readonly dot: (a: Vec2, b: Vec2) => number; readonly cross: (a: Vec2, b: Vec2) => number; readonly len: (a: Vec2) => number; readonly len2: (a: Vec2) => number; readonly dist: (a: Vec2, b: Vec2) => number; readonly dist2: (a: Vec2, b: Vec2) => number; readonly normalize: (a: Vec2) => Vec2; readonly lerp: (a: Vec2, b: Vec2, t: number) => Vec2; readonly angle: (a: Vec2) => number; readonly fromAngle: (radians: number, length?: number) => Vec2; readonly rotate: (a: Vec2, radians: number) => Vec2; readonly perp: (a: Vec2) => Vec2; readonly equals: (a: Vec2, b: Vec2, epsilon?: number) => boolean; }diff --git a/sdk/etc/minigame.api.md b/sdk/etc/minigame.api.mdindex 857a6a254..1acc4ad1a 100644--- a/sdk/etc/minigame.api.md+++ b/sdk/etc/minigame.api.md@@ -1,7 +1,7 @@# API surface — esengine/minigame<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 91 beta · 1692 experimental · 3 deprecated+Symbols: 115 public · 91 beta · 1569 experimental · 3 deprecated## ANCHOR_AXES — const @experimental```@@ -187,11 +187,6 @@ separator: string | undefinedtouches: AiTouchesSource | undefined```-## AiBt — const @experimental-```-ResourceDef<BehaviorTrees>-```-## AiCondition — type @experimental```(ctx: Ctx, bb: Blackboard) => boolean@@ -210,11 +205,6 @@ set: <C extends AnyComponentDef>(component: C, data: ComponentData<C>) => voidworld: World```-## AiFsm — const @experimental-```-ResourceDef<StateMachines>-```-## AiOutputDef — interface @experimental```label: string | undefined@@ -1496,25 +1486,6 @@ touches: SystemTouches | undefinedupdate: ((ctx: BehaviorContext<S>, dt: number) => void) | undefined```-## BehaviorTreeAgent — const @experimental-```-ComponentDef<BehaviorTreeAgentData>-```--## BehaviorTreeAgentData — interface @experimental-```-bt: string-status: string-```--## BehaviorTrees — class @experimental-```-blackboard: (entity: Entity) => Blackboard-status: (entity: Entity) => string | null-static new (states: Map<Entity, BtAgentState>): BehaviorTrees-static prototype: BehaviorTrees-```-## BezierPoints — interface @experimental```p1x: number@@ -1638,75 +1609,6 @@ isSensor: booleanrestitution: number```-## BtDefinition — interface @experimental-```-orphans: BtNode[] | undefined-root: BtNode-```--## BtEdge — interface @experimental-```-from: string-id: string-to: string-```--## BtNode — interface @experimental-```-arg: string | undefined-children: BtNode[] | undefined-count: number | undefined-id: string | undefined-name: string | undefined-params: Record<string, AiParamValue> | undefined-policy: "all" | "one" | undefined-seconds: number | undefined-type: BtNodeType-x: number | undefined-y: number | undefined-```--## BtNodeType — type @experimental-```-| 'sequence' | 'selector' | 'parallel'- // decorators (one child)- | 'inverter' | 'succeeder' | 'repeater' | 'wait'- // leaves- | 'action' | 'condition'-```--## BtPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): BtPlugin-static prototype: BtPlugin-```--## BtRunState — type @experimental-```-Map<string, NodeState>-```--## BuildNavMeshOptions — interface @experimental-```-agentHeight: number | undefined-agentRadius: number | undefined-areas: readonly NavAreaBox[] | undefined-cellHeight: number-cellSize: number-links: readonly NavLinkSegment[] | undefined-max: Vec3-maxEdgeLength: number | undefined-maxSimplificationError: number | undefined-maxSlopeDegrees: number | undefined-maxVertsPerPoly: number | undefined-min: Vec3-minRegionArea: number | undefined-obstacles: readonly NavObstacleBox[] | undefined-stepHeight: number | undefined-```-## BuildProfile — interface @experimental```remoteRoot: string | undefined@@ -2168,12 +2070,6 @@ type: stringuv: { offset: [number, number]; scale: [number, number]; } | undefined```-## Cell — interface @experimental-```-x: number-y: number-```-## CellResidency — type @experimental```'unloaded' | 'preparing' | 'prepared' | 'publishing' | 'resident' | 'unloading'@@ -2362,13 +2258,6 @@ n: [number, number, number]p: [number, number, number]```-## CollectNavGeometryOptions — interface @experimental-```-layers: number | undefined-max: Vec3-min: Vec3-```-## Collider2DInstance — interface @experimental```enabled: boolean@@ -2480,12 +2369,6 @@ static prototype: CommandsInstance'==' | '!=' | '<' | '<=' | '>' | '>=' | 'truthy' | 'falsy'```-## CompiledFsm — interface @experimental-```-initial: string-states: Map<string, FsmState>-```-## Completable — interface @experimental```cancel: () => void@@ -3860,60 +3743,6 @@ text: numbertriangles: number```-## FsmActionRef — type @experimental-```-string | { name: string; arg?: string; params?: Record<string, AiParamValue> }-```--## FsmDefinition — interface @experimental-```-initial: string-states: FsmState[]-```--## FsmEdge — type @experimental-```-from: string-id: string-index: number-to: string-transition: FsmTransition-```--## FsmPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): FsmPlugin-static prototype: FsmPlugin-```--## FsmRunState — interface @experimental-```-current: string-entered: boolean-previous: string | null-```--## FsmState — interface @experimental-```-name: string-onEnter: FsmActionRef | undefined-onExit: FsmActionRef | undefined-onUpdate: FsmActionRef | undefined-transitions: FsmTransition[] | undefined-x: number | undefined-y: number | undefined-```--## FsmTransition — interface @experimental-```-condition: string | undefined-guard: BlackboardGuard | BlackboardGuard[] | undefined-to: string-trigger: string | undefined-```-## GLDebug — const @experimental```{ enable(): void; disable(): void; check(context: string): number; diagnose(): void; }@@ -5699,251 +5528,6 @@ ComponentDef<NameData>value: string```-## Nav — const @experimental-```-ResourceDef<Navigation>-```--## NavAgent — const @experimental-```-ComponentDef<NavAgentData>-```--## NavAgentData — interface @experimental-```-arriveRadius: number-arrived: boolean-hasTarget: boolean-radius: number-repathInterval: number-speed: number-targetX: number-targetY: number-targetZ: number-```--## NavArea — const @experimental-```-ComponentDef<NavAreaData>-```--## NavAreaBox — interface @experimental-```-area: number-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavAreaData — interface @experimental-```-cost: number-enabled: boolean-halfExtents: Vec3-```--## NavDebugDraw — const @experimental-```-ResourceDef<NavDebugDrawConfig>-```--## NavDebugDrawConfig — interface @experimental-```-enabled: boolean-showBorders: boolean-showFaces: boolean-showLinks: boolean-```--## NavGeometry — interface @experimental-```-bodyCount: number-indices: Uint32Array<ArrayBufferLike>-verts: Float32Array<ArrayBufferLike>-```--## NavGrid — class @experimental-```-cellSize: number-cellToWorld: (gx: number, gy: number) => Vec3-clearCosts: () => void-clearObstructions: () => void-clearanceAt: (gx: number, gy: number) => number-costAt: (gx: number, gy: number) => number-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-height: number-inBounds: (gx: number, gy: number) => boolean-index: (gx: number, gy: number) => number-isNavigable: (p: NavPoint) => boolean-isWalkable: (gx: number, gy: number) => boolean-nearestWalkable: (gx: number, gy: number, maxRadius?: number, clearance?: number) => Cell | null-originX: number-originY: number-originZ: number-setCost: (gx: number, gy: number, cost: number) => void-setObstructed: (gx: number, gy: number, obstructed: boolean) => void-setWalkable: (gx: number, gy: number, walkable: boolean) => void-up: Vec3-walkable: Uint8Array<ArrayBufferLike>-width: number-worldToCell: (p: NavPoint) => Cell-static new (opts: NavGridOptions): NavGrid-static prototype: NavGrid-```--## NavGridOptions — interface @experimental-```-cellSize: number-height: number-origin: { x: number; y: number; z?: number; } | undefined-walkable: ArrayLike<number> | undefined-width: number-```--## NavLink — const @experimental-```-ComponentDef<NavLinkData>-```--## NavLinkData — interface @experimental-```-bidirectional: boolean-enabled: boolean-end: Vec3-radius: number-start: Vec3-```--## NavLinkSegment — interface @experimental-```-bidirectional: boolean-end: Vec3-radius: number-start: Vec3-```--## NavMesh — class @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-connect: (segments: readonly NavLinkSegment[]) => void-contains: (p: number, x: number, z: number) => boolean-corner: (p: number, i: number, out: Vec3) => Vec3-costOf: (p: number) => number-describe: (sink: NavSurfaceSink) => void-findPoly: (p: NavPoint, out?: Vec3, snap?: number) => number-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-heightAt: (p: number, x: number, z: number) => number-isNavigable: (p: NavPoint) => boolean-linkCount: number-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-setAreaCost: (area: number, cost: number) => void-snapDistance: number-up: Vec3-vertexCount: (p: number) => number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-static new (data: NavMeshData): NavMesh-static prototype: NavMesh-```--## NavMeshData — interface @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-snapDistance: number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-```--## NavObstacle — const @experimental-```-ComponentDef<NavObstacleData>-```--## NavObstacleBox — interface @experimental-```-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavObstacleData — interface @experimental-```-enabled: boolean-halfExtents: Vec3-```--## NavPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): NavPlugin-static prototype: NavPlugin-```--## NavPoint — interface @experimental-```-x: number-y: number-z: number | undefined-```--## NavQueryOptions — interface @experimental-```-radius: number | undefined-```--## NavSurface — interface @experimental-```-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-isNavigable: (p: NavPoint) => boolean-up: Vec3-```--## NavSurfaceSink — interface @experimental-```-border: (a: Vec3, b: Vec3) => void-face: (corners: readonly Vec3[]) => void-link: (a: Vec3, b: Vec3) => void-```--## NavVolume — const @experimental-```-ComponentDef<NavVolumeData>-```--## NavVolumeData — interface @experimental-```-agentHeight: number-agentRadius: number-cellHeight: number-cellSize: number-halfExtents: Vec3-layers: number-maxSlopeDegrees: number-stepHeight: number-```--## Navigation — class @experimental-```-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-hasSurface: () => boolean-setSurface: (surface: NavSurface | null) => void-surface: NavSurface | null-static new (): Navigation-static prototype: Navigation-```-## NestedPrefabRef — interface @experimental```overrides: PrefabOverride[]@@ -6277,56 +5861,6 @@ x: numberz: number```-## PathfindOptions — interface @experimental-```-clearance: number | undefined-diagonal: boolean | undefined-snapRadius: number | undefined-```--## Perceiver — const @experimental-```-ComponentDef<PerceiverData>-```--## PerceiverData — interface @experimental-```-facingAxis: FacingAxis-fovDegrees: number-losLayers: number-range: number-```--## Perception — const @experimental-```-ComponentDef<PerceptionData>-```--## PerceptionData — interface @experimental-```-dirX: number-dirY: number-dirZ: number-distance: number-targetX: number-targetY: number-targetZ: number-visible: boolean-```--## PerceptionPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): PerceptionPlugin-static prototype: PerceptionPlugin-```--## PerceptionTarget — const @experimental-```-ComponentDef<{}>-```-## Physics2D — const @beta```ResourceDef<Physics2DAPI>@@ -8281,13 +7815,6 @@ world: WorldBuiltinComponentDef<SegmentCollider2DData>```-## SenseResult — interface @experimental-```-dir: Vec3-distance: number-visible: boolean-```-## SensorEvent — interface @experimental```sensorEntity: number@@ -8833,26 +8360,6 @@ reason: stringsite: "variant" | "nested" | "instance"```-## StateMachineAgent — const @experimental-```-ComponentDef<StateMachineAgentData>-```--## StateMachineAgentData — interface @experimental-```-current: string-fsm: string-```--## StateMachines — class @experimental-```-blackboard: (entity: Entity) => Blackboard-fire: (entity: Entity, trigger: string) => void-state: (entity: Entity) => string | null-static new (states: Map<Entity, AgentState>): StateMachines-static prototype: StateMachines-```-## Stats — const @experimental```ResourceDef<FrameStats>@@ -8899,13 +8406,6 @@ position: StatsPosition | undefined'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'```-## Status — enum @experimental-```-Failure = "failure"-Running = "running"-Success = "success"-```-## Stick — const @public```(stick: "left" | "right", pad?: number) => Binding@@ -10739,21 +10239,6 @@ TransformData(requested: RenderBackendRequest, onError?: (message: string) => void): Promise<WebGPUBootResult>```-## actionRefArg — function @experimental-```-(ref: FsmActionRef | undefined): string | undefined-```--## actionRefName — function @experimental-```-(ref: FsmActionRef | undefined): string-```--## actionRefParams — function @experimental-```-(ref: FsmActionRef | undefined): Record<string, AiParamValue> | undefined-```-## activeRemoteRoot — function @experimental```(config: AssetGroupsConfig | null | undefined): string | undefined@@ -10784,16 +10269,6 @@ TransformData(def: AnimatorControllerDef, from: string, to: string, layer?: number): AnimatorControllerDef```-## addBtChild — function @experimental-```-(def: BtDefinition, parentId: string, type: BtNodeType, x?: number, y?: number): BtDefinition-```--## addBtOrphan — function @experimental-```-(def: BtDefinition, type: BtNodeType, x?: number, y?: number): BtDefinition-```-## addNode — function @beta```(g: MaterialGraph, type: GraphNodeType, x: number, y: number): { graph: MaterialGraph; id: string; }@@ -10814,11 +10289,6 @@ TransformData(system: SystemDef): void```-## addState — function @experimental-```-(def: FsmDefinition, name: string, x?: number, y?: number): FsmDefinition-```-## addSystem — function @experimental```(system: SystemDef): void@@ -10834,21 +10304,6 @@ TransformData(schedule: Schedule, system: SystemDef): void```-## addTransition — function @experimental-```-(def: FsmDefinition, from: string, to: string): FsmDefinition-```--## agentBlackboard — function @experimental-```-(states: Map<Entity, AgentState>, entity: Entity): Blackboard-```--## agentBtBlackboard — function @experimental-```-(states: Map<Entity, BtAgentState>, entity: Entity): Blackboard-```-## aiRegistry — const @experimental```AiRegistry<AiContext>@@ -10929,11 +10384,6 @@ AnimationPlugin(def: AnimatorControllerDef): AnimatorScope[]```-## applyAreasToGrid — function @experimental-```-(grid: NavGrid, areas: ReadonlyArray<NavAreaBox & { cost: number; }>): void-```-## applyAssetRefResolvers — function @experimental```(app: App, resolveRef: (ref: string) => string): void@@ -10959,11 +10409,6 @@ AnimationPlugin(source: PrefabData, delta: SourceDelta): PrefabData```-## applyObstaclesToGrid — function @experimental-```-(grid: NavGrid, obstacles: readonly NavObstacleBox[]): void-```-## applyOverrides — function @experimental```(entity: OverrideTarget, overrides: readonly PrefabOverride[] | undefined): void@@ -11084,21 +10529,6 @@ MotionDriver<AnimatorBlend2DMotion>(blend: AnimatorBlend2DMotion, x: number, y: number, out: { weight: number; }[]): void```-## btEdges — function @experimental-```-(def: BtDefinition): BtEdge[]-```--## btNodes — function @experimental-```-(def: BtDefinition): BtNode[]-```--## btPlugin — const @experimental-```-BtPlugin-```-## bucketOverridesByEntity — function @experimental```(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>@@ -11109,11 +10539,6 @@ BtPlugin(input: FrameProfileInput): FrameProfile```-## buildNavMesh — function @experimental-```-(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh-```-## buildText — function @experimental```(init?: TextInit): TextData@@ -11179,11 +10604,6 @@ BtPlugin(module: ESEngineModule): boolean```-## canHaveChildren — function @experimental-```-(type: BtNodeType): boolean-```-## captureFramePixels — function @beta```(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>@@ -11229,21 +10649,11 @@ BtPlugin(): void```-## clearBtStore — function @experimental-```-(): void-```-## clearDrawCallbacks — function @experimental```(): void```-## clearFsmStore — function @experimental-```-(): void-```-## clearProjectSideModules — function @experimental```(): void@@ -11314,26 +10724,6 @@ BtPlugin(): boolean```-## collectNavAreas — function @experimental-```-(world: World): Array<NavAreaBox & { cost: number; }>-```--## collectNavGeometry — function @experimental-```-(world: World, opts: CollectNavGeometryOptions): NavGeometry-```--## collectNavLinks — function @experimental-```-(world: World): NavLinkSegment[]-```--## collectNavObstacles — function @experimental-```-(world: World): NavObstacleBox[]-```-## collectNestedPrefabPaths — function @experimental```(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]@@ -11359,11 +10749,6 @@ BtPlugin(a: DrawRank, b: DrawRank): number```-## compileFsm — function @experimental-```-(def: FsmDefinition): CompiledFsm-```-## compileMaterialGraph — function @beta```(graph: MaterialGraph): string@@ -11434,11 +10819,6 @@ Plugin(textures: string[]): AnimClipAssetData```-## createBtRunState — function @experimental-```-(): BtRunState-```-## createButton — function @experimental```(opts: ButtonOptions): ButtonHandle@@ -11469,11 +10849,6 @@ Plugin(baseUrl: string): SideModuleHost```-## createFsmRunState — function @experimental-```-(fsm: CompiledFsm): FsmRunState-```-## createHeadlessApp — function @beta```(module: ESEngineModule, options?: HeadlessAppOptions): App@@ -11819,16 +11194,6 @@ DragPlugin(): AnimatorAvatar & { version: number; }```-## emptyBt — function @experimental-```-(): BtDefinition-```--## emptyFsm — function @experimental-```-(): FsmDefinition-```-## enableSceneOrigins — function @experimental```(app: App): void@@ -11849,11 +11214,6 @@ DragPlugin(adapter: WebGPUAdapterLike): string[]```-## ensureBtIds — function @experimental-```-(def: BtDefinition): BtDefinition-```-## enterStatePath — function @experimental```(scope: AnimatorScope, name: string): string[]@@ -11954,11 +11314,6 @@ EventBindingPlugin(entities: readonly ExtractEntity[], rootId: number, name: string, makeId?: (sourceId: number) => PrefabEntityId): PrefabData```-## facingFromRotation — function @experimental-```-(rot: Quat, axis?: FacingAxis): Vec3-```-## facingYaw — function @experimental```(direction: Vec3): number@@ -11979,11 +11334,6 @@ EventBindingPlugin(world: World, name: string): Entity | null```-## findPath — function @experimental-```-(grid: NavGrid, start: Cell, goal: Cell, opts?: PathfindOptions): Cell[] | null-```-## fingerprint — function @experimental```(report: DiagnosticReport): string@@ -12039,16 +11389,6 @@ FocusPlugin(frame: CapturedFrame): FrameProfile```-## fsmEdges — function @experimental-```-(def: FsmDefinition): FsmEdge[]-```--## fsmPlugin — const @experimental-```-FsmPlugin-```-## fxPreviewOrPlayMode — function @experimental```(): boolean@@ -12094,11 +11434,6 @@ GameplayPlugin(extensionOrPath: string): AssetTypeEntry | undefined```-## getBt — function @experimental-```-(key: string): BtDefinition | undefined-```-## getComponent — function @experimental```(name: string): AnyComponentDef | undefined@@ -12184,11 +11519,6 @@ GameplayPlugin(): string[]```-## getFsm — function @experimental-```-(key: string): CompiledFsm | undefined-```-## getLogger — function @experimental```(): Logger@@ -12559,11 +11889,6 @@ Logger(value: unknown): value is string```-## makeLosCheck — function @experimental-```-(physics: Physics2DAPI): LosCheck-```-## makeWidgetInteractable — function @experimental```(world: World, entity: Entity, init?: WidgetInteractionInit): void@@ -12579,11 +11904,6 @@ Logger(tag: string, available: readonly string[]): string | null```-## maxChildren — function @experimental-```-(type: BtNodeType): number-```-## meanFrameProfile — function @experimental```(profiles: readonly FrameProfile[]): FrameProfile@@ -12649,11 +11969,6 @@ MeshRendererPlugin(def: AnimatorControllerDef, name: string, x: number, y: number, layer?: number): AnimatorControllerDef```-## moveBtNode — function @experimental-```-(def: BtDefinition, id: string, x: number, y: number): BtDefinition-```-## moveEditorViewFocus — function @experimental```(view: EditorViewData, right: number, up: number, forward?: number): void@@ -12664,44 +11979,14 @@ MeshRendererPlugin(g: MaterialGraph, id: string, x: number, y: number): MaterialGraph```-## moveState — function @experimental-```-(def: FsmDefinition, name: string, x: number, y: number): FsmDefinition-```--## navAreaDigest — function @experimental-```-(areas: ReadonlyArray<NavAreaBox>): number-```--## navGeometryReady — function @experimental-```-(world: World, layers?: number): boolean-```--## navLinkDigest — function @experimental-```-(links: readonly NavLinkSegment[]): number-```--## navObstacleDigest — function @experimental-```-(obstacles: readonly NavObstacleBox[]): number-```--## navPlugin — const @experimental-```-NavPlugin-```-## newMaterialGraph — function @beta```(): MaterialGraph```-## normalizeAngle — function @experimental+## noInput — const @experimental```-(a: number): number+() => InputState```## normalizeBundleMode — function @experimental@@ -12829,11 +12114,6 @@ ParticlePlugin(scene: SceneData, sceneName: string, options: PartitionOptions): WorldPartition | null```-## pathToWorld — function @experimental-```-(grid: NavGrid, path: Cell[]): Vec3[]-```-## percent — const @public```(n: number) => Dimension@@ -12844,11 +12124,6 @@ ParticlePlugin(values: readonly number[], p: number): number```-## perceptionPlugin — const @experimental-```-PerceptionPlugin-```-## persistentEntityRows — function @experimental```(app: App, manifest: WorldManifest): ReadonlyMap<number, Entity>@@ -13114,11 +12389,6 @@ PrefabsPlugin(key: string, def: AnimatorControllerDef): void```-## registerBt — function @experimental-```-(key: string, def: BtDefinition): BtDefinition-```-## registerCensusProbe — function @experimental```(probe: CensusProbe): () => void@@ -13139,11 +12409,6 @@ PrefabsPlugin(id: string, fn: DrawCallback, scene?: string): void```-## registerFsm — function @experimental-```-(key: string, def: FsmDefinition): CompiledFsm-```-## registerPackagedSideModules — function @experimental```(config: Pick<PackagedGameConfig, "sideModules">): void@@ -13214,46 +12479,21 @@ PrefabsPlugin(def: AnimatorControllerDef, from: string, index: number, layer?: number): AnimatorControllerDef```-## removeBtNode — function @experimental-```-(def: BtDefinition, id: string): BtDefinition-```-## removeNode — function @beta```(g: MaterialGraph, id: string): MaterialGraph```-## removeState — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```--## removeTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number): FsmDefinition-```-## renameAnimatorState — function @experimental```(def: AnimatorControllerDef, oldName: string, newName: string, layer?: number): AnimatorControllerDef```-## renameState — function @experimental-```-(def: FsmDefinition, oldName: string, newName: string): FsmDefinition-```-## renderMeshPreview — function @experimental```(module: unknown, mesh: number, w: number, h: number): Promise<ImageData | null>```-## reparentBtNode — function @experimental-```-(def: BtDefinition, id: string, newParentId: string): BtDefinition-```-## replay — function @experimental```(scope: SpeculationScope, body: (commands: CommandsInstance) => SpeculationOutcome): ReplayReport@@ -13444,11 +12684,6 @@ Plugin(forms: PluralForms, count: number, selector: PluralSelector): string```-## senseTarget — function @experimental-```-(observer: Vec3, facing: Vec3, target: Vec3, range: number, halfFov: number, isBlocked?: (from: Vec3, to: Vec3) => boolean): SenseResult-```-## serializeAnimClip — function @experimental```(asset: AnimClipAssetData): Record<string, unknown>@@ -13499,11 +12734,6 @@ ServicesPlugin(def: AnimatorControllerDef, name: string, patch: { speed?: number; loop?: boolean; rootMotion?: boolean; }, layer?: number): AnimatorControllerDef```-## setBtNodeField — function @experimental-```-(def: BtDefinition, id: string, patch: Partial<BtNode>): BtDefinition-```-## setButtonState — function @experimental```(world: World, entity: Entity, state: string): void@@ -13544,11 +12774,6 @@ ServicesPlugin(enabled: boolean): void```-## setInitial — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```-## setLayerState — function @experimental```(a: AnimatorData, index: number, path: string): void@@ -13559,11 +12784,6 @@ ServicesPlugin(level: LogLevel): void```-## setNavDestination — function @experimental-```-(world: World, entity: Entity, target: { x: number; y: number; z?: number; }): void-```-## setPlayMode — function @experimental```(active: boolean): void@@ -13574,11 +12794,6 @@ ServicesPlugin(bytes: number): void```-## setStateHook — function @experimental-```-(def: FsmDefinition, name: string, hook: "onEnter" | "onUpdate" | "onExit", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition-```-## setTextureBudget — function @experimental```(bytes: number): void@@ -13769,21 +12984,6 @@ MotionDriver<AnimatorClipMotion>StatsPlugin```-## stepFsm — function @experimental-```-<Ctx>(fsm: CompiledFsm, run: FsmRunState, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>): boolean-```--## stepPerception — function @experimental-```-(world: PerceptionWorldView, isBlocked?: LosCheck): void-```--## stopNavAgent — function @experimental-```-(world: World, entity: Entity): void-```-## summarizeCapture — function @experimental```(capture: ProfileCapture): CaptureSummary@@ -13839,11 +13039,6 @@ TextPlugin(): ThemeType```-## tickBt — function @experimental-```-<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status-```-## timelinePlugin — const @experimental```TimelinePlugin@@ -13989,11 +13184,6 @@ UIVisibilityPlugin(world: World, aspectRatio: number): void```-## updateTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition-```-## v2 — const @experimental```{ readonly create: (x?: number, y?: number) => Vec2; readonly clone: (a: Vec2) => Vec2; readonly add: (a: Vec2, b: Vec2) => Vec2; readonly sub: (a: Vec2, b: Vec2) => Vec2; readonly scale: (a: Vec2, s: number) => Vec2; readonly mul: (a: Vec2, b: Vec2) => Vec2; readonly neg: (a: Vec2) => Vec2; readonly dot: (a: Vec2, b: Vec2) => number; readonly cross: (a: Vec2, b: Vec2) => number; readonly len: (a: Vec2) => number; readonly len2: (a: Vec2) => number; readonly dist: (a: Vec2, b: Vec2) => number; readonly dist2: (a: Vec2, b: Vec2) => number; readonly normalize: (a: Vec2) => Vec2; readonly lerp: (a: Vec2, b: Vec2, t: number) => Vec2; readonly angle: (a: Vec2) => number; readonly fromAngle: (radians: number, length?: number) => Vec2; readonly rotate: (a: Vec2, radians: number) => Vec2; readonly perp: (a: Vec2) => Vec2; readonly equals: (a: Vec2, b: Vec2, epsilon?: number) => boolean; }diff --git a/sdk/etc/wechat.api.md b/sdk/etc/wechat.api.mdindex 9fd06c857..c83f5d17d 100644--- a/sdk/etc/wechat.api.md+++ b/sdk/etc/wechat.api.md@@ -1,7 +1,7 @@# API surface — esengine/wechat<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 115 public · 91 beta · 1683 experimental · 3 deprecated+Symbols: 115 public · 91 beta · 1560 experimental · 3 deprecated## ANCHOR_AXES — const @experimental```@@ -187,11 +187,6 @@ separator: string | undefinedtouches: AiTouchesSource | undefined```-## AiBt — const @experimental-```-ResourceDef<BehaviorTrees>-```-## AiCondition — type @experimental```(ctx: Ctx, bb: Blackboard) => boolean@@ -210,11 +205,6 @@ set: <C extends AnyComponentDef>(component: C, data: ComponentData<C>) => voidworld: World```-## AiFsm — const @experimental-```-ResourceDef<StateMachines>-```-## AiOutputDef — interface @experimental```label: string | undefined@@ -1496,25 +1486,6 @@ touches: SystemTouches | undefinedupdate: ((ctx: BehaviorContext<S>, dt: number) => void) | undefined```-## BehaviorTreeAgent — const @experimental-```-ComponentDef<BehaviorTreeAgentData>-```--## BehaviorTreeAgentData — interface @experimental-```-bt: string-status: string-```--## BehaviorTrees — class @experimental-```-blackboard: (entity: Entity) => Blackboard-status: (entity: Entity) => string | null-static new (states: Map<Entity, BtAgentState>): BehaviorTrees-static prototype: BehaviorTrees-```-## BezierPoints — interface @experimental```p1x: number@@ -1638,75 +1609,6 @@ isSensor: booleanrestitution: number```-## BtDefinition — interface @experimental-```-orphans: BtNode[] | undefined-root: BtNode-```--## BtEdge — interface @experimental-```-from: string-id: string-to: string-```--## BtNode — interface @experimental-```-arg: string | undefined-children: BtNode[] | undefined-count: number | undefined-id: string | undefined-name: string | undefined-params: Record<string, AiParamValue> | undefined-policy: "all" | "one" | undefined-seconds: number | undefined-type: BtNodeType-x: number | undefined-y: number | undefined-```--## BtNodeType — type @experimental-```-| 'sequence' | 'selector' | 'parallel'- // decorators (one child)- | 'inverter' | 'succeeder' | 'repeater' | 'wait'- // leaves- | 'action' | 'condition'-```--## BtPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): BtPlugin-static prototype: BtPlugin-```--## BtRunState — type @experimental-```-Map<string, NodeState>-```--## BuildNavMeshOptions — interface @experimental-```-agentHeight: number | undefined-agentRadius: number | undefined-areas: readonly NavAreaBox[] | undefined-cellHeight: number-cellSize: number-links: readonly NavLinkSegment[] | undefined-max: Vec3-maxEdgeLength: number | undefined-maxSimplificationError: number | undefined-maxSlopeDegrees: number | undefined-maxVertsPerPoly: number | undefined-min: Vec3-minRegionArea: number | undefined-obstacles: readonly NavObstacleBox[] | undefined-stepHeight: number | undefined-```-## BuildProfile — interface @experimental```remoteRoot: string | undefined@@ -2168,12 +2070,6 @@ type: stringuv: { offset: [number, number]; scale: [number, number]; } | undefined```-## Cell — interface @experimental-```-x: number-y: number-```-## CellResidency — type @experimental```'unloaded' | 'preparing' | 'prepared' | 'publishing' | 'resident' | 'unloading'@@ -2362,13 +2258,6 @@ n: [number, number, number]p: [number, number, number]```-## CollectNavGeometryOptions — interface @experimental-```-layers: number | undefined-max: Vec3-min: Vec3-```-## Collider2DInstance — interface @experimental```enabled: boolean@@ -2480,12 +2369,6 @@ static prototype: CommandsInstance'==' | '!=' | '<' | '<=' | '>' | '>=' | 'truthy' | 'falsy'```-## CompiledFsm — interface @experimental-```-initial: string-states: Map<string, FsmState>-```-## Completable — interface @experimental```cancel: () => void@@ -3860,60 +3743,6 @@ text: numbertriangles: number```-## FsmActionRef — type @experimental-```-string | { name: string; arg?: string; params?: Record<string, AiParamValue> }-```--## FsmDefinition — interface @experimental-```-initial: string-states: FsmState[]-```--## FsmEdge — type @experimental-```-from: string-id: string-index: number-to: string-transition: FsmTransition-```--## FsmPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): FsmPlugin-static prototype: FsmPlugin-```--## FsmRunState — interface @experimental-```-current: string-entered: boolean-previous: string | null-```--## FsmState — interface @experimental-```-name: string-onEnter: FsmActionRef | undefined-onExit: FsmActionRef | undefined-onUpdate: FsmActionRef | undefined-transitions: FsmTransition[] | undefined-x: number | undefined-y: number | undefined-```--## FsmTransition — interface @experimental-```-condition: string | undefined-guard: BlackboardGuard | BlackboardGuard[] | undefined-to: string-trigger: string | undefined-```-## GLDebug — const @experimental```{ enable(): void; disable(): void; check(context: string): number; diagnose(): void; }@@ -5455,251 +5284,6 @@ ComponentDef<NameData>value: string```-## Nav — const @experimental-```-ResourceDef<Navigation>-```--## NavAgent — const @experimental-```-ComponentDef<NavAgentData>-```--## NavAgentData — interface @experimental-```-arriveRadius: number-arrived: boolean-hasTarget: boolean-radius: number-repathInterval: number-speed: number-targetX: number-targetY: number-targetZ: number-```--## NavArea — const @experimental-```-ComponentDef<NavAreaData>-```--## NavAreaBox — interface @experimental-```-area: number-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavAreaData — interface @experimental-```-cost: number-enabled: boolean-halfExtents: Vec3-```--## NavDebugDraw — const @experimental-```-ResourceDef<NavDebugDrawConfig>-```--## NavDebugDrawConfig — interface @experimental-```-enabled: boolean-showBorders: boolean-showFaces: boolean-showLinks: boolean-```--## NavGeometry — interface @experimental-```-bodyCount: number-indices: Uint32Array<ArrayBufferLike>-verts: Float32Array<ArrayBufferLike>-```--## NavGrid — class @experimental-```-cellSize: number-cellToWorld: (gx: number, gy: number) => Vec3-clearCosts: () => void-clearObstructions: () => void-clearanceAt: (gx: number, gy: number) => number-costAt: (gx: number, gy: number) => number-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-height: number-inBounds: (gx: number, gy: number) => boolean-index: (gx: number, gy: number) => number-isNavigable: (p: NavPoint) => boolean-isWalkable: (gx: number, gy: number) => boolean-nearestWalkable: (gx: number, gy: number, maxRadius?: number, clearance?: number) => Cell | null-originX: number-originY: number-originZ: number-setCost: (gx: number, gy: number, cost: number) => void-setObstructed: (gx: number, gy: number, obstructed: boolean) => void-setWalkable: (gx: number, gy: number, walkable: boolean) => void-up: Vec3-walkable: Uint8Array<ArrayBufferLike>-width: number-worldToCell: (p: NavPoint) => Cell-static new (opts: NavGridOptions): NavGrid-static prototype: NavGrid-```--## NavGridOptions — interface @experimental-```-cellSize: number-height: number-origin: { x: number; y: number; z?: number; } | undefined-walkable: ArrayLike<number> | undefined-width: number-```--## NavLink — const @experimental-```-ComponentDef<NavLinkData>-```--## NavLinkData — interface @experimental-```-bidirectional: boolean-enabled: boolean-end: Vec3-radius: number-start: Vec3-```--## NavLinkSegment — interface @experimental-```-bidirectional: boolean-end: Vec3-radius: number-start: Vec3-```--## NavMesh — class @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-connect: (segments: readonly NavLinkSegment[]) => void-contains: (p: number, x: number, z: number) => boolean-corner: (p: number, i: number, out: Vec3) => Vec3-costOf: (p: number) => number-describe: (sink: NavSurfaceSink) => void-findPoly: (p: NavPoint, out?: Vec3, snap?: number) => number-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-heightAt: (p: number, x: number, z: number) => number-isNavigable: (p: NavPoint) => boolean-linkCount: number-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-setAreaCost: (area: number, cost: number) => void-snapDistance: number-up: Vec3-vertexCount: (p: number) => number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-static new (data: NavMeshData): NavMesh-static prototype: NavMesh-```--## NavMeshData — interface @experimental-```-agentRadius: number-areas: Uint8Array<ArrayBufferLike>-maxVertsPerPoly: number-neis: Int32Array<ArrayBufferLike>-polyCount: number-polys: Int32Array<ArrayBufferLike>-snapDistance: number-verticalReach: number-verts: Float32Array<ArrayBufferLike>-```--## NavObstacle — const @experimental-```-ComponentDef<NavObstacleData>-```--## NavObstacleBox — interface @experimental-```-center: Vec3-halfExtents: Vec3-rotation: Quat-```--## NavObstacleData — interface @experimental-```-enabled: boolean-halfExtents: Vec3-```--## NavPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): NavPlugin-static prototype: NavPlugin-```--## NavPoint — interface @experimental-```-x: number-y: number-z: number | undefined-```--## NavQueryOptions — interface @experimental-```-radius: number | undefined-```--## NavSurface — interface @experimental-```-describe: (sink: NavSurfaceSink) => void-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-isNavigable: (p: NavPoint) => boolean-up: Vec3-```--## NavSurfaceSink — interface @experimental-```-border: (a: Vec3, b: Vec3) => void-face: (corners: readonly Vec3[]) => void-link: (a: Vec3, b: Vec3) => void-```--## NavVolume — const @experimental-```-ComponentDef<NavVolumeData>-```--## NavVolumeData — interface @experimental-```-agentHeight: number-agentRadius: number-cellHeight: number-cellSize: number-halfExtents: Vec3-layers: number-maxSlopeDegrees: number-stepHeight: number-```--## Navigation — class @experimental-```-findWorldPath: (from: NavPoint, to: NavPoint, opts?: NavQueryOptions) => Vec3[] | null-hasSurface: () => boolean-setSurface: (surface: NavSurface | null) => void-surface: NavSurface | null-static new (): Navigation-static prototype: Navigation-```-## NestedPrefabRef — interface @experimental```overrides: PrefabOverride[]@@ -6033,56 +5617,6 @@ x: numberz: number```-## PathfindOptions — interface @experimental-```-clearance: number | undefined-diagonal: boolean | undefined-snapRadius: number | undefined-```--## Perceiver — const @experimental-```-ComponentDef<PerceiverData>-```--## PerceiverData — interface @experimental-```-facingAxis: FacingAxis-fovDegrees: number-losLayers: number-range: number-```--## Perception — const @experimental-```-ComponentDef<PerceptionData>-```--## PerceptionData — interface @experimental-```-dirX: number-dirY: number-dirZ: number-distance: number-targetX: number-targetY: number-targetZ: number-visible: boolean-```--## PerceptionPlugin — class @experimental-```-build: (app: App) => void-name: string-static new (): PerceptionPlugin-static prototype: PerceptionPlugin-```--## PerceptionTarget — const @experimental-```-ComponentDef<{}>-```-## Physics2D — const @beta```ResourceDef<Physics2DAPI>@@ -8037,13 +7571,6 @@ world: WorldBuiltinComponentDef<SegmentCollider2DData>```-## SenseResult — interface @experimental-```-dir: Vec3-distance: number-visible: boolean-```-## SensorEvent — interface @experimental```sensorEntity: number@@ -8589,26 +8116,6 @@ reason: stringsite: "variant" | "nested" | "instance"```-## StateMachineAgent — const @experimental-```-ComponentDef<StateMachineAgentData>-```--## StateMachineAgentData — interface @experimental-```-current: string-fsm: string-```--## StateMachines — class @experimental-```-blackboard: (entity: Entity) => Blackboard-fire: (entity: Entity, trigger: string) => void-state: (entity: Entity) => string | null-static new (states: Map<Entity, AgentState>): StateMachines-static prototype: StateMachines-```-## Stats — const @experimental```ResourceDef<FrameStats>@@ -8655,13 +8162,6 @@ position: StatsPosition | undefined'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'```-## Status — enum @experimental-```-Failure = "failure"-Running = "running"-Success = "success"-```-## Stick — const @public```(stick: "left" | "right", pad?: number) => Binding@@ -10510,21 +10010,6 @@ TransformData(requested: RenderBackendRequest, onError?: (message: string) => void): Promise<WebGPUBootResult>```-## actionRefArg — function @experimental-```-(ref: FsmActionRef | undefined): string | undefined-```--## actionRefName — function @experimental-```-(ref: FsmActionRef | undefined): string-```--## actionRefParams — function @experimental-```-(ref: FsmActionRef | undefined): Record<string, AiParamValue> | undefined-```-## activeRemoteRoot — function @experimental```(config: AssetGroupsConfig | null | undefined): string | undefined@@ -10555,16 +10040,6 @@ TransformData(def: AnimatorControllerDef, from: string, to: string, layer?: number): AnimatorControllerDef```-## addBtChild — function @experimental-```-(def: BtDefinition, parentId: string, type: BtNodeType, x?: number, y?: number): BtDefinition-```--## addBtOrphan — function @experimental-```-(def: BtDefinition, type: BtNodeType, x?: number, y?: number): BtDefinition-```-## addNode — function @beta```(g: MaterialGraph, type: GraphNodeType, x: number, y: number): { graph: MaterialGraph; id: string; }@@ -10585,11 +10060,6 @@ TransformData(system: SystemDef): void```-## addState — function @experimental-```-(def: FsmDefinition, name: string, x?: number, y?: number): FsmDefinition-```-## addSystem — function @experimental```(system: SystemDef): void@@ -10605,21 +10075,6 @@ TransformData(schedule: Schedule, system: SystemDef): void```-## addTransition — function @experimental-```-(def: FsmDefinition, from: string, to: string): FsmDefinition-```--## agentBlackboard — function @experimental-```-(states: Map<Entity, AgentState>, entity: Entity): Blackboard-```--## agentBtBlackboard — function @experimental-```-(states: Map<Entity, BtAgentState>, entity: Entity): Blackboard-```-## aiRegistry — const @experimental```AiRegistry<AiContext>@@ -10700,11 +10155,6 @@ AnimationPlugin(def: AnimatorControllerDef): AnimatorScope[]```-## applyAreasToGrid — function @experimental-```-(grid: NavGrid, areas: ReadonlyArray<NavAreaBox & { cost: number; }>): void-```-## applyAssetRefResolvers — function @experimental```(app: App, resolveRef: (ref: string) => string): void@@ -10730,11 +10180,6 @@ AnimationPlugin(source: PrefabData, delta: SourceDelta): PrefabData```-## applyObstaclesToGrid — function @experimental-```-(grid: NavGrid, obstacles: readonly NavObstacleBox[]): void-```-## applyOverrides — function @experimental```(entity: OverrideTarget, overrides: readonly PrefabOverride[] | undefined): void@@ -10855,21 +10300,6 @@ MotionDriver<AnimatorBlend2DMotion>(blend: AnimatorBlend2DMotion, x: number, y: number, out: { weight: number; }[]): void```-## btEdges — function @experimental-```-(def: BtDefinition): BtEdge[]-```--## btNodes — function @experimental-```-(def: BtDefinition): BtNode[]-```--## btPlugin — const @experimental-```-BtPlugin-```-## bucketOverridesByEntity — function @experimental```(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>@@ -10880,11 +10310,6 @@ BtPlugin(input: FrameProfileInput): FrameProfile```-## buildNavMesh — function @experimental-```-(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh-```-## buildText — function @experimental```(init?: TextInit): TextData@@ -10950,11 +10375,6 @@ BtPlugin(module: ESEngineModule): boolean```-## canHaveChildren — function @experimental-```-(type: BtNodeType): boolean-```-## captureFramePixels — function @beta```(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>@@ -11000,21 +10420,11 @@ BtPlugin(): void```-## clearBtStore — function @experimental-```-(): void-```-## clearDrawCallbacks — function @experimental```(): void```-## clearFsmStore — function @experimental-```-(): void-```-## clearProjectSideModules — function @experimental```(): void@@ -11085,26 +10495,6 @@ BtPlugin(): boolean```-## collectNavAreas — function @experimental-```-(world: World): Array<NavAreaBox & { cost: number; }>-```--## collectNavGeometry — function @experimental-```-(world: World, opts: CollectNavGeometryOptions): NavGeometry-```--## collectNavLinks — function @experimental-```-(world: World): NavLinkSegment[]-```--## collectNavObstacles — function @experimental-```-(world: World): NavObstacleBox[]-```-## collectNestedPrefabPaths — function @experimental```(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]@@ -11130,11 +10520,6 @@ BtPlugin(a: DrawRank, b: DrawRank): number```-## compileFsm — function @experimental-```-(def: FsmDefinition): CompiledFsm-```-## compileMaterialGraph — function @beta```(graph: MaterialGraph): string@@ -11205,11 +10590,6 @@ Plugin(textures: string[]): AnimClipAssetData```-## createBtRunState — function @experimental-```-(): BtRunState-```-## createButton — function @experimental```(opts: ButtonOptions): ButtonHandle@@ -11240,11 +10620,6 @@ Plugin(baseUrl: string): SideModuleHost```-## createFsmRunState — function @experimental-```-(fsm: CompiledFsm): FsmRunState-```-## createHeadlessApp — function @beta```(module: ESEngineModule, options?: HeadlessAppOptions): App@@ -11585,16 +10960,6 @@ DragPlugin(): AnimatorAvatar & { version: number; }```-## emptyBt — function @experimental-```-(): BtDefinition-```--## emptyFsm — function @experimental-```-(): FsmDefinition-```-## enableSceneOrigins — function @experimental```(app: App): void@@ -11615,11 +10980,6 @@ DragPlugin(adapter: WebGPUAdapterLike): string[]```-## ensureBtIds — function @experimental-```-(def: BtDefinition): BtDefinition-```-## enterStatePath — function @experimental```(scope: AnimatorScope, name: string): string[]@@ -11720,11 +11080,6 @@ EventBindingPlugin(entities: readonly ExtractEntity[], rootId: number, name: string, makeId?: (sourceId: number) => PrefabEntityId): PrefabData```-## facingFromRotation — function @experimental-```-(rot: Quat, axis?: FacingAxis): Vec3-```-## facingYaw — function @experimental```(direction: Vec3): number@@ -11745,11 +11100,6 @@ EventBindingPlugin(world: World, name: string): Entity | null```-## findPath — function @experimental-```-(grid: NavGrid, start: Cell, goal: Cell, opts?: PathfindOptions): Cell[] | null-```-## fingerprint — function @experimental```(report: DiagnosticReport): string@@ -11805,16 +11155,6 @@ FocusPlugin(frame: CapturedFrame): FrameProfile```-## fsmEdges — function @experimental-```-(def: FsmDefinition): FsmEdge[]-```--## fsmPlugin — const @experimental-```-FsmPlugin-```-## fxPreviewOrPlayMode — function @experimental```(): boolean@@ -11860,11 +11200,6 @@ GameplayPlugin(extensionOrPath: string): AssetTypeEntry | undefined```-## getBt — function @experimental-```-(key: string): BtDefinition | undefined-```-## getComponent — function @experimental```(name: string): AnyComponentDef | undefined@@ -11950,11 +11285,6 @@ GameplayPlugin(): string[]```-## getFsm — function @experimental-```-(key: string): CompiledFsm | undefined-```-## getLogger — function @experimental```(): Logger@@ -12325,11 +11655,6 @@ Logger(value: unknown): value is string```-## makeLosCheck — function @experimental-```-(physics: Physics2DAPI): LosCheck-```-## makeWidgetInteractable — function @experimental```(world: World, entity: Entity, init?: WidgetInteractionInit): void@@ -12345,11 +11670,6 @@ Logger(tag: string, available: readonly string[]): string | null```-## maxChildren — function @experimental-```-(type: BtNodeType): number-```-## meanFrameProfile — function @experimental```(profiles: readonly FrameProfile[]): FrameProfile@@ -12415,11 +11735,6 @@ MeshRendererPlugin(def: AnimatorControllerDef, name: string, x: number, y: number, layer?: number): AnimatorControllerDef```-## moveBtNode — function @experimental-```-(def: BtDefinition, id: string, x: number, y: number): BtDefinition-```-## moveEditorViewFocus — function @experimental```(view: EditorViewData, right: number, up: number, forward?: number): void@@ -12430,44 +11745,14 @@ MeshRendererPlugin(g: MaterialGraph, id: string, x: number, y: number): MaterialGraph```-## moveState — function @experimental-```-(def: FsmDefinition, name: string, x: number, y: number): FsmDefinition-```--## navAreaDigest — function @experimental-```-(areas: ReadonlyArray<NavAreaBox>): number-```--## navGeometryReady — function @experimental-```-(world: World, layers?: number): boolean-```--## navLinkDigest — function @experimental-```-(links: readonly NavLinkSegment[]): number-```--## navObstacleDigest — function @experimental-```-(obstacles: readonly NavObstacleBox[]): number-```--## navPlugin — const @experimental-```-NavPlugin-```-## newMaterialGraph — function @beta```(): MaterialGraph```-## normalizeAngle — function @experimental+## noInput — const @experimental```-(a: number): number+() => InputState```## normalizeBundleMode — function @experimental@@ -12595,11 +11880,6 @@ ParticlePlugin(scene: SceneData, sceneName: string, options: PartitionOptions): WorldPartition | null```-## pathToWorld — function @experimental-```-(grid: NavGrid, path: Cell[]): Vec3[]-```-## percent — const @public```(n: number) => Dimension@@ -12610,11 +11890,6 @@ ParticlePlugin(values: readonly number[], p: number): number```-## perceptionPlugin — const @experimental-```-PerceptionPlugin-```-## persistentEntityRows — function @experimental```(app: App, manifest: WorldManifest): ReadonlyMap<number, Entity>@@ -12880,11 +12155,6 @@ PrefabsPlugin(key: string, def: AnimatorControllerDef): void```-## registerBt — function @experimental-```-(key: string, def: BtDefinition): BtDefinition-```-## registerCensusProbe — function @experimental```(probe: CensusProbe): () => void@@ -12905,11 +12175,6 @@ PrefabsPlugin(id: string, fn: DrawCallback, scene?: string): void```-## registerFsm — function @experimental-```-(key: string, def: FsmDefinition): CompiledFsm-```-## registerPackagedSideModules — function @experimental```(config: Pick<PackagedGameConfig, "sideModules">): void@@ -12980,46 +12245,21 @@ PrefabsPlugin(def: AnimatorControllerDef, from: string, index: number, layer?: number): AnimatorControllerDef```-## removeBtNode — function @experimental-```-(def: BtDefinition, id: string): BtDefinition-```-## removeNode — function @beta```(g: MaterialGraph, id: string): MaterialGraph```-## removeState — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```--## removeTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number): FsmDefinition-```-## renameAnimatorState — function @experimental```(def: AnimatorControllerDef, oldName: string, newName: string, layer?: number): AnimatorControllerDef```-## renameState — function @experimental-```-(def: FsmDefinition, oldName: string, newName: string): FsmDefinition-```-## renderMeshPreview — function @experimental```(module: unknown, mesh: number, w: number, h: number): Promise<ImageData | null>```-## reparentBtNode — function @experimental-```-(def: BtDefinition, id: string, newParentId: string): BtDefinition-```-## replay — function @experimental```(scope: SpeculationScope, body: (commands: CommandsInstance) => SpeculationOutcome): ReplayReport@@ -13210,11 +12450,6 @@ Plugin(forms: PluralForms, count: number, selector: PluralSelector): string```-## senseTarget — function @experimental-```-(observer: Vec3, facing: Vec3, target: Vec3, range: number, halfFov: number, isBlocked?: (from: Vec3, to: Vec3) => boolean): SenseResult-```-## serializeAnimClip — function @experimental```(asset: AnimClipAssetData): Record<string, unknown>@@ -13265,11 +12500,6 @@ ServicesPlugin(def: AnimatorControllerDef, name: string, patch: { speed?: number; loop?: boolean; rootMotion?: boolean; }, layer?: number): AnimatorControllerDef```-## setBtNodeField — function @experimental-```-(def: BtDefinition, id: string, patch: Partial<BtNode>): BtDefinition-```-## setButtonState — function @experimental```(world: World, entity: Entity, state: string): void@@ -13310,11 +12540,6 @@ ServicesPlugin(enabled: boolean): void```-## setInitial — function @experimental-```-(def: FsmDefinition, name: string): FsmDefinition-```-## setLayerState — function @experimental```(a: AnimatorData, index: number, path: string): void@@ -13325,11 +12550,6 @@ ServicesPlugin(level: LogLevel): void```-## setNavDestination — function @experimental-```-(world: World, entity: Entity, target: { x: number; y: number; z?: number; }): void-```-## setPlayMode — function @experimental```(active: boolean): void@@ -13340,11 +12560,6 @@ ServicesPlugin(bytes: number): void```-## setStateHook — function @experimental-```-(def: FsmDefinition, name: string, hook: "onEnter" | "onUpdate" | "onExit", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition-```-## setTextureBudget — function @experimental```(bytes: number): void@@ -13535,21 +12750,6 @@ MotionDriver<AnimatorClipMotion>StatsPlugin```-## stepFsm — function @experimental-```-<Ctx>(fsm: CompiledFsm, run: FsmRunState, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>): boolean-```--## stepPerception — function @experimental-```-(world: PerceptionWorldView, isBlocked?: LosCheck): void-```--## stopNavAgent — function @experimental-```-(world: World, entity: Entity): void-```-## summarizeCapture — function @experimental```(capture: ProfileCapture): CaptureSummary@@ -13605,11 +12805,6 @@ TextPlugin(): ThemeType```-## tickBt — function @experimental-```-<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status-```-## timelinePlugin — const @experimental```TimelinePlugin@@ -13755,11 +12950,6 @@ UIVisibilityPlugin(world: World, aspectRatio: number): void```-## updateTransition — function @experimental-```-(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition-```-## v2 — const @experimental```{ readonly create: (x?: number, y?: number) => Vec2; readonly clone: (a: Vec2) => Vec2; readonly add: (a: Vec2, b: Vec2) => Vec2; readonly sub: (a: Vec2, b: Vec2) => Vec2; readonly scale: (a: Vec2, s: number) => Vec2; readonly mul: (a: Vec2, b: Vec2) => Vec2; readonly neg: (a: Vec2) => Vec2; readonly dot: (a: Vec2, b: Vec2) => number; readonly cross: (a: Vec2, b: Vec2) => number; readonly len: (a: Vec2) => number; readonly len2: (a: Vec2) => number; readonly dist: (a: Vec2, b: Vec2) => number; readonly dist2: (a: Vec2, b: Vec2) => number; readonly normalize: (a: Vec2) => Vec2; readonly lerp: (a: Vec2, b: Vec2, t: number) => Vec2; readonly angle: (a: Vec2) => number; readonly fromAngle: (radians: number, length?: number) => Vec2; readonly rotate: (a: Vec2, radians: number) => Vec2; readonly perp: (a: Vec2) => Vec2; readonly equals: (a: Vec2, b: Vec2, epsilon?: number) => boolean; }diff --git a/sdk/package.json b/sdk/package.jsonindex 29a4d072f..e6614811a 100644--- a/sdk/package.json+++ b/sdk/package.json@@ -16,6 +16,7 @@"./dist/spine/index.js","./dist/tilemap/index.js","./dist/logic/index.js",+ "./dist/ai/index.js","./dist/physics/index.js","./dist/physics3d/index.js","./dist/douyin/index.js",@@ -63,6 +64,10 @@"import": "./dist/logic/index.js","types": "./dist/logic/index.d.ts"},+ "./ai": {+ "import": "./dist/ai/index.js",+ "types": "./dist/ai/index.d.ts"+ },"./physics": {"import": "./dist/physics/index.js","types": "./dist/physics/index.d.ts"diff --git a/sdk/rolldown.config.js b/sdk/rolldown.config.jsindex 350d494d0..970da7ce9 100644--- a/sdk/rolldown.config.js+++ b/sdk/rolldown.config.js@@ -89,6 +89,7 @@ export default defineConfig(['spine/index': 'src/spine/index.ts','tilemap/index': 'src/tilemap/index.ts','logic/index': 'src/logic/index.ts',+ 'ai/index': 'src/ai/index.ts','dragonbones/index': 'src/dragonbones/index.ts','douyin/index': 'src/platform/douyin/index.ts','wasm': 'src/wasm.ts',diff --git a/sdk/rollup.config.js b/sdk/rollup.config.jsindex 506556c5e..36ade234d 100644--- a/sdk/rollup.config.js+++ b/sdk/rollup.config.js@@ -20,6 +20,7 @@ export default ['spine/index': 'src/spine/index.ts','tilemap/index': 'src/tilemap/index.ts','logic/index': 'src/logic/index.ts',+ 'ai/index': 'src/ai/index.ts','dragonbones/index': 'src/dragonbones/index.ts','wasm': 'src/wasm.ts',},diff --git a/sdk/src/ai/aiSupport.ts b/sdk/src/ai/aiSupport.tsnew file mode 100644index 000000000..b0e9325c5--- /dev/null+++ b/sdk/src/ai/aiSupport.ts@@ -0,0 +1,30 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file aiSupport.ts — what a build that ships gameplay AI tells the core.+ *+ * A call, not a file's side effect — see spine/spineSupport.ts. The action+ * vocabulary (`aiRegistry`) stays in the core, because authored event bindings+ * and UI controllers write verbs into it without any of this: what moves is the+ * navigation, perception, state-machine and behaviour-tree runtimes behind it.+ */+import { addEntryPlugin } from '../runtime/entryPlugins';+import { addAssetLoader } from '../asset/optionalLoaders';+// From each plugin's own module, not from './index': the barrel calls this at+// the end of its own evaluation, and a support module that reads the barrel back+// is a cycle whose bindings are not ready when the call lands.+import { navPlugin } from './nav/NavPlugin';+import { fsmPlugin } from './fsm/FsmPlugin';+import { btPlugin } from './bt/BtPlugin';+import { perceptionPlugin } from './perception/PerceptionPlugin';+import { FsmAssetLoader } from '../asset/loaders/FsmAssetLoader';+import { BtAssetLoader } from '../asset/loaders/BtAssetLoader';++export function registerAiSupport(): void {+ addEntryPlugin('ai:nav', () => navPlugin);+ addEntryPlugin('ai:fsm', () => fsmPlugin);+ addEntryPlugin('ai:bt', () => btPlugin);+ addEntryPlugin('ai:perception', () => perceptionPlugin);+ addAssetLoader('fsm', () => new FsmAssetLoader() as never);+ addAssetLoader('bt', () => new BtAssetLoader() as never);+}diff --git a/sdk/src/ai/index.ts b/sdk/src/ai/index.tsindex ae50ff720..c4f381b07 100644--- a/sdk/src/ai/index.ts+++ b/sdk/src/ai/index.ts@@ -63,3 +63,8 @@ export {// Perception: sight/FOV sensing into a Perception component (read by FSM/BT).export * from './perception';++// Importing this subpath INSTALLS gameplay AI — see spine/index.ts.+import { registerAiSupport } from './aiSupport';++registerAiSupport();diff --git a/sdk/src/app/pluginSets.ts b/sdk/src/app/pluginSets.tsindex 464845d73..6fca12031 100644--- a/sdk/src/app/pluginSets.ts+++ b/sdk/src/app/pluginSets.ts@@ -33,7 +33,6 @@ import { gameplayPlugin } from '../gameplay';import { timerPlugin } from '../ecs/timer';import { velocityPlugin } from '../velocity';import { lifecyclePlugin } from '../ecs/lifecycle';-import { navPlugin, fsmPlugin, btPlugin, perceptionPlugin } from '../ai';import { eventBindingPlugin } from '../eventBinding';import { replicationPlugin } from '../net/replication';import { servicesPlugin } from '../services';@@ -53,7 +52,7 @@ import { diagnosticsPlugin } from '../diagnostics';export const simulationBasePlugins = (): Plugin[] => [diagnosticsPlugin,timerPlugin, velocityPlugin, lifecyclePlugin, audioPlugin,- perceptionPlugin, fsmPlugin, btPlugin, navPlugin, eventBindingPlugin, replicationPlugin,+ eventBindingPlugin, replicationPlugin,servicesPlugin,];@@ -73,6 +72,6 @@ export const webBasePlugins = (): Plugin[] => [timerPlugin, velocityPlugin, lifecyclePlugin, animationPlugin, audioPlugin, videoPlugin,particlePlugin, trailPlugin, meshRendererPlugin, postProcessPlugin, timelinePlugin,gameplayPlugin,- perceptionPlugin, fsmPlugin, btPlugin, navPlugin, eventBindingPlugin, replicationPlugin,+ eventBindingPlugin, replicationPlugin,servicesPlugin,];diff --git a/sdk/src/asset/Assets.ts b/sdk/src/asset/Assets.tsindex 5800ee929..2fa47867d 100644--- a/sdk/src/asset/Assets.ts+++ b/sdk/src/asset/Assets.ts@@ -39,10 +39,8 @@ import { AudioAssetLoader } from './loaders/AudioAssetLoader';import { AnimClipAssetLoader } from './loaders/AnimClipAssetLoader';import { TimelineAssetLoader } from './loaders/TimelineAssetLoader';import { PrefabAssetLoader } from './loaders/PrefabAssetLoader';-import { FsmAssetLoader } from './loaders/FsmAssetLoader';import { AnimatorControllerAssetLoader } from './loaders/AnimatorControllerAssetLoader';import { AvatarAssetLoader } from './loaders/AvatarAssetLoader';-import { BtAssetLoader } from './loaders/BtAssetLoader';import { preparePrefab, type PreparedPrefab } from '../prefab/preparedPrefab';import { LocaleAssetLoader } from './loaders/LocaleAssetLoader';import { JsonAssetLoader } from './loaders/JsonAssetLoader';@@ -2243,10 +2241,8 @@ export class Assets {this.register(new AnimClipAssetLoader());this.register(new TimelineAssetLoader());this.register(new PrefabAssetLoader());- this.register(new FsmAssetLoader());this.register(new AnimatorControllerAssetLoader());this.register(new AvatarAssetLoader());- this.register(new BtAssetLoader());this.register(new LocaleAssetLoader());this.register(new JsonAssetLoader());// …and whatever an optional subsystem brought with it. A loader namesdiff --git a/sdk/src/core-content.ts b/sdk/src/core-content.tsindex 1d6305216..a82329c56 100644--- a/sdk/src/core-content.ts+++ b/sdk/src/core-content.ts@@ -745,159 +745,16 @@ export type {// AI — Navigation (a grid for cells, a polygon mesh for geometry)// =============================================================================-export {- NavGrid,- NavMesh,- buildNavMesh,- collectNavGeometry,- navGeometryReady,- findPath,- pathToWorld,- Navigation,- Nav,- NavAgent,- NavVolume,- NavObstacle,- NavLink,- NavArea,- collectNavObstacles,- collectNavLinks,- navLinkDigest,- collectNavAreas,- navAreaDigest,- applyAreasToGrid,- navObstacleDigest,- applyObstaclesToGrid,- setNavDestination,- stopNavAgent,- NavPlugin,- navPlugin,- NavDebugDraw,- type NavSurface,- type NavSurfaceSink,- type NavQueryOptions,- type NavPoint,- type NavGridOptions,- type NavMeshData,- type BuildNavMeshOptions,- type NavGeometry,- type CollectNavGeometryOptions,- type Cell,- type PathfindOptions,- type NavAgentData,- type NavVolumeData,- type NavObstacleData,- type NavLinkData,- type NavAreaData,- type NavAreaBox,- type NavLinkSegment,- type NavObstacleBox,- type NavDebugDrawConfig,-} from './ai';// =============================================================================// AI — State machines (pure-TS interpreter, .esfsm data + named registry)// =============================================================================-export {- Blackboard,- evalGuard,- evalGuards,- AiRegistry,- compileFsm,- createFsmRunState,- stepFsm,- aiRegistry,- registerAction,- registerCondition,- registerValue,- // The declared-parameter surface: an action says what it takes, and the- // projection to/from the canonical `arg` string keeps old data running.- invokeAction,- parseActionArg,- formatActionArg,- type AiParamDef,- type AiParamValue,- type AiParams,- type AiActionSpec,- type AiActionInput,- type AiOutputDef,- type AiOutputs,- type AiValueSpec,- StateMachineAgent,- registerFsm,- getFsm,- clearFsmStore,- FsmPlugin,- fsmPlugin,- StateMachines,- AiFsm,- agentBlackboard,- fsmEdges,- emptyFsm,- addState,- removeState,- moveState,- renameState,- setStateHook,- actionRefName,- actionRefArg,- actionRefParams,- type FsmActionRef,- setInitial,- addTransition,- removeTransition,- updateTransition,- type FsmEdge,- type CompareOp,- type BlackboardGuard,- type FsmTransition,- type FsmState,- type FsmDefinition,- type CompiledFsm,- type FsmRunState,- type AiAction,- type AiCondition,- type AiContext,- type StateMachineAgentData,-} from './ai';// =============================================================================// AI — Behavior trees (pure-TS interpreter, .esbt data + shared registry)// =============================================================================-export {- Status,- tickBt,- createBtRunState,- BehaviorTreeAgent,- registerBt,- getBt,- clearBtStore,- BtPlugin,- btPlugin,- BehaviorTrees,- AiBt,- agentBtBlackboard,- emptyBt,- ensureBtIds,- btNodes,- btEdges,- maxChildren,- canHaveChildren,- addBtChild,- addBtOrphan,- removeBtNode,- moveBtNode,- setBtNodeField,- reparentBtNode,- type BtEdge,- type BtNodeType,- type BtNode,- type BtDefinition,- type BtRunState,- type BehaviorTreeAgentData,-} from './ai';// =============================================================================// Script graph — the `.esgraph` authoring form: events, an exec wire, data wires@@ -908,21 +765,6 @@ export {// AI — Perception (sight/FOV sensing into a Perception component)// =============================================================================-export {- senseTarget,- facingFromRotation,- normalizeAngle,- Perceiver,- Perception,- PerceptionTarget,- PerceptionPlugin,- perceptionPlugin,- stepPerception,- makeLosCheck,- type SenseResult,- type PerceiverData,- type PerceptionData,-} from './ai';// =============================================================================// Gameplay (third-person character + camera)@@ -1008,3 +850,42 @@ export {type TimelineAsset, type Track, type PropertyTrack, type PropertyChannel, type Keyframe,type SpriteAnimTrack, type AudioTrack, type ActivationTrack, type SpineTrack, type AnimFramesTrack,} from './timeline';++// =============================================================================+// Gameplay AI — the VERB VOCABULARY only; the runtimes are `esengine/ai`. From+// their own modules rather than from './ai', which would put those back.+// =============================================================================++export {+ aiRegistry,+ registerAction,+ registerCondition,+ registerValue,+ noInput,+ type AiContext,+} from './ai/fsm/AiContext';++export {+ AiRegistry,+ invokeAction,+ type AiAction,+ type AiCondition,+ parseActionArg,+ formatActionArg,+ type AiParamDef,+ type AiParamValue,+ type AiParams,+ type AiActionSpec,+ type AiActionInput,+ type AiOutputDef,+ type AiOutputs,+ type AiValueSpec,+} from './ai/fsm/registry';++export {+ Blackboard,+ evalGuard,+ evalGuards,+} from './ai/fsm/Blackboard';++export type { CompareOp, BlackboardGuard } from './ai/fsm/types';diff --git a/sdk/src/runtime/optionalPlugins.ts b/sdk/src/runtime/optionalPlugins.tsindex 1acd72fef..724d4c2be 100644--- a/sdk/src/runtime/optionalPlugins.ts+++ b/sdk/src/runtime/optionalPlugins.ts@@ -21,6 +21,7 @@ import { registerPhysics2DSupport } from '../physics/physicsSupport';import { registerPhysics3DSupport } from '../physics3d/physics3dSupport';import { registerTilemapSupport } from '../tilemap/tilemapSupport';import { registerScriptGraphSupport } from '../logic/logicSupport';+import { registerAiSupport } from '../ai/aiSupport';export function installOptionalPlugins(): void {registerSpineSupport();@@ -29,6 +30,7 @@ export function installOptionalPlugins(): void {registerPhysics3DSupport();registerTilemapSupport();registerScriptGraphSupport();+ registerAiSupport();// Video has no subpath of its own to be installed from, so it registers here.setSceneOptionals({video: {diff --git a/sdk/tests/preload-ai-assets.test.ts b/sdk/tests/preload-ai-assets.test.tsindex e67b168cd..e5eadd6b5 100644--- a/sdk/tests/preload-ai-assets.test.ts+++ b/sdk/tests/preload-ai-assets.test.ts@@ -22,6 +22,11 @@ import { defineComponent } from '../src/ecs/component';import { getFsm, clearFsmStore } from '../src/ai/fsm/StateMachineAgent';import { getBt, clearBtStore } from '../src/ai/bt/BehaviorTreeAgent';+// Gameplay AI comes with its subsystem now, not with the core: a package+// without agents carries no navigation, no FSM and no behaviour trees.+import { registerAiSupport } from '../src/ai/aiSupport';+registerAiSupport();+// The FSM/BT loaders don't touch the ResourceManager, but the shared LoadContext// materializes it eagerly — stub it so the load path runs headless.vi.mock('../src/wasm/resourceManager', () => ({diff --git a/sdk/tests/realm-registry-isolation.test.ts b/sdk/tests/realm-registry-isolation.test.tsindex f9928526f..f896cb00d 100644--- a/sdk/tests/realm-registry-isolation.test.ts+++ b/sdk/tests/realm-registry-isolation.test.ts@@ -29,6 +29,11 @@ import { clearBtStore } from '../src/ai/bt/BehaviorTreeAgent';import { ensureBuiltinAiRegistrations } from '../src/ai/builtins';import type { Backend } from '../src/asset/Backend';+// Gameplay AI comes with its subsystem now, not with the core: a package+// without agents carries no navigation, no FSM and no behaviour trees.+import { registerAiSupport } from '../src/ai/aiSupport';+registerAiSupport();+vi.mock('../src/wasm/resourceManager', () => ({requireResourceManager: () => ({}),getResourceManager: () => null,diff --git a/sdk/tests/schedule-declared.test.ts b/sdk/tests/schedule-declared.test.tsindex dc91dc1fd..1f9e686e9 100644--- a/sdk/tests/schedule-declared.test.ts+++ b/sdk/tests/schedule-declared.test.ts@@ -17,11 +17,17 @@ import { describe, it, expect, beforeAll } from 'vitest';import { App } from '../src/app/app';import { Schedule, defineSystem, GetWorld } from '../src/ecs/system';import { simulationBasePlugins } from '../src/app/pluginSets';+import { entryPlugins } from '../src/runtime/entryPlugins';import { StatsPlugin } from '../src/stats';import { registerCharacterController2DSystem } from '../src/physics/CharacterController2DSystem';import { setPlatform } from '../src/platform/base';import { webAdapter } from '../src/platform/web';+// Gameplay AI comes with its subsystem now, not with the core: a package+// without agents carries no navigation, no FSM and no behaviour trees.+import { registerAiSupport } from '../src/ai/aiSupport';+registerAiSupport();+const SCHEDULES = Object.entries(Schedule).filter(([, v]) => typeof v === 'number') as [string, Schedule][];/**@@ -32,6 +38,9 @@ const SCHEDULES = Object.entries(Schedule).filter(([, v]) => typeof v === 'numbeconst build = (): App => {const app = App.new();for (const plugin of simulationBasePlugins()) app.addPlugin(plugin);+ // The AI runtimes are an entry's to install now, and the subject here is the+ // whole engine stack — the base set alone is no longer all of it.+ for (const plugin of entryPlugins()) app.addPlugin(plugin);app.addPlugin(new StatsPlugin({ overlay: false }));registerCharacterController2DSystem(app);return app;diff --git a/tools/baselines/core-carries-options.json b/tools/baselines/core-carries-options.jsonindex 97107e0d6..637aba8e0 100644--- a/tools/baselines/core-carries-options.json+++ b/tools/baselines/core-carries-options.json@@ -1,10 +1,5 @@{"edges": [- "ai/nav/NavPlugin.ts -> ../../physics3d/Physics3DComponents",- "ai/nav/navGeometry.ts -> ../../physics3d/ColliderShape3D",- "ai/nav/navGeometry.ts -> ../../physics3d/Physics3DComponents",- "ai/perception/PerceptionPlugin.ts -> ../../physics",- "ai/perception/PerceptionPlugin.ts -> ../../physics3d/Physics3DPlugin","app/app.ts -> ../physics/Physics2DRuntime","app/pluginSets.ts -> ../video","asset/Assets.ts -> ../spine/prepareSpine",diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjsindex db955214b..ae6521782 100644--- a/tools/releaseNotes.mjs+++ b/tools/releaseNotes.mjs@@ -690,6 +690,10 @@ export const NOTED = {{ internal: 'the wording of a message the export already printed' },'fix(details): the Inspector names the new reason a texture ships raw':{ note: 'A texture that encodes larger than its source now ships as the source.' },+ 'refactor(ai): the AI runtimes move to their own subpath':+ { note: "The AI runtimes are a subpath: `import { NavAgent } from 'esengine/ai'`." },+ 'refactor(ai): the editor imports the AI runtimes from their subpath':+ { note: "The AI runtimes are a subpath: `import { NavAgent } from 'esengine/ai'`." },'refactor(logic): the script-graph API moves to its own subpath':{ note: "Script graphs are a subpath: `import { … } from 'esengine/logic'`." },'refactor(logic): the editor imports script graphs from their subpath':