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 One source of truth for resolving the `esengine` SDK across every export
* pipeline. There are two strategies, and they must agree on the same set
* of subpath exports (mirrors sdk/package.json "exports"):
*
* EXTERNAL (web / desktop) — esengine stays external, resolved at runtime
* by the page import map. The runtime side of this map lives in
* the export's import map; both read the table below.
* ALIASED + INLINED (wechat / playable) — no import map, so the bundle
* inlines the SDK; esbuild `alias` points esengine (+ subpaths) at dist.
*/
import path from 'node:path';
import { ESENGINE_SUBPATHS } from './engineSubpaths';
/** esengine left external (web / desktop import-map builds). */
export const ESENGINE_EXTERNAL = ['esengine', 'esengine/*'];
/**
* The subpaths a game may import, and what each resolves to under the staged
* SDK. ONE list: both strategies read it, and so does the import map — a second
* hand-written copy is how a specifier the SDK never exported survived in both.
* check-import-map.mjs holds it against the package.
*/
// One author, in a module the editor's renderer can also read.
export { ESENGINE_SUBPATHS, ENGINE_MODULES } from './engineSubpaths';
/**
* esbuild `alias` resolving `esengine` and its subpath exports to files under
* `sdkDir`, for INLINED builds (the project root has no esengine to resolve from).
* `mainEntry` picks the SDK build: 'index.js' (web SDK — web/playable) or
* 'index.wechat.js' (the WeChat SDK).
*/
export function esengineAlias(sdkDir: string, mainEntry = 'index.js'): Record<string, string> {
const out: Record<string, string> = { esengine: path.join(sdkDir, mainEntry) };
for (const [specifier, rel] of Object.entries(ESENGINE_SUBPATHS)) {
out[specifier] = path.join(sdkDir, ...rel.split('/'));
}
return out;
}