cluaupp 1.0.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 1.4.0
+
+- **Init** writes a Roblox service tree (`ServerScriptService`, `ReplicatedStorage/Shared`, `StarterPlayer`, `ServerStorage`, `ReplicatedFirst`) with DataBoot + TemplateData. Breaking: no more `src/server` / `src/client` / `src/shared`.
+- Native CluauppLibs only: **Flare, Sweep, Spark, Keep, Mint, Axiom, Roster, Gleam, Bloom, Lens, Crest, Pin, Stage, Coil, Helm, Shift, Hive, Ember, Echo, Guide, Trace, Ward**. No Wally alias folders, no `@cluaupp/janitor` workspaces. Promise stays evaera. Libs ship inside the `cluaupp` npm tarball (`runtime/`).
+- Buffer law: `.flare` / `.mint` / `.bloom` / `.helm` / `.shift` / `.hive` / `.axiom` pack u8 ids, ColorSequence, or tables — no JSON on the hot path. Net codec tables use tagged buffers (no `JSONEncode`).
+- **Keep** is ProfileStore-class session lock plus duplication-proof trade escrow: `Reserve` deducts into a vault, `Commit` credits with receipts and `SaveWait`s both profiles (in-place rollback if a save fails), `AbortIfActive` on leave.
+- **Ward** is the server anti-cheat kernel (rate-limit remotes, packet cap, speed strikes). Flare, Net, Keep replication, and Helm call Ward on inbound client buffers. Hive worlds are authoritative (client writes no-op) by default.
+- **Sweep** is the zelador (`~>` Connect). **Spark** is engine-grade GoodSignal (O(1) Disconnect, reentrant Fire queue, `ConnectParallel`). **Shift** compiles FSM/HSM to u8. **Hive** is jecs-style ECS.
+- Starlight handbooks per native name. HUD: Gleam+Mint+Bloom. NPC: Shift+Hive.
+- Instance headers flatten inherited members and creatable classes get `Class()` plus `Class(Instance parent)`.
+- Accept CL++ **0.3.3** (same JSON contract as 0.3.2).
+- `#include <clpp/libs/keep.clh>` (and the other native headers) now insert `require(ReplicatedStorage.CluauppLibs.*)` even when CL++ does not list the lib in `artifact.libraries`. Template `include/clpp/libs/` ships every native `.clh`.
+
+## 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.

package/README.md

@@ -1,30 +1,42 @@
 # 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>
 
 **CL++ games on Roblox.** You write [CL++](https://kartzrbx.github.io/CLPP/). Cluaupp runs `clpp`, wires Rojo, and copies CluauppLibs.
 
-[CL++ language](https://kartzrbx.github.io/CLPP/) · [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-white.svg)](LICENSE)
 
-Cluaupp is the **toolchain**, not the language compiler. [KartzRbx/CLPP](https://github.com/KartzRbx/CLPP) owns syntax, IntelliSense (`clpp install`), and Luau codegen. This CLI finds `.clpp` / `.clp` / `.clh`, runs `clpp api compile`, rewrites `ClppLibs` → `ReplicatedStorage.CluauppLibs`, and writes `out/` for Rojo.
+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` (and `.flare` / `.mint` / `.bloom` / `.helm` / `.shift` / `.hive` / `.axiom`), runs `clpp api compile`, rewrites `ClppLibs` → `ReplicatedStorage.CluauppLibs`, and writes `out/` for Rojo.
+
+Native PascalCase CluauppLibs: **Flare** net, **Sweep** zelador, **Spark** signal, **Keep** data, **Mint** numbers, **Axiom** math, **Roster** tables, **Gleam** UI, **Bloom** effects, **Lens** debug UI, **Crest** topbar, **Pin** billboard, **Stage** viewport 3D, **Coil** spring, **Helm** commands, **Shift** states, **Hive** ECS, **Ward** anti-cheat, **Ember** VFX, **Echo** replication, **Guide** tutorials, **Trace** pretty-print. Schemas pack u8 ids / ColorSequence / tables — never JSON on the hot path. Name map: [`runtime/SOURCES.md`](runtime/SOURCES.md).
 
 ```clpp
 #include <clpp/roblox.clh>
-#include <clpp/libs/janitor.clh>
+
+struct HelloServer {
+	void Greet(Player player);
+};
+
+void HelloServer::Greet(Player player) {
+	post("Player name: " .: player.Name);
+}
 
 void init() {
-	Players* players = GetService<Players>();
-	players::PlayerAdded~>Connect(func [](Player* player) {
-		guard (player != null) else {
-			return;
-		}
-		post("hello, " .: player.Name);
+	HelloServer hello;
+	Players players = GetService<Players>();
+
+	for (Player player in players.GetPlayers()) {
+		hello.Greet(player);
+	}
+
+	players.PlayerAdded~>Connect(func (Player playerEntered) {
+		hello.Greet(playerEntered);
 	});
 }
 ```
@@ -33,11 +45,11 @@ void init() {
 
 1. [Node.js](https://nodejs.org/) 18+
 2. [Rojo](https://rojo.space/) **7.7.0**
-3. **`clpp` on PATH** from [CL++](https://github.com/KartzRbx/CLPP) (`cargo install --path .`)
+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
-clpp install
+clpp setup
 npx cluaupp init my-game
 cd my-game
 rokit install
@@ -59,16 +71,16 @@ cluaupp init [folder]
 cluaupp build [folder]
 cluaupp watch [folder]
 cluaupp language          # clpp api manifest
-cluaupp intellisense      # files.associations + clpp install
+cluaupp intellisense      # files.associations + clpp setup
 ```
 
-`clpp` missing? Set `CLPP_PATH` or install [CL++](https://github.com/KartzRbx/CLPP).
+`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/)**.
+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: [docs/migration.md](docs/migration.md).
+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 !== "clpp" && 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

@@ -2,7 +2,7 @@
 	"name": "cluaupp-diagnostics",
 	"displayName": "Cluaupp",
 	"description": "Cluaupp project diagnostics. Language highlighting and IntelliSense come from clpp install (CL++).",
-	"version": "1.0.0",
+	"version": "1.4.0",
 	"publisher": "kartzdev",
 	"engines": {
 		"vscode": "^1.74.0"
@@ -18,7 +18,7 @@
 		"commands": [
 			{
 				"command": "cluaupp.restartIntelliSense",
-				"title": "Cluaupp: Reload CL++ diagnostics"
+				"title": "Cluaupp: Reload editor helper"
 			}
 		]
 	}

package/examples/README.md

@@ -1,16 +1,15 @@
 # Sample game
 
-CL++ sources for a Cluaupp project — **not** the compiler. Language samples: [CL++ examples](https://github.com/KartzRbx/CLPP/tree/main/examples).
+Same Roblox service tree as `cluaupp init` (`templates/game`). Language samples: [CL++ examples](https://github.com/KartzRbx/CLPP/tree/main/examples).
 
 | Folder | Rojo | Tag |
 | --- | --- | --- |
-| `src/server/*.server.clpp` | Script | server |
-| `src/client/*.client.clpp` | LocalScript | client |
-| `src/shared/*.clp` / `*.clh` | ModuleScript | none |
+| `src/ServerScriptService/*.server.clpp` | Script | server |
+| `src/StarterPlayer/StarterPlayerScripts/*.client.clpp` | LocalScript | client |
+| `src/StarterPlayer/StarterCharacterScripts/*.client.clpp` | LocalScript (character) | client |
+| `src/ReplicatedStorage/Shared/*.clp` / `*.clh` | ModuleScript | none |
 
 ```bash
 cd examples/game
 npx cluaupp build .
 ```
-
-`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,5 +1,6 @@
 {
 	"unwantedRecommendations": [
 		"ms-vscode.cpptools"
-	]
+	],
+	"recommendations": []
 }

package/examples/game/default.project.json

@@ -2,33 +2,38 @@
 	"name": "cluaupp-game",
 	"tree": {
 		"$className": "DataModel",
+		"ReplicatedFirst": {
+			"$className": "ReplicatedFirst",
+			"$path": "out/ReplicatedFirst"
+		},
 		"ServerScriptService": {
 			"$className": "ServerScriptService",
-			"Cluaupp": {
-				"$path": "out/server"
-			}
+			"$path": "out/ServerScriptService"
 		},
 		"ReplicatedStorage": {
 			"$className": "ReplicatedStorage",
-			"Cluaupp": {
-				"$path": "out/shared"
+			"Shared": {
+				"$path": "out/ReplicatedStorage/Shared"
 			},
 			"CluauppLibs": {
 				"$path": "libs"
-			},
-			"Packages": {
-				"$path": "Packages"
 			}
 		},
 		"StarterPlayer": {
 			"$className": "StarterPlayer",
 			"StarterPlayerScripts": {
 				"$className": "StarterPlayerScripts",
-				"Cluaupp": {
-					"$path": "out/client"
-				}
+				"$path": "out/StarterPlayer/StarterPlayerScripts"
+			},
+			"StarterCharacterScripts": {
+				"$className": "StarterCharacterScripts",
+				"$path": "out/StarterPlayer/StarterCharacterScripts"
 			}
 		},
+		"ServerStorage": {
+			"$className": "ServerStorage",
+			"$path": "out/ServerStorage"
+		},
 		"HttpService": {
 			"$className": "HttpService",
 			"$properties": {