cluaupp 0.2.3 → 1.3.0

package/docs/examples/hud.md

@@ -1,96 +0,0 @@
----
-title: HUD
-sidebar_position: 6
----
-
-# HUD
-
-Client-only: wait for the replicated profile, write labels, listen for currency changes. No `Set` on persisted paths from the client.
-
-Put a ScreenGui named `Hud` in StarterGui with `MoneyLabel` and `LevelLabel` (`TextLabel`).
-
-Define callbacks **above** `init()` or use lambdas in `Connect`.
-
-## `HudClient.client.cpp`
-
-```cpp
-#include <cluaupp/roblox.hpp>
-#include <cluaupp/libs/janitor.hpp>
-#include <cluaupp/libs/dataservice.hpp>
-#include <cluaupp/libs/formatnumber.hpp>
-#include <cluaupp/libs/twinkle.hpp>
-
-Players* Players = GetService<Players>();
-Janitor* janitor = new Janitor();
-
-TextLabel* FindLabel(PlayerGui* playerGui, string name) {
-	if (playerGui == nullptr) {
-		return nullptr;
-	}
-	Instance* gui = playerGui->FindFirstChild("Hud");
-	if (gui == nullptr) {
-		return nullptr;
-	}
-	return gui->FindFirstChild(name);
-}
-
-void Render(Data* data, TextLabel* moneyLabel, TextLabel* levelLabel) {
-	if (data == nullptr) {
-		return;
-	}
-	int money = data->Get(DataService::Client.Paths.Currencies.Money);
-	int level = data->Get(DataService::Client.Paths.Currencies.Level);
-	if (moneyLabel != nullptr) {
-		moneyLabel->Text = FormatNumber::Abbreviate(money);
-	}
-	if (levelLabel != nullptr) {
-		levelLabel->Text = FormatNumber::Comma(level);
-	}
-}
-
-void OnCurrenciesChanged() {
-	Player* player = Players->LocalPlayer;
-	if (player == nullptr) {
-		return;
-	}
-	PlayerGui* playerGui = player->FindFirstChildOfClass("PlayerGui");
-	TextLabel* moneyLabel = FindLabel(playerGui, "MoneyLabel");
-	TextLabel* levelLabel = FindLabel(playerGui, "LevelLabel");
-	Render(DataService::Client.Get(), moneyLabel, levelLabel);
-}
-
-void init() {
-	Player* player = Players->LocalPlayer;
-	if (player == nullptr) {
-		return;
-	}
-	PlayerGui* playerGui = player->FindFirstChildOfClass("PlayerGui");
-	if (playerGui == nullptr) {
-		return;
-	}
-
-	Data* data = DataService::Client.WaitForData();
-	if (data == nullptr) {
-		cout::warn << "HUD: profile missing" << endl;
-		return;
-	}
-
-	TextLabel* moneyLabel = FindLabel(playerGui, "MoneyLabel");
-	TextLabel* levelLabel = FindLabel(playerGui, "LevelLabel");
-	Render(data, moneyLabel, levelLabel);
-
-	if (moneyLabel != nullptr) {
-		Twinkle::Fade(moneyLabel, true);
-	}
-
-	janitor->Add(data->GetChangedSignal(DataService::Client.Paths.Currencies).Connect(OnCurrenciesChanged));
-}
-```
-
-## Rules
-
-- Call `DataService::Client.Init()` in [Data boot](data-boot.md) first. Script order in StarterPlayerScripts is not a contract — `WaitForData` yields until the profile exists.
-- Do not `data->Set` Money from the HUD. Display only.
-- `Twinkle::Fade` is optional. See [more libraries](../libraries/more.md).
-
-`HudClient.client.cpp` is a LocalScript (`init.client.luau`).

package/docs/examples/index.md

@@ -1,45 +0,0 @@
----
-title: Examples
-sidebar_position: 1
----
-
-# Examples
-
-High-quality Cluaupp systems you can copy. Each page is a full service: C++ that the subset actually compiles, server authority, Janitor cleanup, and the file names Studio expects.
-
-In this repo the live sample is [`examples/game`](../../examples/game) (`src/server`, `src/client`, `src/shared`). Compiler TypeScript is never mixed with game C++. `cluaupp init` still copies [`templates/game`](../../templates/game).
-
-These are **not** dumps of `int main()`. Entry is `void init()`. Types are `struct` + `Class::` methods. Callbacks may be named functions or lambdas. Canonical Leaderstats: [handbook](https://kartzrbx.github.io/Cluaupp/docs/leaderstats.html).
-
-## Suggested layout
-
-```
-src/
-  shared/constants/TemplateData.hpp
-  shared/constants/CombatConfig.hpp
-  shared/constants/ShopCatalog.hpp
-  server/boot/DataBoot.server.cpp
-  client/boot/DataBoot.client.cpp
-  server/services/leaderstats/LeaderstatsServer.server.cpp
-  server/services/combat/CombatServer.server.cpp
-  client/controllers/combat/CombatClient.client.cpp
-  server/services/shop/ShopServer.server.cpp
-  client/controllers/shop/ShopClient.client.cpp
-  client/controllers/hud/HudClient.client.cpp
-  server/services/weapons/SwordServer.server.cpp
-```
-
-Boot DataService **once**. Other services `WaitFor` after that.
-
-## Catalog
-
-| Example | Teaches |
-| --- | --- |
-| [Data boot](data-boot.md) | `Server.Init` / `Client.Init`, your Template, not `main()` |
-| [Leaderstats](leaderstats.md) | Folder `leaderstats`, FormatNumber, `GetChangedSignal`, per-player Janitor |
-| [Combat (server validation)](combat.md) | Client sends **intent**; server checks range, cooldown, health, then `TakeDamage` |
-| [Shop](shop.md) | `Net` buy remote, prices on the server, DataService debit |
-| [HUD](hud.md) | Client `WaitForData`, labels, Twinkle |
-| [Sword / Touched](sword.md) | Hitbox on the **server**, debounce, no client damage |
-
-Read with [Libraries](../libraries/index.md), [OOP structure](../oop/index.md), and [Safety](../cpp-safety.md).

package/docs/examples/leaderstats.md

@@ -1,69 +0,0 @@
----
-title: Leaderstats
-sidebar_position: 3
----
-
-# Leaderstats
-
-Canonical copy (three files): [Docs → Example: Leaderstats](https://kartzrbx.github.io/Cluaupp/docs/leaderstats.html).
-
-Roblox shows the player list from a Folder named exactly `leaderstats` under the Player. This service **creates** those values, then mirrors DataService coins into them.
-
-It does **not** call `DataService.Init`. Boot that in [Data boot](data-boot.md) with your `PlayerData` Template.
-
-## Files
-
-| File | Role |
-| --- | --- |
-| `shared/PlayerData.h` | Template structs (`Currencies.Coins`, inventory `LuaArray`) |
-| `server/LeaderstatsServer.h` | `struct LeaderstatsServer` — fields + method decls (same stem) |
-| `server/LeaderstatsServer.server.cpp` | `Class::` bodies + `void init()` |
-
-## Rules
-
-| Rule | Why |
-| --- | --- |
-| Same-stem header | `LeaderstatsServer.h` + `LeaderstatsServer.server.cpp`. A differently named `leaderstats.h` is a `require`. |
-| `.server.cpp` | Untagged cpp is a ModuleScript; `init()` will not run by itself. |
-| `Paths.Currencies.Coins` | After `Init`. A local `int Coins` is not a Data path. |
-| `string_concat` or string `+` | Luau `..`. Do not write `..` in the `.cpp`. |
-| Janitor keyed by player name | Leaving the game must `Destroy` the folder. |
-| Lambda or named function | `GetChangedSignal(...).Connect([coinsValue](int n) { ... })` is valid. |
-
-## Header
-
-```cpp
-#pragma once
-#include <cluaupp/roblox.hpp>
-#include <cluaupp/libs/janitor.hpp>
-#include <cluaupp/libs/dataservice.hpp>
-
-struct LeaderstatsServer {
-	static constexpr int STARTING_COINS = 0;
-	Janitor* janitor;
-	string GetPlayerJanitorKey(Player* player);
-	void UpdateLeaderstatsWithValues(IntValue* currentValue, int newValue);
-	Folder* EnsurePlayerLeaderstatsFolder(Player* player);
-	void PlayerEntered(Player* player);
-};
-```
-
-## `PlayerEntered`
-
-```cpp
-void LeaderstatsServer::PlayerEntered(Player* player) {
-	Folder* leaderstatsFolder = EnsurePlayerLeaderstatsFolder(player);
-	Data* playerData = DataService::Server.WaitFor(player);
-	IntValue* coinsValue = static_cast<IntValue*>(leaderstatsFolder->FindFirstChild("Coins"));
-	if (coinsValue) {
-		playerData->GetChangedSignal(DataService::Server.Paths.Currencies.Coins).Connect(
-			[coinsValue](int newValue) {
-				UpdateLeaderstatsWithValues(coinsValue, newValue);
-			}
-		);
-	}
-	janitor->Add(leaderstatsFolder, "Destroy", GetPlayerJanitorKey(player));
-}
-```
-
-`init()` constructs `LeaderstatsServer`, assigns `janitor = new Janitor()`, runs `PlayerEntered` for everyone already in the game, then `PlayerAdded` + `BindToClose`. Full listing is on the [handbook page](https://kartzrbx.github.io/Cluaupp/docs/leaderstats.html).

package/docs/examples/shop.md

@@ -1,122 +0,0 @@
----
-title: Shop
-sidebar_position: 5
----
-
-# Shop
-
-The client sends **which product**. The server looks up the price, checks Money, then `Set`. Never let the client send the new balance or the price.
-
-## Catalog header
-
-`src/shared/constants/ShopCatalog.hpp`
-
-Cluaupp has no maps. A function with early returns is the catalog.
-
-```cpp
-#pragma once
-
-const int PRODUCT_HEALTH_PACK = 1;
-const int PRODUCT_SPEED_TOME = 2;
-
-int PriceOf(int productId) {
-	if (productId == PRODUCT_HEALTH_PACK) {
-		return 50;
-	}
-	if (productId == PRODUCT_SPEED_TOME) {
-		return 200;
-	}
-	return 0;
-}
-```
-
-`PriceOf` lives in a header so the **server** is the copy that matters. The client may include it for UI labels, but a patched client cannot change what the server charges.
-
-## Server — `ShopServer.server.cpp`
-
-```cpp
-#include <cluaupp/roblox.hpp>
-#include <cluaupp/libs/janitor.hpp>
-#include <cluaupp/libs/net.hpp>
-#include <cluaupp/libs/dataservice.hpp>
-#include "../../../shared/constants/ShopCatalog.hpp"
-
-Janitor* janitor = new Janitor();
-NetEvent* Buy = Net::Event("Buy");
-
-void ApplyProduct(Player* player, int productId) {
-	Model* character = player->Character;
-	if (character == nullptr) {
-		return;
-	}
-	Humanoid* humanoid = character->FindFirstChildOfClass("Humanoid");
-	if (humanoid == nullptr) {
-		return;
-	}
-	if (productId == PRODUCT_HEALTH_PACK) {
-		humanoid->Health = humanoid->MaxHealth;
-		return;
-	}
-	if (productId == PRODUCT_SPEED_TOME) {
-		humanoid->WalkSpeed = 24;
-		return;
-	}
-}
-
-void OnBuy(Player* player, int productId) {
-	int price = PriceOf(productId);
-	if (price < 1) {
-		cout::warn << "unknown product " << productId << endl;
-		return;
-	}
-	Data* data = DataService::Server.WaitFor(player);
-	if (data == nullptr) {
-		return;
-	}
-	int money = data->Get(DataService::Server.Paths.Currencies.Money);
-	if (money < price) {
-		cout::ping << player->Name << " cannot afford " << productId << endl;
-		return;
-	}
-	data->Set(DataService::Server.Paths.Currencies.Money, money - price);
-	ApplyProduct(player, productId);
-}
-
-void init() {
-	Buy->On(OnBuy);
-	janitor->Add(Buy);
-}
-```
-
-Debit **before** (or atomically with) the effect. If you grant the item first and the `Set` fails, the player dupes.
-
-## Client — `ShopClient.client.cpp`
-
-```cpp
-#include <cluaupp/roblox.hpp>
-#include <cluaupp/libs/janitor.hpp>
-#include <cluaupp/libs/net.hpp>
-#include "../../../shared/constants/ShopCatalog.hpp"
-
-Janitor* janitor = new Janitor();
-NetEvent* Buy = Net::Event("Buy");
-
-void OnHealthPackClicked() {
-	Buy->FireServer(PRODUCT_HEALTH_PACK);
-}
-
-void init() {
-	return;
-}
-```
-
-Wire `OnHealthPackClicked` to a `TextButton->MouseButton1Click.Connect(OnHealthPackClicked)` when you have the GUI. The remote payload is only the product id.
-
-## Rules
-
-- `productId < 1` / unknown id → `PriceOf` returns `0` → reject.
-- Do not `FireServer(price)` or `FireServer(newMoney)`.
-- [Leaderstats](leaderstats.md) updates from `GetChangedSignal` after `Set`.
-- Same Net name `"Buy"` on both sides.
-
-See [Safety](../cpp-safety.md).

package/docs/examples/sword.md

@@ -1,108 +0,0 @@
----
-title: Sword (Touched)
-sidebar_position: 7
----
-
-# Sword (Touched)
-
-Melee that uses a **server** `Touched` on the tool handle. The client can play animations; it must not tell the server how much damage to apply.
-
-Same authority as [combat](combat.md), without a Net remote: while the Tool is equipped, `Touched` runs on the server.
-
-## Config
-
-`src/shared/constants/SwordConfig.hpp`
-
-```cpp
-#pragma once
-
-const double SWORD_COOLDOWN = 0.35;
-const int SWORD_DAMAGE = 18;
-```
-
-## Script inside the Tool
-
-Put the source next to the Tool so `script->Parent` is the `Tool`. Use **`.legacy.server.cpp`** so Cluaupp emits a 1:1 Script (no Main/Controller split) that Rojo can parent under `ClassicSword`.
-
-`src/server/tools/Sword.legacy.server.cpp`
-
-```cpp
-#include <cluaupp/roblox.hpp>
-#include "../../shared/constants/SwordConfig.hpp"
-
-Players* Players = GetService<Players>();
-Tool* tool = script->Parent;
-
-void OnTouched(Instance* hit) {
-	if (hit == nullptr) {
-		return;
-	}
-
-	Player* attacker = Players->GetPlayerFromCharacter(tool->Parent);
-	if (attacker == nullptr) {
-		return;
-	}
-
-	NumberValue* last = attacker->FindFirstChild("LastSwordAt");
-	if (last != nullptr) {
-		if (tick() - last->Value < SWORD_COOLDOWN) {
-			return;
-		}
-	}
-
-	Instance* model = hit->FindFirstAncestorOfClass("Model");
-	if (model == nullptr) {
-		return;
-	}
-	Player* victim = Players->GetPlayerFromCharacter(model);
-	if (victim == nullptr) {
-		return;
-	}
-	if (victim == attacker) {
-		return;
-	}
-
-	Humanoid* humanoid = model->FindFirstChildOfClass("Humanoid");
-	if (humanoid == nullptr) {
-		return;
-	}
-	if (humanoid->Health <= 0) {
-		return;
-	}
-
-	if (last == nullptr) {
-		last = new NumberValue(attacker);
-		last->Name = "LastSwordAt";
-	}
-	last->Value = tick();
-	humanoid->TakeDamage(SWORD_DAMAGE);
-}
-
-void init() {
-	BasePart* handle = tool->FindFirstChild("Handle");
-	if (handle == nullptr) {
-		cout::warn << "ClassicSword missing Handle" << endl;
-		return;
-	}
-	handle->Touched.Connect(OnTouched);
-}
-```
-
-`tool->Parent` is the Character while equipped, `nil` in the backpack — `GetPlayerFromCharacter` then fails and the swing is ignored. That is what you want.
-
-## Why `.legacy`
-
-A tagged `Sword.server.cpp` in `src/server/` becomes a service folder in ServerScriptService. A Tool Script must live **under the Tool**. Legacy keeps one file you can Rojo-map into `ClassicSword`.
-
-## Rules
-
-| Do | Do not |
-| --- | --- |
-| `TakeDamage(SWORD_DAMAGE)` on the server | `FireServer(damage)` from a LocalScript |
-| Skip `victim == attacker` | Damage the owner when the handle clips their own parts |
-| Cooldown on the attacker | Trust `Touched` rate (it fires every physics step) |
-| `GetPlayerFromCharacter` | Treat every Humanoid as a player if you only want PvP |
-
-Client: a LocalScript in the same Tool can play an AnimationTrack on `Activated`. It still must not replicate a damage number.
-
-For ranged hits (mouse target → remote), use [combat](combat.md).

package/docs/getting-started.md

@@ -1,179 +0,0 @@
-# Getting started
-
-Cluaupp installs from **npm**, the same channel as roblox-ts and most Roblox tooling outside Studio.
-
-## Requirements
-
-- [Node.js](https://nodejs.org/) 18 or newer
-- [Rojo](https://rojo.space/) **7.7.0** to sync `out/` into Studio (`cluaupp init` writes `rokit.toml`; run `rokit install`)
-- LLVM clangd for C++ IntelliSense (Cursor / VS Code — installed by `cluaupp init`)
-
-## Install the compiler
-
-Global (`cluaupp` on your PATH):
-
-```bash
-npm install -g cluaupp
-cluaupp --version
-```
-
-Without a global install, via `npx`:
-
-```bash
-npx cluaupp init my-game
-```
-
-As a game dependency:
-
-```bash
-npm install --save-dev cluaupp
-```
-
-```json
-{
-	"scripts": {
-		"build": "cluaupp build",
-		"watch": "cluaupp watch"
-	}
-}
-```
-
-## First game
-
-```bash
-cluaupp init my-game
-cd my-game
-rokit install
-cluaupp build
-rojo serve
-```
-
-In Roblox Studio: install the Rojo plugin and connect to `localhost:34872` (default port).
-
-Generated layout:
-
-```
-my-game/
-  cluaupp.config.json
-  default.project.json    ← Rojo
-  include/cluaupp/roblox.hpp
-  include/cluaupp/libs/
-  libs/                   ← CluauppLibs (Janitor, Fusion, Cmdr, DataService, …)
-  Packages/               ← optional extra Wally
-  wally.toml
-  src/
-    server/leaderstats.server.cpp
-    client/init.client.cpp
-    shared/config.h
-    shared/config.cpp
-  out/                    ← generated Luau (do not edit)
-    server/leaderstats.server.luau
-    client/init.client.luau
-    shared/Config.luau
-```
-
-## Datatypes (Vector3, CFrame, UDim2)
-
-```cpp
-#include <cluaupp/roblox.hpp>
-
-void init() {
-	auto* part = new Part(workspace);
-	part->Size = Vector3(8, 1, 8);
-	part->Position = Vector3(0, 10, 0);
-	part->CFrame = CFrame::lookAt(Vector3(0, 10, 0), Vector3(0, 10, -10));
-	part->Color = Color3::fromRGB(255, 0, 0);
-	part->Material = Enum::Material::Plastic;
-
-	auto* frame = new Frame();
-	frame->Size = UDim2::fromScale(1, 1);
-	frame->Position = UDim2(0, 0, 0.5, 0);
-}
-```
-
-This becomes `Vector3.new`, `CFrame.lookAt`, `Color3.fromRGB`, `UDim2.fromScale`, `Enum.Material.Plastic`.
-
-How to spell engine calls: [Roblox in Cluaupp](https://kartzrbx.github.io/Cluaupp/docs/engine.html). Official members: [create.roblox.com](https://create.roblox.com/docs/reference/engine). The complete subset: [Language reference](https://kartzrbx.github.io/Cluaupp/docs/reference.html).
-
-## How to write
-
-Every `.cpp` / `.h` / `.hpp` file can start with the IntelliSense header. Angle-bracket includes are ignored. Quoted `#include "config.h"` is inlined into the file.
-
-```cpp
-#include <cluaupp/roblox.hpp>
-
-void CreateLeaderstats(Player* player) {
-	if (player->FindFirstChild("leaderstats") != nullptr) {
-		return;
-	}
-
-	auto* leaderstats = new Folder(player);
-	leaderstats->Name = "leaderstats";
-}
-
-void init() {
-	auto* players = GetService<Players>();
-	for (auto* player : players->GetPlayers()) {
-		CreateLeaderstats(player);
-	}
-	players->PlayerAdded.Connect(CreateLeaderstats);
-}
-```
-
-If a file defines `void init()`, Cluaupp calls `init()` at the end of the `.luau`. Use that in Scripts and LocalScripts.
-
-## IntelliSense
-
-`cluaupp init` writes clangd config and installs LLVM `clang++` plus the clangd editor extension when missing. Then reload the window. Completion is clangd; Cluaupp does not index C++ itself.
-
-```bash
-cluaupp intellisense
-```
-
-`#include <cluaupp/roblox.hpp>` at the top of each source file. The header is **not** compiled to Luau. clangd learns that path from `-Iinclude` in `.clangd`, `compile_flags.txt`, and `compile_commands.json`.
-
-See [IntelliSense](intellisense.md).
-
-## Watch
-
-```bash
-cluaupp watch
-```
-
-Saving a `.cpp`, `.h`, or `.hpp` under `src/` rebuilds the project. Keep Rojo running at the same time.
-
-## Libraries
-
-`cluaupp build` copies runtime modules to `libs/` (Rojo: `ReplicatedStorage.CluauppLibs`). Include a header and the compiler injects `require`.
-
-```cpp
-#include <cluaupp/libs/janitor.hpp>
-#include <cluaupp/libs/net.hpp>
-
-void init() {
-	auto* janitor = new Janitor();
-	auto* coins = Net::Event("Coins");
-	janitor->Add(coins);
-}
-```
-
-Wally is optional. Fusion, Cmdr, DataServiceV2, and the rest ship **inside** `libs/` (full GitHub source). See [Libraries](libraries/index.md) — start with [DataService Init](libraries/dataservice.md) and [Janitor](libraries/janitor.md).
-
-See [Libraries](libraries/index.md), [OOP](oop/index.md), [types](cpp-types.md), [safety](cpp-safety.md).
-
-## Next
-
-Language handbook (GitHub Pages): **[Docs](https://kartzrbx.github.io/Cluaupp/docs/)** — [every construct](https://kartzrbx.github.io/Cluaupp/docs/reference.html).
-
-- [C++ → Luau syntax](syntax.md)
-- [print and cout](print-cout.md)
-- [C++ types](cpp-types.md)
-- [const](cpp-const.md)
-- [Safety](cpp-safety.md)
-- [Organization](cpp-organization.md)
-- [Architecture](architecture.md)
-- [OOP structure](oop/index.md)
-- [Libraries](libraries/index.md)
-- [Examples](examples/index.md)
-- [Roblox API](roblox-api.md)
-- [CLI](cli.md)

package/docs/intellisense.md

@@ -1,48 +0,0 @@
-# IntelliSense
-
-C++ completion, hover, and go-to-definition are **clangd**. Cluaupp does not ship a second completion engine.
-
-`cluaupp init` / `cluaupp intellisense` install:
-
-1. [clangd](https://marketplace.visualstudio.com/items?itemName=llvm-vs-code-extensions.vscode-clangd) (`llvm-vs-code-extensions.vscode-clangd`)
-2. LLVM `clang++` when missing (Windows: `winget install --id LLVM.LLVM -e`)
-3. `.clangd`, `compile_flags.txt`, and `compile_commands.json` so clangd finds `include/`
-4. Forced include of `include/cluaupp/roblox.hpp` so `GetService`, `Player`, `Janitor` complete from the real C++ stubs
-
-Tree-sitter is the **compiler** frontend (collect → emit Luau). It is not an editor language server. A homemade tokenizer in the CLI would fight clangd — that path is gone.
-
-Microsoft `ms-vscode.cpptools` is **not** used and is **not licensed for Cursor**. Two C++ engines in the same window fight; Cluaupp recommends only clangd and marks cpptools as unwanted.
-
-`cluaupp lsp` only publishes **subset parse errors** (code that clangd may accept as C++ but Cluaupp will not transpile).
-
-## Headers clangd must see
-
-`#include <cluaupp/roblox.hpp>` resolves only if `-Iinclude` is on the clangd compile flags. That maps to `include/cluaupp/roblox.hpp`. Angle-bracket includes are ignored by the transpiler.
-
-`cluaupp init` / `build` / `watch` / `intellisense` rewrite:
-
-- `-Iinclude` and `-Isrc`
-- `-include include/cluaupp/roblox.hpp`
-- one `compile_commands.json` entry per file under `src/`
-
-## Install
-
-```bash
-cluaupp intellisense
-```
-
-Reload: Command Palette → **Developer: Reload Window**. clangd should attach to `.cpp` files.
-
-`cluaupp build` / `watch` only refresh `compile_commands.json` (no download). They never keep deleted files in the compilation database.
-
-## Config that ships
-
-| File | Role |
-| --- | --- |
-| `.vscode/settings.json` | `clangd.enable: true`, `--compile-commands-dir` |
-| `.vscode/extensions.json` | recommends `llvm-vs-code-extensions.vscode-clangd`; marks `ms-vscode.cpptools` unwanted |
-| `.clangd` | C++20, `-Iinclude`, skip `out/` and `libs/` |
-| `compile_flags.txt` | fallback flags if a file is not yet in `compile_commands.json` |
-| `compile_commands.json` | one entry per `src/` file |
-
-`#include <cluaupp/roblox.hpp>` at the top of each source file. The header is not compiled to Luau.