cluaupp 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 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**.

package/README.md

@@ -12,7 +12,9 @@
 [![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 setup`), 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>

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.3.0",
+	"version": "1.4.0",
 	"publisher": "kartzdev",
 	"engines": {
 		"vscode": "^1.74.0"

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/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": {

package/examples/game/include/clpp/datatypes.clh

@@ -27,10 +27,7 @@ struct Player;
 // Stand-in for values the C++ IntelliSense stubs cannot name precisely.
 struct LuauValue {
 	LuauValue();
-	template <typename T>
-	LuauValue(const T&);
-	template <typename T>
-	operator T() const;
+	LuauValue(auto value);
 };
 
 template <typename T>
@@ -240,7 +237,7 @@ struct Ray {
 
 // Filters for WorldRoot:Raycast.
 struct RaycastParams {
-	Instance* FilterDescendantsInstances;
+	LuaArray<Instance> FilterDescendantsInstances;
 	RaycastFilterType FilterType;
 	bool IgnoreWater;
 	string CollisionGroup;
@@ -251,7 +248,7 @@ struct RaycastParams {
 
 // Result of a raycast.
 struct RaycastResult {
-	Instance* Instance;
+	Instance Instance;
 	Vector3 Position;
 	Vector3 Normal;
 	double Distance;
@@ -260,7 +257,7 @@ struct RaycastResult {
 
 // Filters for GetPartBoundsInBox / GetPartsInPart.
 struct OverlapParams {
-	Instance* FilterDescendantsInstances;
+	LuaArray<Instance> FilterDescendantsInstances;
 	RaycastFilterType FilterType;
 	int MaxParts;
 	string CollisionGroup;
@@ -434,12 +431,9 @@ struct RBXScriptConnection {
 
 // Event. PlayerAdded.Connect(callback) — F matches any listener arity.
 struct RBXScriptSignal {
-	template <typename F>
-	RBXScriptConnection Connect(F callback);
-	template <typename F>
-	RBXScriptConnection Once(F callback);
-	template <typename F>
-	RBXScriptConnection ConnectParallel(F callback);
+	RBXScriptConnection Connect(func callback);
+	RBXScriptConnection Once(func callback);
+	RBXScriptConnection ConnectParallel(func callback);
 	LuauValue Wait();
 };
 
@@ -507,9 +501,41 @@ struct Secret {
 	Secret();
 };
 
-// buffer
+// Luau binary buffer. Library + type: buffer::create, buffer::writeu32, buffer::readf64.
 struct buffer {
 	buffer();
+	static buffer create(int size);
+	static buffer fromstring(string str);
+	static string tostring(buffer b);
+	static string tostring(buffer b, int offset);
+	static string tostring(buffer b, int offset, int count);
+	static int len(buffer b);
+	static void copy(buffer target, int targetOffset, buffer source);
+	static void copy(buffer target, int targetOffset, buffer source, int sourceOffset);
+	static void copy(buffer target, int targetOffset, buffer source, int sourceOffset, int count);
+	static void fill(buffer b, int offset, int value);
+	static void fill(buffer b, int offset, int value, int count);
+	static int readi8(buffer b, int offset);
+	static int readu8(buffer b, int offset);
+	static int readi16(buffer b, int offset);
+	static int readu16(buffer b, int offset);
+	static int readi32(buffer b, int offset);
+	static int readu32(buffer b, int offset);
+	static double readf32(buffer b, int offset);
+	static double readf64(buffer b, int offset);
+	static string readstring(buffer b, int offset, int count);
+	static int readbits(buffer b, int bitOffset, int bitCount);
+	static void writei8(buffer b, int offset, int value);
+	static void writeu8(buffer b, int offset, int value);
+	static void writei16(buffer b, int offset, int value);
+	static void writeu16(buffer b, int offset, int value);
+	static void writei32(buffer b, int offset, int value);
+	static void writeu32(buffer b, int offset, int value);
+	static void writef32(buffer b, int offset, double value);
+	static void writef64(buffer b, int offset, double value);
+	static void writestring(buffer b, int offset, string value);
+	static void writestring(buffer b, int offset, string value, int count);
+	static void writebits(buffer b, int bitOffset, int bitCount, int value);
 };
 
 // BinaryString