Skip to content

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.

refactor(ai): the AI runtimes move to their own subpath

esenginef0d2f98c69d1
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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 as
tilemaps below: 65 names re-exported as values put the graph compiler and its node
library in every package, 23KB in a game with no graph, plus the asset loader the
diff --git a/desktop b/desktop
index 3c4a0b283..8bbc2f7ef 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit 3c4a0b2837b023f26d03c65bf3cbd395b86c59f1
+Subproject commit 8bbc2f7efbf0cae84407b68c344435070695a0cd
diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.json
index 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.ts
index 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 for
diff --git a/examples/celestial-heights/src/ai/wisp.ts b/examples/celestial-heights/src/ai/wisp.ts
index 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 resolves
diff --git a/examples/celestial-heights/src/systems/boss.ts b/examples/celestial-heights/src/systems/boss.ts
index 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.ts
index 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.json
index 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.ts
index 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.json
index 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.ts
index 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.ts
index 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.json
index 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.ts
index 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) resolve
diff --git a/examples/enemy-ai/tsconfig.json b/examples/enemy-ai/tsconfig.json
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 | undefined
touches: 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>) => void
world: World
```
-## AiFsm — const @experimental
-```
-ResourceDef<StateMachines>
-```
-
## AiOutputDef — interface @experimental
```
label: string | undefined
@@ -1501,25 +1491,6 @@ touches: SystemTouches | undefined
update: ((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: boolean
restitution: 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: string
uv: { 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: number
triangles: 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: number
z: 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: World
BuiltinComponentDef<SegmentCollider2DData>
```
-## SenseResult — interface @experimental
-```
-dir: Vec3
-distance: number
-visible: boolean
-```
-
## SensorEvent — interface @experimental
```
sensorEntity: number
@@ -8587,26 +8114,6 @@ reason: string
site: "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.md
index 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 | undefined
touches: 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>) => void
world: World
```
-## AiFsm — const @experimental
-```
-ResourceDef<StateMachines>
-```
-
## AiOutputDef — interface @experimental
```
label: string | undefined
@@ -1501,25 +1491,6 @@ touches: SystemTouches | undefined
update: ((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: boolean
restitution: 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: string
uv: { 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: number
triangles: 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): NativePlatformAdapter
static 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: number
z: 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: World
BuiltinComponentDef<SegmentCollider2DData>
```
-## SenseResult — interface @experimental
-```
-dir: Vec3
-distance: number
-visible: boolean
-```
-
## SensorEvent — interface @experimental
```
sensorEntity: number
@@ -8780,26 +8307,6 @@ reason: string
site: "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.md
index 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 | undefined
touches: 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>) => void
world: World
```
-## AiFsm — const @experimental
-```
-ResourceDef<StateMachines>
-```
-
## AiOutputDef — interface @experimental
```
label: string | undefined
@@ -1496,25 +1486,6 @@ touches: SystemTouches | undefined
update: ((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: boolean
restitution: 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: string
uv: { 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: number
triangles: 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: number
z: 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: World
BuiltinComponentDef<SegmentCollider2DData>
```
-## SenseResult — interface @experimental
-```
-dir: Vec3
-distance: number
-visible: boolean
-```
-
## SensorEvent — interface @experimental
```
sensorEntity: number
@@ -8582,26 +8109,6 @@ reason: string
site: "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.md
index 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 | undefined
touches: 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>) => void
world: World
```
-## AiFsm — const @experimental
-```
-ResourceDef<StateMachines>
-```
-
## AiOutputDef — interface @experimental
```
label: string | undefined
@@ -1496,25 +1486,6 @@ touches: SystemTouches | undefined
update: ((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: boolean
restitution: 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: string
uv: { 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: number
triangles: 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: number
z: 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: World
BuiltinComponentDef<SegmentCollider2DData>
```
-## SenseResult — interface @experimental
-```
-dir: Vec3
-distance: number
-visible: boolean
-```
-
## SensorEvent — interface @experimental
```
sensorEntity: number
@@ -8833,26 +8360,6 @@ reason: string
site: "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.md
index 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 | undefined
touches: 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>) => void
world: World
```
-## AiFsm — const @experimental
-```
-ResourceDef<StateMachines>
-```
-
## AiOutputDef — interface @experimental
```
label: string | undefined
@@ -1496,25 +1486,6 @@ touches: SystemTouches | undefined
update: ((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: boolean
restitution: 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: string
uv: { 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: number
triangles: 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: number
z: 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: World
BuiltinComponentDef<SegmentCollider2DData>
```
-## SenseResult — interface @experimental
-```
-dir: Vec3
-distance: number
-visible: boolean
-```
-
## SensorEvent — interface @experimental
```
sensorEntity: number
@@ -8589,26 +8116,6 @@ reason: string
site: "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.json
index 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.js
index 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.js
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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 names
diff --git a/sdk/src/core-content.ts b/sdk/src/core-content.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 === 'numbe
const 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.json
index 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.mjs
index 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':