cluaupp 0.1.4 → 0.2.0

package/src/utils/safe-paths.ts

@@ -0,0 +1,98 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const BLOCKED_DIRS = new Set([".", "..", "node_modules", ".git"]);
+
+export class PathEscapeError extends Error {
+	constructor(message: string) {
+		super(message);
+		this.name = "PathEscapeError";
+	}
+}
+
+export function posixRel(rel: string): string {
+	return String(rel || "").replace(/\\/g, "/");
+}
+
+export function isInside(root: string, target: string): boolean {
+	const absRoot = path.resolve(root);
+	const absTarget = path.resolve(target);
+	const rel = path.relative(absRoot, absTarget);
+	return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+}
+
+export function realPath(target: string): string {
+	try {
+		return fs.realpathSync(target);
+	} catch {
+		return path.resolve(target);
+	}
+}
+
+export function assertInside(root: string, target: string, label: string): string {
+	const absRoot = realPath(root);
+	const absTarget = path.resolve(target);
+	if (!isInside(absRoot, absTarget)) {
+		throw new PathEscapeError(`cluaupp: ${label} escapes the project folder`);
+	}
+	return absTarget;
+}
+
+export function safeRelPath(rel: string): string | null {
+	const normalized = posixRel(rel).replace(/^\.\/+/, "");
+	if (!normalized || path.isAbsolute(normalized) || /^[a-zA-Z]:/.test(normalized)) {
+		return null;
+	}
+	const parts = normalized.split("/").filter((part) => part && part !== ".");
+	if (parts.length === 0 || parts.some((part) => part === ".." || part === ".git")) {
+		return null;
+	}
+	return parts.join("/");
+}
+
+export function safeProjectSubdir(value: string, fallback: string, label: string): string {
+	const cleaned = safeRelPath(value);
+	if (!cleaned || BLOCKED_DIRS.has(cleaned.split("/")[0] || "")) {
+		throw new PathEscapeError(`cluaupp: invalid ${label} ${JSON.stringify(value)}`);
+	}
+	return cleaned;
+}
+
+export function assertInitDest(dest: string): string {
+	const resolved = path.resolve(dest);
+	const root = path.parse(resolved).root;
+	if (resolved === root) {
+		throw new PathEscapeError("cluaupp: refused to init at the filesystem root");
+	}
+	const home = os.homedir();
+	if (home && path.resolve(home) === resolved) {
+		throw new PathEscapeError("cluaupp: refused to init in the home directory itself");
+	}
+	return resolved;
+}
+
+export function childEnv(): NodeJS.ProcessEnv {
+	const env: NodeJS.ProcessEnv = {};
+	for (const key of [
+		"PATH",
+		"Path",
+		"PATHEXT",
+		"SYSTEMROOT",
+		"SystemRoot",
+		"COMSPEC",
+		"ComSpec",
+		"HOME",
+		"USERPROFILE",
+		"TMP",
+		"TEMP",
+		"TMPDIR",
+		"LANG",
+		"LC_ALL",
+	]) {
+		if (process.env[key]) {
+			env[key] = process.env[key];
+		}
+	}
+	return env;
+}

package/templates/game/.clangd

@@ -1,14 +1,23 @@
 CompileFlags:
+  CompilationDatabase: .
   Add:
     - -xc++
     - -std=c++20
     - -ferror-limit=0
     - -Iinclude
     - -Isrc
+    - -I../../include
 
 Diagnostics:
   Suppress: '*'
 
+---
+If:
+  PathMatch: .*\.(cpp|cc|cxx|c|h|hpp|hh)$
+CompileFlags:
+  Add:
+    - -xc++
+
 ---
 If:
   PathMatch: (out|libs)/.*

package/templates/game/.vscode/c_cpp_properties.json

@@ -2,7 +2,7 @@
 	"configurations": [
 		{
 			"name": "Cluaupp",
-			"compilerPath": "C:/Program Files/LLVM/bin/clang++.exe",
+			"compilerPath": "clang++",
 			"cStandard": "c17",
 			"cppStandard": "c++20",
 			"intelliSenseMode": "windows-clang-x64",

package/templates/game/.vscode/extensions.json

@@ -1,6 +1,5 @@
-{
-	"recommendations": [
-		"ms-vscode.cpptools",
-		"kartzdev.cluaupp-intellisense"
-	]
-}
+{
+	"recommendations": [
+		"llvm-vs-code-extensions.vscode-clangd"
+	]
+}

package/templates/game/.vscode/settings.json

@@ -1,18 +1,19 @@
 {
-	"C_Cpp.intelliSenseEngine": "default",
+	"C_Cpp.intelliSenseEngine": "Disabled",
 	"C_Cpp.default.cppStandard": "c++20",
 	"C_Cpp.default.cStandard": "c17",
-	"C_Cpp.default.compilerPath": "C:/Program Files/LLVM/bin/clang++.exe",
+	"C_Cpp.default.compilerPath": "clang++",
 	"C_Cpp.default.intelliSenseMode": "windows-clang-x64",
 	"C_Cpp.default.includePath": [
 		"${workspaceFolder}/include",
 		"${workspaceFolder}/src"
 	],
-	"C_Cpp.default.browse.path": [
-		"${workspaceFolder}/include",
-		"${workspaceFolder}/src"
+	"clangd.enable": true,
+	"clangd.arguments": [
+		"--compile-commands-dir=${workspaceFolder}",
+		"--header-insertion=never",
+		"--query-driver=**/clang++*,**/clang++.exe,**/g++*,**/g++.exe"
 	],
-	"clangd.enable": false,
 	"files.associations": {
 		"*.hpp": "cpp",
 		"*.h": "cpp",

package/templates/game/cluaupp.config.json

@@ -1,6 +1,6 @@
 {
 	"rootDir": "src",
 	"outDir": "out",
-	"strict": true,
-	"architecture": true
+	"strict": false,
+	"architecture": false
 }

package/templates/game/compile_flags.txt

@@ -3,3 +3,4 @@
 -ferror-limit=0
 -Iinclude
 -Isrc
+-I../../include

package/templates/game/rokit.toml

@@ -0,0 +1,5 @@
+# This file lists tools managed by Rokit, a toolchain manager for Roblox projects.
+# https://github.com/rojo-rbx/rokit
+
+[tools]
+rojo = "rojo-rbx/rojo@7.7.0"

package/templates/game/src/client/init.client.cpp

@@ -1,3 +1,4 @@
+#pragma strict
 #include <cluaupp/roblox.hpp>
 
 void init() {

package/templates/game/src/server/leaderstats.server.cpp

@@ -1,3 +1,4 @@
+#pragma strict
 #include <cluaupp/roblox.hpp>
 
 void CreateLeaderstats(Player* player) {

package/src/api.js

@@ -1,57 +0,0 @@
-"use strict";
-
-const generated = require("./api.generated");
-
-const INSTANCE_TYPES = new Set(generated.INSTANCE_TYPES);
-const SERVICES = new Set(generated.SERVICES);
-const METHODS = new Set(generated.METHODS);
-const DATATYPES = new Set(generated.DATATYPES);
-
-const LUAU_TYPES = {
-	void: "()",
-	int: "number",
-	float: "number",
-	double: "number",
-	bool: "boolean",
-	string: "string",
-	auto: null,
-};
-
-function isInstanceType(name) {
-	return INSTANCE_TYPES.has(name);
-}
-
-function isService(name) {
-	return SERVICES.has(name);
-}
-
-function isMethod(name) {
-	return METHODS.has(name);
-}
-
-function isDatatype(name) {
-	return DATATYPES.has(name);
-}
-
-function luauType(name) {
-	if (!name) {
-		return null;
-	}
-	const cleaned = String(name).replace(/\*+$/, "").replace(/^const\s+/, "").replace(/^Enum::/, "Enum.");
-	if (cleaned in LUAU_TYPES) {
-		return LUAU_TYPES[cleaned];
-	}
-	return cleaned;
-}
-
-module.exports = {
-	INSTANCE_TYPES,
-	SERVICES,
-	METHODS,
-	DATATYPES,
-	isInstanceType,
-	isService,
-	isMethod,
-	isDatatype,
-	luauType,
-};