cluaupp 0.2.3 → 1.0.0

package/src/architecture.ts

@@ -1,500 +0,0 @@
-// @ts-nocheck
-import path from "node:path";
-import { emit } from "./emit.js";
-import { requireCluauppLib } from "./libs.js";
-import { organizeDecls, janitorNames, emitSection, joinBlocks, SECTION, ENTRY_FN } from "./layout.js";
-import {
-	VALUE_CLASSES,
-	analyze,
-	toPascalServiceName,
-	legacyOutName,
-	modernScriptOutName,
-} from "./understand.js";
-import { implOutName } from "./preprocess.js";
-
-function header(plan) {
-	const lines = [];
-	if (plan && plan.strict) {
-		lines.push("--!strict");
-	}
-	lines.push("-- Compiled by Cluaupp — C++ × Luau");
-	if (plan && plan.reasoning) {
-		for (const line of plan.reasoning) {
-			lines.push(`-- ${line}`);
-		}
-	}
-	lines.push("");
-	return lines.join("\n");
-}
-
-function cluauppLib(name) {
-	return requireCluauppLib(name);
-}
-
-function emitTypes(plan) {
-	const lines = [header(plan).trimEnd(), ""];
-	lines.push('const ReplicatedStorage = game:GetService("ReplicatedStorage")');
-	lines.push(`const Occlude = ${cluauppLib("Occlude")}`);
-	lines.push(`const ArrayIndexer = ${cluauppLib("ArrayIndexer")}`);
-	lines.push("");
-
-	if (plan.stats.length > 0) {
-		const union = plan.stats.map((stat) => `"${stat.name}"`).join(" | ");
-		lines.push(`export type StatName = ${union}`);
-		lines.push("");
-		lines.push(`export type ${plan.serviceName}Data = {`);
-		for (const stat of plan.stats) {
-			lines.push(`	${stat.name}: ${stat.luau},`);
-		}
-		lines.push("}");
-		lines.push("");
-	}
-
-	if (plan.roles.cache) {
-		lines.push("export type PlayerCache = {");
-		lines.push("	Folder: Folder,");
-		for (const stat of plan.stats) {
-			lines.push(`	${stat.name}: ${stat.instance},`);
-		}
-		lines.push("}");
-		lines.push("");
-	}
-
-	const manifest = [];
-	if (plan.roles.cache) {
-		manifest.push("	CacheController: {");
-		manifest.push("		Get: (player: Player) -> PlayerCache?,");
-		manifest.push("		Ensure: (player: Player) -> PlayerCache,");
-		manifest.push("		Clear: (player: Player) -> (),");
-		manifest.push("		ClearAll: () -> (),");
-		manifest.push("	},");
-	}
-	if (plan.roles.players) {
-		manifest.push("	PlayersManager: {");
-		manifest.push("		Start: (onPlayer: (player: Player) -> (), onLeave: ((player: Player) -> ())?) -> (),");
-		manifest.push("		Stop: () -> (),");
-		manifest.push("	},");
-	}
-	if (plan.roles.domain) {
-		manifest.push(`	${plan.roles.domain}: {`);
-		manifest.push("		Start: () -> (),");
-		manifest.push("		Stop: () -> (),");
-		manifest.push("	},");
-	}
-	lines.push("export type ServiceManifest = {");
-	if (manifest.length === 0) {
-		lines.push("	Main: { Start: () -> (), Stop: () -> () },");
-	} else {
-		lines.push(...manifest);
-	}
-	lines.push("}");
-	lines.push("");
-	if (plan.roles.cache) {
-		lines.push('export type CacheService = ArrayIndexer.Table<ServiceManifest, "CacheController">');
-	} else if (plan.roles.domain) {
-		lines.push(`export type DomainService = ArrayIndexer.Table<ServiceManifest, "${plan.roles.domain}">`);
-	} else {
-		lines.push('export type MainService = ArrayIndexer.Table<ServiceManifest, "Main">');
-	}
-	if (plan.stats.length > 1) {
-		const hide = plan.stats[plan.stats.length - 1].name;
-		lines.push(`export type HudData = Occlude.Keys<${plan.serviceName}Data, "${hide}">`);
-	}
-	lines.push("");
-	lines.push("return {}");
-	lines.push("");
-	return lines.join("\n");
-}
-
-function emitPlayersManager(plan) {
-	return `${header(plan).trimEnd()}
-
-const Players = game:GetService("Players")
-const ReplicatedStorage = game:GetService("ReplicatedStorage")
-const Janitor = ${cluauppLib("Janitor")}
-
-type Janitor = Janitor.Janitor
-export type PlayerHandler = (player: Player) -> ()
-
-local PlayersManager = {}
-local lifetime: Janitor? = nil
-local leaveHandler: PlayerHandler? = nil
-
-function PlayersManager.Start(onPlayer: PlayerHandler, onLeave: PlayerHandler?)
-	PlayersManager.Stop()
-	local janitor = Janitor.new()
-	lifetime = janitor
-	leaveHandler = onLeave
-
-	const function accept(player: Player)
-		onPlayer(player)
-	end
-
-	for _, player in Players:GetPlayers() do
-		accept(player)
-	end
-
-	janitor:Add(Players.PlayerAdded:Connect(accept), "Disconnect", "PlayerAdded")
-	if onLeave then
-		janitor:Add(Players.PlayerRemoving:Connect(onLeave), "Disconnect", "PlayerRemoving")
-	end
-end
-
-function PlayersManager.Stop()
-	if lifetime == nil then
-		return
-	end
-	local onLeave = leaveHandler
-	leaveHandler = nil
-	if onLeave then
-		for _, player in Players:GetPlayers() do
-			onLeave(player)
-		end
-	end
-	lifetime:Cleanup()
-	lifetime = nil
-end
-
-return PlayersManager
-`;
-}
-
-function emitCacheController(plan) {
-	const types = plan.typesName;
-	const folder = plan.folderName || "leaderstats";
-	const lines = [header(plan).trimEnd(), ""];
-	lines.push(`const Types = require(script.Parent.${types})`);
-	lines.push("");
-	lines.push(`const FOLDER_NAME = "${folder}"`);
-	lines.push("");
-	lines.push("local cache: { [Player]: Types.PlayerCache } = {}");
-	lines.push("local CacheController = {}");
-	lines.push("");
-	lines.push("function CacheController.Get(player: Player): Types.PlayerCache?");
-	lines.push("	return cache[player]");
-	lines.push("end");
-	lines.push("");
-	lines.push("function CacheController.Ensure(player: Player): Types.PlayerCache");
-	lines.push("	local existing = cache[player]");
-	lines.push("	if existing then");
-	lines.push("		return existing");
-	lines.push("	end");
-	lines.push("");
-	lines.push("	local folderInstance = player:FindFirstChild(FOLDER_NAME)");
-	lines.push("	local folder: Folder");
-	lines.push('	if folderInstance and folderInstance:IsA("Folder") then');
-	lines.push("		folder = folderInstance");
-	lines.push("	else");
-	lines.push('		folder = Instance.new("Folder")');
-	lines.push("		folder.Name = FOLDER_NAME");
-	lines.push("		folder.Parent = player");
-	lines.push("	end");
-	lines.push("");
-	for (const stat of plan.stats) {
-		const ident = stat.name;
-		lines.push(`	local existing${ident} = folder:FindFirstChild("${stat.name}")`);
-		lines.push(`	local ${ident}: ${stat.instance}`);
-		lines.push(`	if existing${ident} and existing${ident}:IsA("${stat.instance}") then`);
-		lines.push(`		${ident} = existing${ident}`);
-		lines.push("	else");
-		lines.push(`		${ident} = Instance.new("${stat.instance}")`);
-		lines.push(`		${ident}.Name = "${stat.name}"`);
-		lines.push(`		${ident}.Value = ${stat.defaultValue}`);
-		lines.push(`		${ident}.Parent = folder`);
-		lines.push("	end");
-		lines.push("");
-	}
-	lines.push("	local record: Types.PlayerCache = {");
-	lines.push("		Folder = folder,");
-	for (const stat of plan.stats) {
-		lines.push(`		${stat.name} = ${stat.name},`);
-	}
-	lines.push("	}");
-	lines.push("	cache[player] = record");
-	lines.push("	return record");
-	lines.push("end");
-	lines.push("");
-	lines.push("function CacheController.Clear(player: Player)");
-	lines.push("	cache[player] = nil");
-	lines.push("end");
-	lines.push("");
-	lines.push("function CacheController.ClearAll()");
-	lines.push("	table.clear(cache)");
-	lines.push("end");
-	lines.push("");
-	lines.push("return CacheController");
-	lines.push("");
-	return lines.join("\n");
-}
-
-function emitMain(plan) {
-	const lines = [header(plan).trimEnd(), ""];
-	if (plan.roles.players) {
-		lines.push("const PlayersManager = require(script.Parent.PlayersManager)");
-	}
-	if (plan.roles.cache) {
-		lines.push("const CacheController = require(script.Parent.CacheController)");
-	}
-	if (plan.roles.domain) {
-		lines.push(`const ${plan.roles.domain} = require(script.Parent.${plan.roles.domain})`);
-	}
-	lines.push("");
-	lines.push("local Main = {}");
-	lines.push("");
-	lines.push("function Main.Start()");
-	if (plan.roles.players && plan.roles.cache) {
-		lines.push("	PlayersManager.Start(function(player: Player)");
-		lines.push("		CacheController.Ensure(player)");
-		lines.push("	end, function(player: Player)");
-		lines.push("		CacheController.Clear(player)");
-		lines.push("	end)");
-	} else if (plan.roles.players) {
-		lines.push("	PlayersManager.Start(function(_player: Player) end)");
-	}
-	if (plan.roles.domain) {
-		lines.push(`	${plan.roles.domain}.Start()`);
-	}
-	if (!plan.roles.players && !plan.roles.domain) {
-		lines.push("	return");
-	}
-	lines.push("end");
-	lines.push("");
-	lines.push("function Main.Stop()");
-	if (plan.roles.domain) {
-		lines.push(`	${plan.roles.domain}.Stop()`);
-	}
-	if (plan.roles.cache) {
-		lines.push("	CacheController.ClearAll()");
-	}
-	if (plan.roles.players) {
-		lines.push("	PlayersManager.Stop()");
-	}
-	if (!plan.roles.domain && !plan.roles.cache && !plan.roles.players) {
-		lines.push("	return");
-	}
-	lines.push("end");
-	lines.push("");
-	lines.push("return Main");
-	lines.push("");
-	return lines.join("\n");
-}
-
-function emitBootstrap(plan) {
-	return `${header(plan)}require(script.Main):Start()
-`;
-}
-
-function emitConfig(plan, ast, options) {
-	const owned = (ast.body || []).some((decl) => decl.owner);
-	if (owned) {
-		return `${header(plan).trimEnd()}\n\n${emit(ast, { ...options, skipHeader: true, skipInit: true }).trimEnd()}\n`;
-	}
-	const lines = [];
-	if (plan.onlyConsts) {
-		lines.push(header(plan).trimEnd());
-		lines.push("");
-		for (const item of plan.consts) {
-			lines.push(`const ${item.name}: ${item.luau} = ${item.value}`);
-		}
-	} else {
-		lines.push(header(plan).trimEnd());
-		lines.push("");
-		lines.push(emit(ast, { ...options, skipHeader: true, skipInit: true }).trimEnd());
-	}
-	lines.push("");
-	lines.push("return {");
-	for (const item of plan.consts) {
-		lines.push(`	${item.name} = ${item.name},`);
-	}
-	for (const decl of ast.body || []) {
-		if (decl.type === "function" && decl.name !== "init") {
-			lines.push(`	${decl.name} = ${decl.name},`);
-		}
-	}
-	if ((ast.body || []).some((decl) => decl.type === "function" && decl.name === "init")) {
-		lines.push("	Start = init,");
-		lines.push("	Init = init,");
-		lines.push("	init = init,");
-	}
-	lines.push("}");
-	lines.push("");
-	return lines.join("\n");
-}
-
-function emitDecls(decls, options) {
-	if (!decls || decls.length === 0) {
-		return "";
-	}
-	return emit({ type: "program", body: decls }, { ...options, skipHeader: true, skipInit: true }).trimEnd();
-}
-
-function emitDomainController(plan, ast, options) {
-	const keep = (ast.body || []).filter((decl) => {
-		return decl.type === "decl" || decl.type === "proto" || decl.type === "function" || decl.type === "expr";
-	});
-	const groups = organizeDecls(keep);
-	const name = plan.roles.domain;
-	const entry = keep.find((decl) => decl.type === "function" && ENTRY_FN.test(decl.name || ""));
-	const bootExprs = keep.filter((decl) => decl.type === "expr");
-	const janitors = janitorNames(keep);
-	const closer = keep.find((decl) => decl.type === "function" && /^(OnClose|Cleanup|Shutdown)$/i.test(decl.name));
-	const stopLines = [];
-	if (janitors.length > 0) {
-		for (const janitor of janitors) {
-			stopLines.push(`	${janitor}:Cleanup()`);
-		}
-	} else if (closer) {
-		stopLines.push(`	${closer.name}()`);
-	} else {
-		stopLines.push("	return");
-	}
-	const boot = entry
-		? `	${entry.name}()`
-		: bootExprs.length
-			? emitDecls(bootExprs, options)
-					.split("\n")
-					.map((line) => (line ? `\t${line}` : line))
-					.join("\n")
-			: "	return";
-	const startFn = `function ${name}.Start()\n	${name}.Stop()\n${boot}\nend`;
-	const stopFn = `function ${name}.Stop()\n${stopLines.join("\n")}\nend`;
-	const body = `${header(plan).trimEnd()}\n\n${emitSection(SECTION.api, emitDecls(groups.api, options))}${emitSection(SECTION.constants, emitDecls(groups.constants, options))}${emitSection(SECTION.variables, joinBlocks([emitDecls(groups.variables, options), `local ${name} = {}`]))}${emitSection(SECTION.support, emitDecls(groups.support, options))}${emitSection(SECTION.principal, joinBlocks([emitDecls(groups.principal, options), startFn]))}${emitSection(SECTION.cleanup, joinBlocks([emitDecls(groups.cleanup, options), stopFn]))}${emitSection(SECTION.returns, `return ${name}`)}`;
-	return body;
-}
-
-function emitModule(plan, ast, options) {
-	return emitConfig(plan, ast, options);
-}
-
-function emitScriptMeta(runContext) {
-	return `${JSON.stringify(
-		{
-			properties: {
-				RunContext: `Enum.RunContext.${runContext}`,
-			},
-		},
-		null,
-		"\t",
-	)}\n`;
-}
-
-function serviceBootName(plan) {
-	if (plan.isClient) {
-		return "init.client.luau";
-	}
-	return "init.server.luau";
-}
-
-function serviceFiles(plan, ast, options, dir) {
-	const folder = `${dir}/${plan.serviceName}`;
-	const boot = serviceBootName(plan);
-	const files = [{ name: `${folder}/${boot}`, contents: emitBootstrap(plan) }];
-	if (!plan.isClient && plan.runContext) {
-		files.push({ name: `${folder}/init.meta.json`, contents: emitScriptMeta(plan.runContext) });
-	}
-	files.push({ name: `${folder}/Main.luau`, contents: emitMain(plan) });
-	if (plan.roles.players) {
-		files.push({ name: `${folder}/PlayersManager.luau`, contents: emitPlayersManager(plan) });
-	}
-	if (plan.roles.cache) {
-		files.push({ name: `${folder}/CacheController.luau`, contents: emitCacheController(plan) });
-	}
-	if (plan.roles.domain) {
-		files.push({ name: `${folder}/${plan.roles.domain}.luau`, contents: emitDomainController(plan, ast, options) });
-	}
-	files.push({ name: `${folder}/${plan.typesName}.luau`, contents: emitTypes(plan) });
-	return files;
-}
-
-function serviceFolderStale(plan, rel) {
-	const dir = path.posix.dirname(rel).replace(/^\.$/, "");
-	const serviceDir = dir && dir !== "." ? dir : plan.isClient ? "client" : "server";
-	const folder = `${serviceDir}/${plan.serviceName}`;
-	return [
-		folder,
-		`${folder}/init.luau`,
-		`${folder}/init.server.luau`,
-		`${folder}/init.client.luau`,
-		`${folder}/init.meta.json`,
-		`${folder}/Main.luau`,
-		`${folder}/PlayersManager.luau`,
-		`${folder}/CacheController.luau`,
-		`${folder}/${plan.typesName}.luau`,
-		plan.roles && plan.roles.domain ? `${folder}/${plan.roles.domain}.luau` : null,
-	].filter(Boolean);
-}
-
-function planOutput(ast, fileName, options = {}) {
-	const plan = analyze(ast, fileName);
-	plan.strict = options.strict === true;
-	const rel = (options.relativeName || fileName).replace(/\\/g, "/");
-	const dir = path.dirname(rel).replace(/^\.$/, "");
-	const outDir = dir && dir !== "." ? dir : "";
-	const prefix = outDir ? `${outDir}/` : "";
-	const stale = serviceFolderStale(plan, rel);
-
-	if (options.siblingHeader) {
-		return {
-			kind: "module",
-			plan,
-			files: [{ name: implOutName(rel), contents: emitModule(plan, ast, { ...options, skipInit: true }) }],
-			stale: [],
-		};
-	}
-
-	if (options.architecture === true) {
-		if (plan.kind === "legacy") {
-			return { kind: "legacy", plan, files: null, stale: [], outName: legacyOutName(rel) };
-		}
-
-		if (plan.kind === "service") {
-			const serviceDir = outDir || (plan.isClient ? "client" : "server");
-			const folder = `${serviceDir}/${plan.serviceName}`;
-			const serviceStale = plan.isClient
-				? [`${folder}/init.luau`, `${folder}/init.server.luau`, `${folder}/init.meta.json`]
-				: [`${folder}/init.luau`, `${folder}/init.client.luau`];
-			return {
-				kind: "service",
-				plan,
-				files: serviceFiles(plan, ast, options, serviceDir),
-				stale: serviceStale,
-			};
-		}
-
-		if (plan.kind === "config" || plan.kind === "module") {
-			return {
-				kind: plan.kind,
-				plan,
-				files: [{ name: `${prefix}${plan.serviceName}.luau`, contents: emitModule(plan, ast, options) }],
-				stale: [rel.replace(/\.(cpp|cc|cxx|c|h|hpp|hh)$/i, ".luau")],
-			};
-		}
-
-		return { kind: "flat", plan, files: null, stale: [], outName: modernScriptOutName(rel) };
-	}
-
-	if (plan.kind === "legacy") {
-		return { kind: "legacy", plan, files: null, stale, outName: legacyOutName(rel) };
-	}
-
-	if (plan.kind === "config" || plan.kind === "module") {
-		return {
-			kind: plan.kind,
-			plan,
-			files: [{ name: `${prefix}${plan.serviceName}.luau`, contents: emitModule(plan, ast, options) }],
-			stale: [rel.replace(/\.(cpp|cc|cxx|c|h|hpp|hh)$/i, ".luau"), ...stale],
-		};
-	}
-
-	const outName = modernScriptOutName(rel);
-	const stripped = rel.replace(/\.(server|client|plugin)\.(cpp|cc|cxx|c|h|hpp|hh)$/i, ".luau");
-	const extraStale = stripped !== outName ? [stripped] : [];
-	return { kind: "flat", plan, files: null, stale: [...stale, ...extraStale], outName };
-}
-
-export {
-	analyze,
-	planOutput,
-	toPascalServiceName,
-	VALUE_CLASSES,
-};

package/src/ast.ts

@@ -1,37 +0,0 @@
-import type { CompileOptions } from "./types.js";
-
-export type Token = {
-	type: string;
-	value: string;
-	line: number;
-	col: number;
-	start: number;
-	end: number;
-};
-
-export type AstNode = {
-	type: string;
-	[key: string]: any;
-};
-
-export type AstProgram = {
-	type: string;
-	body: AstNode[];
-	fileName: string;
-};
-
-export type ModuleInclude = {
-	name: string;
-	outRel: string;
-	header?: string;
-	impl?: string | null;
-	exports?: { consts?: string[]; structs?: string[]; hasProtos?: boolean };
-};
-
-export type PreprocessOptions = CompileOptions & {
-	pragmaResolved?: boolean;
-	seen?: Set<string>;
-	moduleIncludes?: ModuleInclude[];
-	siblingHeader?: string | null;
-	source?: string;
-};