A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
refactor(tilemap): the tilemap API moves to its own subpath
esenginebf9d3c2c1894
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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 astep 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/desktopindex f9c9c29d8..0d79a110b 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit f9c9c29d8ad140a3f0e7ebc41bbf2aa4d5b01b73+Subproject commit 0d79a110bb9e218cc8c378e1f36b3dca0ea495d8diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.jsonindex 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.tsindex 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.jsonindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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.tsindex 3d111eb92..42b6b3a77 100644--- a/pipeline/src/export/exportMiniGame.ts+++ b/pipeline/src/export/exportMiniGame.ts@@ -51,6 +51,8 @@ import { loadProjectModules, sideModuleDeclarations, stageProjectModules } fromimport { 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.mdindex 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: BtPluginMap<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 | undefined16```-## CHUNK_SIZE — const @experimental-```-16-```-## CLIP_EPSILON — const @experimental```0.00001@@ -1855,16 +1840,6 @@ sprite: number | undefined24```-## 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: numberpointY: 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" | undefineduiThemeOverrides: 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: stringname: 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[] | undefinedwrites: 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) => voidsuspendAudio: () => 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: numberrotationSpeed: 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: numbery: 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.mdindex 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: BtPluginMap<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 | undefined16```-## CHUNK_SIZE — const @experimental-```-16-```-## CLIP_EPSILON — const @experimental```0.00001@@ -1855,16 +1840,6 @@ sprite: number | undefined24```-## 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: numberpointY: 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" | undefineduiThemeOverrides: 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: stringname: 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[] | undefinedwrites: 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) => voidsuspendAudio: () => 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: numberrotationSpeed: 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: numbery: 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.mdindex 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: BtPluginMap<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 | undefined16```-## CHUNK_SIZE — const @experimental-```-16-```-## CLIP_EPSILON — const @experimental```0.00001@@ -1850,16 +1835,6 @@ sprite: number | undefined24```-## 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: numberpointY: 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" | undefineduiThemeOverrides: 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: stringname: 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[] | undefinedwrites: 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) => voidsuspendAudio: () => 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: numberrotationSpeed: 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: numbery: 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.mdindex 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: BtPluginMap<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 | undefined16```-## CHUNK_SIZE — const @experimental-```-16-```-## CLIP_EPSILON — const @experimental```0.00001@@ -1850,16 +1835,6 @@ sprite: number | undefined24```-## 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: numberpointY: 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" | undefineduiThemeOverrides: 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: stringname: 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[] | undefinedwrites: 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) => voidsuspendAudio: () => 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: numberrotationSpeed: 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: numbery: 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.mdindex 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: BtPluginMap<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 | undefined16```-## CHUNK_SIZE — const @experimental-```-16-```-## CLIP_EPSILON — const @experimental```0.00001@@ -1850,16 +1835,6 @@ sprite: number | undefined24```-## 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: numberpointY: 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" | undefineduiThemeOverrides: 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: stringname: 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[] | undefinedwrites: 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) => voidsuspendAudio: () => 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: numberrotationSpeed: 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: numbery: 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.jsonindex 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.jsindex 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.jsindex 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.tsindex 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.tsindex 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.tsindex 6fe27dd5c..6dad5fd46 100644--- a/sdk/src/asset/Assets.ts+++ b/sdk/src/asset/Assets.ts@@ -20,6 +20,7 @@ import type { TextureImportSettings, TextureImportSettingsResolver } from './loaimport 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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.tssimilarity index 82%rename from sdk/src/ai/nav/navGridFromTilemap.tsrename to sdk/src/tilemap/navGridFromTilemap.tsindex 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.mjsnew file mode 100644index 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.mjsindex 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.mjsindex 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':