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
import { readFile, rm } from 'node:fs/promises';
import path from 'node:path';
import type { AddressableManifest } from 'esengine';
import { containsPath, isInsideRoot, realPathOf } from '../fs/pathSandbox';
/** Physical files owned by the exported manifest; shared pack files count once. */
export async function exportedAssetFiles(output: string): Promise<Set<string>> {
let manifest: AddressableManifest;
try {
manifest = JSON.parse(await readFile(path.join(output, 'asset-manifest.json'), 'utf8'));
} catch (err) {
if ((err as NodeJS.ErrnoException).code === 'ENOENT' || err instanceof SyntaxError) return new Set();
throw err;
}
const files = new Set<string>();
const base = path.resolve(output);
for (const group of Object.values(manifest.groups ?? {})) {
for (const asset of Object.values(group.assets ?? {})) {
const file = asset.pack?.file ?? asset.path;
if (typeof file !== 'string' || !file || path.isAbsolute(file) || /^[a-z]+:/i.test(file)) continue;
const target = path.resolve(output, file);
if (target !== base && containsPath(base, target)) files.add(target);
}
}
return files;
}
/** Remove only previously shipped asset files absent from the current manifest. */
export async function pruneExportedAssets(output: string, project: string, previous: ReadonlySet<string>): Promise<void> {
const current = await exportedAssetFiles(output);
const stale = [...previous].filter((file) => !current.has(file));
if (stale.length === 0) return;
if (containsPath(realPathOf(output), realPathOf(project))) {
throw new Error('asset cleanup requires a build output separate from the project source');
}
for (const file of stale) {
if (isInsideRoot(output, file)) await rm(file, { force: true });
}
}