cluaupp 1.0.0 → 1.4.0

package/examples/game/src/ReplicatedStorage/Shared/Constants/Primitives/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ReplicatedStorage/Shared/Modules/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ReplicatedStorage/Shared/Net/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ReplicatedStorage/Shared/Services/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ReplicatedStorage/Shared/Types/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ReplicatedStorage/Shared/Utils/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ServerScriptService/Boot/DataBoot.server.clpp

@@ -0,0 +1,13 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/keep.clh>
+#include "../../ReplicatedStorage/Shared/Constants/Datas/TemplateData.clh"
+
+void init() {
+	PlayerTemplate playerData;
+	Keep.Server.Init(DataServiceOptions {
+		.Template = playerData,
+		.StoreName = "PlayerData",
+		.UseMock = true,
+	});
+}

package/examples/game/src/ServerScriptService/Components/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ServerScriptService/Configuration/ServerConfig.clp

@@ -0,0 +1,4 @@
+#pragma once
+
+const string STORE_NAME = "PlayerData";
+const bool USE_MOCK_IN_STUDIO = true;

package/examples/game/src/ServerScriptService/Handlers/Guard.server.clpp

@@ -0,0 +1,7 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/ward.clh>
+
+void init() {
+	Ward.Start();
+}

package/examples/game/src/ServerScriptService/Handlers/PlayerHandler.server.clpp

@@ -0,0 +1,23 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/keep.clh>
+
+void BindLeaderstats(Player player) {
+	Data data = Keep.Server.WaitFor(player);
+	if (player.FindFirstChild("leaderstats") != null) {
+		return;
+	}
+	Folder leaderstats = new Folder(player);
+	leaderstats.Name = "leaderstats";
+	IntValue coins = new IntValue(leaderstats);
+	coins.Name = "Coins";
+	coins.Value = data.Get(Keep.Server.Paths.Currencies.Coins);
+}
+
+void init() {
+	Players players = GetService<Players>();
+	for (Player player in players.GetPlayers()) {
+		BindLeaderstats(player);
+	}
+	players.PlayerAdded~>Connect(BindLeaderstats);
+}

package/examples/game/src/ServerScriptService/Services/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ServerStorage/Configuration/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/ServerStorage/Modules/.gitkeep

@@ -0,0 +1 @@
+

package/{templates/game/src/client/init.client.clpp → examples/game/src/StarterPlayer/StarterCharacterScripts/Character/CharacterReady.client.clpp}

@@ -2,5 +2,5 @@
 #include <clpp/roblox.clh>
 
 void init() {
-	post("Cluaupp client ok");
+	post("character local ready");
 }

package/examples/game/src/StarterPlayer/StarterCharacterScripts/Combat/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/StarterPlayer/StarterCharacterScripts/Movement/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/StarterPlayer/StarterPlayerScripts/Controllers/DataController.client.clpp

@@ -0,0 +1,7 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/keep.clh>
+
+void init() {
+	Keep.Client.Init();
+}

package/examples/game/src/StarterPlayer/StarterPlayerScripts/Input/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/src/StarterPlayer/StarterPlayerScripts/UI/.gitkeep

@@ -0,0 +1 @@
+

package/examples/game/wally.toml

@@ -4,8 +4,8 @@ version = "0.1.0"
 registry = "https://github.com/UpliftGames/wally-index"
 realm = "shared"
 
-# CluauppLibs already ships Janitor, Promise, Fusion, Iris, Cmdr, TopbarPlus,
-# Chrono, DataServiceV2, EzVisualz, StateMachine, Spring, Display, Module3D,
-# FormatNumber. Add Wally entries only for extra packages.
+# CluauppLibs already ships Sweep, Spark, Keep, Flare, Mint, Axiom, Roster,
+# Gleam, Bloom, Lens, Crest, Pin, Stage, Coil, Helm, Shift, Hive, Ember, Echo,
+# Guide, Trace, Promise, Net. Wally is only for extras.
 
 [dependencies]

package/generated/cli.js

@@ -65,6 +65,7 @@ program
             format: options.format === true,
             analyze: options.analyze === true,
             rojo: options.rojo,
+            strict: options.strict === true,
         });
     }
     catch (err) {
@@ -120,10 +121,15 @@ program
     .description("CL++ manifest (`clpp api manifest`)")
     .action(() => {
     try {
-        (0, runner_js_1.resolveClppBinary)();
+        const bin = (0, runner_js_1.resolveClppBinary)();
         const version = (0, runner_js_1.clppVersion)();
         if (version) {
-            console.log("clpp", version);
+            console.log(version, `(${bin})`);
+        }
+        for (const install of (0, runner_js_1.clppInstalls)()) {
+            if (!install.selected) {
+                console.log(`skipped ${install.bin} (${install.version || "unknown"})`);
+            }
         }
         console.log(JSON.stringify((0, runner_js_1.clppManifest)(), null, "\t"));
     }

package/generated/clpp/contract.js

@@ -1,5 +1,6 @@
 "use strict";
-/** Stable CL++ ↔ Cluaupp contract. Cluaupp invokes the `clpp` binary. */
+/** Stable CL++ ↔ Cluaupp contract (CL++ 0.3.2 / 0.3.3). Cluaupp invokes the `clpp` binary. */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLPP_INSTALL_HINT = void 0;
-exports.CLPP_INSTALL_HINT = "Install CL++ and put `clpp` on PATH: https://github.com/KartzRbx/CLPP (`cargo install --path .` then `clpp install`). Override with CLPP_PATH.";
+exports.CLPP_INSTALL_HINT = exports.MIN_CLPP_VERSION = void 0;
+exports.MIN_CLPP_VERSION = "0.3.2";
+exports.CLPP_INSTALL_HINT = "Install CL++ 0.3.2 or newer (clpp-setup.exe or `clpp setup`) and put `clpp` on PATH. 0.3.3 is the same JSON contract. Instances are class names (`Player player`, not `Player*`). Override with CLPP or CLPP_PATH.";

package/generated/clpp/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toLuauPath = exports.siblingHeader = exports.scriptKind = exports.isTaggedScript = exports.isSourceFile = exports.isImplFile = exports.isHeaderFile = exports.isEngineStub = exports.fileStem = exports.emitKind = exports.collectSources = exports.SOURCE_EXTS = exports.shouldSkipInit = exports.clppLuauToGame = exports.resolveClppBinary = exports.hasClpp = exports.clppVersion = exports.clppManifest = exports.compileViaClpp = exports.CLPP_INSTALL_HINT = void 0;
+exports.toLuauPath = exports.siblingHeader = exports.scriptKind = exports.isTaggedScript = exports.isSourceFile = exports.isImplFile = exports.isHeaderFile = exports.isEngineStub = exports.fileStem = exports.emitKind = exports.collectSources = exports.SOURCE_EXTS = exports.shouldSkipInit = exports.clppLuauToGame = exports.resolveClppBinary = exports.hasClpp = exports.clppVersion = exports.clppManifest = exports.compileViaClppAsync = exports.compileViaClpp = exports.MIN_CLPP_VERSION = exports.CLPP_INSTALL_HINT = void 0;
 var contract_js_1 = require("./contract.js");
 Object.defineProperty(exports, "CLPP_INSTALL_HINT", { enumerable: true, get: function () { return contract_js_1.CLPP_INSTALL_HINT; } });
+Object.defineProperty(exports, "MIN_CLPP_VERSION", { enumerable: true, get: function () { return contract_js_1.MIN_CLPP_VERSION; } });
 var runner_js_1 = require("./runner.js");
 Object.defineProperty(exports, "compileViaClpp", { enumerable: true, get: function () { return runner_js_1.compileViaClpp; } });
+Object.defineProperty(exports, "compileViaClppAsync", { enumerable: true, get: function () { return runner_js_1.compileViaClppAsync; } });
 Object.defineProperty(exports, "clppManifest", { enumerable: true, get: function () { return runner_js_1.clppManifest; } });
 Object.defineProperty(exports, "clppVersion", { enumerable: true, get: function () { return runner_js_1.clppVersion; } });
 Object.defineProperty(exports, "hasClpp", { enumerable: true, get: function () { return runner_js_1.hasClpp; } });

package/generated/clpp/paths.js

@@ -17,6 +17,7 @@ exports.siblingHeader = siblingHeader;
 exports.collectSources = collectSources;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const index_js_1 = require("../flare/index.js");
 exports.SOURCE_EXTS = [".clpp", ".clp", ".clh"];
 function isSourceFile(fileName) {
     return exports.SOURCE_EXTS.includes(node_path_1.default.extname(fileName).toLowerCase());
@@ -27,8 +28,6 @@ function isEngineStub(filePath) {
         normalized.includes("/include/clpp/") ||
         normalized.includes("/include/cluau/") ||
         normalized.includes("/stdlib/") ||
-        normalized.endsWith("/roblox.hpp") ||
-        normalized.endsWith("/roblox.h") ||
         normalized.endsWith("/roblox.clh"));
 }
 function isHeaderFile(fileName) {
@@ -113,7 +112,7 @@ function collectSources(dir, files = []) {
         if (entry.isDirectory()) {
             collectSources(full, files);
         }
-        else if (isSourceFile(entry.name)) {
+        else if (isSourceFile(entry.name) && !(0, index_js_1.isGeneratedHeader)(full)) {
             files.push(full);
         }
     }

package/generated/clpp/postprocess.js

@@ -13,10 +13,43 @@ function insertAfterHeader(luau, block) {
     const rest = luau.slice(insertAt).replace(/^\n*/, "\n");
     return `${luau.slice(0, insertAt)}\n${block}\n${rest}`;
 }
-function rewriteClppLibs(luau) {
-    return String(luau).replace(/require\(\s*ClppLibs\.([A-Za-z0-9_]+)\s*\)/g, (_all, name) => {
-        return (0, libs_js_1.requireCluauppLib)(name);
+const CLPP_LIB_FILE = {
+    Janitor: "Sweep",
+    Signal: "Spark",
+    MathUtils: "Axiom",
+    FormatNumber: "Mint",
+    Module3D: "Stage",
+    Twinkle: "Bloom",
+    EzVisualz: "Bloom",
+    Spring: "Coil",
+    Display: "Trace",
+    StickyBillboard: "Pin",
+    Icon: "Crest",
+    TopbarPlus: "Crest",
+    Cmdr: "Helm",
+    Chrono: "Echo",
+    Iris: "Lens",
+    Fusion: "Gleam",
+    StateMachine: "Shift",
+    VfxUtil: "Ember",
+    DataService: "Keep",
+    TutorialKit: "Guide",
+    TutorialServer: "Guide",
+};
+function rewriteClppLibs(luau, relativeName) {
+    let next = String(luau).replace(/require\(\s*ClppLibs\.([A-Za-z0-9_]+)\s*\)/g, (_all, name) => {
+        return (0, libs_js_1.requireCluauppLib)(CLPP_LIB_FILE[name] || name);
     });
+    next = next.replace(/CluauppLibs\.Janitor\b/g, "CluauppLibs.Sweep");
+    next = next.replace(/CluauppLibs\.Signal\b/g, "CluauppLibs.Spark");
+    next = next.replace(/:Add\(([^,\n()]+),\s*"Disconnect"\s*\)/g, ":Add($1)");
+    const tagged = relativeName ? (0, paths_js_1.isTaggedScript)(relativeName) : false;
+    const hasConnect = /:Connect\(/.test(next);
+    const hasSweep = /CluauppLibs\.Sweep/.test(next) || /\bjanitor\b/.test(next) || /\bsweep\b/.test(next);
+    if (tagged && hasConnect && !hasSweep) {
+        next = insertAfterHeader(next, "local sweep = require(ReplicatedStorage.CluauppLibs.Sweep).new()");
+    }
+    return next;
 }
 function ensureReplicatedStorage(luau) {
     if (!luau.includes("CluauppLibs")) {
@@ -39,11 +72,22 @@ function ensureStrict(luau, strict) {
     }
     return `--!strict\n${luau}`;
 }
+function normalizeLibraryName(name) {
+    const mapped = CLPP_LIB_FILE[name] || name;
+    if (libs_js_1.MODULES[mapped]) {
+        return mapped;
+    }
+    return null;
+}
 function librarySpecs(names) {
     const specs = [];
     const seen = new Set();
     for (const name of names || []) {
-        const spec = libs_js_1.MODULES[name];
+        const mapped = normalizeLibraryName(name);
+        if (!mapped) {
+            continue;
+        }
+        const spec = libs_js_1.MODULES[mapped];
         if (!spec || seen.has(spec.bind)) {
             continue;
         }
@@ -52,6 +96,20 @@ function librarySpecs(names) {
     }
     return specs;
 }
+function includedLibraryNames(artifact, source) {
+    const names = [];
+    for (const name of artifact.libraries || []) {
+        if (name === "*") {
+            names.push(...Object.keys(libs_js_1.MODULES));
+            continue;
+        }
+        names.push(name);
+    }
+    if (source) {
+        names.push(...(0, libs_js_1.libraryNamesFromIncludes)(source));
+    }
+    return names;
+}
 function missingLibraries(luau, names) {
     return librarySpecs(names).filter((spec) => {
         return !luau.includes(`CluauppLibs.${spec.file}`) && !new RegExp(`\\bconst ${spec.bind}\\b`).test(luau);
@@ -64,13 +122,13 @@ function shouldSkipInit(fileName, hasSiblingHeader) {
     return !(0, paths_js_1.isTaggedScript)(fileName);
 }
 function clppLuauToGame(artifact, options) {
-    let luau = rewriteClppLibs(artifact.luau || "");
+    let luau = rewriteClppLibs(artifact.luau || "", options.relativeName);
     luau = ensureReplicatedStorage(luau);
     if (options.skipInit) {
         luau = stripInitCall(luau);
     }
     luau = ensureStrict(luau, options.strict);
-    const missing = missingLibraries(luau, artifact.libraries);
+    const missing = missingLibraries(luau, includedLibraryNames(artifact, options.source));
     if (missing.length > 0) {
         luau = (0, libs_js_1.insertPreamble)(luau, [], missing, options.outName);
     }

package/generated/clpp/runner.js

@@ -1,27 +1,117 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasClpp = hasClpp;
 exports.resolveClppBinary = resolveClppBinary;
+exports.formatClppFailure = formatClppFailure;
 exports.compileViaClpp = compileViaClpp;
+exports.compileViaClppAsync = compileViaClppAsync;
 exports.clppManifest = clppManifest;
 exports.clppVersion = clppVersion;
+exports.clppInstalls = clppInstalls;
 const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 const contract_js_1 = require("./contract.js");
 const MISSING_CLPP = `cluaupp: clpp not found. ${contract_js_1.CLPP_INSTALL_HINT}`;
-function whichClpp() {
-    if (process.env.CLPP_PATH) {
-        return process.env.CLPP_PATH;
+let cachedBin;
+function parseSemver(text) {
+    const match = String(text).match(/(\d+)\.(\d+)\.(\d+)/);
+    if (!match) {
+        return null;
+    }
+    return { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) };
+}
+function cmpSemver(a, b) {
+    return a.major - b.major || a.minor - b.minor || a.patch - b.patch;
+}
+function minClpp() {
+    return parseSemver(contract_js_1.MIN_CLPP_VERSION) || { major: 0, minor: 3, patch: 2 };
+}
+function tooOldMessage(bin, version) {
+    return `cluaupp: clpp ${version || "unknown"} is too old (${bin}). Need CL++ ${contract_js_1.MIN_CLPP_VERSION}+. Install https://github.com/KartzRbx/CLPP/releases/download/v0.3.2/clpp-setup.exe or set CLPP / CLPP_PATH.`;
+}
+function probeVersion(bin) {
+    const result = (0, node_child_process_1.spawnSync)(bin, ["--version"], { encoding: "utf8", windowsHide: true });
+    if (result.status !== 0) {
+        return null;
+    }
+    return String(result.stdout || result.stderr || "").trim() || null;
+}
+function pushCandidate(out, seen, item) {
+    const value = String(item || "").trim();
+    if (!value) {
+        return;
+    }
+    const key = value.toLowerCase();
+    if (seen.has(key)) {
+        return;
+    }
+    seen.add(key);
+    out.push(value);
+}
+function existsBin(bin) {
+    try {
+        return node_fs_1.default.existsSync(bin);
     }
+    catch {
+        return false;
+    }
+}
+function listClppCandidates() {
+    const seen = new Set();
+    const override = [];
+    pushCandidate(override, seen, process.env.CLPP);
+    pushCandidate(override, seen, process.env.CLPP_PATH);
+    const overrideExisting = override.filter(existsBin);
+    if (overrideExisting.length > 0) {
+        return overrideExisting;
+    }
+    const out = [];
     const finder = process.platform === "win32" ? "where" : "which";
     const found = (0, node_child_process_1.spawnSync)(finder, ["clpp"], { encoding: "utf8", windowsHide: true });
-    if (found.status !== 0) {
+    if (found.status === 0) {
+        for (const line of String(found.stdout || "").split(/\r?\n/)) {
+            pushCandidate(out, seen, line);
+        }
+    }
+    if (process.platform === "win32") {
+        const local = process.env.LOCALAPPDATA || node_path_1.default.join(node_os_1.default.homedir(), "AppData", "Local");
+        pushCandidate(out, seen, node_path_1.default.join(local, "Programs", "CLPP", "clpp.exe"));
+    }
+    return out.filter(existsBin);
+}
+function pickClppBinary() {
+    const candidates = listClppCandidates();
+    if (candidates.length === 0) {
         return null;
     }
-    const line = String(found.stdout || "")
-        .split(/\r?\n/)
-        .map((item) => item.trim())
-        .find((item) => item.length > 0);
-    return line || "clpp";
+    let best = null;
+    let fallback = null;
+    for (const bin of candidates) {
+        const version = probeVersion(bin);
+        const parsed = parseSemver(version || "");
+        if (!fallback) {
+            fallback = bin;
+        }
+        if (!parsed) {
+            continue;
+        }
+        if (!best || cmpSemver(parsed, best.parsed) > 0) {
+            best = { bin, parsed };
+        }
+    }
+    return best?.bin || fallback;
+}
+function whichClpp() {
+    if (cachedBin !== undefined) {
+        return cachedBin;
+    }
+    cachedBin = pickClppBinary();
+    return cachedBin;
 }
 function hasClpp() {
     return Boolean(whichClpp());
@@ -31,6 +121,11 @@ function resolveClppBinary() {
     if (!bin) {
         throw new Error(MISSING_CLPP);
     }
+    const version = probeVersion(bin);
+    const parsed = parseSemver(version || "");
+    if (!parsed || cmpSemver(parsed, minClpp()) < 0) {
+        throw new Error(tooOldMessage(bin, version));
+    }
     return bin;
 }
 function parseArtifact(stdout, fileName, fallbackError) {
@@ -57,12 +152,24 @@ function parseArtifact(stdout, fileName, fallbackError) {
         error: fallbackError || "clpp returned invalid JSON",
     };
 }
+function formatClppFailure(artifact, fallback) {
+    const diags = Array.isArray(artifact.diagnostics) ? artifact.diagnostics : [];
+    if (diags.length > 0) {
+        return diags
+            .map((d) => {
+            const where = `${artifact.fileName || "clpp"}:${d.line}:${d.column}`;
+            return `${where}: ${d.message}`;
+        })
+            .join("\n");
+    }
+    return artifact.error || fallback;
+}
 function compileViaClpp(request) {
     const bin = resolveClppBinary();
     const payload = JSON.stringify({
         source: request.source,
         fileName: request.fileName,
-        strict: request.strict,
+        strict: request.strict ?? null,
     });
     const result = (0, node_child_process_1.spawnSync)(bin, ["api", "compile"], {
         input: payload,
@@ -74,10 +181,50 @@ function compileViaClpp(request) {
     const stderr = String(result.stderr || "").trim();
     const artifact = parseArtifact(result.stdout, request.fileName, stderr || result.error?.message || "clpp api compile failed");
     if (!artifact.ok) {
-        throw new Error(artifact.error || stderr || `clpp failed (${result.status})`);
+        throw new Error(formatClppFailure(artifact, stderr || result.error?.message || `clpp failed (${result.status})`));
     }
     return artifact;
 }
+function compileViaClppAsync(request) {
+    return new Promise((resolve, reject) => {
+        let bin;
+        try {
+            bin = resolveClppBinary();
+        }
+        catch (err) {
+            reject(err);
+            return;
+        }
+        const child = (0, node_child_process_1.spawn)(bin, ["api", "compile"], {
+            cwd: request.cwd,
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            const artifact = parseArtifact(stdout, request.fileName, stderr.trim() || `clpp api compile failed (${code})`);
+            if (!artifact.ok) {
+                reject(new Error(formatClppFailure(artifact, stderr.trim() || `clpp failed (${code})`)));
+                return;
+            }
+            resolve(artifact);
+        });
+        child.stdin.end(JSON.stringify({
+            source: request.source,
+            fileName: request.fileName,
+            strict: request.strict ?? null,
+        }));
+    });
+}
 function clppManifest() {
     const bin = resolveClppBinary();
     const result = (0, node_child_process_1.spawnSync)(bin, ["api", "manifest"], {
@@ -94,9 +241,13 @@ function clppVersion() {
     if (!bin) {
         return null;
     }
-    const result = (0, node_child_process_1.spawnSync)(bin, ["--version"], { encoding: "utf8", windowsHide: true });
-    if (result.status !== 0) {
-        return null;
-    }
-    return String(result.stdout || "").trim() || null;
+    return probeVersion(bin);
+}
+function clppInstalls() {
+    const selected = whichClpp();
+    return listClppCandidates().map((bin) => ({
+        bin,
+        version: probeVersion(bin),
+        selected: bin === selected,
+    }));
 }

package/generated/compile.js

@@ -5,25 +5,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compileSource = compileSource;
 exports.compileService = compileService;
+exports.compileServiceAsync = compileServiceAsync;
 const node_path_1 = __importDefault(require("node:path"));
 const runner_js_1 = require("./clpp/runner.js");
 const postprocess_js_1 = require("./clpp/postprocess.js");
 const paths_js_1 = require("./clpp/paths.js");
-function compileSource(source, fileName, options = {}) {
-    return compileService(source, fileName, options).files[0]?.contents ?? "";
-}
-function compileService(source, fileName, options = {}) {
+function compileArgs(source, fileName, options) {
     const relative = (options.relativeName || fileName || "input.clpp").replace(/\\/g, "/");
     const outName = options.outName || (0, paths_js_1.toLuauPath)(relative);
     const header = options.filePath ? (0, paths_js_1.siblingHeader)(options.filePath) : null;
     const skipInit = options.skipInit === true || (0, postprocess_js_1.shouldSkipInit)(relative, Boolean(header));
     const diskPath = options.filePath ? node_path_1.default.resolve(options.filePath) : null;
-    const artifact = (0, runner_js_1.compileViaClpp)({
-        source,
-        fileName: diskPath ? diskPath.replace(/\\/g, "/") : relative,
-        strict: options.strict,
-        cwd: diskPath ? node_path_1.default.dirname(diskPath) : options.srcDir,
-    });
+    return {
+        request: {
+            source,
+            fileName: diskPath ? diskPath.replace(/\\/g, "/") : relative,
+            strict: options.strict,
+            cwd: diskPath ? node_path_1.default.dirname(diskPath) : options.srcDir,
+        },
+        relative,
+        outName,
+        skipInit,
+        options,
+    };
+}
+function finishArtifact(artifact, relative, outName, options, skipInit, source) {
     const luau = (0, postprocess_js_1.clppLuauToGame)(artifact, {
         relativeName: relative,
         outName,
@@ -31,6 +37,7 @@ function compileService(source, fileName, options = {}) {
         rootDir: options.rootDir,
         strict: options.strict,
         skipInit,
+        source,
     });
     return {
         kind: (0, paths_js_1.emitKind)(relative),
@@ -39,3 +46,16 @@ function compileService(source, fileName, options = {}) {
         stale: [],
     };
 }
+function compileSource(source, fileName, options = {}) {
+    return compileService(source, fileName, options).files[0]?.contents ?? "";
+}
+function compileService(source, fileName, options = {}) {
+    const args = compileArgs(source, fileName, options);
+    const artifact = (0, runner_js_1.compileViaClpp)(args.request);
+    return finishArtifact(artifact, args.relative, args.outName, args.options, args.skipInit, source);
+}
+async function compileServiceAsync(source, fileName, options = {}) {
+    const args = compileArgs(source, fileName, options);
+    const artifact = await (0, runner_js_1.compileViaClppAsync)(args.request);
+    return finishArtifact(artifact, args.relative, args.outName, args.options, args.skipInit, source);
+}