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
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
/**
* @file nativeModuleRegistry.ts
* @brief The public `esengine/*` subpath namespaces, published for a native
* game script to resolve against THIS module graph.
*
* A native build has no module loader: the exporter rewrites every
* `esengine` import to something already evaluated. The bare specifier
* binds to `globalThis.ESEngine`; a subpath binds here.
*
* It has to be this graph and not a second copy. `Physics3D` is
* `defineResource(null, 'Physics3D')` — a JS identity, not a C++
* binding — and `Res` is keyed by that identity. A separately bundled
* `physics3d` would mint a second token, the runtime would install a
* resource under the first, and the game would ask for the second and
* be told nothing is there.
*
* NOT public API. It is a non-enumerable global the packaging step
* resolves against, and nothing re-exports it.
*/
import * as Physics2DModule from '../physics';
import * as Physics3DModule from '../physics3d';
import * as SpineModule from '../spine';
import * as DragonBonesModule from '../dragonbones';
import * as TilemapModule from '../tilemap';
import * as TerrainModule from '../terrain';
import * as TimelineModule from '../timeline/api';
import * as FxBasicModule from '../postprocess/fxBasic';
import * as FxAtmosphereModule from '../postprocess/fxAtmosphere';
import * as FxLightingModule from '../postprocess/fxLighting';
import * as FxAgxModule from '../postprocess/fxAgx';
import * as FoliageModule from '../foliage';
import * as WorldGenModule from '../worldgen';
import * as WaterModule from '../water';
import * as ImageModule from '../image';
import * as SoundModule from '../sound';
import * as SplineModule from '../spline';
import * as VoxelModule from '../voxel';
import * as Rig2DModule from '../rig2d';
import * as ImportedSceneModule from '../imported-scene';
import * as SkeletalAnimationModule from '../skeletal-animation';
import * as CharacterShadersModule from '../character';
import * as ScriptGraphModule from '../logic';
import * as AiModule from '../ai';
import * as ReplicationModule from '../net/replication';
import * as SessionModule from '../net/session';
import * as GameplayModule from '../gameplay';
/** Must equal NATIVE_MODULE_REGISTRY in tools/nativeScriptModules.mjs, which is
* what the exporter emits and what check-native-script-modules reads. */
export const NATIVE_MODULE_REGISTRY = '__ESTELLA_NATIVE_MODULES__';
/**
* Namespace per specifier. The keys are the specifiers a project writes, so the
* exporter's lookup and this table are spelled the same way on both sides.
*/
export const NATIVE_MODULE_NAMESPACES: Readonly<Record<string, unknown>> = {
'esengine/physics': Physics2DModule,
'esengine/physics3d': Physics3DModule,
'esengine/spine': SpineModule,
'esengine/dragonbones': DragonBonesModule,
'esengine/tilemap': TilemapModule,
'esengine/terrain': TerrainModule,
'esengine/timeline': TimelineModule,
'esengine/fx-basic': FxBasicModule,
'esengine/fx-atmosphere': FxAtmosphereModule,
'esengine/fx-lighting': FxLightingModule,
'esengine/fx-agx': FxAgxModule,
'esengine/foliage': FoliageModule,
'esengine/worldgen': WorldGenModule,
'esengine/water': WaterModule,
'esengine/image': ImageModule,
'esengine/sound': SoundModule,
'esengine/spline': SplineModule,
'esengine/voxel': VoxelModule,
'esengine/rig2d': Rig2DModule,
'esengine/imported-scene': ImportedSceneModule,
'esengine/skeletal-animation': SkeletalAnimationModule,
'esengine/character-shaders': CharacterShadersModule,
'esengine/logic': ScriptGraphModule,
'esengine/ai': AiModule,
'esengine/replication': ReplicationModule,
'esengine/session': SessionModule,
'esengine/gameplay': GameplayModule,
};
/**
* Publish the namespaces on the global the exporter resolves against.
*
* Non-enumerable so it stays out of anything that walks globalThis, and
* idempotent because a host may evaluate the bundle more than once.
*/
export function installNativeModuleRegistry(target: object = globalThis): void {
const holder = target as Record<string, unknown>;
if (holder[NATIVE_MODULE_REGISTRY]) return;
Object.defineProperty(holder, NATIVE_MODULE_REGISTRY, {
value: NATIVE_MODULE_NAMESPACES,
enumerable: false,
writable: false,
configurable: true,
});
}