cluaupp 0.2.3 → 1.3.0

package/CHANGELOG.md

@@ -1,6 +1,48 @@
 # Changelog
 
-## Unreleased
+## 1.3.0
+
+Align with CL++ **0.3.2**.
+
+- Require `clpp` 0.3.2 (`CLPP` / `CLPP_PATH`, then PATH, then `%LOCALAPPDATA%\Programs\CLPP`).
+- Instances are class names: `Player player`, never `Player*`. Default listen is `~>Connect`; fire with `.Fire`.
+- `@this` / `@field` only inside `Class::Method`. `void init()` holds a local Janitor.
+- Compile failures surface `diagnostics[]` (1-based). `watch` compiles with async `spawn`.
+- Templates, examples, headers, and handbook match the 0.3.2 operator table.
+- Docs site is Starlight (Astro) in `docs/`, with the official CL++ TextMate grammar for `clpp` fences.
+
+## 1.2.1
+
+Align with CL++ **0.3.0** accessors.
+
+- `.` is properties, table keys, **and** instance methods (`player.Name`, `DataService.Server`, `player.FindFirstChild("x")`).
+- `:` is **not** a table/property accessor. It is types (`age: int`) and protected calls (`player:Kick()` → `pcall`).
+- `::` stays for statics and manual Connect (`task::wait`, `Color3::fromRGB`, `players.PlayerAdded::Connect`).
+- Pick the newest `clpp` on PATH. Refuse compilers older than **0.3.0**.
+- Language diagnostics stay with `clpp install` (no keystroke recompile from Cluaupp).
+- Range-for is `for (T x in list)`.
+
+## 1.2.0
+
+Properties use `.`. Manual Connect uses `::`: `players.PlayerAdded::Connect(fn)`. Instance methods also use `.` (`player.FindFirstChild`). Do not use `:` for tables.
+
+## 1.1.0
+
+CL++ 0.3.0: anonymous callbacks are `func (params) { }`. `func [](…)` and C++ capture lists are rejected by `clpp`.
+
+- Examples, README, migration table, and docs use `func (…)` / `func ()`.
+- Requires CL++ **0.3.0** on PATH (`clpp install` for the error lens).
+
+## 1.0.0
+
+Breaking: Cluaupp no longer transpiles a C++ subset. Games are **CL++** (`.clpp` / `.clp` / `.clh`). The CLI orchestrates the [`clpp`](https://github.com/KartzRbx/CLPP) binary (`clpp api compile`), post-processes Luau (`ClppLibs` → `ReplicatedStorage.CluauppLibs`), and writes `out/` for Rojo.
+
+- Requires `clpp` on PATH (`CLPP_PATH` override). Language, IntelliSense, and codegen live in CL++ (`clpp install`).
+- `cluaupp language` prints `clpp api manifest`.
+- Templates and `examples/game` use CL++ syntax (`guard`, `match`, `signal`, `.:`, `::`, Fusion).
+- Docs site and README are CL++ × Luau (no clangd / `.cpp` toolchain).
+- Tree-sitter C++ frontend removed. ForeverHD `"architecture": true` folder split is not implemented on this path.
+- See [migration](docs/migration.md) and [CL++ docs](https://kartzrbx.github.io/CLPP/).
 
 ## 0.2.3
 
@@ -9,81 +51,3 @@
 - `string_concat(...)` joins to Luau `..` (alongside string `+`).
 - Cursor is not a licensed host for Microsoft `ms-vscode.cpptools`. Cluaupp no longer writes `C_Cpp.*` settings or `c_cpp_properties.json`; `watch` strips leftover keys and marks cpptools as unwanted. C++ completion stays clangd.
 - Docs site is a C++-class handbook (syntax through lambdas and Luau `--!strict`). Per-class and per-enum dump pages are gone; engine members stay on create.roblox.com.
-
-## 0.2.2
-
-- Header modules with a sibling `.cpp` now re-export those functions (`startingCoins` from `config.cpp` lands on `config.luau` via `configImpl`). The impl no longer `require`s its own header (`ReplicatedStorage.config`).
-
-## 0.2.1
-
-- Pin `tree-sitter` 0.21.1 and `tree-sitter-c` 0.23.2 so `npm i -g cluaupp` no longer pulls `tree-sitter-c@0.23.6` (peerOptional `tree-sitter@^0.22.1`).
-
-## 0.2.0
-
-- CLI rewritten as a TypeScript collector-emitter pipeline: Tree-sitter collection, Rojo-mapped `require`s, ordered Luau blocks (Services → Requires → Types → Constants → Code), then optional StyLua / `luau-analyze`. Commands `init`, `build`, `watch`, `lsp`, and `intellisense` stay. `cluaupp build -i file.cpp -o out.luau --rojo default.project.json` is the single-file path.
-- C++ IntelliSense is **clangd** only. The old tokenizer/`completeAt` engine is gone. Tree-sitter is the compiler frontend. `cluaupp lsp` publishes subset parse errors only.
-- `SystemUnderstander` scans identifiers, scores Roblox intents, and stamps Controller / Manager / utility plus `GetService` injections. Filename tags still decide Script vs LocalScript vs ModuleScript.
-- Sample game C++ lives in `examples/game/` (`src/server`, `src/client`, `src/shared`). Compiler `src/` is TypeScript only.
-- CLI security: StyLua / luau-analyze via `spawn` without a shell; emitted paths cannot leave the project; `.env*` stays out of git and the npm pack.
-- Docs / GitHub Pages: clangd, SystemUnderstander, one-file-out emit, `examples/game`. Rojo **7.7.0**.
-- Tests cover `out/` tree, types, modules, path safety, and understander roles.
-
-## 0.1.5
-
-- Default emit is one tagged `.cpp` → one `.server.luau` / `.client.luau`. `"architecture": true` keeps the old ForeverHD service folders.
-- `--!strict` is opt-in: `#pragma strict`, `#pragma nstrict`, or `"strict": true` in config (default `false`).
-- `.h` / `.hpp` emit type ModuleScripts (`export type` + typed table). A sibling `.cpp` becomes `*Impl.luau`; the header binds those functions.
-- Shared `#include` modules `require` game-rooted paths (`ReplicatedStorage.Cluaupp...` / `ServerScriptService.Cluaupp...`).
-
-## 0.1.4
-
-- Quoted `#include "Header.h"` of project files becomes `const Header = require(...)`. Header-only structs emit a constructor (`TemplateData()`); const headers bind `PLAYER_DATA_VERSION` from the module. Boot scripts require services (`LeaderstatsServer:init()`).
-- Keep `const` for injected `require` / `GetService` and `const function` for C++ functions (not `local`).
-- `init.meta.json` stays pure JSON. Library `require` injection no longer prepends Luau onto Rojo meta files (which made `rojo serve` fail with a JSONC parse error).
-- Server services emit `init.server.luau` + `init.meta.json` with **only** `RunContext.Server`. Rojo forbids `className` when an `init.*` script exists (the folder is already a Script, not a Folder). `init.luau` is pruned so the instance is not a ModuleScript.
-
-## 0.1.3
-
-- Architecture: generated services keep a fixed declaration order (requires, types, constants, variables, functions, cleanup, return) without section banners. Domain `Stop` runs `janitor:Cleanup()`.
-- IntelliSense: `cluaupp init` / `cluaupp intellisense` install Microsoft `ms-vscode.cpptools` (VSIX on Cursor, where the marketplace omits it), write `.vscode/c_cpp_properties.json` (LLVM clang++, C++20, `include/` + `src/`, `compile_commands.json`), and disable clangd so the two engines do not fight. `build`/`watch` only refresh `compile_commands.json`.
-- `Class::method` on game types becomes `Class:method()` (`self`). Datatype/library statics stay dotted (`CFrame.lookAt`, `Color3.fromRGB`, `FormatNumber.Abbreviate`).
-- `switch` / `case` / `default` / `break` compile to a one-shot `repeat` with `if` / `elseif` / `else`. The discriminant is evaluated once; stacked `case` labels share a body; `break` leaves the switch even from inside an `if`.
-- Janitor typed border re-exports `_impl` (`export type Janitor = Impl.Janitor; return Impl`). It no longer invents `Has` or requires Promise for a parallel type that did not match howmanysmall.
-- Emit: injected `require` / `GetService` are `const`. C++ functions emit as `const function` instead of `local function`.
-- `.server.cpp` emits `init.luau` + `init.meta.json` with `RunContext.Server`. `init.server.luau` is Legacy and is pruned.
-- `cout << ... << endl` emits `print(...)`. `cerr <<` emits `warn`. `cout::print` / `cout::warn` / `cout::error` / `cout::ping` map to the Roblox globals.
-- Docs: [print and cout](docs/print-cout.md); [Libraries](docs/libraries/index.md) how-tos (DataService Init, Janitor, Promise, Net); [OOP structure](docs/oop/index.md) (file tags, services, modules); [Examples](docs/examples/index.md) (leaderstats, combat validation, shop, HUD, sword). GitHub Pages Learn tabs: OOP, Libraries, print/cout, Examples — generated into `site/` (`guide/oop.html`, `guide/examples.html`).
-
-## 0.1.2
-
-- Watch does not write `out/` while any file fails to compile (Studio keeps the last good scripts).
-- Watch/build skip rewriting Luau whose contents did not change (a space in C++ no longer floods Rojo).
-- Watch never copies `libs/` or headers. Changing a constant no longer makes Rojo 7 crash on `libs/ArrayIndexer`.
-- `libs/` on `cluaupp build` is fill-only: missing files are restored, existing files are never overwritten or deleted.
-- Filename tags: `.server.cpp` → Script (`init.server.luau`), `.client.cpp` → LocalScript (`init.client.luau`), `.plugin.cpp` → Plugin, `.legacy` / `.legacy.client` / `.legacy.server` → Legacy. Bare `init.luau` is not used for `.server` (Rojo would make a ModuleScript).
-- Dropped `$optional` from `default.project.json` (Rojo 7.7 failed to deserialize it).
-
-## 0.1.1
-
-- DataService: `DataServiceOptions<T>.Template` is the required player-data table (`T` matches the save struct). Also documents `Exclude`.
-- Compiler: C++ designated initializers (`Type { .Field = value }`) emit Luau tables, so `DataService.Server:Init({ Template = ... })` type-checks and compiles.
-- Watch/build: delete orphaned `out/` files when a source is removed. Never wipe `out/` or `libs/` as a whole — Rojo 7 crashes if `libs/ArrayIndexer` disappears mid-serve. Vendor files are only created if missing; existing `libs/` is never overwritten on watch/build. Watch skips writing `out/` when compile fails, and skips rewriting Luau whose contents did not change.
-
-## 0.1.0
-
-- Product name: **Cluaupp** (C++ × Luau)
-- First public release
-- CLI: `init`, `build`, `watch`, `--version`
-- Transpile C++ subset → Luau `--!strict`
-- `local` and `const x = ...`
-- Full Roblox API from the official dump (925 classes, 636 enums)
-- Datatypes: Vector3, Vector2, CFrame, UDim, UDim2, Color3, BrickColor, Rect, Ray, …
-- `Enum::Material::Plastic` → `Enum.Material.Plastic`
-- GitHub Pages site for every class, method, and event
-- Game template + IntelliSense header (`roblox.hpp`, `compile_flags.txt`, clangd)
-- IntelliSense headers are valid C++: `LuaArray` for `GetPlayers`, templated `Connect`, optional dump defaults (`FindFirstChild`), no recursive `Vector3.Unit` field
-- Libraries: full GitHub systems in CluauppLibs (Janitor, Promise, Fusion, Iris, Cmdr, TopbarPlus, Chrono, DataServiceV2, EzVisualz, StateMachine, Spring, Display, Module3D, FormatNumber) plus Cluaupp originals (Net, MathUtils, Twinkle, StickyBillboard, VfxUtil)
-- Wally is optional; `node scripts/vendor-libs.js` re-copies from `vendor/` clones
-- Moonwave docs (C++ types, const, safety, organization)
-- Service architecture: filename tags (`.server` / `.client` / `.legacy.*` / module) plus AST intent scoring (combat, cache, players, …) — not leaderstats-only
-- Type functions ArrayIndexer (`Table`) and Occlude (`Keys`) in CluauppLibs

package/README.md

@@ -1,120 +1,84 @@
 # Cluaupp
 
 <p align="center">
-  <img src="site/assets/logo.png" alt="Cluaupp" width="160">
+  <img src="docs/public/assets/logo.png" alt="Cluaupp" width="160">
 </p>
 
-**The definitive merge of C++ and modern Luau.**
+**CL++ games on Roblox.** You write [CL++](https://kartzrbx.github.io/CLPP/). Cluaupp runs `clpp`, wires Rojo, and copies CluauppLibs.
 
-[Docs](https://kartzrbx.github.io/Cluaupp/) · [Handbook](https://kartzrbx.github.io/Cluaupp/docs/)
+[CL++ language](https://kartzrbx.github.io/CLPP/) · [Docs](https://kartzrbx.github.io/Cluaupp/)
 
 [![npm version](https://img.shields.io/npm/v/cluaupp.svg)](https://www.npmjs.com/package/cluaupp)
 [![Node.js](https://img.shields.io/node/v/cluaupp.svg)](https://nodejs.org)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-white.svg)](LICENSE)
 
-Source-to-source transpiler: you write a C++ subset, Cluaupp emits modern [Luau](https://luau.org/getting-started) (`local`, `const`, optional `--!strict`). C++ structure, Luau quality, one language.
+Cluaupp is the **toolchain**, not the language compiler. [KartzRbx/CLPP](https://github.com/KartzRbx/CLPP) owns syntax, IntelliSense (`clpp setup`), and Luau codegen. This CLI finds `.clpp` / `.clp` / `.clh`, runs `clpp api compile`, rewrites `ClppLibs` → `ReplicatedStorage.CluauppLibs`, and writes `out/` for Rojo.
 
-No WASM. No Emscripten. No `lua_call`. Roblox APIs come out as they do in Studio: `game:GetService("Players")`, `player:FindFirstChild("leaderstats")`, `players:GetPlayers()`.
+```clpp
+#include <clpp/roblox.clh>
 
-```cpp
-auto* players = GetService<Players>();
-for (auto* player : players->GetPlayers()) {
-	CreateLeaderstats(player);
+struct HelloServer {
+	void Greet(Player player);
+};
+
+void HelloServer::Greet(Player player) {
+	post("Player name: " .: player.Name);
 }
-players->PlayerAdded.Connect(CreateLeaderstats);
 
-auto* part = new Part(workspace);
-part->Size = Vector3(8, 1, 8);
-part->CFrame = CFrame::lookAt(Vector3(0, 10, 0), Vector3(0, 10, -10));
-frame->Size = UDim2::fromScale(1, 1);
-```
+void init() {
+	HelloServer hello;
+	Players players = GetService<Players>();
 
-becomes
+	for (Player player in players.GetPlayers()) {
+		hello.Greet(player);
+	}
 
-```luau
---!strict
-local players: Players = game:GetService("Players")
-for _, player in players:GetPlayers() do
-	CreateLeaderstats(player)
-end
-players.PlayerAdded:Connect(CreateLeaderstats)
+	players.PlayerAdded~>Connect(func (Player playerEntered) {
+		hello.Greet(playerEntered);
+	});
+}
 ```
 
 ## Install
 
-Node.js 18+ and [Rojo](https://rojo.space/) **7.7.0** for Studio sync (`rokit.toml` in the game template).
+1. [Node.js](https://nodejs.org/) 18+
+2. [Rojo](https://rojo.space/) **7.7.0**
+3. **`clpp` 0.3.2** on PATH from [CL++](https://github.com/KartzRbx/CLPP/releases/tag/v0.3.2) (`clpp-setup.exe` or `clpp setup`). Do not leave a cargo `clpp 0.1.0` first on PATH.
 
 ```bash
 npm install -g cluaupp
-```
-
-Or run without a global install:
-
-```bash
+clpp setup
 npx cluaupp init my-game
-```
-
-## Quick start
-
-```bash
-cluaupp init my-game
 cd my-game
 rokit install
 cluaupp build
 rojo serve
 ```
 
-Connect the Rojo plugin in Roblox Studio. Edit `src/**/*.{cpp,h,hpp}`, run `cluaupp watch` to rebuild on save.
+| Source | Output | Rojo |
+| --- | --- | --- |
+| `*.server.clpp` | `*.server.luau` | Script |
+| `*.client.clpp` | `*.client.luau` | LocalScript |
+| `*.clp` / untagged `.clpp` | `*.luau` | ModuleScript |
+| `*.clh` | `*.luau` | ModuleScript |
 
-C++ autocomplete is **clangd**, not a Cluaupp tokenizer and not Microsoft cpptools. Put `#include <cluaupp/roblox.hpp>` at the top of each script; `cluaupp init` writes `.clangd` / `compile_flags.txt` / `compile_commands.json` with `-Iinclude` so clangd finds that header. Tree-sitter is only used to compile. See [IntelliSense](docs/intellisense.md).
+## CLI
 
-```
-src/server/*.server.cpp  →  out/server/*.server.luau  Script
-src/client/*.client.cpp  →  out/client/*.client.luau  LocalScript
-src/shared/*.cpp         →  out/shared/*.luau         ModuleScript
+```bash
+cluaupp init [folder]
+cluaupp build [folder]
+cluaupp watch [folder]
+cluaupp language          # clpp api manifest
+cluaupp intellisense      # files.associations + clpp setup
 ```
 
-Filename tags: `.server.cpp`, `.client.cpp`, `.legacy.server.cpp`, `.legacy.client.cpp`, or no tag (ModuleScript). One source file becomes one instance. Set `"architecture": true` only for the old PascalCase folder split. See [Architecture](docs/architecture.md) and [OOP structure](docs/oop/index.md).
-
-Compiler TypeScript lives in `src/`. Sample game C++ is [`examples/game`](examples/game) (`src/server`, `src/client`, `src/shared`). `cluaupp init` still copies [`templates/game`](templates/game).
-
-## Documentation
-
-| Guide | What it covers |
-| --- | --- |
-| [Getting started](docs/getting-started.md) | Install, first project, Rojo, IntelliSense |
-| [**Docs + API (GitHub Pages)**](https://kartzrbx.github.io/Cluaupp/) | Site, Learn tab, every class / datatype / enum |
-| [Learn](https://kartzrbx.github.io/Cluaupp/learn/) | C++ subset, Luau output, safety, architecture |
-| [CLI](docs/cli.md) | `init`, `build`, `watch`, flags |
-| [Syntax](docs/syntax.md) | C++ subset → Luau (`local`, `const`, types) |
-| [print and cout](docs/print-cout.md) | `cout <<`, `cout::warn`, `endl` |
-| [Roblox API](docs/roblox-api.md) | Vector3, CFrame, UDim2, GetService, Instance.new |
-| [Architecture](docs/architecture.md) | One file in, one file out; opt-in ForeverHD folders |
-| [OOP structure](docs/oop/index.md) | File tags, services, modules, structs |
-| [Libraries](docs/libraries/index.md) | DataService Init, Janitor, Promise, Net |
-| [Examples](docs/examples/index.md) | Leaderstats, combat validation, shop, HUD, sword |
-| [C++ types](docs/cpp-types.md) | Typing, `const`, safety, organization |
-| [Comparison](docs/comparison.md) | vs roblox-ts and WASM toolchains |
-| [Contributing](CONTRIBUTING.md) | Tests, layout, how to ship |
-
-## Programmatic API
-
-```js
-const { compileSource, compileService } = require("cluaupp");
-
-const luau = compileSource(
-	`void init() { print("ok"); }`,
-	"init.cpp",
-	{ strict: true },
-);
-
-const service = compileService(
-	cppSource,
-	"server/leaderstats.server.cpp",
-	{ relativeName: "server/leaderstats.server.cpp" },
-);
-// service.files → LeaderStats/Main.luau, PlayersManager, CacheController, Types
-```
+`clpp` missing? Set `CLPP` / `CLPP_PATH` or install [CL++ 0.3.2](https://github.com/KartzRbx/CLPP/releases/tag/v0.3.2).
+
+## Language
+
+Course and reference: **[kartzrbx.github.io/CLPP](https://kartzrbx.github.io/CLPP/)**. Write `Player player` (never `Player*`). Default listen is `~>Connect`. Fire with `.Fire`. `@this` only inside `Class::Method`.
+
+Exclusive CL++ (`guard`, `match`, `signal`, `observable`, `.:`, `::`, Fusion) is compiled by `clpp`. Samples: [`examples/game`](examples/game). Old C++ games: [migration](docs/src/content/docs/migration.md). Toolchain docs (Starlight): `npm run site:dev`.
 
 ## License
 

package/editors/vscode/extension.js

@@ -28,7 +28,7 @@ function loadEngine(context) {
 			}
 		}
 	}
-	throw new Error("Cluaupp diagnostics engine not found. Run `cluaupp intellisense` in the game folder.");
+	throw new Error("Cluaupp editor helper not found. Run `cluaupp intellisense` then `clpp install`.");
 }
 
 function activate(context) {
@@ -43,44 +43,21 @@ function activate(context) {
 	const diagnostics = vscode.languages.createDiagnosticCollection("cluaupp");
 	context.subscriptions.push(diagnostics);
 
-	const optionsFor = (document) => ({
-		projectRoot: loaded.workspaceFolder || path.dirname(document.uri.fsPath),
-		file: document.uri.fsPath,
-		filePath: document.uri.fsPath,
-		includeDirs: [
-			path.dirname(document.uri.fsPath),
-			path.join(loaded.workspaceFolder || "", "src"),
-			path.join(loaded.workspaceFolder || "", "include"),
-		],
-	});
-
-	const refreshDiagnostics = (document) => {
-		if (!document || document.languageId !== "cpp") {
-			return;
-		}
-		if (typeof loaded.engine.diagnosticsFor !== "function") {
+	const clearCluaupp = (document) => {
+		if (!document || document.languageId !== "clpp") {
 			return;
 		}
-		const items = loaded.engine.diagnosticsFor(document.getText(), document.uri.fsPath, optionsFor(document));
-		diagnostics.set(
-			document.uri,
-			items.map((item) => {
-				const line = Math.max(0, (item.line || 1) - 1);
-				const col = Math.max(0, (item.col || 1) - 1);
-				const range = new vscode.Range(line, col, line, col + 1);
-				return new vscode.Diagnostic(range, item.message, vscode.DiagnosticSeverity.Error);
-			}),
-		);
+		diagnostics.set(document.uri, []);
 	};
 
 	context.subscriptions.push(
-		vscode.workspace.onDidChangeTextDocument((event) => refreshDiagnostics(event.document)),
-		vscode.workspace.onDidOpenTextDocument(refreshDiagnostics),
+		vscode.workspace.onDidOpenTextDocument(clearCluaupp),
 		vscode.commands.registerCommand("cluaupp.restartIntelliSense", () => {
 			try {
 				delete require.cache[require.resolve(loaded.enginePath)];
 				loaded = loadEngine(context);
-				vscode.window.showInformationMessage("Cluaupp diagnostics reloaded. C++ completion is clangd.");
+				diagnostics.clear();
+				vscode.window.showInformationMessage("Cluaupp helper reloaded. Language diagnostics come from clpp install.");
 			} catch (err) {
 				vscode.window.showErrorMessage(String(err.message || err));
 			}
@@ -88,7 +65,7 @@ function activate(context) {
 	);
 
 	for (const document of vscode.workspace.textDocuments) {
-		refreshDiagnostics(document);
+		clearCluaupp(document);
 	}
 }
 

package/editors/vscode/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "cluaupp-diagnostics",
 	"displayName": "Cluaupp",
-	"description": "Cluaupp subset parse errors. C++ completion, hover, and go-to-definition come from clangd + include/cluaupp/roblox.hpp.",
-	"version": "0.2.2",
+	"description": "Cluaupp project diagnostics. Language highlighting and IntelliSense come from clpp install (CL++).",
+	"version": "1.3.0",
 	"publisher": "kartzdev",
 	"engines": {
 		"vscode": "^1.74.0"
@@ -11,14 +11,14 @@
 		"Linters"
 	],
 	"activationEvents": [
-		"onLanguage:cpp"
+		"onLanguage:clpp"
 	],
 	"main": "./extension.js",
 	"contributes": {
 		"commands": [
 			{
 				"command": "cluaupp.restartIntelliSense",
-				"title": "Cluaupp: Reload subset diagnostics"
+				"title": "Cluaupp: Reload editor helper"
 			}
 		]
 	}

package/examples/README.md

@@ -1,18 +1,16 @@
 # Sample game
 
-This is the C++ a Cluaupp game looks like — **not** the compiler.
+CL++ sources for a Cluaupp project — **not** the compiler. Language samples: [CL++ examples](https://github.com/KartzRbx/CLPP/tree/main/examples).
 
 | Folder | Rojo | Tag |
 | --- | --- | --- |
-| `src/server/*.server.cpp` | Script | server |
-| `src/client/*.client.cpp` | LocalScript | client |
-| `src/shared/*` | ModuleScript | none |
-
-`src/` of **this repo** is the TypeScript CLI ([roblox-ts](https://github.com/roblox-ts/roblox-ts) does the same). The sample scripts live here so they never mix with `understand.ts`.
+| `src/server/*.server.clpp` | Script | server |
+| `src/client/*.client.clpp` | LocalScript | client |
+| `src/shared/*.clp` / `*.clh` | ModuleScript | none |
 
 ```bash
 cd examples/game
 npx cluaupp build .
 ```
 
-`cluaupp init` copies `templates/game` (the slim scaffold). This folder adds combat / HUD so `SystemUnderstander` has real tokens to score.
+`cluaupp init` copies `templates/game`. This folder adds combat (`guard` / `match` / `signal` / `observable` / `spawn`), a Fusion HUD, `features.clp`, and `PlayerData.clh`.

package/examples/game/.vscode/extensions.json

@@ -1,8 +1,6 @@
 {
-	"recommendations": [
-		"llvm-vs-code-extensions.vscode-clangd"
-	],
 	"unwantedRecommendations": [
 		"ms-vscode.cpptools"
-	]
+	],
+	"recommendations": []
 }

package/examples/game/.vscode/settings.json

@@ -1,18 +1,10 @@
 {
-	"clangd.enable": true,
-	"clangd.arguments": [
-		"--compile-commands-dir=${workspaceFolder}",
-		"--header-insertion=never",
-		"--query-driver=**/clang++*,**/clang++.exe,**/g++*,**/g++.exe"
-	],
 	"files.associations": {
-		"*.hpp": "cpp",
-		"*.h": "cpp",
-		"*.server.cpp": "cpp",
-		"*.client.cpp": "cpp",
-		"*.plugin.cpp": "cpp",
-		"*.legacy.cpp": "cpp",
-		"*.legacy.server.cpp": "cpp",
-		"*.legacy.client.cpp": "cpp"
+		"*.clpp": "clpp",
+		"*.clp": "clpp",
+		"*.clh": "clpp",
+		"*.server.clpp": "clpp",
+		"*.client.clpp": "clpp",
+		"*.plugin.clpp": "clpp"
 	}
 }

package/{include/cluaupp/datatypes.hpp → examples/game/include/clpp/datatypes.clh}

@@ -1,5 +1,5 @@
 #pragma once
-#include <cluaupp/generated/enums.hpp>
+#include <clpp/generated/enums.clh>
 using Enum::EasingStyle;
 using Enum::EasingDirection;
 using Enum::Material;