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 check-path-sandbox.mjs — one containment check, not six.
*
* "Is this path inside that root?" was written out by hand at six doors, each
* with a different amount of it right; the project one was lexical, so a symlink
* inside a project walked out of the sandbox. They now share `pathSandbox.ts`,
* and this keeps the idiom from being open-coded again.
*
* A use that is NOT a boundary — classifying paths for a report, say — opts out
* on the line above with `path-sandbox: <why>`.
*/
import { readFileSync, existsSync } from 'node:fs';
import { listTrackedSources } from './lib/sourceRoots.mjs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
const HOME = 'pipeline/src/fs/pathSandbox.ts';
const SCOPE = /^(desktop\/(electron|src)|pipeline\/src)\/.*\.tsx?$/;
// The two spellings of lexical containment, which is the check that is not one.
const IDIOMS = [
{ id: 'dotdot', re: /\.startsWith\(\s*['"]\.\.['"]\s*\)/ },
{ id: 'sep', re: /\.startsWith\(\s*\w[\w.]*\s*\+\s*path\.sep\s*\)/ },
];
const OPT_OUT = /path-sandbox:/;
const { files: tracked, missing } = listTrackedSources(['desktop/electron', 'desktop/src', 'pipeline/src']);
// A gate that scans the editor has to read the SUBMODULE's index: this repo's
// `git ls-files` does not list a submodule's contents, so scanning that way
// quietly dropped 90% of the files in scope and still printed green.
if (missing.length) {
console.log(`check-path-sandbox: no editor checkout — ${missing.join(', ')} not scanned.`);
}
const files = tracked
// `git ls-files` lists what is TRACKED, which includes a file deleted in the
// working tree; reading one throws before any verdict is reached.
.filter((f) => SCOPE.test(f) && f !== HOME && existsSync(path.join(ROOT, f)));
const findings = [];
for (const file of files) {
const lines = readFileSync(path.join(ROOT, file), 'utf8').split('\n');
for (let i = 0; i < lines.length; i++) {
const hit = IDIOMS.find((r) => r.re.test(lines[i]));
if (!hit) continue;
// The opt-out sits on the line itself or anywhere in the comment block above
// it — a justification worth reading is usually more than one line.
let j = i - 1;
while (j >= 0 && /^\s*(\/\/|\*|\/\*)/.test(lines[j])) j--;
if (OPT_OUT.test(lines[i]) || lines.slice(j + 1, i).some((l) => OPT_OUT.test(l))) continue;
findings.push({ file, line: i + 1, text: lines[i].trim() });
}
}
if (findings.length === 0) {
console.log(`check-path-sandbox: ${files.length} file(s) — containment is asked of ${HOME}, not open-coded.`);
process.exit(0);
}
for (const f of findings) {
console.error(`\n${f.file}:${f.line} hand-rolled containment check`);
console.error(` ${f.text}`);
}
console.error(
`\ncheck-path-sandbox: ${findings.length} finding(s). Use isInsideRoot/resolveInside from `
+ `${HOME}, or mark a non-boundary use with a "path-sandbox: <why>" comment.`,
);
process.exit(1);