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(tilemap): the tilemap API moves to its own subpath

esenginebf9d3c2c1894
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ac9b09698..ab0e678e0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,16 @@ published separately; it ships inside the editor.
header at 13px read as bold body text rather than as a title. Window titles now have a
step of their own, which is what every editor this size gives them.
+### Changed
+
+- **Tilemaps are a subpath: `import { Tilemap } from 'esengine/tilemap'`.** `esengine`
+ re-exported 105 tilemap names as values, so every package carried the subsystem behind
+ them — 44KB of parser and plugin in a game with no tilemap, plus the two asset loaders
+ the registry constructed whether or not a project had a `.tmj`. A package now pays for
+ tilemaps by importing them, the way it already did for Spine and physics. The names are
+ unchanged and all were `@beta`; the whole entry still installs everything, so anything
+ that imports `esengine` alone behaves as before.
+
### Added
- **A UI node can keep clear of WeChat's capsule menu, which the safe area does not cover.**
diff --git a/desktop b/desktop
index f9c9c29d8..0d79a110b 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit f9c9c29d8ad140a3f0e7ebc41bbf2aa4d5b01b73
+Subproject commit 0d79a110bb9e218cc8c378e1f36b3dca0ea495d8
diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.json
index eaf5a01a4..e82491618 100644
--- a/docs/astro/src/data/apiStability.generated.json
+++ b/docs/astro/src/data/apiStability.generated.json
@@ -2,11 +2,11 @@
"note": "Generated by tools/api-stability.mjs from sdk/etc/*.api.md — do not edit.",
"counts": {
"public": 115,
- "beta": 103,
- "experimental": 2001,
+ "beta": 98,
+ "experimental": 1899,
"deprecated": 3
},
- "total": 2219,
+ "total": 2112,
"subsystems": [
{
"id": "ecs",
@@ -2597,66 +2597,6 @@
"minigame"
]
},
- {
- "name": "TilemapLayer",
- "kind": "const",
- "deprecated": false,
- "entries": [
- "index",
- "index.node",
- "index.native",
- "wechat",
- "minigame"
- ]
- },
- {
- "name": "TilemapLayerData",
- "kind": "interface",
- "deprecated": false,
- "entries": [
- "index",
- "index.node",
- "index.native",
- "wechat",
- "minigame"
- ]
- },
- {
- "name": "TilemapOrientation",
- "kind": "enum",
- "deprecated": false,
- "entries": [
- "index",
- "index.node",
- "index.native",
- "wechat",
- "minigame"
- ]
- },
- {
- "name": "TilemapStaggerAxis",
- "kind": "enum",
- "deprecated": false,
- "entries": [
- "index",
- "index.node",
- "index.native",
- "wechat",
- "minigame"
- ]
- },
- {
- "name": "TilemapStaggerIndex",
- "kind": "enum",
- "deprecated": false,
- "entries": [
- "index",
- "index.node",
- "index.native",
- "wechat",
- "minigame"
- ]
- },
{
"name": "TouchPoint",
"kind": "interface",
diff --git a/examples/celestial-heights/src/systems/world.ts b/examples/celestial-heights/src/systems/world.ts
index eaf8ed002..a6702ac6e 100644
--- a/examples/celestial-heights/src/systems/world.ts
+++ b/examples/celestial-heights/src/systems/world.ts
@@ -1,8 +1,11 @@
import {
defineSystem, Query, Mut, Res, Commands, GetWorld,
- Transform, Camera, FollowTarget, TilemapLayer, RuntimeOnly, Text, Sprite, Prefabs,
- Nav, navGridFromTilemapLayer, SceneManager, transitionTo,
+ Transform, Camera, FollowTarget, RuntimeOnly, Text, Sprite, Prefabs,
+ Nav, SceneManager, transitionTo,
} from 'esengine';
+// 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 { 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 1f11ff310..c46932a2c 100644
--- a/examples/celestial-heights/tsconfig.json
+++ b/examples/celestial-heights/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/tilemap": ["./.esengine/sdk/tilemap/index.d.ts"]
}
},
"include": ["src/**/*"],
diff --git a/pipeline/src/bundle/esengineResolve.ts b/pipeline/src/bundle/esengineResolve.ts
index e2efab34b..8ba29667a 100644
--- a/pipeline/src/bundle/esengineResolve.ts
+++ b/pipeline/src/bundle/esengineResolve.ts
@@ -24,6 +24,7 @@ export const ESENGINE_EXTERNAL = ['esengine', 'esengine/*'];
*/
export const ESENGINE_SUBPATHS: Readonly<Record<string, string>> = {
'esengine/spine': 'spine/index.js',
+ 'esengine/tilemap': 'tilemap/index.js',
'esengine/dragonbones': 'dragonbones/index.js',
'esengine/physics': 'physics/index.js',
'esengine/physics3d': 'physics3d/index.js',
diff --git a/pipeline/src/export/contentSubsystems.ts b/pipeline/src/export/contentSubsystems.ts
new file mode 100644
index 000000000..00fabcc79
--- /dev/null
+++ b/pipeline/src/export/contentSubsystems.ts
@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file Which engine subsystems the shipped content actually reaches.
+ *
+ * Two questions read the same answer: what a target cannot render (a warning),
+ * and which subpaths a package has to import to get what it uses. Asking twice
+ * would be two walks of the same documents that could disagree about a scene.
+ *
+ * `targetSupport` owns the component→subsystem table and is deliberately free
+ * of node imports, so the walk lives here rather than beside it.
+ */
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { collectSubsystems, type Subsystem } from '../project/targetSupport';
+
+/** Subsystem → the shipped documents that use it, for a message that names one. */
+export async function contentSubsystems(
+ root: string, includedPaths: readonly string[],
+): Promise<Map<Subsystem, string[]>> {
+ const usage = new Map<Subsystem, string[]>();
+ for (const rel of includedPaths) {
+ const ext = path.extname(rel).toLowerCase();
+ if (ext !== '.esscene' && ext !== '.esprefab') continue;
+ let doc: unknown;
+ try {
+ doc = JSON.parse(await readFile(path.join(root, rel), 'utf8'));
+ } catch {
+ continue; // unreadable/!JSON — the cook already staged (and warned about) it
+ }
+ for (const subsystem of collectSubsystems(doc)) {
+ const files = usage.get(subsystem);
+ if (files) files.push(rel);
+ else usage.set(subsystem, [rel]);
+ }
+ }
+ return usage;
+}
diff --git a/pipeline/src/export/exportGame.ts b/pipeline/src/export/exportGame.ts
index ab113c1df..3ea63018c 100644
--- a/pipeline/src/export/exportGame.ts
+++ b/pipeline/src/export/exportGame.ts
@@ -66,7 +66,8 @@ import type { DesktopPackaging, SteamPackaging } from '../project/format';
import type { SizeBudget } from '../project/sizeBudget';
import { measureBuild, type BuildSizeReport } from './sizeReport';
import { loadProjectModules, sideModuleDeclarations, stageProjectModules } from './projectModules';
-import { collectSubsystems, subsystemGapWarnings, targetGaps, type Subsystem } from '../project/targetSupport';
+import { subsystemGapWarnings, targetGaps } from '../project/targetSupport';
+import { contentSubsystems } from './contentSubsystems';
import { scanSideModuleIds, sideModuleFiles, shipsSideModule, textureDecoderBytes } from '../bundle/sideModuleScan';
import { MODULES, NATIVE_MODULE_REGISTRY } from '../../../tools/nativeScriptModules.js';
@@ -227,23 +228,7 @@ async function dropSourceMapRefs(dir: string): Promise<void> {
*/
async function unsupportedContentWarnings(root: string, includedPaths: string[], platform: ExportPlatform): Promise<string[]> {
if (targetGaps(platform).length === 0) return [];
- const usage = new Map<Subsystem, string[]>();
- for (const rel of includedPaths) {
- const ext = path.extname(rel).toLowerCase();
- if (ext !== '.esscene' && ext !== '.esprefab') continue;
- let doc: unknown;
- try {
- doc = JSON.parse(await readFile(path.join(root, rel), 'utf8'));
- } catch {
- continue; // unreadable/!JSON — the cook already staged (and warned about) it
- }
- for (const subsystem of collectSubsystems(doc)) {
- const files = usage.get(subsystem);
- if (files) files.push(rel);
- else usage.set(subsystem, [rel]);
- }
- }
- return subsystemGapWarnings(platform, usage);
+ return subsystemGapWarnings(platform, await contentSubsystems(root, includedPaths));
}
export interface ExportGameResult {
diff --git a/pipeline/src/export/exportMiniGame.ts b/pipeline/src/export/exportMiniGame.ts
index 3d111eb92..42b6b3a77 100644
--- a/pipeline/src/export/exportMiniGame.ts
+++ b/pipeline/src/export/exportMiniGame.ts
@@ -51,6 +51,8 @@ import { loadProjectModules, sideModuleDeclarations, stageProjectModules } from
import { buildCompiledSystems, type BuildMode } from '../bundle/buildCompiledSystems';
import { resolveEmcc, runEmcc } from '../bundle/emccPath';
import type { MiniGameExportProfile, MiniGameVendor } from './miniGameExportProfile';
+import { contentSubsystems } from './contentSubsystems';
+import type { Subsystem } from '../project/targetSupport';
@@ -460,6 +462,13 @@ export async function exportMiniGame(profile: MiniGameExportProfile, opts: {
physics3d: 'esengine/physics3d',
dragonbones: 'esengine/dragonbones',
};
+ // A subsystem with no wasm of its own leaves no trace in the side-module scan,
+ // so its evidence is the content: a scene holding a Tilemap is what says the
+ // package needs the tilemap subpath.
+ const CONTENT_SUBPATH: Partial<Record<Subsystem, string>> = {
+ tilemap: 'esengine/tilemap',
+ };
+ const usedSubsystems = await contentSubsystems(opts.root, cook.includedPaths);
const needed = new Set(sideModules.map((m) => m.id));
const wantsVideo = needed.has('videodec');
// Only when the SDK build actually produced one: a tree without it (an older
@@ -470,9 +479,10 @@ export async function exportMiniGame(profile: MiniGameExportProfile, opts: {
? profile.sdkLeanEntryFile : null;
const lean = !!leanEntry && !wantsVideo;
const installs = lean
- ? [...new Set([...needed].map((id) => (id.startsWith('spine:')
- ? 'esengine/spine'
- : OPTIONAL_SUBPATH[id] ?? '')).filter(Boolean))].sort()
+ ? [...new Set([
+ ...[...needed].map((id) => (id.startsWith('spine:') ? 'esengine/spine' : OPTIONAL_SUBPATH[id] ?? '')),
+ ...[...usedSubsystems.keys()].map((s) => CONTENT_SUBPATH[s] ?? ''),
+ ].filter(Boolean))].sort()
: [];
const entrySrc =
diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.md
index 3a3852b48..01fb1503a 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 · 96 beta · 1837 experimental · 3 deprecated
+Symbols: 115 public · 91 beta · 1735 experimental · 3 deprecated
## ABI_LAYOUT_HASH — const @experimental
```
@@ -1703,16 +1703,6 @@ static prototype: BtPlugin
Map<string, NodeState>
```
-## BuildNavGridOptions — interface @experimental
-```
-blockedTileIds: Iterable<number> | undefined
-cellSize: number
-height: number
-isBlocked: ((tileId: number) => boolean) | undefined
-origin: Vec2 | undefined
-width: number
-```
-
## BuildNavMeshOptions — interface @experimental
```
agentHeight: number | undefined
@@ -1840,11 +1830,6 @@ sprite: number | undefined
16
```
-## CHUNK_SIZE — const @experimental
-```
-16
-```
-
## CLIP_EPSILON — const @experimental
```
0.00001
@@ -1855,16 +1840,6 @@ sprite: number | undefined
24
```
-## COLLISION_BRUSHES — const @experimental
-```
-CollisionBrush[]
-```
-
-## COLLISION_PALETTE_REF — const @experimental
-```
-"builtin:collision"
-```
-
## COMBAT_ATTACK_END — const @experimental
```
"attack-end"
@@ -2454,13 +2429,6 @@ shape: Collider3DShape
| { kind: 'capsule'; radius: number; halfHeight: number }
```
-## CollisionBrush — interface @experimental
-```
-collision: ResolvedTileCollision
-id: number
-key: string
-```
-
## CollisionEnterEvent — interface @experimental
```
contactX: number
@@ -2482,13 +2450,6 @@ pointX: number
pointY: number
```
-## CollisionMaterial — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-restitution: number | undefined
-```
-
## Color — interface @public
```
a: number
@@ -2918,13 +2879,6 @@ normals: Float32Array<ArrayBufferLike>
positions: Float32Array<ArrayBufferLike>
```
-## DecodedChunk — interface @experimental
-```
-tiles: Uint16Array<ArrayBufferLike>
-x: number
-y: number
-```
-
## DecodedPixels — interface @experimental
```
height: number
@@ -4914,38 +4868,6 @@ uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
-## LoadedTilemapLayer — type @experimental
-```
-TiledLayerData
-```
-
-## LoadedTilemapSource — interface @experimental
-```
-collisionTileIds: number[] | undefined
-hexSideLength: number | undefined
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[] | undefined
-orientation: string | undefined
-staggerAxis: string | undefined
-staggerIndex: string | undefined
-tileAnimations: Map<number, { tileId: number; duration: number; }[]> | undefined
-tileHeight: number
-tileProperties: Map<number, Map<string, string>> | undefined
-tileShapes: Map<number, ResolvedTileCollision> | undefined
-tileWidth: number
-tilesets: LoadedTilemapTileset[]
-```
-
-## LoadedTilemapTileset — interface @experimental
-```
-columns: number
-firstId: number
-margin: number
-rows: number
-spacing: number
-textureHandle: number
-```
-
## LocalTransform — const @experimental @deprecated
```
BuiltinComponentDef<TransformData>
@@ -7532,24 +7454,6 @@ folder: string
name: string
```
-## ResolvedTileCollision — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-oneWay: { nx: number; ny: number; } | undefined
-restitution: number | undefined
-sensor: boolean | undefined
-shape: { type: "box"; } | { type: "polygon"; points: [number, number][]; } | { type: "circle"; cx: number; cy: number; r: number; }
-```
-
-## ResolvedTileset — interface @experimental
-```
-asset: TilesetAsset
-textureHandle: number
-textureHeight: number | undefined
-textureWidth: number | undefined
-```
-
## ResourceDef — interface @public
```
@internal _default: T
@@ -9124,86 +9028,11 @@ reads: readonly string[] | undefined
writes: readonly string[] | undefined
```
-## TB_E — const @experimental
-```
-2
-```
-
-## TB_N — const @experimental
-```
-1
-```
-
-## TB_NE — const @experimental
-```
-16
-```
-
-## TB_NW — const @experimental
-```
-128
-```
-
-## TB_S — const @experimental
-```
-4
-```
-
-## TB_SE — const @experimental
-```
-32
-```
-
-## TB_SW — const @experimental
-```
-64
-```
-
-## TB_W — const @experimental
-```
-8
-```
-
-## TERRAIN_NEIGHBORS — const @experimental
-```
-readonly { dx: number; dy: number; bit: number; }[]
-```
-
## THEME_COLOR_ROLES — const @experimental
```
readonly (keyof ThemeColors)[]
```
-## TILESET_FORMAT_VERSION — const @experimental
-```
-"1"
-```
-
-## TILE_FLAGS_MASK — const @experimental
-```
-number
-```
-
-## TILE_FLIP_D — const @experimental
-```
-32768
-```
-
-## TILE_FLIP_H — const @experimental
-```
-8192
-```
-
-## TILE_FLIP_V — const @experimental
-```
-16384
-```
-
-## TILE_ID_MASK — const @experimental
-```
-8191
-```
-
## TIMELINE_FORMAT_VERSION — const @experimental
```
"1.2"
@@ -9255,29 +9084,6 @@ setPaused: (paused: boolean) => void
suspendAudio: () => void
```
-## TerrainColor — interface @experimental
-```
-color: string
-name: string
-```
-
-## TerrainIndex — interface @experimental
-```
-byMask: Map<number, number>
-mode: TerrainMode
-```
-
-## TerrainIndices — interface @experimental
-```
-sets: Map<number, TerrainIndex>
-tileTerrain: Map<number, number>
-```
-
-## TerrainMode — type @experimental
-```
-'edge' | 'corner' | 'wang'
-```
-
## Text — const @public
```
ComponentDef<TextData>
@@ -9451,12 +9257,6 @@ type: "text"
(typeof TextVerticalAlign)[keyof typeof TextVerticalAlign]
```
-## TextureDimensions — interface @experimental
-```
-height: number
-width: number
-```
-
## TextureFilter — type @experimental
```
(typeof TextureFilter)[keyof typeof TextureFilter]
@@ -9610,237 +9410,6 @@ moveSpeed: number
rotationSpeed: number
```
-## TileCollisionPiece — interface @experimental
-```
-center: Vec2
-circles: { c: Vec2; r: number; }[]
-oneWay: { nx: number; ny: number; } | null
-polylines: Vec2[][]
-sensor: boolean
-```
-
-## TileCollisionShape — type @experimental
-```
-| { type: 'box' }
- | { type: 'polygon'; points: [number, number][] }
- | { type: 'circle'; cx: number; cy: number; r: number }
-```
-
-## TileFlags — interface @experimental
-```
-flipD: boolean
-flipH: boolean
-flipV: boolean
-```
-
-## TileGridParams — interface @experimental
-```
-hexSideLength: number | undefined
-orientation: number
-staggerAxisX: boolean | undefined
-staggerIndexEven: boolean | undefined
-tileHeight: number
-tileWidth: number
-```
-
-## TileStamp — interface @experimental
-```
-cells: number[]
-h: number
-w: number
-```
-
-## TiledLayerData — interface @experimental
-```
-chunks: TiledChunkData[]
-height: number
-infinite: boolean
-name: string
-opacity: number
-parallaxX: number
-parallaxY: number
-tiles: Uint16Array<ArrayBufferLike>
-tintColor: { r: number; g: number; b: number; a: number; }
-visible: boolean
-width: number
-```
-
-## TiledMapData — interface @experimental
-```
-collisionTileIds: number[]
-height: number
-hexSideLength: number
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[]
-orientation: string
-staggerAxis: string
-staggerIndex: string
-tileAnimations: Map<number, TiledAnimFrame[]>
-tileHeight: number
-tileProperties: Map<number, Map<string, string>>
-tileShapes: Map<number, ResolvedTileCollision>
-tileWidth: number
-tilesets: TiledTilesetData[]
-width: number
-```
-
-## TiledTilesetData — interface @experimental
-```
-collectionTiles: TiledCollectionTile[] | undefined
-columns: number
-firstGid: number
-image: string
-margin: number | undefined
-name: string
-spacing: number | undefined
-tileCount: number
-tileHeight: number
-tileWidth: number
-```
-
-## Tilemap — const @experimental
-```
-ComponentDef<TilemapData>
-```
-
-## TilemapAPI — const @experimental
-```
-{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }
-```
-
-## TilemapData — interface @experimental
-```
-source: string
-```
-
-## TilemapLayer — const @beta
-```
-BuiltinComponentDef<TilemapLayerData>
-```
-
-## TilemapLayerData — interface @beta
-```
-cellSize: Vec2
-hexSideLength: number
-opacity: number
-orientation: TilemapOrientation
-originOffset: Vec2
-parallaxFactor: Vec2
-renderLayer: number
-staggerAxis: TilemapStaggerAxis
-staggerIndex: TilemapStaggerIndex
-tileset: number
-tilesetColumns: number
-tintColor: Color
-visible: boolean
-```
-
-## TilemapLiveSync — const @experimental
-```
-{ setLayerTilesets(app: App, entity: number, refs: readonly string[]): void; }
-```
-
-## TilemapOrientation — enum @beta
-```
-Hexagonal = 3
-Isometric = 1
-Orthogonal = 0
-Staggered = 2
-```
-
-## TilemapPlugin — class @experimental
-```
-build: (app: App) => void
-cleanup: (app?: App) => void
-name: string
-static new (): TilemapPlugin
-static prototype: TilemapPlugin
-```
-
-## TilemapStaggerAxis — enum @beta
-```
-X = 1
-Y = 0
-```
-
-## TilemapStaggerIndex — enum @beta
-```
-Even = 1
-Odd = 0
-```
-
-## Tilemaps — const @experimental
-```
-ResourceDef<{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }>
-```
-
-## TilesetAnimFrame — interface @experimental
-```
-durationMs: number
-tile: number
-```
-
-## TilesetAsset — interface @experimental
-```
-columns: number
-extrude: number
-margin: number
-spacing: number
-terrains: TilesetTerrain[] | undefined
-texture: string
-tileCount: number | undefined
-tileHeight: number
-tileWidth: number
-tiles: Record<number, TilesetTile>
-version: string
-```
-
-## TilesetCollision — type @experimental
-```
-TileCollisionShape & {
- /** One-way (jump-through) platform: contacts from behind this normal pass through. */
- oneWay?: { nx: number; ny: number };
- /** Non-solid trigger volume (fires events, no physical response). */
- sensor?: boolean;
- /** Physics material overrides (absent = engine defaults). */
- density?: number;
- friction?: number;
- restitution?: number;
-}
-```
-
-## TilesetModel — interface @experimental
-```
-animations: Map<number, { tileId: number; duration: number; }[]>
-collidableTileIds: number[]
-slots: TilesetModelSlot[]
-tileShapes: Map<number, ResolvedTileCollision>
-```
-
-## TilesetTerrain — interface @experimental
-```
-color: string | undefined
-colors: TerrainColor[] | undefined
-mode: TerrainMode
-name: string
-```
-
-## TilesetTile — interface @experimental
-```
-animation: TilesetAnimFrame[] | undefined
-collision: TilesetCollision | undefined
-probability: number | undefined
-properties: Record<string, string> | undefined
-terrain: TilesetTileTerrain | undefined
-```
-
-## TilesetTileTerrain — interface @experimental
-```
-corners: number[] | undefined
-mask: number | undefined
-set: number
-```
-
## Time — const @public
```
ResourceDef<TimeData>
@@ -10626,12 +10195,6 @@ x: number
y: number
```
-## Vec2Like — interface @experimental
-```
-x: number
-y: number
-```
-
## Vec3 — interface @public
```
x: number
@@ -10778,17 +10341,6 @@ MoveBasis
"world"
```
-## WangIndex — interface @experimental
-```
-byKey: Map<number, number>
-```
-
-## WangIndices — interface @experimental
-```
-sets: Map<number, WangIndex>
-tileTerrain: Map<number, number>
-```
-
## WeChatSideModuleFactories — type @experimental
```
Partial<Record<SideModuleId, EmscriptenFactory>>
@@ -11404,11 +10956,6 @@ AssetPlugin
(atlas: CookedAtlasInfo, pagePath: string): Pick<CatalogEntry, "atlas" | "frame" | "uv">
```
-## atlasCells — function @experimental
-```
-(size: number, margin: number, tileSize: number, spacing: number): number
-```
-
## audioPlugin — const @experimental
```
AudioPlugin
@@ -11509,11 +11056,6 @@ BtPlugin
(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>
```
-## buildCollisionPaletteModel — function @experimental
-```
-(material?: CollisionMaterial): TilesetModel
-```
-
## buildFrameProfile — function @experimental
```
(input: FrameProfileInput): FrameProfile
@@ -11524,11 +11066,6 @@ BtPlugin
(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh
```
-## buildTerrainIndices — function @experimental
-```
-(asset: TilesetAsset): TerrainIndices
-```
-
## buildText — function @experimental
```
(init?: TextInit): TextData
@@ -11549,11 +11086,6 @@ BtPlugin
(base: PrefabData, baseRef: string, name: string, delta: { overrides: readonly PrefabOverride[]; added: readonly AddedEntity[]; }): PrefabData
```
-## buildWangIndices — function @experimental
-```
-(asset: TilesetAsset): WangIndices
-```
-
## builtinBusVolume — function @experimental
```
(name: string): number | null
@@ -11614,11 +11146,6 @@ BtPlugin
(type: BtNodeType): boolean
```
-## canonicalMask — function @experimental
-```
-(mode: TerrainMode, mask: number): number
-```
-
## captureFramePixels — function @beta
```
(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>
@@ -11784,11 +11311,6 @@ BtPlugin
(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]
```
-## collidableTileIds — function @experimental
-```
-(asset: TilesetAsset): number[]
-```
-
## collider2DOutline — function @experimental
```
(shape: Collider2DShape, center: Vec2, angle: number, ppu: number): Collider2DOutline
@@ -11799,11 +11321,6 @@ BtPlugin
(shape: Collider3DShape, segments?: number): Vec3[][]
```
-## collisionRefWithMaterial — function @experimental
-```
-(material: CollisionMaterial): string
-```
-
## color — const @experimental
```
(r?: number, g?: number, b?: number, a?: number) => Color
@@ -12014,11 +11531,6 @@ Plugin
(opts: TextInputOptions): TextInputHandle
```
-## createTileset — function @experimental
-```
-(texture: string, tileWidth?: number, tileHeight?: number, columns?: number): TilesetAsset
-```
-
## createTimelineMotionDriver — function @experimental
```
(timeline: TimelineAPI): MotionDriver<AnimatorClipMotion>
@@ -12074,11 +11586,6 @@ Plugin
(bytes: Uint8Array): MeshData
```
-## decodeTilemapChunks — function @experimental
-```
-(blob: string): DecodedChunk[]
-```
-
## decomposePolygon2D — function @experimental
```
(vertices: readonly Vec2[]): PolygonDecomposition
@@ -12349,11 +11856,6 @@ DragPlugin
(data: MeshData): Uint8Array
```
-## encodeTile — function @experimental
-```
-(id: number, flags?: TileFlags): number
-```
-
## engineWebGPUFeatures — function @experimental
```
(adapter: WebGPUAdapterLike): string[]
@@ -12519,26 +12021,6 @@ EventBindingPlugin
(prefab: PrefabData, overrides: PrefabOverride[], ctx: FlattenContext): FlattenResult
```
-## flipFlagsH — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipFlagsV — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipStampH — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
-## flipStampV — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## flushPendingRegistrations — function @experimental
```
(app: App): void
@@ -12769,11 +12251,6 @@ GameplayPlugin
(key: string): CompiledScriptGraph | undefined
```
-## getTextureDimensions — function @experimental
-```
-(handle: number): TextureDimensions | null
-```
-
## getTheme — function @experimental
```
(): ThemeTokens
@@ -12934,11 +12411,6 @@ InputRouter
(graph: ScriptGraph): boolean
```
-## isCollisionPaletteRef — function @experimental
-```
-(refs: readonly string[]): boolean
-```
-
## isCustomExtension — function @experimental
```
(path: string): boolean
@@ -12959,11 +12431,6 @@ InputRouter
(): boolean
```
-## isEmptyStamp — function @experimental
-```
-(s: TileStamp): boolean
-```
-
## isEntityActive — function @experimental
```
(world: World, entity: Entity): boolean
@@ -12979,11 +12446,6 @@ InputRouter
(): boolean
```
-## isHexOrientation — function @experimental
-```
-(orientation: number): boolean
-```
-
## isKnownAssetExtension — function @experimental
```
(ext: string): boolean
@@ -12994,11 +12456,6 @@ InputRouter
(): boolean
```
-## isNonOrthogonal — function @experimental
-```
-(orientation: number): boolean
-```
-
## isPlatformInitialized — function @experimental
```
(): boolean
@@ -13114,11 +12571,6 @@ LifecyclePlugin
(world: World, sceneData: SceneData, options?: SceneLoadOptions): Promise<Map<number, Entity>>
```
-## loadTiledMap — function @experimental
-```
-(world: World, mapData: TiledMapData, textureHandles: Map<string, number>, options?: TilemapLoadOptions): Entity[]
-```
-
## localizationPlugin — const @experimental
```
LocalizationPlugin
@@ -13259,16 +12711,6 @@ MeshRendererPlugin
(world: World, layers?: number): boolean
```
-## navGridFromTilemapLayer — function @experimental
-```
-(entity: Entity, opts: BuildNavGridOptions): NavGrid
-```
-
-## navGridFromTiles — function @experimental
-```
-(getTile: (x: number, y: number) => number, opts: BuildNavGridOptions): NavGrid
-```
-
## navLinkDigest — function @experimental
```
(links: readonly NavLinkSegment[]): number
@@ -13299,11 +12741,6 @@ NavPlugin
(mode: string | undefined | null): BundleMode
```
-## normalizeCornerMask — function @experimental
-```
-(mask: number): number
-```
-
## onCameraCommitChanged — function @beta
```
(fn: CameraCommitListener): () => void
@@ -13329,11 +12766,6 @@ NavPlugin
(yawDeg: number, pitchDeg: number): Vec3
```
-## orientationPerm — function @experimental
-```
-(flags: TileFlags): Perm
-```
-
## overlayPose — function @experimental
```
(acc: Pose, layer: Pose, weight: number, world: PoseWorld, reach: LayerReach | null): void
@@ -13344,11 +12776,6 @@ NavPlugin
(semantics: { semantic: number; components: number; type: number; }[]): { channels: MeshChannelDesc[]; vertexStride: number; }
```
-## packCorners — function @experimental
-```
-(tl: number, tr: number, br: number, bl: number): number
-```
-
## packagedAppOptions — function @experimental
```
(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces"; msaaSamples?: number; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
@@ -13399,11 +12826,6 @@ NavPlugin
(raw: unknown): BusEffectDef[]
```
-## parseCollisionMaterial — function @experimental
-```
-(refs: readonly string[]): CollisionMaterial
-```
-
## parseLocaleTable — function @experimental
```
(text: string, path: string): LocaleTableAsset
@@ -13424,26 +12846,11 @@ NavPlugin
(colors?: Record<string, string>): ThemeOverrides | undefined
```
-## parseTileset — function @experimental
-```
-(rawJson: unknown): TilesetAsset
-```
-
## parseTimelineAsset — function @experimental
```
(rawJson: unknown): TimelineAsset
```
-## parseTmjJson — function @experimental
-```
-(json: Record<string, unknown>): TiledMapData | null
-```
-
-## parseTmjWithExternals — function @experimental
-```
-(json: Record<string, unknown>, resolveExternal: (source: string) => Promise<string>): Promise<TiledMapData | null>
-```
-
## particlePlugin — const @experimental
```
ParticlePlugin
@@ -13949,11 +13356,6 @@ ReplicationPlugin
(projectRelPath: string, config: AssetGroupsConfig | null | undefined): ResolvedAtlas | null
```
-## resolveAutotile — function @experimental
-```
-(index: TerrainIndex, neighbors: readonly boolean[]): number
-```
-
## resolveBindingTarget — function @experimental
```
(world: World, from: Entity, name: string): Entity | null
@@ -13979,31 +13381,11 @@ ReplicationPlugin
(scene: SceneData, read: (ref: string) => Promise<unknown | null>): Promise<(ref: string) => PrefabRoot | null>
```
-## resolveRelativePath — function @experimental
-```
-(basePath: string, relativePath: string): string
-```
-
## resolveThemeTokens — function @experimental
```
(base: "dark" | "light", overrides?: ThemeOverrides): ThemeTokens
```
-## resolveTilesetModel — function @experimental
-```
-(tilesets: ResolvedTileset[]): TilesetModel
-```
-
-## resolveWang — function @experimental
-```
-(index: WangIndex, corners: readonly number[]): number
-```
-
-## resolvedTileset — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): ResolvedTileset | undefined
-```
-
## restoreToFull — function @experimental
```
(world: World, entity: Entity): void
@@ -14019,16 +13401,6 @@ ReplicationPlugin
(delta: { x: number; z: number; }, seconds: number): { x: number; z: number; }
```
-## rotateFlagsCW — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## rotateStampCW — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## rotateVec3ByQuat — function @experimental
```
(rot: Quat, v: Vec3): Vec3
@@ -14189,11 +13561,6 @@ ScriptGraphPlugin
(world: World, sceneName?: string): SceneData
```
-## serializeTileset — function @experimental
-```
-(asset: TilesetAsset): Record<string, unknown>
-```
-
## serializeTimelineAsset — function @experimental
```
(asset: TimelineAsset): Record<string, unknown>
@@ -14464,11 +13831,6 @@ ServicesPlugin
(graph: ScriptGraph): ScriptGraphSignature
```
-## singleStamp — function @experimental
-```
-(raw: number): TileStamp
-```
-
## solveAnimatorIK — function @experimental
```
(world: World, rigRoot: Entity, pose: Pose, constraints: readonly AnimatorIK[], params: MotionParams, resolveJoint?: JointResolver): void
@@ -14604,41 +13966,6 @@ TextPlugin
<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status
```
-## tileCellCenter — function @experimental
-```
-(p: TileGridParams, tx: number, ty: number): Vec2Like
-```
-
-## tileCellOutline — function @experimental
-```
-(p: TileGridParams): Vec2Like[]
-```
-
-## tileCollisionOutlines — function @experimental
-```
-(chunks: DecodedChunk[], model: TilesetModel, tileW: number, tileH: number, originX: number, originY: number): TileCollisionPiece[]
-```
-
-## tileFlagsOf — function @experimental
-```
-(raw: number): TileFlags
-```
-
-## tileIdOf — function @experimental
-```
-(raw: number): number
-```
-
-## tilemapPlugin — const @experimental
-```
-TilemapPlugin
-```
-
-## tilemapSource — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): LoadedTilemapSource | undefined
-```
-
## timelinePlugin — const @experimental
```
TimelinePlugin
@@ -14789,11 +14116,6 @@ UIVisibilityPlugin
(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition
```
-## usesStagger — function @experimental
-```
-(orientation: number): boolean
-```
-
## 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 d7a6704a1..b39192679 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 · 101 beta · 1856 experimental · 3 deprecated
+Symbols: 115 public · 96 beta · 1754 experimental · 3 deprecated
## ABI_LAYOUT_HASH — const @experimental
```
@@ -1703,16 +1703,6 @@ static prototype: BtPlugin
Map<string, NodeState>
```
-## BuildNavGridOptions — interface @experimental
-```
-blockedTileIds: Iterable<number> | undefined
-cellSize: number
-height: number
-isBlocked: ((tileId: number) => boolean) | undefined
-origin: Vec2 | undefined
-width: number
-```
-
## BuildNavMeshOptions — interface @experimental
```
agentHeight: number | undefined
@@ -1840,11 +1830,6 @@ sprite: number | undefined
16
```
-## CHUNK_SIZE — const @experimental
-```
-16
-```
-
## CLIP_EPSILON — const @experimental
```
0.00001
@@ -1855,16 +1840,6 @@ sprite: number | undefined
24
```
-## COLLISION_BRUSHES — const @experimental
-```
-CollisionBrush[]
-```
-
-## COLLISION_PALETTE_REF — const @experimental
-```
-"builtin:collision"
-```
-
## COMBAT_ATTACK_END — const @experimental
```
"attack-end"
@@ -2454,13 +2429,6 @@ shape: Collider3DShape
| { kind: 'capsule'; radius: number; halfHeight: number }
```
-## CollisionBrush — interface @experimental
-```
-collision: ResolvedTileCollision
-id: number
-key: string
-```
-
## CollisionEnterEvent — interface @experimental
```
contactX: number
@@ -2482,13 +2450,6 @@ pointX: number
pointY: number
```
-## CollisionMaterial — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-restitution: number | undefined
-```
-
## Color — interface @public
```
a: number
@@ -2926,13 +2887,6 @@ normals: Float32Array<ArrayBufferLike>
positions: Float32Array<ArrayBufferLike>
```
-## DecodedChunk — interface @experimental
-```
-tiles: Uint16Array<ArrayBufferLike>
-x: number
-y: number
-```
-
## DecodedPixels — interface @experimental
```
height: number
@@ -4922,38 +4876,6 @@ uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
-## LoadedTilemapLayer — type @experimental
-```
-TiledLayerData
-```
-
-## LoadedTilemapSource — interface @experimental
-```
-collisionTileIds: number[] | undefined
-hexSideLength: number | undefined
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[] | undefined
-orientation: string | undefined
-staggerAxis: string | undefined
-staggerIndex: string | undefined
-tileAnimations: Map<number, { tileId: number; duration: number; }[]> | undefined
-tileHeight: number
-tileProperties: Map<number, Map<string, string>> | undefined
-tileShapes: Map<number, ResolvedTileCollision> | undefined
-tileWidth: number
-tilesets: LoadedTilemapTileset[]
-```
-
-## LoadedTilemapTileset — interface @experimental
-```
-columns: number
-firstId: number
-margin: number
-rows: number
-spacing: number
-textureHandle: number
-```
-
## LocalTransform — const @experimental @deprecated
```
BuiltinComponentDef<TransformData>
@@ -7725,24 +7647,6 @@ folder: string
name: string
```
-## ResolvedTileCollision — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-oneWay: { nx: number; ny: number; } | undefined
-restitution: number | undefined
-sensor: boolean | undefined
-shape: { type: "box"; } | { type: "polygon"; points: [number, number][]; } | { type: "circle"; cx: number; cy: number; r: number; }
-```
-
-## ResolvedTileset — interface @experimental
-```
-asset: TilesetAsset
-textureHandle: number
-textureHeight: number | undefined
-textureWidth: number | undefined
-```
-
## ResourceDef — interface @public
```
@internal _default: T
@@ -9317,86 +9221,11 @@ reads: readonly string[] | undefined
writes: readonly string[] | undefined
```
-## TB_E — const @experimental
-```
-2
-```
-
-## TB_N — const @experimental
-```
-1
-```
-
-## TB_NE — const @experimental
-```
-16
-```
-
-## TB_NW — const @experimental
-```
-128
-```
-
-## TB_S — const @experimental
-```
-4
-```
-
-## TB_SE — const @experimental
-```
-32
-```
-
-## TB_SW — const @experimental
-```
-64
-```
-
-## TB_W — const @experimental
-```
-8
-```
-
-## TERRAIN_NEIGHBORS — const @experimental
-```
-readonly { dx: number; dy: number; bit: number; }[]
-```
-
## THEME_COLOR_ROLES — const @experimental
```
readonly (keyof ThemeColors)[]
```
-## TILESET_FORMAT_VERSION — const @experimental
-```
-"1"
-```
-
-## TILE_FLAGS_MASK — const @experimental
-```
-number
-```
-
-## TILE_FLIP_D — const @experimental
-```
-32768
-```
-
-## TILE_FLIP_H — const @experimental
-```
-8192
-```
-
-## TILE_FLIP_V — const @experimental
-```
-16384
-```
-
-## TILE_ID_MASK — const @experimental
-```
-8191
-```
-
## TIMELINE_FORMAT_VERSION — const @experimental
```
"1.2"
@@ -9448,29 +9277,6 @@ setPaused: (paused: boolean) => void
suspendAudio: () => void
```
-## TerrainColor — interface @experimental
-```
-color: string
-name: string
-```
-
-## TerrainIndex — interface @experimental
-```
-byMask: Map<number, number>
-mode: TerrainMode
-```
-
-## TerrainIndices — interface @experimental
-```
-sets: Map<number, TerrainIndex>
-tileTerrain: Map<number, number>
-```
-
-## TerrainMode — type @experimental
-```
-'edge' | 'corner' | 'wang'
-```
-
## Text — const @public
```
ComponentDef<TextData>
@@ -9644,12 +9450,6 @@ type: "text"
(typeof TextVerticalAlign)[keyof typeof TextVerticalAlign]
```
-## TextureDimensions — interface @experimental
-```
-height: number
-width: number
-```
-
## TextureFilter — type @experimental
```
(typeof TextureFilter)[keyof typeof TextureFilter]
@@ -9803,237 +9603,6 @@ moveSpeed: number
rotationSpeed: number
```
-## TileCollisionPiece — interface @experimental
-```
-center: Vec2
-circles: { c: Vec2; r: number; }[]
-oneWay: { nx: number; ny: number; } | null
-polylines: Vec2[][]
-sensor: boolean
-```
-
-## TileCollisionShape — type @experimental
-```
-| { type: 'box' }
- | { type: 'polygon'; points: [number, number][] }
- | { type: 'circle'; cx: number; cy: number; r: number }
-```
-
-## TileFlags — interface @experimental
-```
-flipD: boolean
-flipH: boolean
-flipV: boolean
-```
-
-## TileGridParams — interface @experimental
-```
-hexSideLength: number | undefined
-orientation: number
-staggerAxisX: boolean | undefined
-staggerIndexEven: boolean | undefined
-tileHeight: number
-tileWidth: number
-```
-
-## TileStamp — interface @experimental
-```
-cells: number[]
-h: number
-w: number
-```
-
-## TiledLayerData — interface @experimental
-```
-chunks: TiledChunkData[]
-height: number
-infinite: boolean
-name: string
-opacity: number
-parallaxX: number
-parallaxY: number
-tiles: Uint16Array<ArrayBufferLike>
-tintColor: { r: number; g: number; b: number; a: number; }
-visible: boolean
-width: number
-```
-
-## TiledMapData — interface @experimental
-```
-collisionTileIds: number[]
-height: number
-hexSideLength: number
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[]
-orientation: string
-staggerAxis: string
-staggerIndex: string
-tileAnimations: Map<number, TiledAnimFrame[]>
-tileHeight: number
-tileProperties: Map<number, Map<string, string>>
-tileShapes: Map<number, ResolvedTileCollision>
-tileWidth: number
-tilesets: TiledTilesetData[]
-width: number
-```
-
-## TiledTilesetData — interface @experimental
-```
-collectionTiles: TiledCollectionTile[] | undefined
-columns: number
-firstGid: number
-image: string
-margin: number | undefined
-name: string
-spacing: number | undefined
-tileCount: number
-tileHeight: number
-tileWidth: number
-```
-
-## Tilemap — const @experimental
-```
-ComponentDef<TilemapData>
-```
-
-## TilemapAPI — const @experimental
-```
-{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }
-```
-
-## TilemapData — interface @experimental
-```
-source: string
-```
-
-## TilemapLayer — const @beta
-```
-BuiltinComponentDef<TilemapLayerData>
-```
-
-## TilemapLayerData — interface @beta
-```
-cellSize: Vec2
-hexSideLength: number
-opacity: number
-orientation: TilemapOrientation
-originOffset: Vec2
-parallaxFactor: Vec2
-renderLayer: number
-staggerAxis: TilemapStaggerAxis
-staggerIndex: TilemapStaggerIndex
-tileset: number
-tilesetColumns: number
-tintColor: Color
-visible: boolean
-```
-
-## TilemapLiveSync — const @experimental
-```
-{ setLayerTilesets(app: App, entity: number, refs: readonly string[]): void; }
-```
-
-## TilemapOrientation — enum @beta
-```
-Hexagonal = 3
-Isometric = 1
-Orthogonal = 0
-Staggered = 2
-```
-
-## TilemapPlugin — class @experimental
-```
-build: (app: App) => void
-cleanup: (app?: App) => void
-name: string
-static new (): TilemapPlugin
-static prototype: TilemapPlugin
-```
-
-## TilemapStaggerAxis — enum @beta
-```
-X = 1
-Y = 0
-```
-
-## TilemapStaggerIndex — enum @beta
-```
-Even = 1
-Odd = 0
-```
-
-## Tilemaps — const @experimental
-```
-ResourceDef<{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }>
-```
-
-## TilesetAnimFrame — interface @experimental
-```
-durationMs: number
-tile: number
-```
-
-## TilesetAsset — interface @experimental
-```
-columns: number
-extrude: number
-margin: number
-spacing: number
-terrains: TilesetTerrain[] | undefined
-texture: string
-tileCount: number | undefined
-tileHeight: number
-tileWidth: number
-tiles: Record<number, TilesetTile>
-version: string
-```
-
-## TilesetCollision — type @experimental
-```
-TileCollisionShape & {
- /** One-way (jump-through) platform: contacts from behind this normal pass through. */
- oneWay?: { nx: number; ny: number };
- /** Non-solid trigger volume (fires events, no physical response). */
- sensor?: boolean;
- /** Physics material overrides (absent = engine defaults). */
- density?: number;
- friction?: number;
- restitution?: number;
-}
-```
-
-## TilesetModel — interface @experimental
-```
-animations: Map<number, { tileId: number; duration: number; }[]>
-collidableTileIds: number[]
-slots: TilesetModelSlot[]
-tileShapes: Map<number, ResolvedTileCollision>
-```
-
-## TilesetTerrain — interface @experimental
-```
-color: string | undefined
-colors: TerrainColor[] | undefined
-mode: TerrainMode
-name: string
-```
-
-## TilesetTile — interface @experimental
-```
-animation: TilesetAnimFrame[] | undefined
-collision: TilesetCollision | undefined
-probability: number | undefined
-properties: Record<string, string> | undefined
-terrain: TilesetTileTerrain | undefined
-```
-
-## TilesetTileTerrain — interface @experimental
-```
-corners: number[] | undefined
-mask: number | undefined
-set: number
-```
-
## Time — const @public
```
ResourceDef<TimeData>
@@ -10819,12 +10388,6 @@ x: number
y: number
```
-## Vec2Like — interface @experimental
-```
-x: number
-y: number
-```
-
## Vec3 — interface @public
```
x: number
@@ -10971,17 +10534,6 @@ MoveBasis
"world"
```
-## WangIndex — interface @experimental
-```
-byKey: Map<number, number>
-```
-
-## WangIndices — interface @experimental
-```
-sets: Map<number, WangIndex>
-tileTerrain: Map<number, number>
-```
-
## WeChatSideModuleFactories — type @experimental
```
Partial<Record<SideModuleId, EmscriptenFactory>>
@@ -11612,11 +11164,6 @@ AssetPlugin
(atlas: CookedAtlasInfo, pagePath: string): Pick<CatalogEntry, "atlas" | "frame" | "uv">
```
-## atlasCells — function @experimental
-```
-(size: number, margin: number, tileSize: number, spacing: number): number
-```
-
## audioPlugin — const @experimental
```
AudioPlugin
@@ -11717,11 +11264,6 @@ BtPlugin
(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>
```
-## buildCollisionPaletteModel — function @experimental
-```
-(material?: CollisionMaterial): TilesetModel
-```
-
## buildFrameProfile — function @experimental
```
(input: FrameProfileInput): FrameProfile
@@ -11732,11 +11274,6 @@ BtPlugin
(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh
```
-## buildTerrainIndices — function @experimental
-```
-(asset: TilesetAsset): TerrainIndices
-```
-
## buildText — function @experimental
```
(init?: TextInit): TextData
@@ -11757,11 +11294,6 @@ BtPlugin
(base: PrefabData, baseRef: string, name: string, delta: { overrides: readonly PrefabOverride[]; added: readonly AddedEntity[]; }): PrefabData
```
-## buildWangIndices — function @experimental
-```
-(asset: TilesetAsset): WangIndices
-```
-
## builtinBusVolume — function @experimental
```
(name: string): number | null
@@ -11822,11 +11354,6 @@ BtPlugin
(type: BtNodeType): boolean
```
-## canonicalMask — function @experimental
-```
-(mode: TerrainMode, mask: number): number
-```
-
## captureFramePixels — function @beta
```
(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>
@@ -11992,11 +11519,6 @@ BtPlugin
(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]
```
-## collidableTileIds — function @experimental
-```
-(asset: TilesetAsset): number[]
-```
-
## collider2DOutline — function @experimental
```
(shape: Collider2DShape, center: Vec2, angle: number, ppu: number): Collider2DOutline
@@ -12007,11 +11529,6 @@ BtPlugin
(shape: Collider3DShape, segments?: number): Vec3[][]
```
-## collisionRefWithMaterial — function @experimental
-```
-(material: CollisionMaterial): string
-```
-
## color — const @experimental
```
(r?: number, g?: number, b?: number, a?: number) => Color
@@ -12247,11 +11764,6 @@ Plugin
(opts: TextInputOptions): TextInputHandle
```
-## createTileset — function @experimental
-```
-(texture: string, tileWidth?: number, tileHeight?: number, columns?: number): TilesetAsset
-```
-
## createTimelineMotionDriver — function @experimental
```
(timeline: TimelineAPI): MotionDriver<AnimatorClipMotion>
@@ -12307,11 +11819,6 @@ Plugin
(bytes: Uint8Array): MeshData
```
-## decodeTilemapChunks — function @experimental
-```
-(blob: string): DecodedChunk[]
-```
-
## decomposePolygon2D — function @experimental
```
(vertices: readonly Vec2[]): PolygonDecomposition
@@ -12582,11 +12089,6 @@ DragPlugin
(data: MeshData): Uint8Array
```
-## encodeTile — function @experimental
-```
-(id: number, flags?: TileFlags): number
-```
-
## engineWebGPUFeatures — function @experimental
```
(adapter: WebGPUAdapterLike): string[]
@@ -12752,26 +12254,6 @@ EventBindingPlugin
(prefab: PrefabData, overrides: PrefabOverride[], ctx: FlattenContext): FlattenResult
```
-## flipFlagsH — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipFlagsV — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipStampH — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
-## flipStampV — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## flushPendingRegistrations — function @experimental
```
(app: App): void
@@ -13002,11 +12484,6 @@ GameplayPlugin
(key: string): CompiledScriptGraph | undefined
```
-## getTextureDimensions — function @experimental
-```
-(handle: number): TextureDimensions | null
-```
-
## getTheme — function @experimental
```
(): ThemeTokens
@@ -13177,11 +12654,6 @@ InputRouter
(graph: ScriptGraph): boolean
```
-## isCollisionPaletteRef — function @experimental
-```
-(refs: readonly string[]): boolean
-```
-
## isCustomExtension — function @experimental
```
(path: string): boolean
@@ -13202,11 +12674,6 @@ InputRouter
(): boolean
```
-## isEmptyStamp — function @experimental
-```
-(s: TileStamp): boolean
-```
-
## isEntityActive — function @experimental
```
(world: World, entity: Entity): boolean
@@ -13222,11 +12689,6 @@ InputRouter
(): boolean
```
-## isHexOrientation — function @experimental
-```
-(orientation: number): boolean
-```
-
## isKnownAssetExtension — function @experimental
```
(ext: string): boolean
@@ -13237,11 +12699,6 @@ InputRouter
(): boolean
```
-## isNonOrthogonal — function @experimental
-```
-(orientation: number): boolean
-```
-
## isPlatformInitialized — function @experimental
```
(): boolean
@@ -13357,11 +12814,6 @@ LifecyclePlugin
(world: World, sceneData: SceneData, options?: SceneLoadOptions): Promise<Map<number, Entity>>
```
-## loadTiledMap — function @experimental
-```
-(world: World, mapData: TiledMapData, textureHandles: Map<string, number>, options?: TilemapLoadOptions): Entity[]
-```
-
## localizationPlugin — const @experimental
```
LocalizationPlugin
@@ -13502,16 +12954,6 @@ MeshRendererPlugin
(world: World, layers?: number): boolean
```
-## navGridFromTilemapLayer — function @experimental
-```
-(entity: Entity, opts: BuildNavGridOptions): NavGrid
-```
-
-## navGridFromTiles — function @experimental
-```
-(getTile: (x: number, y: number) => number, opts: BuildNavGridOptions): NavGrid
-```
-
## navLinkDigest — function @experimental
```
(links: readonly NavLinkSegment[]): number
@@ -13542,11 +12984,6 @@ NavPlugin
(mode: string | undefined | null): BundleMode
```
-## normalizeCornerMask — function @experimental
-```
-(mask: number): number
-```
-
## onCameraCommitChanged — function @beta
```
(fn: CameraCommitListener): () => void
@@ -13572,11 +13009,6 @@ NavPlugin
(yawDeg: number, pitchDeg: number): Vec3
```
-## orientationPerm — function @experimental
-```
-(flags: TileFlags): Perm
-```
-
## overlayPose — function @experimental
```
(acc: Pose, layer: Pose, weight: number, world: PoseWorld, reach: LayerReach | null): void
@@ -13587,11 +13019,6 @@ NavPlugin
(semantics: { semantic: number; components: number; type: number; }[]): { channels: MeshChannelDesc[]; vertexStride: number; }
```
-## packCorners — function @experimental
-```
-(tl: number, tr: number, br: number, bl: number): number
-```
-
## packagedAppOptions — function @experimental
```
(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces"; msaaSamples?: number; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
@@ -13642,11 +13069,6 @@ NavPlugin
(raw: unknown): BusEffectDef[]
```
-## parseCollisionMaterial — function @experimental
-```
-(refs: readonly string[]): CollisionMaterial
-```
-
## parseLocaleTable — function @experimental
```
(text: string, path: string): LocaleTableAsset
@@ -13667,26 +13089,11 @@ NavPlugin
(colors?: Record<string, string>): ThemeOverrides | undefined
```
-## parseTileset — function @experimental
-```
-(rawJson: unknown): TilesetAsset
-```
-
## parseTimelineAsset — function @experimental
```
(rawJson: unknown): TimelineAsset
```
-## parseTmjJson — function @experimental
-```
-(json: Record<string, unknown>): TiledMapData | null
-```
-
-## parseTmjWithExternals — function @experimental
-```
-(json: Record<string, unknown>, resolveExternal: (source: string) => Promise<string>): Promise<TiledMapData | null>
-```
-
## particlePlugin — const @experimental
```
ParticlePlugin
@@ -14192,11 +13599,6 @@ ReplicationPlugin
(projectRelPath: string, config: AssetGroupsConfig | null | undefined): ResolvedAtlas | null
```
-## resolveAutotile — function @experimental
-```
-(index: TerrainIndex, neighbors: readonly boolean[]): number
-```
-
## resolveBindingTarget — function @experimental
```
(world: World, from: Entity, name: string): Entity | null
@@ -14222,31 +13624,11 @@ ReplicationPlugin
(scene: SceneData, read: (ref: string) => Promise<unknown | null>): Promise<(ref: string) => PrefabRoot | null>
```
-## resolveRelativePath — function @experimental
-```
-(basePath: string, relativePath: string): string
-```
-
## resolveThemeTokens — function @experimental
```
(base: "dark" | "light", overrides?: ThemeOverrides): ThemeTokens
```
-## resolveTilesetModel — function @experimental
-```
-(tilesets: ResolvedTileset[]): TilesetModel
-```
-
-## resolveWang — function @experimental
-```
-(index: WangIndex, corners: readonly number[]): number
-```
-
-## resolvedTileset — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): ResolvedTileset | undefined
-```
-
## restoreToFull — function @experimental
```
(world: World, entity: Entity): void
@@ -14262,16 +13644,6 @@ ReplicationPlugin
(delta: { x: number; z: number; }, seconds: number): { x: number; z: number; }
```
-## rotateFlagsCW — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## rotateStampCW — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## rotateVec3ByQuat — function @experimental
```
(rot: Quat, v: Vec3): Vec3
@@ -14432,11 +13804,6 @@ ScriptGraphPlugin
(world: World, sceneName?: string): SceneData
```
-## serializeTileset — function @experimental
-```
-(asset: TilesetAsset): Record<string, unknown>
-```
-
## serializeTimelineAsset — function @experimental
```
(asset: TimelineAsset): Record<string, unknown>
@@ -14707,11 +14074,6 @@ ServicesPlugin
(graph: ScriptGraph): ScriptGraphSignature
```
-## singleStamp — function @experimental
-```
-(raw: number): TileStamp
-```
-
## solveAnimatorIK — function @experimental
```
(world: World, rigRoot: Entity, pose: Pose, constraints: readonly AnimatorIK[], params: MotionParams, resolveJoint?: JointResolver): void
@@ -14847,41 +14209,6 @@ TextPlugin
<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status
```
-## tileCellCenter — function @experimental
-```
-(p: TileGridParams, tx: number, ty: number): Vec2Like
-```
-
-## tileCellOutline — function @experimental
-```
-(p: TileGridParams): Vec2Like[]
-```
-
-## tileCollisionOutlines — function @experimental
-```
-(chunks: DecodedChunk[], model: TilesetModel, tileW: number, tileH: number, originX: number, originY: number): TileCollisionPiece[]
-```
-
-## tileFlagsOf — function @experimental
-```
-(raw: number): TileFlags
-```
-
-## tileIdOf — function @experimental
-```
-(raw: number): number
-```
-
-## tilemapPlugin — const @experimental
-```
-TilemapPlugin
-```
-
-## tilemapSource — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): LoadedTilemapSource | undefined
-```
-
## timelinePlugin — const @experimental
```
TimelinePlugin
@@ -15032,11 +14359,6 @@ UIVisibilityPlugin
(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition
```
-## usesStagger — function @experimental
-```
-(orientation: number): boolean
-```
-
## 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 6734c25a3..25e9411f6 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 · 98 beta · 1836 experimental · 3 deprecated
+Symbols: 115 public · 93 beta · 1734 experimental · 3 deprecated
## ANCHOR_AXES — const @experimental
```
@@ -1698,16 +1698,6 @@ static prototype: BtPlugin
Map<string, NodeState>
```
-## BuildNavGridOptions — interface @experimental
-```
-blockedTileIds: Iterable<number> | undefined
-cellSize: number
-height: number
-isBlocked: ((tileId: number) => boolean) | undefined
-origin: Vec2 | undefined
-width: number
-```
-
## BuildNavMeshOptions — interface @experimental
```
agentHeight: number | undefined
@@ -1835,11 +1825,6 @@ sprite: number | undefined
16
```
-## CHUNK_SIZE — const @experimental
-```
-16
-```
-
## CLIP_EPSILON — const @experimental
```
0.00001
@@ -1850,16 +1835,6 @@ sprite: number | undefined
24
```
-## COLLISION_BRUSHES — const @experimental
-```
-CollisionBrush[]
-```
-
-## COLLISION_PALETTE_REF — const @experimental
-```
-"builtin:collision"
-```
-
## COMBAT_ATTACK_END — const @experimental
```
"attack-end"
@@ -2449,13 +2424,6 @@ shape: Collider3DShape
| { kind: 'capsule'; radius: number; halfHeight: number }
```
-## CollisionBrush — interface @experimental
-```
-collision: ResolvedTileCollision
-id: number
-key: string
-```
-
## CollisionEnterEvent — interface @experimental
```
contactX: number
@@ -2477,13 +2445,6 @@ pointX: number
pointY: number
```
-## CollisionMaterial — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-restitution: number | undefined
-```
-
## Color — interface @public
```
a: number
@@ -2913,13 +2874,6 @@ normals: Float32Array<ArrayBufferLike>
positions: Float32Array<ArrayBufferLike>
```
-## DecodedChunk — interface @experimental
-```
-tiles: Uint16Array<ArrayBufferLike>
-x: number
-y: number
-```
-
## DecodedPixels — interface @experimental
```
height: number
@@ -4909,38 +4863,6 @@ uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
-## LoadedTilemapLayer — type @experimental
-```
-TiledLayerData
-```
-
-## LoadedTilemapSource — interface @experimental
-```
-collisionTileIds: number[] | undefined
-hexSideLength: number | undefined
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[] | undefined
-orientation: string | undefined
-staggerAxis: string | undefined
-staggerIndex: string | undefined
-tileAnimations: Map<number, { tileId: number; duration: number; }[]> | undefined
-tileHeight: number
-tileProperties: Map<number, Map<string, string>> | undefined
-tileShapes: Map<number, ResolvedTileCollision> | undefined
-tileWidth: number
-tilesets: LoadedTilemapTileset[]
-```
-
-## LoadedTilemapTileset — interface @experimental
-```
-columns: number
-firstId: number
-margin: number
-rows: number
-spacing: number
-textureHandle: number
-```
-
## LocalTransform — const @experimental @deprecated
```
BuiltinComponentDef<TransformData>
@@ -7527,24 +7449,6 @@ folder: string
name: string
```
-## ResolvedTileCollision — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-oneWay: { nx: number; ny: number; } | undefined
-restitution: number | undefined
-sensor: boolean | undefined
-shape: { type: "box"; } | { type: "polygon"; points: [number, number][]; } | { type: "circle"; cx: number; cy: number; r: number; }
-```
-
-## ResolvedTileset — interface @experimental
-```
-asset: TilesetAsset
-textureHandle: number
-textureHeight: number | undefined
-textureWidth: number | undefined
-```
-
## ResourceDef — interface @public
```
@internal _default: T
@@ -9119,86 +9023,11 @@ reads: readonly string[] | undefined
writes: readonly string[] | undefined
```
-## TB_E — const @experimental
-```
-2
-```
-
-## TB_N — const @experimental
-```
-1
-```
-
-## TB_NE — const @experimental
-```
-16
-```
-
-## TB_NW — const @experimental
-```
-128
-```
-
-## TB_S — const @experimental
-```
-4
-```
-
-## TB_SE — const @experimental
-```
-32
-```
-
-## TB_SW — const @experimental
-```
-64
-```
-
-## TB_W — const @experimental
-```
-8
-```
-
-## TERRAIN_NEIGHBORS — const @experimental
-```
-readonly { dx: number; dy: number; bit: number; }[]
-```
-
## THEME_COLOR_ROLES — const @experimental
```
readonly (keyof ThemeColors)[]
```
-## TILESET_FORMAT_VERSION — const @experimental
-```
-"1"
-```
-
-## TILE_FLAGS_MASK — const @experimental
-```
-number
-```
-
-## TILE_FLIP_D — const @experimental
-```
-32768
-```
-
-## TILE_FLIP_H — const @experimental
-```
-8192
-```
-
-## TILE_FLIP_V — const @experimental
-```
-16384
-```
-
-## TILE_ID_MASK — const @experimental
-```
-8191
-```
-
## TIMELINE_FORMAT_VERSION — const @experimental
```
"1.2"
@@ -9250,29 +9079,6 @@ setPaused: (paused: boolean) => void
suspendAudio: () => void
```
-## TerrainColor — interface @experimental
-```
-color: string
-name: string
-```
-
-## TerrainIndex — interface @experimental
-```
-byMask: Map<number, number>
-mode: TerrainMode
-```
-
-## TerrainIndices — interface @experimental
-```
-sets: Map<number, TerrainIndex>
-tileTerrain: Map<number, number>
-```
-
-## TerrainMode — type @experimental
-```
-'edge' | 'corner' | 'wang'
-```
-
## Text — const @public
```
ComponentDef<TextData>
@@ -9446,12 +9252,6 @@ type: "text"
(typeof TextVerticalAlign)[keyof typeof TextVerticalAlign]
```
-## TextureDimensions — interface @experimental
-```
-height: number
-width: number
-```
-
## TextureFilter — type @experimental
```
(typeof TextureFilter)[keyof typeof TextureFilter]
@@ -9605,237 +9405,6 @@ moveSpeed: number
rotationSpeed: number
```
-## TileCollisionPiece — interface @experimental
-```
-center: Vec2
-circles: { c: Vec2; r: number; }[]
-oneWay: { nx: number; ny: number; } | null
-polylines: Vec2[][]
-sensor: boolean
-```
-
-## TileCollisionShape — type @experimental
-```
-| { type: 'box' }
- | { type: 'polygon'; points: [number, number][] }
- | { type: 'circle'; cx: number; cy: number; r: number }
-```
-
-## TileFlags — interface @experimental
-```
-flipD: boolean
-flipH: boolean
-flipV: boolean
-```
-
-## TileGridParams — interface @experimental
-```
-hexSideLength: number | undefined
-orientation: number
-staggerAxisX: boolean | undefined
-staggerIndexEven: boolean | undefined
-tileHeight: number
-tileWidth: number
-```
-
-## TileStamp — interface @experimental
-```
-cells: number[]
-h: number
-w: number
-```
-
-## TiledLayerData — interface @experimental
-```
-chunks: TiledChunkData[]
-height: number
-infinite: boolean
-name: string
-opacity: number
-parallaxX: number
-parallaxY: number
-tiles: Uint16Array<ArrayBufferLike>
-tintColor: { r: number; g: number; b: number; a: number; }
-visible: boolean
-width: number
-```
-
-## TiledMapData — interface @experimental
-```
-collisionTileIds: number[]
-height: number
-hexSideLength: number
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[]
-orientation: string
-staggerAxis: string
-staggerIndex: string
-tileAnimations: Map<number, TiledAnimFrame[]>
-tileHeight: number
-tileProperties: Map<number, Map<string, string>>
-tileShapes: Map<number, ResolvedTileCollision>
-tileWidth: number
-tilesets: TiledTilesetData[]
-width: number
-```
-
-## TiledTilesetData — interface @experimental
-```
-collectionTiles: TiledCollectionTile[] | undefined
-columns: number
-firstGid: number
-image: string
-margin: number | undefined
-name: string
-spacing: number | undefined
-tileCount: number
-tileHeight: number
-tileWidth: number
-```
-
-## Tilemap — const @experimental
-```
-ComponentDef<TilemapData>
-```
-
-## TilemapAPI — const @experimental
-```
-{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }
-```
-
-## TilemapData — interface @experimental
-```
-source: string
-```
-
-## TilemapLayer — const @beta
-```
-BuiltinComponentDef<TilemapLayerData>
-```
-
-## TilemapLayerData — interface @beta
-```
-cellSize: Vec2
-hexSideLength: number
-opacity: number
-orientation: TilemapOrientation
-originOffset: Vec2
-parallaxFactor: Vec2
-renderLayer: number
-staggerAxis: TilemapStaggerAxis
-staggerIndex: TilemapStaggerIndex
-tileset: number
-tilesetColumns: number
-tintColor: Color
-visible: boolean
-```
-
-## TilemapLiveSync — const @experimental
-```
-{ setLayerTilesets(app: App, entity: number, refs: readonly string[]): void; }
-```
-
-## TilemapOrientation — enum @beta
-```
-Hexagonal = 3
-Isometric = 1
-Orthogonal = 0
-Staggered = 2
-```
-
-## TilemapPlugin — class @experimental
-```
-build: (app: App) => void
-cleanup: (app?: App) => void
-name: string
-static new (): TilemapPlugin
-static prototype: TilemapPlugin
-```
-
-## TilemapStaggerAxis — enum @beta
-```
-X = 1
-Y = 0
-```
-
-## TilemapStaggerIndex — enum @beta
-```
-Even = 1
-Odd = 0
-```
-
-## Tilemaps — const @experimental
-```
-ResourceDef<{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }>
-```
-
-## TilesetAnimFrame — interface @experimental
-```
-durationMs: number
-tile: number
-```
-
-## TilesetAsset — interface @experimental
-```
-columns: number
-extrude: number
-margin: number
-spacing: number
-terrains: TilesetTerrain[] | undefined
-texture: string
-tileCount: number | undefined
-tileHeight: number
-tileWidth: number
-tiles: Record<number, TilesetTile>
-version: string
-```
-
-## TilesetCollision — type @experimental
-```
-TileCollisionShape & {
- /** One-way (jump-through) platform: contacts from behind this normal pass through. */
- oneWay?: { nx: number; ny: number };
- /** Non-solid trigger volume (fires events, no physical response). */
- sensor?: boolean;
- /** Physics material overrides (absent = engine defaults). */
- density?: number;
- friction?: number;
- restitution?: number;
-}
-```
-
-## TilesetModel — interface @experimental
-```
-animations: Map<number, { tileId: number; duration: number; }[]>
-collidableTileIds: number[]
-slots: TilesetModelSlot[]
-tileShapes: Map<number, ResolvedTileCollision>
-```
-
-## TilesetTerrain — interface @experimental
-```
-color: string | undefined
-colors: TerrainColor[] | undefined
-mode: TerrainMode
-name: string
-```
-
-## TilesetTile — interface @experimental
-```
-animation: TilesetAnimFrame[] | undefined
-collision: TilesetCollision | undefined
-probability: number | undefined
-properties: Record<string, string> | undefined
-terrain: TilesetTileTerrain | undefined
-```
-
-## TilesetTileTerrain — interface @experimental
-```
-corners: number[] | undefined
-mask: number | undefined
-set: number
-```
-
## Time — const @public
```
ResourceDef<TimeData>
@@ -10621,12 +10190,6 @@ x: number
y: number
```
-## Vec2Like — interface @experimental
-```
-x: number
-y: number
-```
-
## Vec3 — interface @public
```
x: number
@@ -10773,17 +10336,6 @@ MoveBasis
"world"
```
-## WangIndex — interface @experimental
-```
-byKey: Map<number, number>
-```
-
-## WangIndices — interface @experimental
-```
-sets: Map<number, WangIndex>
-tileTerrain: Map<number, number>
-```
-
## WeChatSideModuleFactories — type @experimental
```
Partial<Record<SideModuleId, EmscriptenFactory>>
@@ -11399,11 +10951,6 @@ AssetPlugin
(atlas: CookedAtlasInfo, pagePath: string): Pick<CatalogEntry, "atlas" | "frame" | "uv">
```
-## atlasCells — function @experimental
-```
-(size: number, margin: number, tileSize: number, spacing: number): number
-```
-
## audioPlugin — const @experimental
```
AudioPlugin
@@ -11504,11 +11051,6 @@ BtPlugin
(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>
```
-## buildCollisionPaletteModel — function @experimental
-```
-(material?: CollisionMaterial): TilesetModel
-```
-
## buildFrameProfile — function @experimental
```
(input: FrameProfileInput): FrameProfile
@@ -11519,11 +11061,6 @@ BtPlugin
(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh
```
-## buildTerrainIndices — function @experimental
-```
-(asset: TilesetAsset): TerrainIndices
-```
-
## buildText — function @experimental
```
(init?: TextInit): TextData
@@ -11544,11 +11081,6 @@ BtPlugin
(base: PrefabData, baseRef: string, name: string, delta: { overrides: readonly PrefabOverride[]; added: readonly AddedEntity[]; }): PrefabData
```
-## buildWangIndices — function @experimental
-```
-(asset: TilesetAsset): WangIndices
-```
-
## builtinBusVolume — function @experimental
```
(name: string): number | null
@@ -11609,11 +11141,6 @@ BtPlugin
(type: BtNodeType): boolean
```
-## canonicalMask — function @experimental
-```
-(mode: TerrainMode, mask: number): number
-```
-
## captureFramePixels — function @beta
```
(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>
@@ -11779,11 +11306,6 @@ BtPlugin
(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]
```
-## collidableTileIds — function @experimental
-```
-(asset: TilesetAsset): number[]
-```
-
## collider2DOutline — function @experimental
```
(shape: Collider2DShape, center: Vec2, angle: number, ppu: number): Collider2DOutline
@@ -11794,11 +11316,6 @@ BtPlugin
(shape: Collider3DShape, segments?: number): Vec3[][]
```
-## collisionRefWithMaterial — function @experimental
-```
-(material: CollisionMaterial): string
-```
-
## color — const @experimental
```
(r?: number, g?: number, b?: number, a?: number) => Color
@@ -12009,11 +11526,6 @@ Plugin
(opts: TextInputOptions): TextInputHandle
```
-## createTileset — function @experimental
-```
-(texture: string, tileWidth?: number, tileHeight?: number, columns?: number): TilesetAsset
-```
-
## createTimelineMotionDriver — function @experimental
```
(timeline: TimelineAPI): MotionDriver<AnimatorClipMotion>
@@ -12069,11 +11581,6 @@ Plugin
(bytes: Uint8Array): MeshData
```
-## decodeTilemapChunks — function @experimental
-```
-(blob: string): DecodedChunk[]
-```
-
## decomposePolygon2D — function @experimental
```
(vertices: readonly Vec2[]): PolygonDecomposition
@@ -12344,11 +11851,6 @@ DragPlugin
(data: MeshData): Uint8Array
```
-## encodeTile — function @experimental
-```
-(id: number, flags?: TileFlags): number
-```
-
## engineWebGPUFeatures — function @experimental
```
(adapter: WebGPUAdapterLike): string[]
@@ -12514,26 +12016,6 @@ EventBindingPlugin
(prefab: PrefabData, overrides: PrefabOverride[], ctx: FlattenContext): FlattenResult
```
-## flipFlagsH — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipFlagsV — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipStampH — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
-## flipStampV — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## flushPendingRegistrations — function @experimental
```
(app: App): void
@@ -12764,11 +12246,6 @@ GameplayPlugin
(key: string): CompiledScriptGraph | undefined
```
-## getTextureDimensions — function @experimental
-```
-(handle: number): TextureDimensions | null
-```
-
## getTheme — function @experimental
```
(): ThemeTokens
@@ -12929,11 +12406,6 @@ InputRouter
(graph: ScriptGraph): boolean
```
-## isCollisionPaletteRef — function @experimental
-```
-(refs: readonly string[]): boolean
-```
-
## isCustomExtension — function @experimental
```
(path: string): boolean
@@ -12954,11 +12426,6 @@ InputRouter
(): boolean
```
-## isEmptyStamp — function @experimental
-```
-(s: TileStamp): boolean
-```
-
## isEntityActive — function @experimental
```
(world: World, entity: Entity): boolean
@@ -12974,11 +12441,6 @@ InputRouter
(): boolean
```
-## isHexOrientation — function @experimental
-```
-(orientation: number): boolean
-```
-
## isKnownAssetExtension — function @experimental
```
(ext: string): boolean
@@ -12989,11 +12451,6 @@ InputRouter
(): boolean
```
-## isNonOrthogonal — function @experimental
-```
-(orientation: number): boolean
-```
-
## isPlatformInitialized — function @experimental
```
(): boolean
@@ -13114,11 +12571,6 @@ LifecyclePlugin
(world: World, sceneData: SceneData, options?: SceneLoadOptions): Promise<Map<number, Entity>>
```
-## loadTiledMap — function @experimental
-```
-(world: World, mapData: TiledMapData, textureHandles: Map<string, number>, options?: TilemapLoadOptions): Entity[]
-```
-
## localizationPlugin — const @experimental
```
LocalizationPlugin
@@ -13259,16 +12711,6 @@ MeshRendererPlugin
(world: World, layers?: number): boolean
```
-## navGridFromTilemapLayer — function @experimental
-```
-(entity: Entity, opts: BuildNavGridOptions): NavGrid
-```
-
-## navGridFromTiles — function @experimental
-```
-(getTile: (x: number, y: number) => number, opts: BuildNavGridOptions): NavGrid
-```
-
## navLinkDigest — function @experimental
```
(links: readonly NavLinkSegment[]): number
@@ -13304,11 +12746,6 @@ NodePlatformAdapter
(mode: string | undefined | null): BundleMode
```
-## normalizeCornerMask — function @experimental
-```
-(mask: number): number
-```
-
## onCameraCommitChanged — function @beta
```
(fn: CameraCommitListener): () => void
@@ -13334,11 +12771,6 @@ NodePlatformAdapter
(yawDeg: number, pitchDeg: number): Vec3
```
-## orientationPerm — function @experimental
-```
-(flags: TileFlags): Perm
-```
-
## overlayPose — function @experimental
```
(acc: Pose, layer: Pose, weight: number, world: PoseWorld, reach: LayerReach | null): void
@@ -13349,11 +12781,6 @@ NodePlatformAdapter
(semantics: { semantic: number; components: number; type: number; }[]): { channels: MeshChannelDesc[]; vertexStride: number; }
```
-## packCorners — function @experimental
-```
-(tl: number, tr: number, br: number, bl: number): number
-```
-
## packagedAppOptions — function @experimental
```
(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces"; msaaSamples?: number; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
@@ -13404,11 +12831,6 @@ NodePlatformAdapter
(raw: unknown): BusEffectDef[]
```
-## parseCollisionMaterial — function @experimental
-```
-(refs: readonly string[]): CollisionMaterial
-```
-
## parseLocaleTable — function @experimental
```
(text: string, path: string): LocaleTableAsset
@@ -13429,26 +12851,11 @@ NodePlatformAdapter
(colors?: Record<string, string>): ThemeOverrides | undefined
```
-## parseTileset — function @experimental
-```
-(rawJson: unknown): TilesetAsset
-```
-
## parseTimelineAsset — function @experimental
```
(rawJson: unknown): TimelineAsset
```
-## parseTmjJson — function @experimental
-```
-(json: Record<string, unknown>): TiledMapData | null
-```
-
-## parseTmjWithExternals — function @experimental
-```
-(json: Record<string, unknown>, resolveExternal: (source: string) => Promise<string>): Promise<TiledMapData | null>
-```
-
## particlePlugin — const @experimental
```
ParticlePlugin
@@ -13954,11 +13361,6 @@ ReplicationPlugin
(projectRelPath: string, config: AssetGroupsConfig | null | undefined): ResolvedAtlas | null
```
-## resolveAutotile — function @experimental
-```
-(index: TerrainIndex, neighbors: readonly boolean[]): number
-```
-
## resolveBindingTarget — function @experimental
```
(world: World, from: Entity, name: string): Entity | null
@@ -13984,31 +13386,11 @@ ReplicationPlugin
(scene: SceneData, read: (ref: string) => Promise<unknown | null>): Promise<(ref: string) => PrefabRoot | null>
```
-## resolveRelativePath — function @experimental
-```
-(basePath: string, relativePath: string): string
-```
-
## resolveThemeTokens — function @experimental
```
(base: "dark" | "light", overrides?: ThemeOverrides): ThemeTokens
```
-## resolveTilesetModel — function @experimental
-```
-(tilesets: ResolvedTileset[]): TilesetModel
-```
-
-## resolveWang — function @experimental
-```
-(index: WangIndex, corners: readonly number[]): number
-```
-
-## resolvedTileset — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): ResolvedTileset | undefined
-```
-
## restoreToFull — function @experimental
```
(world: World, entity: Entity): void
@@ -14024,16 +13406,6 @@ ReplicationPlugin
(delta: { x: number; z: number; }, seconds: number): { x: number; z: number; }
```
-## rotateFlagsCW — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## rotateStampCW — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## rotateVec3ByQuat — function @experimental
```
(rot: Quat, v: Vec3): Vec3
@@ -14194,11 +13566,6 @@ ScriptGraphPlugin
(world: World, sceneName?: string): SceneData
```
-## serializeTileset — function @experimental
-```
-(asset: TilesetAsset): Record<string, unknown>
-```
-
## serializeTimelineAsset — function @experimental
```
(asset: TimelineAsset): Record<string, unknown>
@@ -14469,11 +13836,6 @@ ServicesPlugin
(graph: ScriptGraph): ScriptGraphSignature
```
-## singleStamp — function @experimental
-```
-(raw: number): TileStamp
-```
-
## solveAnimatorIK — function @experimental
```
(world: World, rigRoot: Entity, pose: Pose, constraints: readonly AnimatorIK[], params: MotionParams, resolveJoint?: JointResolver): void
@@ -14609,41 +13971,6 @@ TextPlugin
<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status
```
-## tileCellCenter — function @experimental
-```
-(p: TileGridParams, tx: number, ty: number): Vec2Like
-```
-
-## tileCellOutline — function @experimental
-```
-(p: TileGridParams): Vec2Like[]
-```
-
-## tileCollisionOutlines — function @experimental
-```
-(chunks: DecodedChunk[], model: TilesetModel, tileW: number, tileH: number, originX: number, originY: number): TileCollisionPiece[]
-```
-
-## tileFlagsOf — function @experimental
-```
-(raw: number): TileFlags
-```
-
-## tileIdOf — function @experimental
-```
-(raw: number): number
-```
-
-## tilemapPlugin — const @experimental
-```
-TilemapPlugin
-```
-
-## tilemapSource — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): LoadedTilemapSource | undefined
-```
-
## timelinePlugin — const @experimental
```
TimelinePlugin
@@ -14794,11 +14121,6 @@ UIVisibilityPlugin
(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition
```
-## usesStagger — function @experimental
-```
-(orientation: number): boolean
-```
-
## 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 ab8047777..dbd20be05 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 · 96 beta · 1858 experimental · 3 deprecated
+Symbols: 115 public · 91 beta · 1756 experimental · 3 deprecated
## ANCHOR_AXES — const @experimental
```
@@ -1698,16 +1698,6 @@ static prototype: BtPlugin
Map<string, NodeState>
```
-## BuildNavGridOptions — interface @experimental
-```
-blockedTileIds: Iterable<number> | undefined
-cellSize: number
-height: number
-isBlocked: ((tileId: number) => boolean) | undefined
-origin: Vec2 | undefined
-width: number
-```
-
## BuildNavMeshOptions — interface @experimental
```
agentHeight: number | undefined
@@ -1835,11 +1825,6 @@ sprite: number | undefined
16
```
-## CHUNK_SIZE — const @experimental
-```
-16
-```
-
## CLIP_EPSILON — const @experimental
```
0.00001
@@ -1850,16 +1835,6 @@ sprite: number | undefined
24
```
-## COLLISION_BRUSHES — const @experimental
-```
-CollisionBrush[]
-```
-
-## COLLISION_PALETTE_REF — const @experimental
-```
-"builtin:collision"
-```
-
## COMBAT_ATTACK_END — const @experimental
```
"attack-end"
@@ -2449,13 +2424,6 @@ shape: Collider3DShape
| { kind: 'capsule'; radius: number; halfHeight: number }
```
-## CollisionBrush — interface @experimental
-```
-collision: ResolvedTileCollision
-id: number
-key: string
-```
-
## CollisionEnterEvent — interface @experimental
```
contactX: number
@@ -2477,13 +2445,6 @@ pointX: number
pointY: number
```
-## CollisionMaterial — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-restitution: number | undefined
-```
-
## Color — interface @public
```
a: number
@@ -2913,13 +2874,6 @@ normals: Float32Array<ArrayBufferLike>
positions: Float32Array<ArrayBufferLike>
```
-## DecodedChunk — interface @experimental
-```
-tiles: Uint16Array<ArrayBufferLike>
-x: number
-y: number
-```
-
## DecodedPixels — interface @experimental
```
height: number
@@ -4909,38 +4863,6 @@ uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
-## LoadedTilemapLayer — type @experimental
-```
-TiledLayerData
-```
-
-## LoadedTilemapSource — interface @experimental
-```
-collisionTileIds: number[] | undefined
-hexSideLength: number | undefined
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[] | undefined
-orientation: string | undefined
-staggerAxis: string | undefined
-staggerIndex: string | undefined
-tileAnimations: Map<number, { tileId: number; duration: number; }[]> | undefined
-tileHeight: number
-tileProperties: Map<number, Map<string, string>> | undefined
-tileShapes: Map<number, ResolvedTileCollision> | undefined
-tileWidth: number
-tilesets: LoadedTilemapTileset[]
-```
-
-## LoadedTilemapTileset — interface @experimental
-```
-columns: number
-firstId: number
-margin: number
-rows: number
-spacing: number
-textureHandle: number
-```
-
## LocalTransform — const @experimental @deprecated
```
BuiltinComponentDef<TransformData>
@@ -7778,24 +7700,6 @@ folder: string
name: string
```
-## ResolvedTileCollision — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-oneWay: { nx: number; ny: number; } | undefined
-restitution: number | undefined
-sensor: boolean | undefined
-shape: { type: "box"; } | { type: "polygon"; points: [number, number][]; } | { type: "circle"; cx: number; cy: number; r: number; }
-```
-
-## ResolvedTileset — interface @experimental
-```
-asset: TilesetAsset
-textureHandle: number
-textureHeight: number | undefined
-textureWidth: number | undefined
-```
-
## ResourceDef — interface @public
```
@internal _default: T
@@ -9370,86 +9274,11 @@ reads: readonly string[] | undefined
writes: readonly string[] | undefined
```
-## TB_E — const @experimental
-```
-2
-```
-
-## TB_N — const @experimental
-```
-1
-```
-
-## TB_NE — const @experimental
-```
-16
-```
-
-## TB_NW — const @experimental
-```
-128
-```
-
-## TB_S — const @experimental
-```
-4
-```
-
-## TB_SE — const @experimental
-```
-32
-```
-
-## TB_SW — const @experimental
-```
-64
-```
-
-## TB_W — const @experimental
-```
-8
-```
-
-## TERRAIN_NEIGHBORS — const @experimental
-```
-readonly { dx: number; dy: number; bit: number; }[]
-```
-
## THEME_COLOR_ROLES — const @experimental
```
readonly (keyof ThemeColors)[]
```
-## TILESET_FORMAT_VERSION — const @experimental
-```
-"1"
-```
-
-## TILE_FLAGS_MASK — const @experimental
-```
-number
-```
-
-## TILE_FLIP_D — const @experimental
-```
-32768
-```
-
-## TILE_FLIP_H — const @experimental
-```
-8192
-```
-
-## TILE_FLIP_V — const @experimental
-```
-16384
-```
-
-## TILE_ID_MASK — const @experimental
-```
-8191
-```
-
## TIMELINE_FORMAT_VERSION — const @experimental
```
"1.2"
@@ -9501,29 +9330,6 @@ setPaused: (paused: boolean) => void
suspendAudio: () => void
```
-## TerrainColor — interface @experimental
-```
-color: string
-name: string
-```
-
-## TerrainIndex — interface @experimental
-```
-byMask: Map<number, number>
-mode: TerrainMode
-```
-
-## TerrainIndices — interface @experimental
-```
-sets: Map<number, TerrainIndex>
-tileTerrain: Map<number, number>
-```
-
-## TerrainMode — type @experimental
-```
-'edge' | 'corner' | 'wang'
-```
-
## Text — const @public
```
ComponentDef<TextData>
@@ -9697,12 +9503,6 @@ type: "text"
(typeof TextVerticalAlign)[keyof typeof TextVerticalAlign]
```
-## TextureDimensions — interface @experimental
-```
-height: number
-width: number
-```
-
## TextureFilter — type @experimental
```
(typeof TextureFilter)[keyof typeof TextureFilter]
@@ -9856,237 +9656,6 @@ moveSpeed: number
rotationSpeed: number
```
-## TileCollisionPiece — interface @experimental
-```
-center: Vec2
-circles: { c: Vec2; r: number; }[]
-oneWay: { nx: number; ny: number; } | null
-polylines: Vec2[][]
-sensor: boolean
-```
-
-## TileCollisionShape — type @experimental
-```
-| { type: 'box' }
- | { type: 'polygon'; points: [number, number][] }
- | { type: 'circle'; cx: number; cy: number; r: number }
-```
-
-## TileFlags — interface @experimental
-```
-flipD: boolean
-flipH: boolean
-flipV: boolean
-```
-
-## TileGridParams — interface @experimental
-```
-hexSideLength: number | undefined
-orientation: number
-staggerAxisX: boolean | undefined
-staggerIndexEven: boolean | undefined
-tileHeight: number
-tileWidth: number
-```
-
-## TileStamp — interface @experimental
-```
-cells: number[]
-h: number
-w: number
-```
-
-## TiledLayerData — interface @experimental
-```
-chunks: TiledChunkData[]
-height: number
-infinite: boolean
-name: string
-opacity: number
-parallaxX: number
-parallaxY: number
-tiles: Uint16Array<ArrayBufferLike>
-tintColor: { r: number; g: number; b: number; a: number; }
-visible: boolean
-width: number
-```
-
-## TiledMapData — interface @experimental
-```
-collisionTileIds: number[]
-height: number
-hexSideLength: number
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[]
-orientation: string
-staggerAxis: string
-staggerIndex: string
-tileAnimations: Map<number, TiledAnimFrame[]>
-tileHeight: number
-tileProperties: Map<number, Map<string, string>>
-tileShapes: Map<number, ResolvedTileCollision>
-tileWidth: number
-tilesets: TiledTilesetData[]
-width: number
-```
-
-## TiledTilesetData — interface @experimental
-```
-collectionTiles: TiledCollectionTile[] | undefined
-columns: number
-firstGid: number
-image: string
-margin: number | undefined
-name: string
-spacing: number | undefined
-tileCount: number
-tileHeight: number
-tileWidth: number
-```
-
-## Tilemap — const @experimental
-```
-ComponentDef<TilemapData>
-```
-
-## TilemapAPI — const @experimental
-```
-{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }
-```
-
-## TilemapData — interface @experimental
-```
-source: string
-```
-
-## TilemapLayer — const @beta
-```
-BuiltinComponentDef<TilemapLayerData>
-```
-
-## TilemapLayerData — interface @beta
-```
-cellSize: Vec2
-hexSideLength: number
-opacity: number
-orientation: TilemapOrientation
-originOffset: Vec2
-parallaxFactor: Vec2
-renderLayer: number
-staggerAxis: TilemapStaggerAxis
-staggerIndex: TilemapStaggerIndex
-tileset: number
-tilesetColumns: number
-tintColor: Color
-visible: boolean
-```
-
-## TilemapLiveSync — const @experimental
-```
-{ setLayerTilesets(app: App, entity: number, refs: readonly string[]): void; }
-```
-
-## TilemapOrientation — enum @beta
-```
-Hexagonal = 3
-Isometric = 1
-Orthogonal = 0
-Staggered = 2
-```
-
-## TilemapPlugin — class @experimental
-```
-build: (app: App) => void
-cleanup: (app?: App) => void
-name: string
-static new (): TilemapPlugin
-static prototype: TilemapPlugin
-```
-
-## TilemapStaggerAxis — enum @beta
-```
-X = 1
-Y = 0
-```
-
-## TilemapStaggerIndex — enum @beta
-```
-Even = 1
-Odd = 0
-```
-
-## Tilemaps — const @experimental
-```
-ResourceDef<{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }>
-```
-
-## TilesetAnimFrame — interface @experimental
-```
-durationMs: number
-tile: number
-```
-
-## TilesetAsset — interface @experimental
-```
-columns: number
-extrude: number
-margin: number
-spacing: number
-terrains: TilesetTerrain[] | undefined
-texture: string
-tileCount: number | undefined
-tileHeight: number
-tileWidth: number
-tiles: Record<number, TilesetTile>
-version: string
-```
-
-## TilesetCollision — type @experimental
-```
-TileCollisionShape & {
- /** One-way (jump-through) platform: contacts from behind this normal pass through. */
- oneWay?: { nx: number; ny: number };
- /** Non-solid trigger volume (fires events, no physical response). */
- sensor?: boolean;
- /** Physics material overrides (absent = engine defaults). */
- density?: number;
- friction?: number;
- restitution?: number;
-}
-```
-
-## TilesetModel — interface @experimental
-```
-animations: Map<number, { tileId: number; duration: number; }[]>
-collidableTileIds: number[]
-slots: TilesetModelSlot[]
-tileShapes: Map<number, ResolvedTileCollision>
-```
-
-## TilesetTerrain — interface @experimental
-```
-color: string | undefined
-colors: TerrainColor[] | undefined
-mode: TerrainMode
-name: string
-```
-
-## TilesetTile — interface @experimental
-```
-animation: TilesetAnimFrame[] | undefined
-collision: TilesetCollision | undefined
-probability: number | undefined
-properties: Record<string, string> | undefined
-terrain: TilesetTileTerrain | undefined
-```
-
-## TilesetTileTerrain — interface @experimental
-```
-corners: number[] | undefined
-mask: number | undefined
-set: number
-```
-
## Time — const @public
```
ResourceDef<TimeData>
@@ -10872,12 +10441,6 @@ x: number
y: number
```
-## Vec2Like — interface @experimental
-```
-x: number
-y: number
-```
-
## Vec3 — interface @public
```
x: number
@@ -11030,17 +10593,6 @@ MoveBasis
"world"
```
-## WangIndex — interface @experimental
-```
-byKey: Map<number, number>
-```
-
-## WangIndices — interface @experimental
-```
-sets: Map<number, WangIndex>
-tileTerrain: Map<number, number>
-```
-
## WeChatSideModuleFactories — type @experimental
```
Partial<Record<SideModuleId, EmscriptenFactory>>
@@ -11656,11 +11208,6 @@ AssetPlugin
(atlas: CookedAtlasInfo, pagePath: string): Pick<CatalogEntry, "atlas" | "frame" | "uv">
```
-## atlasCells — function @experimental
-```
-(size: number, margin: number, tileSize: number, spacing: number): number
-```
-
## audioPlugin — const @experimental
```
AudioPlugin
@@ -11761,11 +11308,6 @@ BtPlugin
(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>
```
-## buildCollisionPaletteModel — function @experimental
-```
-(material?: CollisionMaterial): TilesetModel
-```
-
## buildFrameProfile — function @experimental
```
(input: FrameProfileInput): FrameProfile
@@ -11776,11 +11318,6 @@ BtPlugin
(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh
```
-## buildTerrainIndices — function @experimental
-```
-(asset: TilesetAsset): TerrainIndices
-```
-
## buildText — function @experimental
```
(init?: TextInit): TextData
@@ -11801,11 +11338,6 @@ BtPlugin
(base: PrefabData, baseRef: string, name: string, delta: { overrides: readonly PrefabOverride[]; added: readonly AddedEntity[]; }): PrefabData
```
-## buildWangIndices — function @experimental
-```
-(asset: TilesetAsset): WangIndices
-```
-
## builtinBusVolume — function @experimental
```
(name: string): number | null
@@ -11866,11 +11398,6 @@ BtPlugin
(type: BtNodeType): boolean
```
-## canonicalMask — function @experimental
-```
-(mode: TerrainMode, mask: number): number
-```
-
## captureFramePixels — function @beta
```
(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>
@@ -12036,11 +11563,6 @@ BtPlugin
(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]
```
-## collidableTileIds — function @experimental
-```
-(asset: TilesetAsset): number[]
-```
-
## collider2DOutline — function @experimental
```
(shape: Collider2DShape, center: Vec2, angle: number, ppu: number): Collider2DOutline
@@ -12051,11 +11573,6 @@ BtPlugin
(shape: Collider3DShape, segments?: number): Vec3[][]
```
-## collisionRefWithMaterial — function @experimental
-```
-(material: CollisionMaterial): string
-```
-
## color — const @experimental
```
(r?: number, g?: number, b?: number, a?: number) => Color
@@ -12271,11 +11788,6 @@ Plugin
(opts: TextInputOptions): TextInputHandle
```
-## createTileset — function @experimental
-```
-(texture: string, tileWidth?: number, tileHeight?: number, columns?: number): TilesetAsset
-```
-
## createTimelineMotionDriver — function @experimental
```
(timeline: TimelineAPI): MotionDriver<AnimatorClipMotion>
@@ -12331,11 +11843,6 @@ Plugin
(bytes: Uint8Array): MeshData
```
-## decodeTilemapChunks — function @experimental
-```
-(blob: string): DecodedChunk[]
-```
-
## decomposePolygon2D — function @experimental
```
(vertices: readonly Vec2[]): PolygonDecomposition
@@ -12606,11 +12113,6 @@ DragPlugin
(data: MeshData): Uint8Array
```
-## encodeTile — function @experimental
-```
-(id: number, flags?: TileFlags): number
-```
-
## engineWebGPUFeatures — function @experimental
```
(adapter: WebGPUAdapterLike): string[]
@@ -12776,26 +12278,6 @@ EventBindingPlugin
(prefab: PrefabData, overrides: PrefabOverride[], ctx: FlattenContext): FlattenResult
```
-## flipFlagsH — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipFlagsV — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipStampH — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
-## flipStampV — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## flushPendingRegistrations — function @experimental
```
(app: App): void
@@ -13026,11 +12508,6 @@ GameplayPlugin
(key: string): CompiledScriptGraph | undefined
```
-## getTextureDimensions — function @experimental
-```
-(handle: number): TextureDimensions | null
-```
-
## getTheme — function @experimental
```
(): ThemeTokens
@@ -13201,11 +12678,6 @@ InputRouter
(graph: ScriptGraph): boolean
```
-## isCollisionPaletteRef — function @experimental
-```
-(refs: readonly string[]): boolean
-```
-
## isCustomExtension — function @experimental
```
(path: string): boolean
@@ -13226,11 +12698,6 @@ InputRouter
(): boolean
```
-## isEmptyStamp — function @experimental
-```
-(s: TileStamp): boolean
-```
-
## isEntityActive — function @experimental
```
(world: World, entity: Entity): boolean
@@ -13246,11 +12713,6 @@ InputRouter
(): boolean
```
-## isHexOrientation — function @experimental
-```
-(orientation: number): boolean
-```
-
## isKnownAssetExtension — function @experimental
```
(ext: string): boolean
@@ -13261,11 +12723,6 @@ InputRouter
(): boolean
```
-## isNonOrthogonal — function @experimental
-```
-(orientation: number): boolean
-```
-
## isPlatformInitialized — function @experimental
```
(): boolean
@@ -13381,11 +12838,6 @@ LifecyclePlugin
(world: World, sceneData: SceneData, options?: SceneLoadOptions): Promise<Map<number, Entity>>
```
-## loadTiledMap — function @experimental
-```
-(world: World, mapData: TiledMapData, textureHandles: Map<string, number>, options?: TilemapLoadOptions): Entity[]
-```
-
## localizationPlugin — const @experimental
```
LocalizationPlugin
@@ -13526,16 +12978,6 @@ MeshRendererPlugin
(world: World, layers?: number): boolean
```
-## navGridFromTilemapLayer — function @experimental
-```
-(entity: Entity, opts: BuildNavGridOptions): NavGrid
-```
-
-## navGridFromTiles — function @experimental
-```
-(getTile: (x: number, y: number) => number, opts: BuildNavGridOptions): NavGrid
-```
-
## navLinkDigest — function @experimental
```
(links: readonly NavLinkSegment[]): number
@@ -13566,11 +13008,6 @@ NavPlugin
(mode: string | undefined | null): BundleMode
```
-## normalizeCornerMask — function @experimental
-```
-(mask: number): number
-```
-
## onCameraCommitChanged — function @beta
```
(fn: CameraCommitListener): () => void
@@ -13596,11 +13033,6 @@ NavPlugin
(yawDeg: number, pitchDeg: number): Vec3
```
-## orientationPerm — function @experimental
-```
-(flags: TileFlags): Perm
-```
-
## overlayPose — function @experimental
```
(acc: Pose, layer: Pose, weight: number, world: PoseWorld, reach: LayerReach | null): void
@@ -13611,11 +13043,6 @@ NavPlugin
(semantics: { semantic: number; components: number; type: number; }[]): { channels: MeshChannelDesc[]; vertexStride: number; }
```
-## packCorners — function @experimental
-```
-(tl: number, tr: number, br: number, bl: number): number
-```
-
## packagedAppOptions — function @experimental
```
(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces"; msaaSamples?: number; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
@@ -13666,11 +13093,6 @@ NavPlugin
(raw: unknown): BusEffectDef[]
```
-## parseCollisionMaterial — function @experimental
-```
-(refs: readonly string[]): CollisionMaterial
-```
-
## parseLocaleTable — function @experimental
```
(text: string, path: string): LocaleTableAsset
@@ -13691,26 +13113,11 @@ NavPlugin
(colors?: Record<string, string>): ThemeOverrides | undefined
```
-## parseTileset — function @experimental
-```
-(rawJson: unknown): TilesetAsset
-```
-
## parseTimelineAsset — function @experimental
```
(rawJson: unknown): TimelineAsset
```
-## parseTmjJson — function @experimental
-```
-(json: Record<string, unknown>): TiledMapData | null
-```
-
-## parseTmjWithExternals — function @experimental
-```
-(json: Record<string, unknown>, resolveExternal: (source: string) => Promise<string>): Promise<TiledMapData | null>
-```
-
## particlePlugin — const @experimental
```
ParticlePlugin
@@ -14216,11 +13623,6 @@ ReplicationPlugin
(projectRelPath: string, config: AssetGroupsConfig | null | undefined): ResolvedAtlas | null
```
-## resolveAutotile — function @experimental
-```
-(index: TerrainIndex, neighbors: readonly boolean[]): number
-```
-
## resolveBindingTarget — function @experimental
```
(world: World, from: Entity, name: string): Entity | null
@@ -14246,31 +13648,11 @@ ReplicationPlugin
(scene: SceneData, read: (ref: string) => Promise<unknown | null>): Promise<(ref: string) => PrefabRoot | null>
```
-## resolveRelativePath — function @experimental
-```
-(basePath: string, relativePath: string): string
-```
-
## resolveThemeTokens — function @experimental
```
(base: "dark" | "light", overrides?: ThemeOverrides): ThemeTokens
```
-## resolveTilesetModel — function @experimental
-```
-(tilesets: ResolvedTileset[]): TilesetModel
-```
-
-## resolveWang — function @experimental
-```
-(index: WangIndex, corners: readonly number[]): number
-```
-
-## resolvedTileset — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): ResolvedTileset | undefined
-```
-
## restoreToFull — function @experimental
```
(world: World, entity: Entity): void
@@ -14286,16 +13668,6 @@ ReplicationPlugin
(delta: { x: number; z: number; }, seconds: number): { x: number; z: number; }
```
-## rotateFlagsCW — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## rotateStampCW — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## rotateVec3ByQuat — function @experimental
```
(rot: Quat, v: Vec3): Vec3
@@ -14456,11 +13828,6 @@ ScriptGraphPlugin
(world: World, sceneName?: string): SceneData
```
-## serializeTileset — function @experimental
-```
-(asset: TilesetAsset): Record<string, unknown>
-```
-
## serializeTimelineAsset — function @experimental
```
(asset: TimelineAsset): Record<string, unknown>
@@ -14731,11 +14098,6 @@ ServicesPlugin
(graph: ScriptGraph): ScriptGraphSignature
```
-## singleStamp — function @experimental
-```
-(raw: number): TileStamp
-```
-
## solveAnimatorIK — function @experimental
```
(world: World, rigRoot: Entity, pose: Pose, constraints: readonly AnimatorIK[], params: MotionParams, resolveJoint?: JointResolver): void
@@ -14871,41 +14233,6 @@ TextPlugin
<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status
```
-## tileCellCenter — function @experimental
-```
-(p: TileGridParams, tx: number, ty: number): Vec2Like
-```
-
-## tileCellOutline — function @experimental
-```
-(p: TileGridParams): Vec2Like[]
-```
-
-## tileCollisionOutlines — function @experimental
-```
-(chunks: DecodedChunk[], model: TilesetModel, tileW: number, tileH: number, originX: number, originY: number): TileCollisionPiece[]
-```
-
-## tileFlagsOf — function @experimental
-```
-(raw: number): TileFlags
-```
-
-## tileIdOf — function @experimental
-```
-(raw: number): number
-```
-
-## tilemapPlugin — const @experimental
-```
-TilemapPlugin
-```
-
-## tilemapSource — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): LoadedTilemapSource | undefined
-```
-
## timelinePlugin — const @experimental
```
TimelinePlugin
@@ -15056,11 +14383,6 @@ UIVisibilityPlugin
(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition
```
-## usesStagger — function @experimental
-```
-(orientation: number): boolean
-```
-
## 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 5bc9d15d1..36b7f8bf8 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 · 96 beta · 1849 experimental · 3 deprecated
+Symbols: 115 public · 91 beta · 1747 experimental · 3 deprecated
## ANCHOR_AXES — const @experimental
```
@@ -1698,16 +1698,6 @@ static prototype: BtPlugin
Map<string, NodeState>
```
-## BuildNavGridOptions — interface @experimental
-```
-blockedTileIds: Iterable<number> | undefined
-cellSize: number
-height: number
-isBlocked: ((tileId: number) => boolean) | undefined
-origin: Vec2 | undefined
-width: number
-```
-
## BuildNavMeshOptions — interface @experimental
```
agentHeight: number | undefined
@@ -1835,11 +1825,6 @@ sprite: number | undefined
16
```
-## CHUNK_SIZE — const @experimental
-```
-16
-```
-
## CLIP_EPSILON — const @experimental
```
0.00001
@@ -1850,16 +1835,6 @@ sprite: number | undefined
24
```
-## COLLISION_BRUSHES — const @experimental
-```
-CollisionBrush[]
-```
-
-## COLLISION_PALETTE_REF — const @experimental
-```
-"builtin:collision"
-```
-
## COMBAT_ATTACK_END — const @experimental
```
"attack-end"
@@ -2449,13 +2424,6 @@ shape: Collider3DShape
| { kind: 'capsule'; radius: number; halfHeight: number }
```
-## CollisionBrush — interface @experimental
-```
-collision: ResolvedTileCollision
-id: number
-key: string
-```
-
## CollisionEnterEvent — interface @experimental
```
contactX: number
@@ -2477,13 +2445,6 @@ pointX: number
pointY: number
```
-## CollisionMaterial — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-restitution: number | undefined
-```
-
## Color — interface @public
```
a: number
@@ -2913,13 +2874,6 @@ normals: Float32Array<ArrayBufferLike>
positions: Float32Array<ArrayBufferLike>
```
-## DecodedChunk — interface @experimental
-```
-tiles: Uint16Array<ArrayBufferLike>
-x: number
-y: number
-```
-
## DecodedPixels — interface @experimental
```
height: number
@@ -4916,38 +4870,6 @@ uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
-## LoadedTilemapLayer — type @experimental
-```
-TiledLayerData
-```
-
-## LoadedTilemapSource — interface @experimental
-```
-collisionTileIds: number[] | undefined
-hexSideLength: number | undefined
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[] | undefined
-orientation: string | undefined
-staggerAxis: string | undefined
-staggerIndex: string | undefined
-tileAnimations: Map<number, { tileId: number; duration: number; }[]> | undefined
-tileHeight: number
-tileProperties: Map<number, Map<string, string>> | undefined
-tileShapes: Map<number, ResolvedTileCollision> | undefined
-tileWidth: number
-tilesets: LoadedTilemapTileset[]
-```
-
-## LoadedTilemapTileset — interface @experimental
-```
-columns: number
-firstId: number
-margin: number
-rows: number
-spacing: number
-textureHandle: number
-```
-
## LocalTransform — const @experimental @deprecated
```
BuiltinComponentDef<TransformData>
@@ -7534,24 +7456,6 @@ folder: string
name: string
```
-## ResolvedTileCollision — interface @experimental
-```
-density: number | undefined
-friction: number | undefined
-oneWay: { nx: number; ny: number; } | undefined
-restitution: number | undefined
-sensor: boolean | undefined
-shape: { type: "box"; } | { type: "polygon"; points: [number, number][]; } | { type: "circle"; cx: number; cy: number; r: number; }
-```
-
-## ResolvedTileset — interface @experimental
-```
-asset: TilesetAsset
-textureHandle: number
-textureHeight: number | undefined
-textureWidth: number | undefined
-```
-
## ResourceDef — interface @public
```
@internal _default: T
@@ -9126,86 +9030,11 @@ reads: readonly string[] | undefined
writes: readonly string[] | undefined
```
-## TB_E — const @experimental
-```
-2
-```
-
-## TB_N — const @experimental
-```
-1
-```
-
-## TB_NE — const @experimental
-```
-16
-```
-
-## TB_NW — const @experimental
-```
-128
-```
-
-## TB_S — const @experimental
-```
-4
-```
-
-## TB_SE — const @experimental
-```
-32
-```
-
-## TB_SW — const @experimental
-```
-64
-```
-
-## TB_W — const @experimental
-```
-8
-```
-
-## TERRAIN_NEIGHBORS — const @experimental
-```
-readonly { dx: number; dy: number; bit: number; }[]
-```
-
## THEME_COLOR_ROLES — const @experimental
```
readonly (keyof ThemeColors)[]
```
-## TILESET_FORMAT_VERSION — const @experimental
-```
-"1"
-```
-
-## TILE_FLAGS_MASK — const @experimental
-```
-number
-```
-
-## TILE_FLIP_D — const @experimental
-```
-32768
-```
-
-## TILE_FLIP_H — const @experimental
-```
-8192
-```
-
-## TILE_FLIP_V — const @experimental
-```
-16384
-```
-
-## TILE_ID_MASK — const @experimental
-```
-8191
-```
-
## TIMELINE_FORMAT_VERSION — const @experimental
```
"1.2"
@@ -9257,29 +9086,6 @@ setPaused: (paused: boolean) => void
suspendAudio: () => void
```
-## TerrainColor — interface @experimental
-```
-color: string
-name: string
-```
-
-## TerrainIndex — interface @experimental
-```
-byMask: Map<number, number>
-mode: TerrainMode
-```
-
-## TerrainIndices — interface @experimental
-```
-sets: Map<number, TerrainIndex>
-tileTerrain: Map<number, number>
-```
-
-## TerrainMode — type @experimental
-```
-'edge' | 'corner' | 'wang'
-```
-
## Text — const @public
```
ComponentDef<TextData>
@@ -9453,12 +9259,6 @@ type: "text"
(typeof TextVerticalAlign)[keyof typeof TextVerticalAlign]
```
-## TextureDimensions — interface @experimental
-```
-height: number
-width: number
-```
-
## TextureFilter — type @experimental
```
(typeof TextureFilter)[keyof typeof TextureFilter]
@@ -9612,237 +9412,6 @@ moveSpeed: number
rotationSpeed: number
```
-## TileCollisionPiece — interface @experimental
-```
-center: Vec2
-circles: { c: Vec2; r: number; }[]
-oneWay: { nx: number; ny: number; } | null
-polylines: Vec2[][]
-sensor: boolean
-```
-
-## TileCollisionShape — type @experimental
-```
-| { type: 'box' }
- | { type: 'polygon'; points: [number, number][] }
- | { type: 'circle'; cx: number; cy: number; r: number }
-```
-
-## TileFlags — interface @experimental
-```
-flipD: boolean
-flipH: boolean
-flipV: boolean
-```
-
-## TileGridParams — interface @experimental
-```
-hexSideLength: number | undefined
-orientation: number
-staggerAxisX: boolean | undefined
-staggerIndexEven: boolean | undefined
-tileHeight: number
-tileWidth: number
-```
-
-## TileStamp — interface @experimental
-```
-cells: number[]
-h: number
-w: number
-```
-
-## TiledLayerData — interface @experimental
-```
-chunks: TiledChunkData[]
-height: number
-infinite: boolean
-name: string
-opacity: number
-parallaxX: number
-parallaxY: number
-tiles: Uint16Array<ArrayBufferLike>
-tintColor: { r: number; g: number; b: number; a: number; }
-visible: boolean
-width: number
-```
-
-## TiledMapData — interface @experimental
-```
-collisionTileIds: number[]
-height: number
-hexSideLength: number
-layers: TiledLayerData[]
-objectGroups: TiledObjectGroupData[]
-orientation: string
-staggerAxis: string
-staggerIndex: string
-tileAnimations: Map<number, TiledAnimFrame[]>
-tileHeight: number
-tileProperties: Map<number, Map<string, string>>
-tileShapes: Map<number, ResolvedTileCollision>
-tileWidth: number
-tilesets: TiledTilesetData[]
-width: number
-```
-
-## TiledTilesetData — interface @experimental
-```
-collectionTiles: TiledCollectionTile[] | undefined
-columns: number
-firstGid: number
-image: string
-margin: number | undefined
-name: string
-spacing: number | undefined
-tileCount: number
-tileHeight: number
-tileWidth: number
-```
-
-## Tilemap — const @experimental
-```
-ComponentDef<TilemapData>
-```
-
-## TilemapAPI — const @experimental
-```
-{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }
-```
-
-## TilemapData — interface @experimental
-```
-source: string
-```
-
-## TilemapLayer — const @beta
-```
-BuiltinComponentDef<TilemapLayerData>
-```
-
-## TilemapLayerData — interface @beta
-```
-cellSize: Vec2
-hexSideLength: number
-opacity: number
-orientation: TilemapOrientation
-originOffset: Vec2
-parallaxFactor: Vec2
-renderLayer: number
-staggerAxis: TilemapStaggerAxis
-staggerIndex: TilemapStaggerIndex
-tileset: number
-tilesetColumns: number
-tintColor: Color
-visible: boolean
-```
-
-## TilemapLiveSync — const @experimental
-```
-{ setLayerTilesets(app: App, entity: number, refs: readonly string[]): void; }
-```
-
-## TilemapOrientation — enum @beta
-```
-Hexagonal = 3
-Isometric = 1
-Orthogonal = 0
-Staggered = 2
-```
-
-## TilemapPlugin — class @experimental
-```
-build: (app: App) => void
-cleanup: (app?: App) => void
-name: string
-static new (): TilemapPlugin
-static prototype: TilemapPlugin
-```
-
-## TilemapStaggerAxis — enum @beta
-```
-X = 1
-Y = 0
-```
-
-## TilemapStaggerIndex — enum @beta
-```
-Even = 1
-Odd = 0
-```
-
-## Tilemaps — const @experimental
-```
-ResourceDef<{ initLayer(entity: number, width: number, height: number, tileWidth: number, tileHeight: number): void; destroyLayer(entity: number): void; setTile(entity: number, x: number, y: number, tileId: number): void; getTile(entity: number, x: number, y: number): number; fillRect(entity: number, x: number, y: number, w: number, h: number, tileId: number): void; setTiles(entity: number, tiles: Uint16Array): void; setTilesets(entity: number, slots: { firstId: number; textureHandle: number; columns: number; margin?: number; spacing?: number; extrude?: number; }[]): void; hasLayer(entity: number): boolean; setRenderProps(entity: number, textureHandle: number, tilesetColumns: number, uvTileW: number, uvTileH: number, sortLayer: number, depth: number, parallaxX: number, parallaxY: number): void; setTint(entity: number, r: number, g: number, b: number, a: number, opacity: number): void; setVisible(entity: number, visible: boolean): void; setOriginEntity(layerKey: number, originEntity: number): void; setTileAnimation(entity: number, tileId: number, frames: { tileId: number; duration: number; }[]): void; clearTileAnimations(entity: number): void; advanceAnimations(entity: number, dtMs: number): void; setTileProperty(entity: number, tileId: number, key: string, value: string): void; getTileProperty(entity: number, x: number, y: number, key: string): string; flipTile(entity: number, x: number, y: number, flipH: boolean, flipV: boolean, flipD: boolean): void; rotateTile(entity: number, x: number, y: number, degrees: number): void; initInfiniteLayer(entity: number, tileWidth: number, tileHeight: number): void; setChunkTiles(entity: number, chunkX: number, chunkY: number, tiles: Uint16Array, width: number, height: number): void; setGridType(entity: number, type: number): void; setHexParams(entity: number, sideLength: number, staggerAxisX: boolean, staggerIndexEven: boolean): void; tileToWorld(entity: number, tx: number, ty: number, originX: number, originY: number): { x: number; y: number; }; worldToTile(entity: number, wx: number, wy: number, originX: number, originY: number): { x: number; y: number; }; exportChunks(entity: number): string; importChunks(entity: number, encoded: string): boolean; }>
-```
-
-## TilesetAnimFrame — interface @experimental
-```
-durationMs: number
-tile: number
-```
-
-## TilesetAsset — interface @experimental
-```
-columns: number
-extrude: number
-margin: number
-spacing: number
-terrains: TilesetTerrain[] | undefined
-texture: string
-tileCount: number | undefined
-tileHeight: number
-tileWidth: number
-tiles: Record<number, TilesetTile>
-version: string
-```
-
-## TilesetCollision — type @experimental
-```
-TileCollisionShape & {
- /** One-way (jump-through) platform: contacts from behind this normal pass through. */
- oneWay?: { nx: number; ny: number };
- /** Non-solid trigger volume (fires events, no physical response). */
- sensor?: boolean;
- /** Physics material overrides (absent = engine defaults). */
- density?: number;
- friction?: number;
- restitution?: number;
-}
-```
-
-## TilesetModel — interface @experimental
-```
-animations: Map<number, { tileId: number; duration: number; }[]>
-collidableTileIds: number[]
-slots: TilesetModelSlot[]
-tileShapes: Map<number, ResolvedTileCollision>
-```
-
-## TilesetTerrain — interface @experimental
-```
-color: string | undefined
-colors: TerrainColor[] | undefined
-mode: TerrainMode
-name: string
-```
-
-## TilesetTile — interface @experimental
-```
-animation: TilesetAnimFrame[] | undefined
-collision: TilesetCollision | undefined
-probability: number | undefined
-properties: Record<string, string> | undefined
-terrain: TilesetTileTerrain | undefined
-```
-
-## TilesetTileTerrain — interface @experimental
-```
-corners: number[] | undefined
-mask: number | undefined
-set: number
-```
-
## Time — const @public
```
ResourceDef<TimeData>
@@ -10628,12 +10197,6 @@ x: number
y: number
```
-## Vec2Like — interface @experimental
-```
-x: number
-y: number
-```
-
## Vec3 — interface @public
```
x: number
@@ -10780,17 +10343,6 @@ MoveBasis
"world"
```
-## WangIndex — interface @experimental
-```
-byKey: Map<number, number>
-```
-
-## WangIndices — interface @experimental
-```
-sets: Map<number, WangIndex>
-tileTerrain: Map<number, number>
-```
-
## WeChatRuntimeConfig — interface @experimental
```
aot: { module: string; manifest: AotManifest; } | undefined
@@ -11427,11 +10979,6 @@ AssetPlugin
(atlas: CookedAtlasInfo, pagePath: string): Pick<CatalogEntry, "atlas" | "frame" | "uv">
```
-## atlasCells — function @experimental
-```
-(size: number, margin: number, tileSize: number, spacing: number): number
-```
-
## audioPlugin — const @experimental
```
AudioPlugin
@@ -11532,11 +11079,6 @@ BtPlugin
(overrides: readonly PrefabOverride[]): Map<PrefabEntityId, PrefabOverride[]>
```
-## buildCollisionPaletteModel — function @experimental
-```
-(material?: CollisionMaterial): TilesetModel
-```
-
## buildFrameProfile — function @experimental
```
(input: FrameProfileInput): FrameProfile
@@ -11547,11 +11089,6 @@ BtPlugin
(verts: Float32Array, indices: ArrayLike<number>, opts: BuildNavMeshOptions): NavMesh
```
-## buildTerrainIndices — function @experimental
-```
-(asset: TilesetAsset): TerrainIndices
-```
-
## buildText — function @experimental
```
(init?: TextInit): TextData
@@ -11572,11 +11109,6 @@ BtPlugin
(base: PrefabData, baseRef: string, name: string, delta: { overrides: readonly PrefabOverride[]; added: readonly AddedEntity[]; }): PrefabData
```
-## buildWangIndices — function @experimental
-```
-(asset: TilesetAsset): WangIndices
-```
-
## builtinBusVolume — function @experimental
```
(name: string): number | null
@@ -11637,11 +11169,6 @@ BtPlugin
(type: BtNodeType): boolean
```
-## canonicalMask — function @experimental
-```
-(mode: TerrainMode, mask: number): number
-```
-
## captureFramePixels — function @beta
```
(module: ESEngineModule, width: number, height: number, advance?: () => void | Promise<void>): Promise<FramePixels | null>
@@ -11807,11 +11334,6 @@ BtPlugin
(prefab: PrefabData, loadPrefab: (path: string) => PrefabData | null, visited?: Set<string>): string[]
```
-## collidableTileIds — function @experimental
-```
-(asset: TilesetAsset): number[]
-```
-
## collider2DOutline — function @experimental
```
(shape: Collider2DShape, center: Vec2, angle: number, ppu: number): Collider2DOutline
@@ -11822,11 +11344,6 @@ BtPlugin
(shape: Collider3DShape, segments?: number): Vec3[][]
```
-## collisionRefWithMaterial — function @experimental
-```
-(material: CollisionMaterial): string
-```
-
## color — const @experimental
```
(r?: number, g?: number, b?: number, a?: number) => Color
@@ -12037,11 +11554,6 @@ Plugin
(opts: TextInputOptions): TextInputHandle
```
-## createTileset — function @experimental
-```
-(texture: string, tileWidth?: number, tileHeight?: number, columns?: number): TilesetAsset
-```
-
## createTimelineMotionDriver — function @experimental
```
(timeline: TimelineAPI): MotionDriver<AnimatorClipMotion>
@@ -12097,11 +11609,6 @@ Plugin
(bytes: Uint8Array): MeshData
```
-## decodeTilemapChunks — function @experimental
-```
-(blob: string): DecodedChunk[]
-```
-
## decomposePolygon2D — function @experimental
```
(vertices: readonly Vec2[]): PolygonDecomposition
@@ -12372,11 +11879,6 @@ DragPlugin
(data: MeshData): Uint8Array
```
-## encodeTile — function @experimental
-```
-(id: number, flags?: TileFlags): number
-```
-
## engineWebGPUFeatures — function @experimental
```
(adapter: WebGPUAdapterLike): string[]
@@ -12542,26 +12044,6 @@ EventBindingPlugin
(prefab: PrefabData, overrides: PrefabOverride[], ctx: FlattenContext): FlattenResult
```
-## flipFlagsH — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipFlagsV — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## flipStampH — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
-## flipStampV — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## flushPendingRegistrations — function @experimental
```
(app: App): void
@@ -12792,11 +12274,6 @@ GameplayPlugin
(key: string): CompiledScriptGraph | undefined
```
-## getTextureDimensions — function @experimental
-```
-(handle: number): TextureDimensions | null
-```
-
## getTheme — function @experimental
```
(): ThemeTokens
@@ -12967,11 +12444,6 @@ InputRouter
(graph: ScriptGraph): boolean
```
-## isCollisionPaletteRef — function @experimental
-```
-(refs: readonly string[]): boolean
-```
-
## isCustomExtension — function @experimental
```
(path: string): boolean
@@ -12992,11 +12464,6 @@ InputRouter
(): boolean
```
-## isEmptyStamp — function @experimental
-```
-(s: TileStamp): boolean
-```
-
## isEntityActive — function @experimental
```
(world: World, entity: Entity): boolean
@@ -13012,11 +12479,6 @@ InputRouter
(): boolean
```
-## isHexOrientation — function @experimental
-```
-(orientation: number): boolean
-```
-
## isKnownAssetExtension — function @experimental
```
(ext: string): boolean
@@ -13027,11 +12489,6 @@ InputRouter
(): boolean
```
-## isNonOrthogonal — function @experimental
-```
-(orientation: number): boolean
-```
-
## isPlatformInitialized — function @experimental
```
(): boolean
@@ -13147,11 +12604,6 @@ LifecyclePlugin
(world: World, sceneData: SceneData, options?: SceneLoadOptions): Promise<Map<number, Entity>>
```
-## loadTiledMap — function @experimental
-```
-(world: World, mapData: TiledMapData, textureHandles: Map<string, number>, options?: TilemapLoadOptions): Entity[]
-```
-
## localizationPlugin — const @experimental
```
LocalizationPlugin
@@ -13292,16 +12744,6 @@ MeshRendererPlugin
(world: World, layers?: number): boolean
```
-## navGridFromTilemapLayer — function @experimental
-```
-(entity: Entity, opts: BuildNavGridOptions): NavGrid
-```
-
-## navGridFromTiles — function @experimental
-```
-(getTile: (x: number, y: number) => number, opts: BuildNavGridOptions): NavGrid
-```
-
## navLinkDigest — function @experimental
```
(links: readonly NavLinkSegment[]): number
@@ -13332,11 +12774,6 @@ NavPlugin
(mode: string | undefined | null): BundleMode
```
-## normalizeCornerMask — function @experimental
-```
-(mask: number): number
-```
-
## onCameraCommitChanged — function @beta
```
(fn: CameraCommitListener): () => void
@@ -13362,11 +12799,6 @@ NavPlugin
(yawDeg: number, pitchDeg: number): Vec3
```
-## orientationPerm — function @experimental
-```
-(flags: TileFlags): Perm
-```
-
## overlayPose — function @experimental
```
(acc: Pose, layer: Pose, weight: number, world: PoseWorld, reach: LayerReach | null): void
@@ -13377,11 +12809,6 @@ NavPlugin
(semantics: { semantic: number; components: number; type: number; }[]): { channels: MeshChannelDesc[]; vertexStride: number; }
```
-## packCorners — function @experimental
-```
-(tl: number, tr: number, br: number, bl: number): number
-```
-
## packagedAppOptions — function @experimental
```
(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces"; msaaSamples?: number; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
@@ -13432,11 +12859,6 @@ NavPlugin
(raw: unknown): BusEffectDef[]
```
-## parseCollisionMaterial — function @experimental
-```
-(refs: readonly string[]): CollisionMaterial
-```
-
## parseLocaleTable — function @experimental
```
(text: string, path: string): LocaleTableAsset
@@ -13457,26 +12879,11 @@ NavPlugin
(colors?: Record<string, string>): ThemeOverrides | undefined
```
-## parseTileset — function @experimental
-```
-(rawJson: unknown): TilesetAsset
-```
-
## parseTimelineAsset — function @experimental
```
(rawJson: unknown): TimelineAsset
```
-## parseTmjJson — function @experimental
-```
-(json: Record<string, unknown>): TiledMapData | null
-```
-
-## parseTmjWithExternals — function @experimental
-```
-(json: Record<string, unknown>, resolveExternal: (source: string) => Promise<string>): Promise<TiledMapData | null>
-```
-
## particlePlugin — const @experimental
```
ParticlePlugin
@@ -13982,11 +13389,6 @@ ReplicationPlugin
(projectRelPath: string, config: AssetGroupsConfig | null | undefined): ResolvedAtlas | null
```
-## resolveAutotile — function @experimental
-```
-(index: TerrainIndex, neighbors: readonly boolean[]): number
-```
-
## resolveBindingTarget — function @experimental
```
(world: World, from: Entity, name: string): Entity | null
@@ -14012,31 +13414,11 @@ ReplicationPlugin
(scene: SceneData, read: (ref: string) => Promise<unknown | null>): Promise<(ref: string) => PrefabRoot | null>
```
-## resolveRelativePath — function @experimental
-```
-(basePath: string, relativePath: string): string
-```
-
## resolveThemeTokens — function @experimental
```
(base: "dark" | "light", overrides?: ThemeOverrides): ThemeTokens
```
-## resolveTilesetModel — function @experimental
-```
-(tilesets: ResolvedTileset[]): TilesetModel
-```
-
-## resolveWang — function @experimental
-```
-(index: WangIndex, corners: readonly number[]): number
-```
-
-## resolvedTileset — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): ResolvedTileset | undefined
-```
-
## restoreToFull — function @experimental
```
(world: World, entity: Entity): void
@@ -14052,16 +13434,6 @@ ReplicationPlugin
(delta: { x: number; z: number; }, seconds: number): { x: number; z: number; }
```
-## rotateFlagsCW — function @experimental
-```
-(flags: TileFlags): TileFlags
-```
-
-## rotateStampCW — function @experimental
-```
-(s: TileStamp): TileStamp
-```
-
## rotateVec3ByQuat — function @experimental
```
(rot: Quat, v: Vec3): Vec3
@@ -14222,11 +13594,6 @@ ScriptGraphPlugin
(world: World, sceneName?: string): SceneData
```
-## serializeTileset — function @experimental
-```
-(asset: TilesetAsset): Record<string, unknown>
-```
-
## serializeTimelineAsset — function @experimental
```
(asset: TimelineAsset): Record<string, unknown>
@@ -14497,11 +13864,6 @@ ServicesPlugin
(graph: ScriptGraph): ScriptGraphSignature
```
-## singleStamp — function @experimental
-```
-(raw: number): TileStamp
-```
-
## solveAnimatorIK — function @experimental
```
(world: World, rigRoot: Entity, pose: Pose, constraints: readonly AnimatorIK[], params: MotionParams, resolveJoint?: JointResolver): void
@@ -14637,41 +13999,6 @@ TextPlugin
<Ctx>(def: BtDefinition, ctx: Ctx, bb: Blackboard, registry: AiRegistry<Ctx>, rs: BtRunState, dt: number): Status
```
-## tileCellCenter — function @experimental
-```
-(p: TileGridParams, tx: number, ty: number): Vec2Like
-```
-
-## tileCellOutline — function @experimental
-```
-(p: TileGridParams): Vec2Like[]
-```
-
-## tileCollisionOutlines — function @experimental
-```
-(chunks: DecodedChunk[], model: TilesetModel, tileW: number, tileH: number, originX: number, originY: number): TileCollisionPiece[]
-```
-
-## tileFlagsOf — function @experimental
-```
-(raw: number): TileFlags
-```
-
-## tileIdOf — function @experimental
-```
-(raw: number): number
-```
-
-## tilemapPlugin — const @experimental
-```
-TilemapPlugin
-```
-
-## tilemapSource — function @experimental
-```
-(assets: AssetsData | null | undefined, ref: string): LoadedTilemapSource | undefined
-```
-
## timelinePlugin — const @experimental
```
TimelinePlugin
@@ -14822,11 +14149,6 @@ UIVisibilityPlugin
(def: FsmDefinition, from: string, index: number, patch: Partial<FsmTransition>): FsmDefinition
```
-## usesStagger — function @experimental
-```
-(orientation: number): boolean
-```
-
## 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 9f0d5996a..be9f7165e 100644
--- a/sdk/package.json
+++ b/sdk/package.json
@@ -14,6 +14,7 @@
"./dist/index.native.js",
"./dist/dragonbones/index.js",
"./dist/spine/index.js",
+ "./dist/tilemap/index.js",
"./dist/physics/index.js",
"./dist/physics3d/index.js",
"./dist/douyin/index.js",
@@ -53,6 +54,10 @@
"import": "./dist/spine/index.js",
"types": "./dist/spine/index.d.ts"
},
+ "./tilemap": {
+ "import": "./dist/tilemap/index.js",
+ "types": "./dist/tilemap/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 ab21c646f..d02e3c2b6 100644
--- a/sdk/rolldown.config.js
+++ b/sdk/rolldown.config.js
@@ -87,6 +87,7 @@ export default defineConfig([
'physics/index': 'src/physics/index.ts',
'physics3d/index': 'src/physics3d/index.ts',
'spine/index': 'src/spine/index.ts',
+ 'tilemap/index': 'src/tilemap/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 51232603c..e6eea5a91 100644
--- a/sdk/rollup.config.js
+++ b/sdk/rollup.config.js
@@ -18,6 +18,7 @@ export default [
'physics3d/index': 'src/physics3d/index.ts',
'douyin/index': 'src/platform/douyin/index.ts',
'spine/index': 'src/spine/index.ts',
+ 'tilemap/index': 'src/tilemap/index.ts',
'dragonbones/index': 'src/dragonbones/index.ts',
'wasm': 'src/wasm.ts',
},
diff --git a/sdk/src/ai/nav/index.ts b/sdk/src/ai/nav/index.ts
index 30978f08d..5fe58ed9d 100644
--- a/sdk/src/ai/nav/index.ts
+++ b/sdk/src/ai/nav/index.ts
@@ -10,11 +10,6 @@ export type {
} from './NavSurface';
export { NavGrid, type NavGridOptions, type Cell } from './NavGrid';
export { findPath, pathToWorld, type PathfindOptions } from './pathfind';
-export {
- navGridFromTiles,
- navGridFromTilemapLayer,
- type BuildNavGridOptions,
-} from './navGridFromTilemap';
export { NavMesh, type NavMeshData, type NavLinkSegment } from './NavMesh';
export { buildNavMesh, type BuildNavMeshOptions } from './navmesh/build';
export {
diff --git a/sdk/src/app/pluginSets.ts b/sdk/src/app/pluginSets.ts
index f5aa567f3..cc9426bb2 100644
--- a/sdk/src/app/pluginSets.ts
+++ b/sdk/src/app/pluginSets.ts
@@ -27,7 +27,6 @@ import { videoPlugin } from '../video';
import { particlePlugin } from '../particle';
import { trailPlugin } from '../trail';
import { meshRendererPlugin } from '../render/meshRenderer';
-import { tilemapPlugin } from '../tilemap';
import { postProcessPlugin } from '../postprocess';
import { timelinePlugin } from '../timeline';
import { gameplayPlugin } from '../gameplay';
@@ -62,7 +61,7 @@ export const simulationBasePlugins = (): Plugin[] => [
/** What exists to be seen. Every entry drives the engine through `engineApi`. */
export const presentationBasePlugins = (): Plugin[] => [
animationPlugin, videoPlugin, particlePlugin, trailPlugin, meshRendererPlugin,
- tilemapPlugin, postProcessPlugin, timelinePlugin, gameplayPlugin,
+ postProcessPlugin, timelinePlugin, gameplayPlugin,
];
/**
@@ -73,7 +72,7 @@ export const presentationBasePlugins = (): Plugin[] => [
export const webBasePlugins = (): Plugin[] => [
diagnosticsPlugin,
timerPlugin, velocityPlugin, lifecyclePlugin, animationPlugin, audioPlugin, videoPlugin,
- particlePlugin, trailPlugin, meshRendererPlugin, tilemapPlugin, postProcessPlugin, timelinePlugin,
+ particlePlugin, trailPlugin, meshRendererPlugin, postProcessPlugin, timelinePlugin,
gameplayPlugin,
perceptionPlugin, fsmPlugin, btPlugin, scriptGraphPlugin, navPlugin, eventBindingPlugin, replicationPlugin,
servicesPlugin,
diff --git a/sdk/src/asset/Assets.ts b/sdk/src/asset/Assets.ts
index 6fe27dd5c..6dad5fd46 100644
--- a/sdk/src/asset/Assets.ts
+++ b/sdk/src/asset/Assets.ts
@@ -20,6 +20,7 @@ import type { TextureImportSettings, TextureImportSettingsResolver } from './loa
import type { TextureFormatReport } from './textureFormatReport';
import { TextureLoader, textureResidencyKey } from './loaders/TextureLoader';
import { AssetRefLedger, type AssetRefLease } from './AssetRefLedger';
+import { optionalAssetLoaders } from './optionalLoaders';
import { AssetScope, type AssetLease } from './AssetLease';
import { EntityAssetScopes } from './entityAssetScopes';
import { RegistryAssetSlots, type RegistryAssetKind } from './registryAssets';
@@ -36,8 +37,6 @@ import { ProbeVolumeAssetLoader } from './loaders/ProbeVolumeAssetLoader';
import { FontAssetLoader } from './loaders/FontAssetLoader';
import { AudioAssetLoader } from './loaders/AudioAssetLoader';
import { AnimClipAssetLoader } from './loaders/AnimClipAssetLoader';
-import { TilemapAssetLoader } from './loaders/TilemapAssetLoader';
-import { TilesetAssetLoader } from './loaders/TilesetAssetLoader';
import { TimelineAssetLoader } from './loaders/TimelineAssetLoader';
import { PrefabAssetLoader } from './loaders/PrefabAssetLoader';
import { FsmAssetLoader } from './loaders/FsmAssetLoader';
@@ -2243,8 +2242,6 @@ export class Assets {
// invalidate have no LoadContext), so it shares Assets' lazy accessor.
this.register(new AudioAssetLoader(() => this.getAudio_()));
this.register(new AnimClipAssetLoader());
- this.register(new TilemapAssetLoader());
- this.register(new TilesetAssetLoader());
this.register(new TimelineAssetLoader());
this.register(new PrefabAssetLoader());
this.register(new FsmAssetLoader());
@@ -2254,6 +2251,10 @@ export class Assets {
this.register(new ScriptGraphAssetLoader());
this.register(new LocaleAssetLoader());
this.register(new JsonAssetLoader());
+ // …and whatever an optional subsystem brought with it. A loader names
+ // its subsystem's parser, so one the core constructs is one every
+ // package carries.
+ for (const loader of optionalAssetLoaders()) this.register(loader);
}
private textureCacheKey_(path: string, flip: boolean): string {
diff --git a/sdk/src/asset/optionalLoaders.ts b/sdk/src/asset/optionalLoaders.ts
new file mode 100644
index 000000000..549edaca3
--- /dev/null
+++ b/sdk/src/asset/optionalLoaders.ts
@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file optionalLoaders.ts — asset loaders an optional subsystem brings, held
+ * apart from the registry that installs them.
+ *
+ * `Assets` constructs every loader it knows, and a loader names its subsystem's
+ * parser — so a project with no tilemap carried the tilemap parser because the
+ * asset layer knew how to read one. The subsystem registers instead, when a
+ * package imports its subpath.
+ *
+ * Keyed by subsystem, for the reason `entryPlugins` is: registration is a call
+ * an entry and a subpath can both make.
+ */
+import type { AssetLoader } from './AssetLoader';
+
+const makers = new Map<string, () => AssetLoader<unknown>>();
+
+/** Called by an optional subsystem's support module. */
+export function addAssetLoader(id: string, make: () => AssetLoader<unknown>): void {
+ makers.set(id, make);
+}
+
+/** Fresh instances per registry: a loader may hold per-registry state. */
+export function optionalAssetLoaders(): Array<AssetLoader<unknown>> {
+ return [...makers.values()].map((make) => make());
+}
diff --git a/sdk/src/core-content.ts b/sdk/src/core-content.ts
index 8838244cb..f73733ce1 100644
--- a/sdk/src/core-content.ts
+++ b/sdk/src/core-content.ts
@@ -726,112 +726,6 @@ export {
// Tilemap
// =============================================================================
-export {
- Tilemap,
- TilemapLayer,
- TilemapAPI,
- Tilemaps,
- TilemapPlugin,
- tilemapPlugin,
- TilemapLiveSync,
- parseTmjJson,
- parseTmjWithExternals,
- loadTiledMap,
- resolveRelativePath,
- getTextureDimensions,
- TILESET_FORMAT_VERSION,
- parseTileset,
- serializeTileset,
- createTileset,
- collidableTileIds,
- resolveTilesetModel,
- atlasCells,
- decodeTilemapChunks,
- CHUNK_SIZE,
- tileCollisionOutlines,
- COLLISION_PALETTE_REF,
- COLLISION_BRUSHES,
- isCollisionPaletteRef,
- buildCollisionPaletteModel,
- parseCollisionMaterial,
- collisionRefWithMaterial,
- tileCellCenter,
- tileCellOutline,
- isNonOrthogonal,
- usesStagger,
- isHexOrientation,
- TilemapOrientation,
- TilemapStaggerAxis,
- TilemapStaggerIndex,
- TB_N,
- TB_E,
- TB_S,
- TB_W,
- TB_NE,
- TB_SE,
- TB_SW,
- TB_NW,
- TERRAIN_NEIGHBORS,
- normalizeCornerMask,
- canonicalMask,
- buildTerrainIndices,
- resolveAutotile,
- packCorners,
- buildWangIndices,
- resolveWang,
- TILE_ID_MASK,
- TILE_FLIP_H,
- TILE_FLIP_V,
- TILE_FLIP_D,
- TILE_FLAGS_MASK,
- encodeTile,
- tileIdOf,
- tileFlagsOf,
- orientationPerm,
- flipFlagsH,
- flipFlagsV,
- rotateFlagsCW,
- singleStamp,
- isEmptyStamp,
- flipStampH,
- flipStampV,
- rotateStampCW,
- type TileFlags,
- type TileStamp,
- type TilemapData,
- type TilemapLayerData,
- type TiledMapData,
- type TiledLayerData,
- type TiledTilesetData,
- type TextureDimensions,
- tilemapSource,
- resolvedTileset,
- type LoadedTilemapSource,
- type LoadedTilemapLayer,
- type LoadedTilemapTileset,
- type TilesetAsset,
- type TilesetTile,
- type TilesetCollision,
- type TileCollisionShape,
- type ResolvedTileCollision,
- type ResolvedTileset,
- type TilesetModel,
- type DecodedChunk,
- type TileCollisionPiece,
- type CollisionBrush,
- type CollisionMaterial,
- type TileGridParams,
- type Vec2Like,
- type TilesetAnimFrame,
- type TerrainMode,
- type TerrainColor,
- type TilesetTerrain,
- type TilesetTileTerrain,
- type TerrainIndex,
- type TerrainIndices,
- type WangIndex,
- type WangIndices,
-} from './tilemap';
// =============================================================================
// Physics types (the plugin + config surface; simulation lives in the package)
@@ -859,8 +753,6 @@ export {
navGeometryReady,
findPath,
pathToWorld,
- navGridFromTiles,
- navGridFromTilemapLayer,
Navigation,
Nav,
NavAgent,
@@ -892,7 +784,6 @@ export {
type CollectNavGeometryOptions,
type Cell,
type PathfindOptions,
- type BuildNavGridOptions,
type NavAgentData,
type NavVolumeData,
type NavObstacleData,
diff --git a/sdk/src/runtime/optionalPlugins.ts b/sdk/src/runtime/optionalPlugins.ts
index cdc383b67..6b9ee96c3 100644
--- a/sdk/src/runtime/optionalPlugins.ts
+++ b/sdk/src/runtime/optionalPlugins.ts
@@ -19,12 +19,14 @@ import { registerSpineSupport } from '../spine/spineSupport';
import { registerDragonBonesSupport } from '../dragonbones/dragonBonesSupport';
import { registerPhysics2DSupport } from '../physics/physicsSupport';
import { registerPhysics3DSupport } from '../physics3d/physics3dSupport';
+import { registerTilemapSupport } from '../tilemap/tilemapSupport';
export function installOptionalPlugins(): void {
registerSpineSupport();
registerDragonBonesSupport();
registerPhysics2DSupport();
registerPhysics3DSupport();
+ registerTilemapSupport();
// Video has no subpath of its own to be installed from, so it registers here.
setSceneOptionals({
video: {
diff --git a/sdk/src/tilemap/index.ts b/sdk/src/tilemap/index.ts
index 2b6f618ea..26d9e915a 100644
--- a/sdk/src/tilemap/index.ts
+++ b/sdk/src/tilemap/index.ts
@@ -61,3 +61,14 @@ export {
tileCollisionAt, isTileSolid, tileCollisionAtWorld,
type LayerCollisionTable,
} from './tileQuery';
+
+export {
+ navGridFromTiles,
+ navGridFromTilemapLayer,
+ type BuildNavGridOptions,
+} from './navGridFromTilemap';
+
+// Importing this subpath INSTALLS tilemaps — see spine/index.ts.
+import { registerTilemapSupport } from './tilemapSupport';
+
+registerTilemapSupport();
diff --git a/sdk/src/ai/nav/navGridFromTilemap.ts b/sdk/src/tilemap/navGridFromTilemap.ts
similarity index 82%
rename from sdk/src/ai/nav/navGridFromTilemap.ts
rename to sdk/src/tilemap/navGridFromTilemap.ts
index 5fd849280..17c737e79 100644
--- a/sdk/src/ai/nav/navGridFromTilemap.ts
+++ b/sdk/src/tilemap/navGridFromTilemap.ts
@@ -4,16 +4,17 @@
* @file navGridFromTilemap.ts
* @brief Build a NavGrid from tilemap walkability.
*
- * The core builder takes a raw `getTile(x,y)` reader so it stays wasm-free and
- * unit-testable; the convenience wrapper reads a live tilemap layer through
- * TilemapAPI. Cells are raw u16 (`tileId | flipBits`), split by the mask the
+ * Lives with tilemap rather than with nav: it READS tilemap data, and nav is in
+ * every package while tilemap is not. The core builder takes a raw `getTile(x,y)`
+ * reader so it stays wasm-free and unit-testable; the wrapper reads a live layer
+ * through TilemapAPI. Cells are raw u16 (`tileId | flipBits`), split by the mask the
* C++ header owns — a wider one here reads every cell as a different tile.
*/
-import type { Entity, Vec2 } from '../../types';
-import { NavGrid } from './NavGrid';
-import { TilemapAPI } from '../../tilemap/tilemapAPI';
-import { TILE_ID_MASK } from '../../tilemap/tileBits';
+import type { Entity, Vec2 } from '../types';
+import { NavGrid } from '../ai/nav/NavGrid';
+import { TilemapAPI } from './tilemapAPI';
+import { TILE_ID_MASK } from './tileBits';
export interface BuildNavGridOptions {
width: number;
diff --git a/sdk/src/tilemap/tilemapSupport.ts b/sdk/src/tilemap/tilemapSupport.ts
new file mode 100644
index 000000000..a5d5175a9
--- /dev/null
+++ b/sdk/src/tilemap/tilemapSupport.ts
@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file tilemapSupport.ts — what a build that ships tilemaps tells the core.
+ *
+ * A call, not a file's side effect — see spine/spineSupport.ts. Both halves come
+ * from here: the plugin an app installs, and the loaders that read a `.tmj` and
+ * a tileset. A loader names its subsystem's parser, so one the asset registry
+ * constructs is one every package carries.
+ */
+import { addEntryPlugin } from '../runtime/entryPlugins';
+import { addAssetLoader } from '../asset/optionalLoaders';
+import { tilemapPlugin } from './tilemapPlugin';
+import { TilemapAssetLoader } from '../asset/loaders/TilemapAssetLoader';
+import { TilesetAssetLoader } from '../asset/loaders/TilesetAssetLoader';
+
+export function registerTilemapSupport(): void {
+ addEntryPlugin('tilemap', () => tilemapPlugin);
+ addAssetLoader('tilemap', () => new TilemapAssetLoader() as never);
+ addAssetLoader('tileset', () => new TilesetAssetLoader() as never);
+}
diff --git a/sdk/tests/asset-dependencies.test.ts b/sdk/tests/asset-dependencies.test.ts
index 70625e4d5..5a500352b 100644
--- a/sdk/tests/asset-dependencies.test.ts
+++ b/sdk/tests/asset-dependencies.test.ts
@@ -16,6 +16,11 @@ import { Catalog } from '../src/asset/Catalog';
import type { Backend } from '../src/asset/Backend';
import type { LoadContext } from '../src/asset/AssetLoader';
+// The tilemap loaders come with the subsystem now, not with the asset
+// registry: a package without tilemaps does not carry a tilemap parser.
+import { registerTilemapSupport } from '../src/tilemap/tilemapSupport';
+registerTilemapSupport();
+
function createPoolFake() {
const live = new Set<number>();
const byPath = new Map<string, number>();
diff --git a/sdk/tests/nav-step.test.ts b/sdk/tests/nav-step.test.ts
index f786e55e7..7cc62db4e 100644
--- a/sdk/tests/nav-step.test.ts
+++ b/sdk/tests/nav-step.test.ts
@@ -11,9 +11,14 @@ import {
type AgentRuntime,
type NavWorldView,
} from '../src/ai/nav/NavPlugin';
-import { navGridFromTiles, navGridFromTilemapLayer } from '../src/ai/nav/navGridFromTilemap';
+import { navGridFromTiles, navGridFromTilemapLayer } from '../src/tilemap/navGridFromTilemap';
import { initTilemapAPI, shutdownTilemapAPI } from '../src/tilemap/tilemapAPI';
+// The tilemap loaders come with the subsystem now, not with the asset
+// registry: a package without tilemaps does not carry a tilemap parser.
+import { registerTilemapSupport } from '../src/tilemap/tilemapSupport';
+registerTilemapSupport();
+
/** Minimal in-memory world satisfying what stepNavigation calls. */
class FakeWorld implements NavWorldView {
private store = new Map<string, unknown>();
diff --git a/sdk/tests/tiled-layer-drawing.test.ts b/sdk/tests/tiled-layer-drawing.test.ts
index 2758cbf50..f152cf399 100644
--- a/sdk/tests/tiled-layer-drawing.test.ts
+++ b/sdk/tests/tiled-layer-drawing.test.ts
@@ -16,6 +16,11 @@ import type { Backend } from '../src/asset/Backend';
import type { PublishedTilemap } from '../src/tilemap/tilesetCache';
import { tiledLayerComponent } from '../src/tilemap/tiledLoader';
+// The tilemap loaders come with the subsystem now, not with the asset
+// registry: a package without tilemaps does not carry a tilemap parser.
+import { registerTilemapSupport } from '../src/tilemap/tilemapSupport';
+registerTilemapSupport();
+
vi.mock('../src/wasm/resourceManager', () => ({
requireResourceManager: () => ({ releaseTexture: vi.fn(), invalidateTexturePath: vi.fn(() => false) }),
getResourceManager: () => null,
diff --git a/sdk/tests/tilemap-realm-assets.test.ts b/sdk/tests/tilemap-realm-assets.test.ts
index 66ed81823..56a14436f 100644
--- a/sdk/tests/tilemap-realm-assets.test.ts
+++ b/sdk/tests/tilemap-realm-assets.test.ts
@@ -18,6 +18,11 @@ import { Catalog } from '../src/asset/Catalog';
import type { Backend } from '../src/asset/Backend';
import type { PublishedTilemap, PublishedTileset } from '../src/tilemap/tilesetCache';
+// The tilemap loaders come with the subsystem now, not with the asset
+// registry: a package without tilemaps does not carry a tilemap parser.
+import { registerTilemapSupport } from '../src/tilemap/tilemapSupport';
+registerTilemapSupport();
+
/** The pool, modelled: what is live is what has not been released. */
function createPoolFake() {
const live = new Set<number>();
diff --git a/sdk/tests/tilemap-source-invalidate.test.ts b/sdk/tests/tilemap-source-invalidate.test.ts
index 8ef2e8069..afa96bc8f 100644
--- a/sdk/tests/tilemap-source-invalidate.test.ts
+++ b/sdk/tests/tilemap-source-invalidate.test.ts
@@ -16,6 +16,11 @@ import { Catalog } from '../src/asset/Catalog';
import type { Backend } from '../src/asset/Backend';
import type { PublishedTilemap } from '../src/tilemap/tilesetCache';
+// The tilemap loaders come with the subsystem now, not with the asset
+// registry: a package without tilemaps does not carry a tilemap parser.
+import { registerTilemapSupport } from '../src/tilemap/tilemapSupport';
+registerTilemapSupport();
+
vi.mock('../src/wasm/resourceManager', () => ({
requireResourceManager: () => ({ releaseTexture: vi.fn(), invalidateTexturePath: vi.fn(() => false) }),
getResourceManager: () => null,
diff --git a/tools/check-subsystem-install-reach.mjs b/tools/check-subsystem-install-reach.mjs
new file mode 100644
index 000000000..e2a7f36b4
--- /dev/null
+++ b/tools/check-subsystem-install-reach.mjs
@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file Every optional subsystem an entry can install, some entry installs.
+ *
+ * A subsystem behind a subpath is paid for only by the packages that import it —
+ * and a package that should have imported it and did not renders a scene with a
+ * piece missing and says nothing. Moving tilemap out of the fixed plugin set did
+ * exactly that to the web export, which builds from the whole entry and has no
+ * subpath step: the example drew its player and none of its ground, with an
+ * empty console.
+ *
+ * So the whole entry installs everything: `installOptionalPlugins` names every
+ * `register…Support` there is. A new subsystem that forgets is a build that is
+ * quietly missing half a scene.
+ *
+ * node tools/check-subsystem-install-reach.mjs
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const SRC = path.join(ROOT, 'sdk/src');
+const INSTALLER = 'sdk/src/runtime/optionalPlugins.ts';
+
+/** Every `register<X>Support` a subsystem exports, by the file that exports it. */
+const supports = [];
+for (const dir of readdirSync(SRC, { withFileTypes: true })) {
+ if (!dir.isDirectory()) continue;
+ for (const name of readdirSync(path.join(SRC, dir.name))) {
+ if (!/Support\.ts$/.test(name)) continue;
+ const src = readFileSync(path.join(SRC, dir.name, name), 'utf8');
+ for (const m of src.matchAll(/export function (register\w*Support)\s*\(/g)) {
+ supports.push({ fn: m[1], from: `${dir.name}/${name}` });
+ }
+ }
+}
+
+if (supports.length === 0) {
+ console.error('check-subsystem-install-reach: no register…Support found — they moved.');
+ process.exit(1);
+}
+
+const installer = readFileSync(path.join(ROOT, INSTALLER), 'utf8');
+const missing = supports.filter((s) => !new RegExp(`\\b${s.fn}\\s*\\(\\s*\\)`).test(installer));
+
+if (missing.length > 0) {
+ for (const s of missing) {
+ console.error(` ${INSTALLER} never calls ${s.fn}() — a package built from the whole `
+ + `entry would render ${s.from.split('/')[0]} content with the subsystem absent, silently`);
+ }
+ console.error(`check-subsystem-install-reach: ${missing.length} subsystem(s) the whole entry forgets.`);
+ process.exit(1);
+}
+
+console.log(`check-subsystem-install-reach: ${supports.length} optional subsystem(s), `
+ + 'each installed by the entry that claims to carry them all.');
diff --git a/tools/gates.mjs b/tools/gates.mjs
index bea1d4ce3..78a50972a 100644
--- a/tools/gates.mjs
+++ b/tools/gates.mjs
@@ -265,6 +265,9 @@ export const GATES = [
// A packaging setting the manifest parser does not read is a setting that
// does nothing, in the editor and on a build server alike.
{ id: 'packaging-settings', run: 'node tools/check-packaging-settings.mjs' },
+ // A subsystem behind a subpath is paid for only by packages that import it,
+ // and one that should have and did not renders half a scene in silence.
+ { id: 'subsystem-install-reach', run: 'node tools/check-subsystem-install-reach.mjs' },
// The generated entry is the only code that runs before the game, so the
// platform has to be installed there — not by a module side effect a bundler
// is free to drop, which is how every WeChat package stopped booting.
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index dc346d536..a78f8097c 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(tilemap): the tilemap API moves to its own subpath':
+ { note: "Tilemaps are a subpath: `import { Tilemap } from 'esengine/tilemap'`." },
+ 'chore: desktop — tilemaps move to their own subpath':
+ { note: "Tilemaps are a subpath: `import { Tilemap } from 'esengine/tilemap'`." },
'fix(assets): compression that cannot pay for its decoder is skipped':
{ note: 'A project whose art weighs less than the transcoder no longer compresses any of it.' },
'fix(assets): a texture ships in whichever form is smaller':